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 说明与校验逻辑中保持一致。