refactor(agents): 角色文档解耦——移除工具硬编码,简化工作流

This commit is contained in:
DESKTOP-2K5TJI4\admin
2026-06-08 11:28:44 +08:00
parent 29232eff8f
commit d36991299c
6 changed files with 209 additions and 332 deletions
+36 -55
View File
@@ -214,9 +214,9 @@ node scripts/gitea.js test
## 8. Pipeline Tracker
Pipeline Tracker 是一个 **Meta Issue**,用于记录项目当前阶段和进度。
Pipeline Tracker 是一个 **Meta Issue**,仅记录**无法从 Issue/Milestone 系统直接推导**的信息。
### Tracker 正文格式
### Tracker 正文只保留
```markdown
# 流水线进度追踪
@@ -224,23 +224,28 @@ Pipeline Tracker 是一个 **Meta Issue**,用于记录项目当前阶段和进
## 当前阶段
草图阶段 / 总路线阶段 / 迭代阶段
## 当前里程碑
- 名称: <milestone title>
- 状态: open/closed
- Open Issues: X
- Closed Issues: Y
## 当前迭代
v1.4(迭代阶段时填写,其他阶段留空)
## 阶段历史
| 阶段 | 里程碑 | 进入日期 | 完成日期 |
|------|--------|----------|----------|
| 草图阶段 | 草图阶段 | YYYY-MM-DD | — |
| 草图阶段 | 草图阶段 | YYYY-MM-DD | YYYY-MM-DD |
| 总路线阶段 | 总路线阶段 | YYYY-MM-DD | — |
```
### 不记录的信息(从 Issue/Milestone 直接查询)
- ~~当前里程碑详情~~ → `milestone list --state open`
- ~~Open/Closed Issues 计数~~ → `milestone list` 自带
- ~~7 步流水线步骤状态~~ → 从任务的 status/review 标签聚合
- ~~相关任务索引~~ → `issue list --state open`
- ~~当前阻塞~~ → `issue list --labels status:blocked`
### 相关命令
- 初始化:`pipeline init`
- 查看状态:`pipeline status`
- 更新步骤:`pipeline update <number> --step <1-7> --status "描述"`
- 阶段转换时直接编辑 Issue 正文更新「当前阶段」和「阶段历史」
---
@@ -309,28 +314,15 @@ node scripts/gitea.js --role pm issue close <number> --body "## 任务完成 ✔
---
## 10. PM 会话启动命令序列
## 10. PM 会话启动
PM 在每次会话启动时按序执行:
PM 每次启动时:
```bash
# 1. 读取 Pipeline Tracker(确定当前阶段)
node scripts/gitea.js --role pm pipeline status
# 2. 读取当前里程碑
node scripts/gitea.js --role pm milestone list --state open
# 3. 读取活跃任务
node scripts/gitea.js --role pm issue list --state open
# 4. 根据阶段调用对应技能:
# 无进度 → project-initializer
# 草图阶段 → stage-sketch
# 总路线阶段 → stage-roadmap
# 迭代阶段 → stage-iteration
# 5. 检查 review:pass 标签的 Issue → 请示用户是否关闭
```
1. **读取当前阶段**:`pipeline status`(仅获取当前阶段)
2. **列出激活里程碑**:`milestone list --state open`
3. **列出所有活跃任务**:`issue list --state open`,展示摘要(任务 ID、标题、状态标签、assignee)
4. **展开需要关注任务的详情**:仅对 `status:in-progress`、`status:blocked`、`review:pass` 的任务执行 `issue get` 获取详情
5. **按阶段调用技能**:无进度 → project-initializer / 草图 → stage-sketch / 总路线 → stage-roadmap / 迭代 → stage-iteration
---
@@ -362,37 +354,26 @@ node scripts/gitea.js --role pm issue close <number> --body "## 任务完成 ✔
---
## 12. 其他角色读取命令
## 12. 角色(非 PM)任务查询
### 程序查看任务
非 PM 角色启动时只需三步,**不需要**读取 Pipeline Tracker:
```bash
# 查看分配给自己的任务
node scripts/gitea.js --role dev issue list --assigned ai-programmer --milestone <当前版本>
# 1. 查看当前激活里程碑
node scripts/gitea.js --role <role> milestone list --state open
# 查看流水线状态
node scripts/gitea.js --role dev pipeline status
# 2. 查看分配给自己的活跃任务
node scripts/gitea.js --role <role> issue list --assigned <自己的用户名> --state open
# 查看 Issue 详情
node scripts/gitea.js --role dev issue get <number>
# 3. 查看具体任务详情(仅在需要时)
node scripts/gitea.js --role <role> issue get <number>
```
### 策划查看任务
### 角色参数速查
```bash
# 查看分配给自己的任务
node scripts/gitea.js --role designer issue list --assigned ai-designer --milestone <当前版本>
# 查看 Issue 详情
node scripts/gitea.js --role designer issue get <number>
```
### 美术查看任务
```bash
# 查看分配给自己的任务
node scripts/gitea.js --role artist issue list --assigned ai-artist --milestone <当前版本>
# 查看 Issue 详情
node scripts/gitea.js --role artist issue get <number>
```
| 角色 | `--role` | `--assigned` |
|------|----------|-------------|
| 策划 | `designer` | `ai-designer` |
| 程序 | `dev` | `ai-programmer` |
| 美术 | `artist` | `ai-artist` |
| 审查 | `reviewer` | (不拥有任务) |