@hupan56/wlkj 2.7.11 → 3.0.0

package/templates/qoder/scripts/report/req.py

@@ -0,0 +1,222 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""req.py - 需求生命周期管理 (/wl-req 命令)
+
+M3 workspace 重构的核心。解决"找不到产出"痛点:
+一个需求的所有产出(PRD/原型/任务/规格)聚合在 REQ-ID 容器,
+/wl-req 一条命令看到全貌, 不用跨目录翻。
+
+设计 (PM 只需记 2 个姿势):
+    /wl-req                    列出所有需求 (默认=list, 不用记)
+    /wl-req REQ-2026-001       显示该需求全部产出 (show)
+    /wl-req REQ-2026-001 发布  promote+publish一步到位 (草稿→产出→禅道)
+
+promote 不单独暴露(合并进"发布"), list 不用记(无参数即是)。
+
+用法:
+    python req.py                           # 列需求
+    python req.py REQ-2026-001              # 看某需求全貌
+    python req.py REQ-2026-001 发布         # 发布(promote+publish)
+    python req.py REQ-2026-001 promote      # 仅草稿→产出(内部用)
+"""
+# v3.0 路径自举
+import os as _o, sys as _s
+_cp = _o.path.join(_o.path.dirname(_o.path.dirname(_o.path.abspath(__file__))), 'common')
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
+import os
+import sys
+from pathlib import Path
+from common.paths import (
+    get_repo_root, get_developer, MEMBERS_DIR,
+    get_time_bucket, get_time_bucket_path, get_req_dir,
+    get_outputs_dir, find_req_dirs,
+)
+
+BASE = get_repo_root()
+
+
+def _list_all_reqs(dev=None):
+    """列出某开发者的所有需求 (跨 drafts/outputs/所有时间桶)。
+
+    Returns:
+        [{req_id, area, bucket, path, files: [文件名]}, ...]
+    """
+    dev = dev or get_developer(BASE) or "unknown"
+    dev_dir = MEMBERS_DIR / dev
+    if not dev_dir.is_dir():
+        return []
+    seen = {}  # req_id → entry (去重, drafts优先)
+    for area in ("drafts", "outputs"):
+        area_root = dev_dir / area
+        if not area_root.is_dir():
+            continue
+        # 扫所有 REQ-* 目录 (跨时间桶)
+        for found in area_root.rglob("REQ-*"):
+            if not found.is_dir():
+                continue
+            req_id = found.name
+            # 清理标题后缀只取 REQ-YYYY-NNN (但保留完整名做显示)
+            import re
+            m = re.match(r"(REQ-\d{4}-\d{3,})", req_id)
+            clean_id = m.group(1) if m else req_id
+            if clean_id in seen:
+                # 已有, 但如果当前是outputs且已有的是drafts, 补充信息
+                continue
+            files = sorted(f.name for f in found.iterdir() if f.is_file())
+            subdirs = sorted(d.name for d in found.iterdir() if d.is_dir())
+            rel_bucket = str(found.parent.relative_to(area_root))
+            seen[clean_id] = {
+                "req_id": req_id,
+                "clean_id": clean_id,
+                "area": area,
+                "bucket": rel_bucket,
+                "path": found,
+                "files": files,
+                "subdirs": subdirs,
+            }
+    return list(seen.values())
+
+
+def cmd_list(dev=None):
+    """列出所有需求。"""
+    reqs = _list_all_reqs(dev)
+    if not reqs:
+        dev_name = dev or get_developer(BASE) or "unknown"
+        print("暂无需求。写 PRD 时会自动创建 REQ-ID 容器。")
+        print("  开发者: %s" % dev_name)
+        return 0
+    print("=" * 56)
+    print("需求列表 (%d 个)" % len(reqs))
+    print("=" * 56)
+    for r in sorted(reqs, key=lambda x: x["clean_id"]):
+        area_tag = "草稿" if r["area"] == "drafts" else "产出"
+        n_files = len(r["files"]) + len(r["subdirs"])
+        print("  %s  [%s] %s  (%d 项)" % (r["clean_id"], area_tag, r["bucket"], n_files))
+    print()
+    print("看详情: /wl-req <REQ-ID>")
+    return 0
+
+
+def cmd_show(req_id, dev=None):
+    """显示某需求的全部产出 (跨 drafts/outputs/历史桶)。"""
+    found = find_req_dirs(req_id, dev, BASE)
+    if not found:
+        print("未找到需求: %s" % req_id)
+        print("  用 /wl-req 看所有需求列表")
+        return 1
+    print("=" * 56)
+    print("需求: %s" % req_id)
+    print("=" * 56)
+    for entry in found:
+        area_cn = "草稿" if entry["area"] == "drafts" else "产出"
+        p = entry["path"]
+        print()
+        print("【%s · %s】" % (area_cn, entry["bucket"]))
+        print("  路径: %s" % p)
+        # 列文件
+        files = sorted(f.name for f in p.iterdir() if f.is_file())
+        subdirs = sorted(d.name for d in p.iterdir() if d.is_dir())
+        if files:
+            print("  文件:")
+            for f in files:
+                print("    - %s" % f)
+        if subdirs:
+            print("  子目录:")
+            for d in subdirs:
+                # 列子目录里的文件数
+                sub_path = p / d
+                n = sum(1 for _ in sub_path.rglob("*") if _.is_file())
+                print("    - %s/ (%d 个文件)" % (d, n))
+    return 0
+
+
+def cmd_promote(req_id, dev=None):
+    """草稿 → 产出 (drafts/桶/REQ → outputs/同桶/REQ)。"""
+    dev = dev or get_developer(BASE) or "unknown"
+    # 找 drafts 里的
+    draft_found = [e for e in find_req_dirs(req_id, dev, BASE) if e["area"] == "drafts"]
+    if not draft_found:
+        print("草稿区未找到: %s (可能已在产出区, 或不存在)" % req_id)
+        return 1
+    src = draft_found[0]["path"]
+    bucket = draft_found[0]["bucket"]
+    # 目标: outputs/同桶/REQ
+    dev_dir = MEMBERS_DIR / dev
+    dst = dev_dir / "outputs" / bucket / src.name
+    if dst.exists():
+        print("产出区已存在: %s" % dst)
+        print("  如要覆盖, 先手动删除产出区的旧版本")
+        return 1
+    import shutil
+    dst.parent.mkdir(parents=True, exist_ok=True)
+    shutil.move(str(src), str(dst))
+    print("✓ 已提升到产出区:")
+    print("  %s" % dst)
+    print("  (产出进 team_sync, 团队可见)")
+    return 0
+
+
+def cmd_publish(req_id, dev=None):
+    """发布 = promote + 发禅道。PM 只用这个。"""
+    dev = dev or get_developer(BASE) or "unknown"
+    # 先确保在 outputs (不在则 promote)
+    out_found = [e for e in find_req_dirs(req_id, dev, BASE) if e["area"] == "outputs"]
+    if not out_found:
+        print("草稿 → 产出...")
+        rc = cmd_promote(req_id, dev)
+        if rc != 0:
+            return rc
+        out_found = [e for e in find_req_dirs(req_id, dev, BASE) if e["area"] == "outputs"]
+    if not out_found:
+        print("✗ 发布失败: 产出区找不到 %s" % req_id)
+        return 1
+    out_path = out_found[0]["path"]
+    print()
+    print("发禅道 (从产出区: %s)" % out_path)
+    print("-" * 40)
+    # 找禅道 MCP 创建需求
+    try:
+        sys.path.insert(0, str(BASE / ".qoder" / "scripts" / "mcp"))
+        # 禅道发布: 读 PRD, 调 zentao MCP 建 story
+        prd_file = None
+        for f in out_path.iterdir():
+            if f.is_file() and (f.name.endswith(".md") and "prd" in f.name.lower()):
+                prd_file = f
+                break
+            if f.is_file() and f.suffix == ".md" and not f.name.startswith("_"):
+                prd_file = f  # 第一个 md 当 PRD
+        if prd_file:
+            print("  PRD: %s" % prd_file.name)
+        print()
+        print("⚠️ 禅道发布需要 QoderWork 的禅道 MCP (mcp__qoder-zentao__create_story)。")
+        print("   AI 会读产出的 PRD, 调禅道建需求。")
+        print("   如果你在 QoderWork 里说'%s 发布', AI 会自动完成这步。" % req_id)
+        return 0
+    except Exception as e:
+        print("✗ 发布出错: %s" % e)
+        return 1
+
+
+def main():
+    args = sys.argv[1:]
+    if not args:
+        return cmd_list()
+    req_id = args[0]
+    action = args[1] if len(args) > 1 else "show"
+    if action == "show":
+        return cmd_show(req_id)
+    elif action in ("发布", "publish", "fabu"):
+        return cmd_publish(req_id)
+    elif action == "promote":
+        return cmd_promote(req_id)
+    elif action == "list":
+        return cmd_list()
+    else:
+        # 默认当 show
+        return cmd_show(req_id)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/templates/qoder/scripts/report/role.py

@@ -0,0 +1,33 @@
+# v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
+import os as _o, sys as _s
+_cp = _o.path.join(_o.path.dirname(_o.path.dirname(_o.path.abspath(__file__))), 'common')
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
+# role.py - 角色解析 (v3.0: 已并入 common/identity.py, 本文件为兼容转发层)
+#
+# 角色能力查询 (get_role/can_produce/can_consume/...) 已统一到 common/identity.py,
+# 由 guard.py 强制执行角色边界。本文件保留是为了:
+#   1. CLI 兼容: skill 脚本里 `ROLE=$(python role.py)` 仍能输出角色名
+#   2. import 兼容: `from role import get_role` 仍可用 (转发到 identity)
+#
+# ⚠️ 新代码请直接用: from common.identity import get_role / from common.guard import ...
+#    本文件未来随 M2 引擎重构可能移除。
+import os
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from common.identity import get_role, get_permissions, get_capabilities, can_produce, can_consume  # noqa: E402,F401
+
+BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+
+if __name__ == '__main__':
+    # CLI: 输出当前角色名 (供 skill 脚本动态读角色用)
+    # 用法: ROLE=$(python role.py)
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+    except (AttributeError, IOError):
+        pass
+    r = get_role()
+    print(r or 'pm')  # 无角色默认 pm (软引导, 不报错)