asia-aidlc 1.14.0 → 1.14.1

package/.aidlc-engine/cli/flow.py

@@ -5,10 +5,14 @@
 子命令:
   init      从 example 生成 workflow-state.json 骨架 + 按目录规约创建仓库脚手架
             （产物目录 / 根级登记册 / .gitignore 合并，全部幂等；不动 openspec/ 与 .ai-sdd/）
-            + Trae 接入：.trae/mcp.json 合并、斜杠命令同步、11 个 Skill 复制到
+            + Trae 接入：.trae/mcp.json 合并、斜杠命令同步、14 个 Skill 复制到
             .trae/skills（--skills-dir 可改目标，--no-skills 跳过；脚本兼容复制安装）
             + --git-hooks：安装 git 钩子，pull/切分支/commit 后自动重建 viewer 视图
             + --sync-skills：维护模式，只补装缺失的 Skill（已初始化的仓库也能跑）
+            **收尾会问「是否配置团队成员」**（TTY 交互；它决定门控审批人校验、视图「配置负责人」
+            列、日历按人筛选）。非 TTY / --no-input 下不提问，改为打印 [next] 待办清单——
+            Agent 据此在对话里问用户。一行带全：--team "张敏:产品负责人,…" --admin 张敏
+            （按角色自动推断阶段归属并跑一次 validate；未配完只报 [info]，不影响退出码）
   hooks     安装/查看/卸载 git 钩子（install / status / uninstall）——让 .aidlc-engine/viewer/
             的派生视图保持最新：钩子只跑 `render.py --if-stale`（新鲜即跳过、不阻断 git）；
             自己的钩子可重复安装，他人同名钩子一律不覆盖
@@ -138,6 +142,21 @@ def _repo_root_from_state(state):
 VIEW_OUT_NAME = {"calendar": "calendar.html", "console": "workflow-view.html", "trace": "trace.html"}
 _RENDER_MOD = None          # None=未尝试 / False=加载失败 / module=已加载
 _RENDER_NOTE = {}           # 最近一次自动重建的结果，供 CLI/MCP 回给用户
+_PENDING_SETUP = {}         # init 的交互式收尾（团队/钩子）：由 main() 在汇总打印之后执行
+
+
+def _exec_no_pycache(spec, mod):
+    """执行模块但**不写 __pycache__**。
+
+    引擎脚本是"源码"而非依赖：在 .aidlc-engine/ 下留 .pyc 会污染仓库，
+    而且会被 _install_skills 连带复制进 .trae/skills/。
+    """
+    prev = sys.dont_write_bytecode
+    sys.dont_write_bytecode = True
+    try:
+        spec.loader.exec_module(mod)
+    finally:
+        sys.dont_write_bytecode = prev
 
 
 def _load_render(system=None):
@@ -153,7 +172,7 @@ def _load_render(system=None):
         import importlib.util
         spec = importlib.util.spec_from_file_location("aidlc_viewer_render", cand)
         mod = importlib.util.module_from_spec(spec)
-        spec.loader.exec_module(mod)
+        _exec_no_pycache(spec, mod)
         _RENDER_MOD = mod
     except Exception as exc:  # fail-open：渲染器坏了也不能拖垮 flow
         LOG.warning("加载 viewer/render.py 失败：%s", exc)
@@ -332,8 +351,241 @@ GITIGNORE_ENTRIES = ["aidlc-data/traceability-matrix.md", "*.tmp", "aidlc-data/g
                      "aidlc-data/trace.html", "aidlc-data/req/"]
 
 
+# ---------------- 团队配置（team-init 的**进程内**调用，同 _load_render 的理由） ----------------
+# Pyodide（npm 包）下没有子进程，进程内 import 才两边都能用；team.json 与状态文件同目录。
+_TEAM_MOD = None
+
+
+def _load_team_init(system=None):
+    """惰性加载 <system>/skills/team-init/scripts/init_owners.py；失败返回 None。"""
+    global _TEAM_MOD
+    if _TEAM_MOD is not None:
+        return _TEAM_MOD or None
+    cand = os.path.join(os.path.abspath(system or DEFAULT_SYSTEM),
+                        "skills", "team-init", "scripts", "init_owners.py")
+    if not os.path.exists(cand):
+        _TEAM_MOD = False
+        return None
+    try:
+        import importlib.util
+        spec = importlib.util.spec_from_file_location("aidlc_team_init", cand)
+        mod = importlib.util.module_from_spec(spec)
+        _exec_no_pycache(spec, mod)
+        _TEAM_MOD = mod
+    except Exception as exc:                      # fail-open
+        LOG.warning("加载 team-init 失败：%s", exc)
+        _TEAM_MOD = False
+        return None
+    return _TEAM_MOD
+
+
+def team_path_of(state):
+    return os.path.join(os.path.dirname(os.path.abspath(state)), "team.json")
+
+
+def team_configured(state):
+    """team.json 是否存在且至少配了一个阶段负责人。"""
+    p = team_path_of(state)
+    if not os.path.exists(p):
+        return False
+    try:
+        with open(p, encoding="utf-8") as f:
+            team = json.load(f)
+    except (OSError, ValueError):
+        return False
+    return any((n.get("owner") or "").strip() for n in (team.get("nodes") or []))
+
+
+def run_team_init(system, argv_list):
+    """跑一次 team-init 子命令（进程内、捕获 stdout+stderr）。返回 (ok, 输出文本)。"""
+    mod = _load_team_init(system)
+    if mod is None:
+        return False, "找不到 skills/team-init/scripts/init_owners.py"
+    import io
+    buf, real_out, real_err = io.StringIO(), sys.stdout, sys.stderr
+    try:
+        sys.stdout = sys.stderr = buf
+        try:
+            rc = mod.main(list(argv_list))
+        except SystemExit as exc:
+            rc = exc.code if isinstance(exc.code, int) else 0
+    except Exception as exc:
+        return False, "team-init 执行失败：%s" % exc
+    finally:
+        sys.stdout, sys.stderr = real_out, real_err
+    text = buf.getvalue().strip()
+    return (not isinstance(rc, int)) or rc == 0, text
+
+
+ROLE_NODE_HINT = (
+    ("产品", ("N0", "N1")), ("需求", ("N0", "N1")), ("项目", ("N0", "N1")),
+    ("技术", ("N2",)), ("架构", ("N2", "N3")),
+    ("研发", ("N3",)), ("开发", ("N3",)),
+    ("测试", ("N4",)), ("qa", ("N4",)), ("质量", ("N4",)),
+    ("交付", ("N5",)), ("发布", ("N5",)), ("运维", ("N5",)),
+)
+NODE_LABEL = (("N0", "任务受理"), ("N1", "需求生成"), ("N2", "方案生成"),
+              ("N3", "代码生成"), ("N4", "测试执行"), ("N5", "交付发布"))
+
+
+def parse_members(text):
+    """把「张敏:产品负责人 / 李强:技术负责人 / 王磊」解析成 [(名字, 角色)]；换行与逗号都当分隔。"""
+    items = []
+    for chunk in re.split(r"[\n,，;；]+", text or ""):
+        chunk = chunk.strip()
+        if not chunk:
+            continue
+        name, _, role = chunk.partition(":")
+        if not role:
+            name, _, role = chunk.partition("：")
+        name, role = name.strip(), role.strip()
+        if name:
+            items.append((name, role))
+    return items
+
+
+def suggest_owners(members):
+    """按角色名猜阶段归属（只作**默认值**给用户确认，不静默落盘）。"""
+    owners = {}
+    for name, role in members:
+        low = (role or "").lower()
+        for kw, nodes in ROLE_NODE_HINT:
+            if kw in role or kw in low:
+                for nid in nodes:
+                    owners.setdefault(nid, name)
+                break
+    return owners
+
+
+def _ask(prompt, default=""):
+    """读一行输入；非 TTY / EOF / Ctrl-C 一律回落到默认值（绝不因提问把 init 弄挂）。"""
+    try:
+        shown = (" [%s]" % default) if default else ""
+        line = input("%s%s: " % (prompt, shown))
+    except (EOFError, KeyboardInterrupt, OSError):
+        print()
+        return default
+    return line.strip() or default
+
+
+def setup_team_wizard(system, state):
+    """交互式配团队（最简版：单负责人）。返回要打印的文本。
+
+    **由 main() 在 init 汇总打印之后调用**——否则提问会插在汇总前面，看起来很乱。
+    """
+    data_root = os.path.dirname(os.path.abspath(state))
+    tpath = team_path_of(state)
+    try:
+        project = (read_state(state).get("meta") or {}).get("project") or ""
+    except Exception:
+        project = ""
+    project = project or os.path.basename(os.path.dirname(data_root)) or "未命名项目"
+
+    print("\n" + "─" * 8 + " 下一步：配置团队成员 " + "─" * 8)
+    print("  它决定：门控审批人校验、视图里的「配置负责人」、日历按人筛选。")
+    print("  [1] 现在配（约 30 秒）   [2] 先跳过（随时可配：flow init --team \"张敏:产品负责人\")")
+    if _ask("选择", "1") not in ("1", "y", "Y", "yes", ""):
+        return "  已跳过。之后可用：flow init --team \"张敏:产品负责人,…\" --admin 张敏"
+
+    proj = _ask("项目名", project)
+    admin = _ask("管理员 / 产品负责人（填入 N0/N1 与 req_review）", "")
+    print("团队名单（每行一条，格式 名字:角色；空行结束）")
+    roster = []
+    while True:
+        try:
+            ln = input("  > ").strip()
+        except (EOFError, KeyboardInterrupt, OSError):
+            print()
+            break
+        if not ln:
+            break
+        roster += parse_members(ln)
+    if admin and all(n != admin for n, _ in roster):
+        roster.insert(0, (admin, "项目管理员"))
+    if not roster:
+        return "  名单为空，已跳过。随时可配：flow init --team \"张敏:产品负责人\" --admin 张敏"
+
+    sug = suggest_owners(roster)
+    print("六个阶段分别归谁？（格式 N0=张敏,N1=张敏,…；回车用下面的建议值；留空 = 暂不指定）")
+    for nid, label in NODE_LABEL:
+        print("    %s %-6s → %s" % (nid, label, sug.get(nid) or "（待定）"))
+    mapping = _ask("阶段归属", ",".join("%s=%s" % (nid, sug.get(nid, "")) for nid, _ in NODE_LABEL))
+
+    base = ["--file", tpath, "--state", os.path.abspath(state)]
+    init_argv = base + (["--project", proj] if proj else [])
+    outs = []
+    if not os.path.exists(tpath):
+        ok, t = run_team_init(system, ["init"] + init_argv +
+                              (["--admin", admin] if admin else ["--force"]))
+        outs.append(t)
+        if not ok:
+            return "\n".join(outs + ["  [warn] 初始化 team.json 失败，可重试：flow init --team \"…\""])
+    args = ["add-members"] + base
+    for name, role in roster:
+        args += ["--member", ("%s:%s" % (name, role)) if role else name]
+    ok, t = run_team_init(system, args)
+    outs.append(t)
+    if not ok:
+        return "\n".join(outs + ["  [warn] 写入成员失败，已保留已写入的部分"])
+    pairs = [p.strip() for p in mapping.split(",") if "=" in p and p.split("=", 1)[1].strip()]
+    if pairs:
+        ok, t = run_team_init(system, ["apply"] + base + sum([["--pair", p] for p in pairs], []))
+        outs.append(t)
+    okv, tv = run_team_init(system, ["validate"] + base)
+    outs.append("  项目：%s ｜ 管理员：%s ｜ 成员：%s" %
+                (proj, admin or "（未指定）", "、".join(n for n, _ in roster)))
+    outs += _team_report(tv)
+    outs.append("  随时可改：flow init --team \"…\" ／ 直接编辑 aidlc-data/team.json")
+    return "\n".join(outs)
+
+
+def _team_report(validate_text):
+    """把 team-init validate 的结果整理成「硬问题 / 待补 / 通过」，并给出可执行的补救命令。
+
+    注意：**不要把 validate 的原始 [FAIL] 行直接拼进 init 的输出**——init 本身是成功的，
+    带着 [FAIL] 会让 `flow init` 退出码变成 1，CI 与 Agent 的错误处理都会被误触发。
+    """
+    problems = [ln.strip()[2:].strip() for ln in (validate_text or "").splitlines()
+                if ln.strip().startswith("- ")]
+    hard = [p for p in problems if ("DUTY_CONFLICT" in p or "不在成员名单" in p)]
+    todo = [p for p in problems if p not in hard]
+    lines = []
+    if hard:
+        lines.append("[warn] 团队配置有硬问题（必须修）：")
+        lines += ["         - %s" % p for p in hard]
+    if todo:
+        lines.append("[info] 还有 %d 项待补（不影响现在继续用）：" % len(todo))
+        lines += ["         - %s" % p for p in todo]
+        if any("代码评审" in p or "code_review" in p for p in todo):
+            lines.append("         代码评审需要**独立于 N3 负责人**的评审人（作者≠评审人），例如：")
+            lines.append("         aidlc skill team-init set --gate code_review --approver <独立的人>")
+        if any("未配置负责人" in p for p in todo):
+            lines.append("         补齐阶段负责人：flow init --team \"名字:角色,…\""
+                         "（或直接编辑 aidlc-data/team.json）")
+    if not hard and not todo:
+        lines.append("[ok] 团队配置校验通过")
+    return lines
+
+
+def next_steps_block(state, team_done=False, hooks_done=False):
+    """init 之后的待办清单：人类可读、Agent 可解析（`[next] key=value`）。"""
+    lines = []
+    if not team_done and not team_configured(state):
+        lines += [
+            "[next] step=team 状态=未配置 影响=门控审批人校验/视图「配置负责人」列/日历按人筛选",
+            "[next] step=team 一条命令配好=flow init --team \"张敏:产品负责人,李强:技术负责人\" --admin 张敏",
+            "[next] step=team 跳过=回答「先跳过」即可（不影响 init 结果；随时可再配）",
+        ]
+    if not hooks_done:
+        lines.append("[next] step=hooks 状态=未安装 影响=commit/切分支后视图不自动重建 "
+                     "cmd=\"flow init --git-hooks\"")
+    if lines:
+        lines.append("[next] step=view cmd=\"flow view\"（渲染日历 + 每个需求一个文件，并给出可点开的路径）")
+    return "\n".join(lines)
+
+
 def do_init(system, state, skills_dir=".trae/skills", no_skills=False, empty=False, git_hooks=False,
-            sync_skills=False):
+            sync_skills=False, team="", admin="", no_input=False):
     src = os.path.join(STATE_DIR, "workflow-state.example.json")
     # 钩子装到状态文件所在仓库（脚本自身会 git rev-parse 定位仓库根，传目录即可）
     hook_start = os.path.dirname(os.path.abspath(state)) or os.getcwd()
@@ -390,6 +642,52 @@ def do_init(system, state, skills_dir=".trae/skills", no_skills=False, empty=Fal
         out += "\n" + dep
     if hint:
         out += hint
+
+    # ---- 收尾：团队 + 下一步（让「init 完不知道该干嘛」这件事消失）----
+    global _PENDING_SETUP
+    team_done = team_configured(state)
+    if team.strip():                       # 一行带全：调用方已知道答案（Agent / 脚本）
+        proj = ""
+        try:
+            proj = (data.get("meta") or {}).get("project") or ""
+        except Exception:
+            proj = ""
+        base = ["--file", team_path_of(state), "--state", os.path.abspath(state)]
+        init_argv = base + (["--project", proj] if proj else [])
+        members = parse_members(team)
+        if not team_done:
+            run_team_init(system, ["init"] + init_argv + (["--admin", admin] if admin else ["--force"]))
+        args2 = ["add-members"] + base
+        for name, role in members:
+            args2 += ["--member", ("%s:%s" % (name, role)) if role else name]
+        ok1, t2 = run_team_init(system, args2)
+        sug = suggest_owners(members)
+        pairs = [["--pair", "%s=%s" % (nid, sug[nid])] for nid, _ in NODE_LABEL if sug.get(nid)]
+        ok2, t3 = (run_team_init(system, ["apply"] + base + sum(pairs, [])) if pairs else (True, ""))
+        okv, t4 = run_team_init(system, ["validate"] + base)
+        out += "\n" + "\n".join(x for x in (t2, t3) if x)
+        out += "\n" + "\n".join(_team_report(t4))
+        if pairs:
+            out += "\n    阶段归属按角色推断：" + "、".join(
+                "%s=%s" % (p[1].split("=")[0], p[1].split("=")[1]) for p in pairs)
+        team_done = team_configured(state)
+        if admin:
+            out += "\nOK: 管理员 %s 已填入 N0/N1 与 req_review" % admin
+        if not (ok1 and ok2):
+            out += "\n[warn] 写入成员/阶段归属未成功，可重试：flow init --team \"…\" --admin <名字>"
+    elif not team_done and not no_input and sys.stdin.isatty():
+        # 提问放在 main() 打印完汇总之后（否则提示会插在 OK 行前面）
+        _PENDING_SETUP = {"system": system, "state": state}
+
+    if not git_hooks and not no_input and sys.stdin.isatty() and not team.strip():
+        _PENDING_SETUP.setdefault("hooks_dir", hook_start)
+    elif not git_hooks:
+        pass
+
+    blk = next_steps_block(state, team_done=team_done or bool(team.strip()),
+                           hooks_done=git_hooks or bool(_PENDING_SETUP.get("hooks_dir")))
+    if blk:
+        out += "\n\n下一步：\n" + blk
     return out
 
 
@@ -568,7 +866,7 @@ def _install_skills(system, root, target_rel=".trae/skills"):
         if os.path.exists(dst):
             skipped.append(name)
             continue
-        shutil.copytree(src, dst)
+        shutil.copytree(src, dst, ignore=shutil.ignore_patterns("__pycache__", "*.pyc", "*.pyo"))
         copied.append(name)
     msg = "技能 %d 个 → %s（%s）" % (len(copied), target_rel, ",".join(copied) or "无新增")
     if skipped:
@@ -1703,7 +2001,7 @@ def main():
     ap = argparse.ArgumentParser(prog="flow", description="OpenSpec+AI-DLC 研发流程统一 CLI")
     sub = ap.add_subparsers(dest="cmd", required=True)
 
-    p = sub.add_parser("init", help="生成 workflow-state.json 骨架 + 仓库目录脚手架 + Trae 接入件/技能安装")
+    p = sub.add_parser("init", help="初始化：状态骨架 + 脚手架 + Trae 接入件/技能；结束时会询问是否配团队")
     p.add_argument("--state", default=DEFAULT_STATE)
     p.add_argument("--system", default=DEFAULT_SYSTEM, help=".aidlc-engine 引擎目录（含 skills/ 与 state/）")
     p.add_argument("--skills-dir", default=".trae/skills",
@@ -1716,6 +2014,12 @@ def main():
     p.add_argument("--sync-skills", dest="sync_skills", action="store_true",
                    help="只补装缺失的 Skill 到 --skills-dir（已初始化的仓库也能跑；"
                         "新增 Skill 后用它在 .trae/skills 落地，不动状态与脚手架）")
+    p.add_argument("--team", default="",
+                   help="一行配好团队：\"张敏:产品负责人,李强:技术负责人\"（逗号/换行分隔；"
+                        "按角色自动猜阶段归属，配完跑一次 validate）")
+    p.add_argument("--admin", default="", help="项目管理员（填入 N0/N1 负责人与 req_review 审批人）")
+    p.add_argument("--no-input", dest="no_input", action="store_true",
+                   help="不提问（CI/无头环境；只打印 [next] 待办清单，不读 stdin）")
 
     p = sub.add_parser("hooks", help="git 钩子：让 .aidlc-engine/viewer/ 派生视图保持实时")
     hsub = p.add_subparsers(dest="hooks_cmd", required=True)
@@ -1863,7 +2167,8 @@ def main():
 
     dispatch = {
         "init": lambda: do_init(system, a.state, a.skills_dir, a.no_skills, a.empty, a.git_hooks,
-                                a.sync_skills),
+                                a.sync_skills, getattr(a, "team", ""), getattr(a, "admin", ""),
+                                getattr(a, "no_input", False)),
         "hooks install": lambda: install_viewer_hooks(os.getcwd()),
         "hooks status": lambda: viewer_hooks_status(os.getcwd()),
         "hooks uninstall": lambda: uninstall_viewer_hooks(os.getcwd()),
@@ -1902,6 +2207,30 @@ def main():
         if note:
             out = (out.rstrip() + "\n\n" + note) if out else note
     print(out)
+
+    # init 的交互式收尾放在汇总之后：否则提问会插在 OK 行前面，读起来是乱的
+    global _PENDING_SETUP
+    if _PENDING_SETUP.get("system"):
+        st = _PENDING_SETUP.get("state")
+        try:
+            print(setup_team_wizard(_PENDING_SETUP["system"], st))
+        except (EOFError, KeyboardInterrupt):
+            print("\n  已取消。随时可配：flow init --team \"张敏:产品负责人\" --admin 张敏")
+        except Exception as exc:                      # 向导失败绝不拖垮 init
+            LOG.warning("配团队向导失败：%s", exc)
+            print("  [warn] 交互式配置团队失败（%s）；可改用："
+                  "flow init --team \"张敏:产品负责人\" --admin 张敏" % exc)
+        else:
+            _auto_render(st)                          # 团队变了，让视图跟上
+            extra = view_note()
+            if extra:
+                print("\n" + extra)
+    if _PENDING_SETUP.get("hooks_dir"):
+        if _ask("是否安装 git 钩子（commit/切分支后自动重建视图）", "y").lower() in ("y", "yes", "1"):
+            print("OK: " + install_viewer_hooks(_PENDING_SETUP["hooks_dir"]))
+        else:
+            print("  已跳过。之后可装：flow init --git-hooks ／ flow hooks install")
+    _PENDING_SETUP = {}
     # 进程退出码反映判定结果（供 shell/CI 消费）：失败标记 → 1
     fail_markers = (
         "[FAIL]", "[REJECT]", "[ERROR]", "Traceback",

package/.aidlc-engine/cli/flow_mcp.py

@@ -40,11 +40,17 @@ DEFAULT_STATE = None  # 由调用方 arguments 传 state，缺省用 cwd
 def resolve_state(arg):
     if arg and os.path.exists(arg):
         return arg
-    # 两目录布局优先：cwd/aidlc-data/workflow-state.json → 回退旧布局 cwd/workflow-state.json
+    # 两目录布局优先：cwd/aidlc-data/workflow-state.json
     new = os.path.join(os.getcwd(), flow.DATA_DIR, "workflow-state.json")
     if os.path.exists(new):
         return new
-    return os.path.join(os.getcwd(), "workflow-state.json")
+    # 旧布局（根目录平铺）**只在真的存在时**才用；否则一律走两目录布局——
+    # 否则全新项目里 flow_init 会把 workflow-state.json / team.json 建到仓库根，
+    # 与 `flow init` 的缺省路径（aidlc-data/）不一致。
+    legacy = os.path.join(os.getcwd(), "workflow-state.json")
+    if os.path.exists(legacy):
+        return legacy
+    return new
 
 
 TOOLS = [
@@ -81,10 +87,17 @@ TOOLS = [
       "required": ["actor", "action", "entity", "result"]}},
     {"name": "flow_matrix", "description": "渲染追溯矩阵（输出到状态文件同目录 traceability-matrix.md）",
      "inputSchema": {"type": "object", "properties": {"state": {"type": "string"}}}},
-    {"name": "flow_init", "description": "初始化 workflow-state.json + 仓库脚手架 + Trae 接入件/技能/编排规则安装",
+    {"name": "flow_init", "description": "初始化 workflow-state.json + 仓库脚手架 + Trae 接入件/技能/编排规则安装。"
+     "【初始化后请主动问用户是否配置团队成员】——它决定门控审批人校验、视图里的「配置负责人」列、日历按人筛选。"
+     "用户给了名单就用 team=\"张敏:产品负责人,李强:技术负责人\" + admin 一步配好（会按角色自动推断阶段归属）；"
+     "用户说「先跳过」就直接不传（返回值里的 [next] 清单会说明后果与随时补配的命令），不要反复追问。"
+     "注意：本工具**不会**在返回前提问（MCP 无人机交互），提问由你在对话里完成。",
      "inputSchema": {"type": "object",
       "properties": {"state": {"type": "string"},
-                     "empty": {"type": "boolean", "description": "空白初始化：清空示例实体，仅保留骨架"}}}},
+                     "empty": {"type": "boolean", "description": "空白初始化：清空示例实体，仅保留骨架"},
+                     "team": {"type": "string",
+                              "description": "团队成员名单，格式 \"名字:角色,名字:角色\"（用户确认后传入；不传则只输出待办）"},
+                     "admin": {"type": "string", "description": "项目管理员（填入 N0/N1 负责人与 req_review 审批人）"}}}},
     {"name": "flow_branch_create", "description": "建执行分支 feature/chg-<NNN> + 登记 base_commit/owned + 审计 branch.create（分支做容器，状态推进仍走 transition）",
      "inputSchema": {"type": "object",
       "properties": {"chg": {"type": "string", "description": "change 编号，如 CHG-003"},
@@ -147,7 +160,9 @@ HANDLERS = {
                                           a["actor"], a["action"], a["entity"], a["result"], a.get("detail", "")),
     "flow_matrix": lambda a: flow.do_matrix(DEFAULT_SYSTEM, resolve_state(a.get("state"))),
     "flow_init": lambda a: flow.do_init(DEFAULT_SYSTEM, resolve_state(a.get("state")),
-                                        empty=bool(a.get("empty"))),
+                                        empty=bool(a.get("empty")),
+                                        team=a.get("team", ""), admin=a.get("admin", ""),
+                                        no_input=True),
     "flow_branch_create": lambda a: flow.do_branch_create(DEFAULT_SYSTEM, resolve_state(a.get("state")),
                                                           a["chg"], a.get("actor", "编排Agent")),
     "flow_branch_merge": lambda a: flow.do_branch_merge(DEFAULT_SYSTEM, resolve_state(a.get("state")),

package/.aidlc-engine/docs/design.md

@@ -369,7 +369,7 @@ hook 一览（全部 fail-open：读盘失败放行，硬校验由 flow CLI 兜
 
 | 子命令 | 行为 | 审计 |
 |---|---|---|
-| `flow init` | 从 example 生成 workflow-state.json 骨架 + 仓库脚手架 + Trae 接入安装。`_scaffold`：按目录规约创建 10 个产物目录；`risk-register.md`/`dependency-map.md` 模板落仓库根；派生状态条目合并进 `.gitignore`（逐行去重）。`_install_trae`：`.aidlc-engine/cli/.trae/mcp.json` 合并到项目根 `.trae/`（保留既有 server；utf-8-sig 兼容 BOM；python 路径含空格自动改写绝对路径）、斜杠命令覆盖式同步。`_install_agent_rule`：编排 Agent 提示词写入 `.trae/rules/flow-orchestration.md`（alwaysApply，已存在跳过）。`_install_skills`：14 个 Skill 复制到 `.trae/skills/`（默认，`--skills-dir` 可改、`--no-skills` 跳过；已存在跳过）。`--empty` 空白初始化（清空示例实体）。init 检测 jsonschema 缺失并提示；flow.py/flow_mcp.py 启动时 reconfigure stdout/stderr 为 UTF-8（消除 GBK 乱码）。全部幂等；不创建 `openspec/` 与 `.ai-sdd/`（SDD 工作区层）。复制安装的脚本（verify/validate/append）以 `_resolve_state_dir()` 解析 state：`__file__` 上溯 → `FLOW_SYSTEM_DIR` 环境变量 → cwd 向上查找 `.aidlc-engine/state`。`--git-hooks` 顺带安装 viewer 钩子（见下）。**维护模式**：`--git-hooks` / `--sync-skills` 在状态文件已存在时不再 `[FAIL]` 退出，而是打印 `[skip] … 不覆盖（维护模式）` 并只执行所请求的安装动作（补钩子 / 补 Skill），供已初始化仓库补装新 Skill | 无 |
+| `flow init` | 从 example 生成 workflow-state.json 骨架 + 仓库脚手架 + Trae 接入安装。`_scaffold`：按目录规约创建 10 个产物目录；`risk-register.md`/`dependency-map.md` 模板落仓库根；派生状态条目合并进 `.gitignore`（逐行去重）。`_install_trae`：`.aidlc-engine/cli/.trae/mcp.json` 合并到项目根 `.trae/`（保留既有 server；utf-8-sig 兼容 BOM；python 路径含空格自动改写绝对路径）、斜杠命令覆盖式同步。`_install_agent_rule`：编排 Agent 提示词写入 `.trae/rules/flow-orchestration.md`（alwaysApply，已存在跳过）。`_install_skills`：14 个 Skill 复制到 `.trae/skills/`（默认，`--skills-dir` 可改、`--no-skills` 跳过；已存在跳过）。`--empty` 空白初始化（清空示例实体）。init 检测 jsonschema 缺失并提示；flow.py/flow_mcp.py 启动时 reconfigure stdout/stderr 为 UTF-8（消除 GBK 乱码）。全部幂等；不创建 `openspec/` 与 `.ai-sdd/`（SDD 工作区层）。复制安装的脚本（verify/validate/append）以 `_resolve_state_dir()` 解析 state：`__file__` 上溯 → `FLOW_SYSTEM_DIR` 环境变量 → cwd 向上查找 `.aidlc-engine/state`。`--git-hooks` 顺带安装 viewer 钩子（见下）。**收尾询问团队**：TTY 下问「是否配置团队成员」（`_PENDING_SETUP` 延后到 main() 打印完汇总再交互，避免提问插在 OK 行前面），走 `setup_team_wizard()` → 进程内调 team-init 的 `init/add-members/apply/validate`；非 TTY（Agent/CI/管道）或 `--no-input` **绝不读 stdin**，改为输出 `[next] step=…` 结构化待办，由编排 Agent 在对话里问用户。`--team "名字:角色,…" --admin X` 一行带全（按角色经 `ROLE_NODE_HINT` 推断阶段归属）。**汇报分级**：`_team_report()` 把 validate 结果分成「硬问题（DUTY_CONFLICT/不在成员名单）」与「待补（未配置负责人/审批人）」，后者只报 `[info]`——**不把 validate 的原始 `[FAIL]` 拼进 init 输出**，否则 init 明明成功也会被 `fail_markers` 判成退出码 1。`code_review` 需独立于 N3 负责人的评审人，init 猜不出来，故给出补救命令。**维护模式**：`--git-hooks` / `--sync-skills` 在状态文件已存在时不再 `[FAIL]` 退出，而是打印 `[skip] … 不覆盖（维护模式）` 并只执行所请求的安装动作（补钩子 / 补 Skill），供已初始化仓库补装新 Skill。`_install_skills` 复制时忽略 `__pycache__`/`*.pyc` | 无 |
 | `flow hooks install/status/uninstall` | **viewer 派生视图实时化**（`.aidlc-engine/viewer/README.md`「让视图保持最新」）：把 `render.py --if-stale` 挂到 `post-merge`/`post-checkout`/`post-commit`/`post-rewrite`，pull / 切分支 / commit / rebase 后自动重建视图。脚本为 POSIX sh（Git for Windows 自带 sh 执行），内容恒为 `_viewer_hook_script()` 生成并带 `aidlc-viewer-hook` 标记。契约：**幂等**（本工具的钩子覆盖更新，他人同名钩子一律跳过不覆盖）、**fail-open**（任何失败都放行 git，末尾恒 `exit 0`）、**新鲜即跳过**（`--if-stale`）、**无真相不渲染**（`aidlc-data/workflow-state.json` 缺失时不动作，避免 render.py 回退样例快照污染仓库）、`post-checkout` 仅 `$3=1` 分支切换触发；逃生开关 `AIDLC_SKIP_VIEWER_HOOK=1`、`AIDLC_VIEWER_FORCE=1`、追加参数 `AIDLC_VIEWER_HOOK_ARGS`。钩子目录尊重 `core.hooksPath`，`.git` 为文件（worktree/submodule）按 `gitdir:` 解析；git 不可用时向上查找 `.git` 降级 | 无 |
 | `flow status` | 输出需求看板/实体统计/覆盖率 | 无 |
 | `flow view` | **交付可视化视图的唯一入口**：`kind` ∈ calendar（默认，研发日历 + 每个需求一个文件）/ console / trace。渲染后输出**可点开的绝对路径**（+ 单需求文件目录），`--open` 用系统默认程序打开；**只产出静态 HTML，不起任何服务**（UI 状态存 URL hash，刷新/分享不丢筛选）。与 MCP `flow_render`、Skill `render-views` 同源（都走 `do_view()`）。**状态写盘后自动重建**：`write_state()` 末尾调 `render_views(if_stale=True)`（幂等 + fail-open + 静默），并在命令输出末尾附 `[视图]` 提示行；`AIDLC_RENDER=off` 关闭 | 无 |
@@ -406,7 +406,7 @@ MCP stdio Server（JSON-RPC 2.0），暴露 14 个工具供 Trae 调用：
 | `flow_compliance` | do_compliance |
 | `flow_audit` | do_audit |
 | `flow_matrix` | do_matrix |
-| `flow_init` | do_init |
+| `flow_init` | do_init。除 `empty` 外新增 **`team` / `admin`**：用户在对话里确认名单后一步配好（MCP 侧强制 `no_input=True`——**绝不在返回前提问**，提问由 Agent 在对话里完成；不传 `team` 则返回值带 `[next]` 待办清单，含「初始化后请主动问用户是否配团队」的触发指引）。`resolve_state` 两目录布局优先，旧布局**只在真的存在时才用**，避免全新项目把数据建到仓库根 |
 | `flow_branch_create` / `flow_branch_merge` / `flow_branch_discard` | do_branch_create/merge/discard |
 | `flow_req_create` | do_req_create |
 | `flow_e2e` | do_e2e |

package/.aidlc-engine/skills/team-init/SKILL.md

@@ -11,11 +11,16 @@ description: 初始化与维护「六阶段节点负责人 + 四门控审批人
 
 | 场景 | 入口 |
 |---|---|
+| **`flow init` 收尾时被问到** | init 会主动问「是否配置团队成员」（TTY 交互；非 TTY 打印 `[next]` 待办让编排 Agent 在对话里问）。这时就是本 Skill 的活 |
 | 项目开工，一次把团队配好 | 对话："初始化团队，管理员张敏，方案李强，开发王磊，测试赵倩，发布陈昊" |
 | 中途换人 | 对话："把测试负责人改成赵倩" / "代码评审加上赵倩" |
 | 查看现状 | 对话："现在谁负责发布？" → `list` |
 | 开工前体检 | 对话："负责人配齐了吗？" → `validate` |
-| 无对话环境（CI / 脚本 / 手工） | 直接跑下面的 CLI |
+| 无对话环境（CI / 脚本 / 手工） | 直接跑下面的 CLI；Agent 已拿到名单时可用 `flow init --team "名字:角色,…" --admin X` 一步配好 |
+
+> **多人**：当前模型是**每个阶段一个负责人**（`nodes[].owner` 单值）；门控审批人已经是列表
+> （`--approver` 可多次）。多负责人（`owners` 列表）是规划中的改动，尚未实现——需要时先用
+> 门控审批人（可多人）表达"这条事多人参与"。
 
 ## 六个节点 / 四个门控（固定，来自 `directory-convention.md` 与 `agent-roles.md`）
 

package/.tmp-init-team-test.py

@@ -0,0 +1,119 @@
+# -*- coding: utf-8 -*-
+"""临时验证：init 的团队向导（打桩 input）+ 待办块 + MCP 入参。"""
+import builtins
+import importlib.util
+import io
+import json
+import os
+import sys
+import contextlib
+
+ROOT = os.path.abspath(os.path.dirname(os.path.abspath(__file__)))
+CLI = os.path.join(ROOT, ".aidlc-engine", "cli")
+sys.path.insert(0, CLI)
+
+
+def load(name, path):
+    spec = importlib.util.spec_from_file_location(name, path)
+    mod = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(mod)
+    return mod
+
+
+flow = load("flow_t", os.path.join(CLI, "flow.py"))
+fails = []
+
+
+def ck(name, cond, extra=""):
+    print(("  OK   " if cond else "  FAIL ") + name + ("" if cond else "  " + str(extra)))
+    if not cond:
+        fails.append(name)
+
+
+state = os.path.join(ROOT, ".tmp-wz", "aidlc-data", "workflow-state.json")
+os.makedirs(os.path.dirname(state), exist_ok=True)
+with open(state, "w", encoding="utf-8") as f:
+    json.dump({"meta": {"project": "订单中心", "updated_at": "2026-10-09T00:00:00+08:00",
+                        "owner": "张敏"}}, f, ensure_ascii=False)
+
+# ---- 1) 名单解析 + 角色推断 ----
+ck("parse_members 支持逗号/换行/中英文冒号",
+   flow.parse_members("张敏:产品负责人, 李强：技术负责人\n王磊") ==
+   [("张敏", "产品负责人"), ("李强", "技术负责人"), ("王磊", "")],
+   flow.parse_members("张敏:产品负责人, 李强：技术负责人\n王磊"))
+sug = flow.suggest_owners([("张敏", "产品负责人"), ("李强", "技术负责人"),
+                           ("王磊", "研发负责人"), ("赵倩", "QA负责人"), ("陈昊", "交付负责人")])
+ck("角色推断铺满六阶段", sorted(sug) == ["N0", "N1", "N2", "N3", "N4", "N5"], sug)
+ck("研发负责人 → N3", sug.get("N3") == "王磊", sug)
+
+# ---- 2) 打桩 input 跑向导 ----
+answers = iter(["1",            # 现在配
+                "订单中心",      # 项目名
+                "张敏",          # 管理员
+                "张敏:产品负责人", "李强:技术负责人", "王磊:研发负责人",
+                "赵倩:QA负责人", "陈昊:交付负责人", "",   # 名单 + 空行结束
+                ""])            # 阶段归属：回车用建议值
+asked = []
+
+
+def fake_input(prompt=""):
+    asked.append(prompt)
+    try:
+        return next(answers)
+    except StopIteration:
+        raise EOFError
+
+
+builtins.input = fake_input
+buf = io.StringIO()
+with contextlib.redirect_stdout(buf):
+    text = flow.setup_team_wizard(os.path.join(ROOT, ".aidlc-engine"), state)
+out = buf.getvalue()
+print("--- 向导输出 ---")
+print(out + "\n" + text)
+
+team_p = os.path.join(os.path.dirname(state), "team.json")
+team = json.load(open(team_p, encoding="utf-8")) if os.path.exists(team_p) else {}
+owners = {n["id"]: n.get("owner") for n in team.get("nodes", [])}
+ck("向导写出 team.json", os.path.exists(team_p))
+ck("六阶段负责人齐备", all(owners.get("N%d" % i) for i in range(6)), owners)
+ck("N3 = 王磊", owners.get("N3") == "王磊", owners)
+ck("成员 5 人", len(team.get("members", [])) == 5, [m["name"] for m in team.get("members", [])])
+ck("req_review 审批人随 N1 联动",
+   next((g["approvers"] for n in team["nodes"] if n["id"] == "N1" for g in n["gates"]
+         if g["type"] == "req_review"), None) == ["张敏"])
+ck("code_review 未被自动同步（职责分离例外）",
+   next((g["approvers"] for n in team["nodes"] if n["id"] == "N3" for g in n["gates"]
+         if g["type"] == "code_review"), None) == [], "应为空并要求另行指定")
+ck("向导给出了 code_review 的补救命令",
+   "code_review" in text and "set --gate code_review" in text, text[-300:])
+ck("向导问了「是否现在配」", any("选择" in a for a in asked), asked[:2])
+
+# ---- 3) 待办块 ----
+blk = flow.next_steps_block(state, team_done=True, hooks_done=False)
+ck("钩子未装 → [next] step=hooks", "step=hooks" in blk, blk)
+ck("团队已配 → 不再提 step=team", "step=team" not in blk, blk)
+# 用一份「还没有 team.json」的状态验证未配分支
+fresh = os.path.join(ROOT, ".tmp-wz2", "aidlc-data", "workflow-state.json")
+os.makedirs(os.path.dirname(fresh), exist_ok=True)
+with open(fresh, "w", encoding="utf-8") as f:
+    json.dump({"meta": {"project": "p"}}, f, ensure_ascii=False)
+blk2 = flow.next_steps_block(fresh, team_done=False, hooks_done=True)
+ck("团队未配 → [next] step=team 且含一行命令",
+   "step=team" in blk2 and "--team" in blk2, blk2)
+ck("已配置的仓库再跑 init 不重复唠叨",
+   "step=team" not in flow.next_steps_block(state, team_done=False, hooks_done=True))
+
+# ---- 4) MCP 入参 ----
+mcp = load("mcp_t", os.path.join(CLI, "flow_mcp.py"))
+tool = next(t for t in mcp.TOOLS if t["name"] == "flow_init")
+props = set(tool["inputSchema"]["properties"])
+ck("MCP flow_init 增加 team/admin", {"team", "admin"} <= props, props)
+ck("MCP flow_init description 要求主动问团队", "主动问" in tool["description"], "")
+import inspect
+src = inspect.getsource(mcp)
+ck("MCP 侧强制 no_input=True（不会在返回前提问）",
+   "no_input=True" in src, "")
+
+print("\n" + ("失败 %d 项" % len(fails) if fails else "INIT-TEAM TEST PASS"))
+sys.exit(1 if fails else 0)