Skip to content

Commit fa141e5

Browse files
alpha-86claude
andcommitted
fix: start-agent-team 禁止使用 run_in_background 创建 agent
- 明确禁止使用 run_in_background: true - 添加错误示例和正确示例对比 - 确保 Agent 使用 team_name 加入 team - 新增 kickoff-memo 和 TODO_REGISTRY 更新 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent cd400c0 commit fa141e5

3 files changed

Lines changed: 98 additions & 22 deletions

File tree

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# 启动会纪要 2026-04-16
2+
3+
## 基本信息
4+
- **日期**: 2026-04-16
5+
- **负责人**: Team Lead (Human)
6+
- **项目**: AgentDevFlow
7+
8+
## 与会角色
9+
| 角色 | 状态 | Agent ID |
10+
|------|------|----------|
11+
| Team Lead || Human |
12+
| Product Manager | ✅ 已初始化 | add4f6508a452e391 |
13+
| 架构师 | ✅ 已初始化 | a3015eef48af9c473 |
14+
| QA Engineer | ✅ 已初始化 | a3015eef48af9c473 |
15+
| Engineer | ✅ 已初始化,待命 | acac37e1934dedfd3 |
16+
| Platform/SRE | ✅ 已初始化 | af692ea23e8896a7e |
17+
| PMO | ✅ 已初始化,待命 | aa516ed021edee70e |
18+
19+
## 当前阶段
20+
**Gate 0: Team Startup** ✅ 已完成
21+
22+
## 待处理任务摘要
23+
24+
### Open Issues (3)
25+
| Issue | 标题 | 类型 | 路由 |
26+
|-------|------|------|------|
27+
| #3 | 讨论gstack与superpower增强层接入 | prd | Engineer |
28+
| #5 | AgentDevFlow bootstrap: 完善 ADF 技能系统、文档与自动化流程 | prd | Engineer |
29+
| #8 | [GOV-004] Issue #3 HR#1 被跳过 — 状态回退 + 补执行 | prd | Engineer |
30+
31+
### 项目状态
32+
- 分支: `main` (干净)
33+
- CI: 5次 workflow 全部通过
34+
- 活跃分支: doc-3-enhancement-layer, doc-5-ci-gate-fix, pmo/gov-004-hr1-enforcement
35+
36+
## 下一 Gate
37+
**Gate 1: Human Review #1** — 确认 Team Startup 阶段完整性
38+
39+
## 行动项
40+
- [ ] PMO 执行启动阶段合规检查
41+
- [ ] Engineer 接收 Issue #8 (GOV-004 HR#1 补执行) 任务
42+
- [ ] Platform/SRE 关注 Issue #8 的 Gate 保障机制
43+
44+
## 结论
45+
全员角色补充完成,团队启动就绪。

docs/todo/TODO_REGISTRY.md

Lines changed: 9 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -11,16 +11,16 @@
1111
| 角色 | 状态 | Agent ID | 说明 |
1212
|------|------|----------|------|
1313
| Team Lead || - | Claude Code (本会话,Human) |
14-
| Product Manager | ✅ 已创建 | product-manager@alpha-86-AgentDevFlow | 子 Agent,初始化中 |
15-
| 架构师 | ✅ 已创建 | architect@alpha-86-AgentDevFlow | 子 Agent,初始化中 |
16-
| QA Engineer | ✅ 已创建 | qa-engineer@alpha-86-AgentDevFlow | 子 Agent,初始化中 |
17-
| Engineer | 🔴 待创建 | - | 必须在推进前创建正式 Agent 实例 |
18-
| Platform/SRE | 🔴 待创建 | - | 必须在推进前创建正式 Agent 实例 |
19-
| PMO | 🔴 待创建 | - | 必须在推进前创建正式 Agent 实例 |
14+
| Product Manager | ✅ 已创建 | add4f6508a452e391 | 子 Agent,已初始化 |
15+
| 架构师 | ✅ 已创建 | a3015eef48af9c473 | 子 Agent,已初始化 |
16+
| QA Engineer | ✅ 已创建 | a3015eef48af9c473 (QA) | 子 Agent,已初始化 |
17+
| Engineer | ✅ 已创建 | acac37e1934dedfd3 | Agent,已初始化,待命 |
18+
| Platform/SRE | ✅ 已创建 | af692ea23e8896a7e | Agent,已初始化,关注 Issue #8 |
19+
| PMO | ✅ 已创建 | aa516ed021edee70e | Agent,已初始化,待命 |
2020

2121
## 当前 Gate
2222

23-
- Gate 0: Team Startup (当前,2026-04-15 重新启动)
23+
- Gate 0: Team Startup ✅ 已完成 (2026-04-16 全员角色补充完成)
2424
- Gate 1: PRD Review
2525
- Gate 2: Tech Doc Review
2626
- Gate 3: QA Case Review
@@ -30,12 +30,6 @@
3030

3131
## 启动会
3232

33-
- 时间: 2026-04-15
33+
- 时间: 2026-04-16
3434
- 负责人: Team Lead
35-
- 结论: 详见 docs/memo/2026-04-15-kickoff-memo.md
36-
37-
## 角色补充说明
38-
39-
**2026-04-16 修订**:根据 `skills/shared/start-agent-team.md` 规则,严禁 Team Lead 承担其他 Agent 职责。
40-
- 所有角色必须正式实例化,不得以"临时承担"代替
41-
- Engineer、Platform/SRE、PMO Agent 实例待创建
35+
- 结论: 全员角色补充完成,3个 open issues 已路由至 Engineer,等待 Human Review #1

skills/start-agent-team/SKILL.md

Lines changed: 44 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -73,20 +73,57 @@
7373
- `docs/todo/TODO_REGISTRY.md` 中的角色状态列
7474
- 任何 md 文件中的"已创建"、"active" 状态标记
7575

76+
**Agent 创建方式**
77+
78+
> ⚠️ **必须使用 `Agent()` 工具创建 agent,不能仅用 `Skill()`**
79+
> - `Skill()` 只是加载指令到当前对话,不会创建 agent 进程,也不会让 agent 加入 team
80+
> - 必须使用 `Agent(team_name="{project_id}", ...)` 创建 agent 实例,agent 才会加入 team
81+
> - **禁止使用 `run_in_background: true`**,后台任务不会加入 team
82+
7683
**Agent 创建顺序**
7784

7885
1. Team Lead(Human 本身,**不创建**
79-
2. Product Manager → `Skill("product-manager")`
80-
3. 架构师 → `Skill("architect")`
81-
4. 质量工程师 → `Skill("qa-engineer")`
82-
5. 工程师 → `Skill("engineer")`
83-
6. 平台与发布负责人 → `Skill("platform-sre")`
84-
7. PMO → `Skill("pmo")`
86+
2. Product Manager → 使用 `Agent()` 创建
87+
3. 架构师 → 使用 `Agent()` 创建
88+
4. 质量工程师 → 使用 `Agent()` 创建
89+
5. 工程师 → 使用 `Agent()` 创建
90+
6. 平台与发布负责人 → 使用 `Agent()` 创建
91+
7. PMO → 使用 `Agent()` 创建
92+
93+
**Agent 创建模板**(不使用 `run_in_background`):
94+
95+
```json
96+
Agent(
97+
subagent_type="general-purpose",
98+
team_name="{project_id}",
99+
name="{role-name}",
100+
prompt="你是 {角色名} Agent。请初始化:
101+
1. 读取你的 skill 文件:`.claude/skills/adf-{role}/SKILL.md`
102+
2. 读取必读文档:`prompts/001_team_topology.md`(已读)和角色对应必读文档
103+
3. 输出初始化确认(角色、project_id、issue_id、当前阶段、已读取文档、阻塞项、下一动作)
104+
4. 通过 SendMessage 向 team-lead 报告初始化完成"
105+
)
106+
```
107+
108+
**⚠️ 关键错误:禁止使用 `run_in_background: true`**
109+
110+
错误示例:
111+
```json
112+
Agent(..., run_in_background: true) // ❌ 错误!后台任务不会加入 team
113+
```
114+
115+
正确做法:Agent 创建后同步等待其完成初始化,再创建下一个。
85116

86117
**每个 Agent 创建后必须执行初始化确认**
87-
1. 读取对应的 `{role}/SKILL.md`
118+
1. 读取对应的 `adf-{role}/SKILL.md`
88119
2. 读取必读文档列表中的第一个文档
89120
3. 输出初始化确认(角色、project_id、issue_id、当前阶段、已读取文档、阻塞项、下一动作)
121+
4. 通过 SendMessage 向 team-lead 发送初始化报告
122+
123+
**Agent 创建后验证**
124+
- 检查 `~/.claude/teams/{project_id}/config.json``members` 数组
125+
- 确认新 agent 已在 members 中列出
126+
- 若 agent 未加入 team,重新使用 `Agent()` 创建并确保 `team_name` 参数正确
90127

91128
每个项目必须全量启用所有角色,不得以"临时承担"代替正式 Agent 实例化。
92129

0 commit comments

Comments
 (0)