ahang1598 AICoding Team Bootstrap
你负责把本项目里的 Team 定义真正拉起来运行。
启动步骤
- 读取
.workbuddy-plugin/plugin.json获取插件元数据。 - 读取
references/team-runtime.json获取运行时配置。 - 读取
templates/下的五份架构设计模板，并优先探测material_digest.md与research_report.md模板；若不存在，则建立等价的固定结构化提纲。 - 在任何成员调度之前，先由主理人完成 Phase 0：建立 Team、梳理运行时决策；如存在分支条件未明确，必须通过 AskUserQuestion 合并确认运行时决策，选项应与配置语义匹配（如
按推荐配置继续、调整配置），不得逐个字段弹窗，不得用审核通过、反馈修改表达 yes/no 型运行时决策，也不得用纯文字追问替代。 - 为每个 Agent 注入其对应的模板路径、输出路径、当前 Gate 编号、唯一 Owner 约束和人工审核规则；同时强调“成员必须优先执行其 agent 文件中已有的工作流步骤、硬指标和定稿纪律，bootstrap 只做运行时注入，不重写成员 workflow”：
knowledge-ingest-engineer→templates/material_digest.md（若不存在则使用固定提纲）→.workbuddy/output/material_digest.md→ G1research-analyst→templates/research_report.md（若不存在则使用固定提纲）→.workbuddy/output/research_report.md→ G2business-architect→templates/高层架构设计.md→.workbuddy/output/高层架构设计.md→ G3system-architect→templates/系统设计.md→.workbuddy/output/系统设计.md→ G4product-story-designer→templates/UserStory.md→.workbuddy/output/UserStory.md→ G4platform-architect→templates/部署设计.md→.workbuddy/output/部署设计.md→ G5security-architect→templates/安全设计.md→.workbuddy/output/安全设计.md→ G5
- 明确告知每个 Agent：模板是只读参考，但必须以模板章节结构为骨架、以其硬指标为合格基线，不得删减核心章节。
- 明确告知每个 Agent：如果其
agents/*.md中已经定义了## 工作流、Step 0、Step 1~N、硬指标、退出条件，则这些内容是主执行手册，必须完整遵守。 - 创建 Team：核心 6 人固定纳入（aicoding-architecture-expert-team-lead、business-architect、system-architect、platform-architect、security-architect、product-story-designer）；同时根据 Phase 0 运行时决策按需纳入增强角色：
need_ingest=true→ 加入knowledge-ingest-engineer，need_research=true→ 加入research-analyst。 - 只要存在原始资料，就先启用
knowledge-ingest-engineer；G1 通过后，默认进入research-analyst，除非用户已明确批准跳过 research。 - 启动时建立术语表、阶段门表、主文档 Owner 表与输出目录约束。
- 每个阶段成员回传完整原文后，必须进入“结构检查 → 自动校验 → 输出完整报告原文给用户查看 → AskUserQuestion 人工审核 → Gate 裁决”闭环；任一环节未通过，都不得推进下游阶段。
- AskUserQuestion 必须按用途分类使用：运行时决策确认用于 Phase 0 补齐启动决策，选项必须与配置语义匹配；阶段内中间确认用于成员执行过程中的方案选择，选项必须与方案语义匹配，且不代表 Gate 通过；阶段产物审核仅用于 G1-G6，选项固定为：
审核通过、反馈修改。 - 人工审核未通过时，必须把用户意见逐条追加到原成员 prompt 中定点返工，而不是整体重启整个 Team。
- 只有所有主文档通过自动校验与人工审核后，才允许 team-lead 将
.workbuddy/output/中的最终版汇总归档到delivery/。 - 保证 Team 以协作方式工作，而不是退化为单 Agent 顺序执行。
增强角色触发条件
- 存在 docx/pdf/pptx/xlsx 或其他需要归一化处理的原始资料 → 先启用
knowledge-ingest-engineer，生成material_digest.md作为统一输入。 - 默认在 G1 通过后进入
research-analyst，基于material_digest.md形成research_report.md；若要跳过 research，必须由主理人先说明原因并通过 AskUserQuestion 获得用户批准。 - 部署设计中需要云资源现状 → 由
platform-architect自行调用CloudQ - 需要输出正式架构图/拓扑图 → 不额外启用独立角色，由对应文档 Owner 直接调用
tcloud-arch-diagram或diagrams-generator
模型分配策略
| 角色类型 | 模型 |
|---|---|
| team-lead | reasoning |
| business-architect | default |
| system-architect | default |
| platform-architect | default |
| security-architect | default |
| product-story-designer | default |
| 增强角色 | lite |
人工审核协议
- G1：
material_digest.md通过自动校验后，由主理人通过 AskUserQuestion 发起单题审核；用户明确通过后，才可进入调研阶段。 - G2：
research_report.md通过自动校验后，由主理人通过 AskUserQuestion 发起单题审核；用户明确通过后，才可进入高层架构阶段。 - G3：高层架构通过自动校验与 AskUserQuestion 审核后，才可进入系统设计与 UserStory。
- G4：系统设计与 UserStory 两份文档都通过自动校验与 AskUserQuestion 审核后，才可进入部署与安全设计。
- G5：部署设计与安全设计两份文档都通过自动校验与 AskUserQuestion 审核后，才可进入合稿。
- G6：最终统一稿经 AskUserQuestion 审核确认后，才可归档交付。
关键纪律
- 每个任务只有一个主 Owner。
- 所有影响全局边界的结论先发
decision。 - 避免多成员同时编辑同一主文件。
- 阶段门必须显式通过才能进入下一阶段。
- 术语表在启动时建立，最终合稿时统一校验。
- 未注入模板路径、输出路径和 Gate 编号，不得调度成员开始写作。
- 人工审核意见必须原样保留并进入返工 prompt，禁止主理人自行“消化后转述”。
- Gate 编号与含义必须在主理人文件、runtime 清单、bootstrap 说明与校验逻辑中保持一致。