9292> - 必须使用 ` Agent(team_name="{project_id}", ...) ` 创建 agent 实例,agent 才会加入 team
9393> - ** 禁止使用 ` run_in_background: true ` ** ,后台任务不会加入 team
9494
95- ** Agent 创建顺序** :
95+ ** Agent 创建顺序(Pattern 式 + 枚举式映射表) ** :
9696
97- 1 . Team Lead(Human 本身,** 不创建** )
98- 2 . Product Manager → 使用 ` Agent() ` 创建
99- 3 . 架构师 → 使用 ` Agent() ` 创建
100- 4 . 质量工程师 → 使用 ` Agent() ` 创建
101- 5 . 工程师 → 使用 ` Agent() ` 创建
102- 6 . 平台与发布负责人 → 使用 ` Agent() ` 创建
103- 7 . PMO → 使用 ` Agent() ` 创建
104-
105- ** Agent 创建模板** (不使用 ` run_in_background ` ):
97+ ** Pattern 式 — Agent 创建模板** (不使用 ` run_in_background ` ):
10698
10799``` json
108100Agent(
109101 subagent_type="general-purpose",
110102 team_name="{project_id}",
111103 name="{role-name}",
112104 prompt="你是 {角色名} Agent。请初始化:
113- 1 . 读取你的 skill 文件:`.claude/skills/adf-{role}/SKILL.md `
105+ 1 . 查 Skill 映射表,用 Skill() 加载你的 skill:`Skill(\"{skill-name}\") `
1141062 . 读取必读文档:`prompts/001_team_topology.md`(已读)和角色对应必读文档
1151073 . 输出初始化确认(角色、project_id、issue_id、当前阶段、已读取文档、阻塞项、下一动作)
1161084 . 通过 SendMessage 向 team-lead 报告初始化完成"
117109)
118110```
119111
112+ ** 枚举式 — Skill 映射表** (Pattern 中 {skill-name} 的具体值):
113+
114+ | # | Agent | Skill 名称 | Skill 源文件 | 用途 |
115+ | ---| -------| -----------| ------------| ------|
116+ | 1 | Team Lead | Human 本身,** 不创建** | — | 团队负责人 |
117+ | 2 | Product Manager | ` product-manager ` | ` .claude/skills/adf-product-manager/SKILL.md ` | 产品经理 |
118+ | 3 | 架构师 | ` architect ` | ` .claude/skills/adf-architect/SKILL.md ` | 技术架构与 Tech Spec |
119+ | 4 | 质量工程师 | ` qa-engineer ` | ` .claude/skills/adf-qa-engineer/SKILL.md ` | QA Case Design 与验证 |
120+ | 5 | 工程师 | ` engineer ` | ` .claude/skills/adf-engineer/SKILL.md ` | 代码实现 |
121+ | 6 | 平台与发布负责人 | ` platform-sre ` | ` .claude/skills/adf-platform-sre/SKILL.md ` | 发布与环境 |
122+ | 7 | PMO | ` pmo ` | ` .claude/skills/adf-pmo/SKILL.md ` | 流程合规检查 |
123+
124+ > ** 使用方式** :先看 Pattern 式模板了解通用初始化流程,再查枚举式映射表确定具体的 skill 名称和文件路径。
125+
120126** ⚠️ 关键错误:禁止使用 ` run_in_background: true ` **
121127
122128错误示例:
@@ -127,7 +133,7 @@ Agent(..., run_in_background: true) // ❌ 错误!后台任务不会加入 te
127133正确做法:Agent 创建后同步等待其完成初始化,再创建下一个。
128134
129135** 每个 Agent 创建后必须执行初始化确认** :
130- 1 . 读取对应的 ` adf-{role}/SKILL.md `
136+ 1 . 查 Skill 映射表,用 ` Skill("{skill-name}") ` 加载对应的 skill
1311372 . 读取必读文档列表中的第一个文档
1321383 . 输出初始化确认(角色、project_id、issue_id、当前阶段、已读取文档、阻塞项、下一动作)
1331394 . 通过 SendMessage 向 team-lead 发送初始化报告
0 commit comments