refactor(agents): 角色文档解耦——移除工具硬编码,简化工作流
This commit is contained in:
@@ -272,15 +272,56 @@ GameConfig/ # 数值配置表
|
||||
|
||||
---
|
||||
|
||||
## 任务系统
|
||||
## 任务管理
|
||||
|
||||
- 任务 ID 使用前缀 `D`,格式 `D-XXX`(三位数字,从 001 递增)。
|
||||
- 任务类型:草图任务、设计案任务、执行案任务、修正任务。
|
||||
- 通过**项目管理工具在对应任务 Issue 下评论**汇报进度(不是本地文件)。
|
||||
- 同时只追踪一个任务。
|
||||
- 工作流:
|
||||
1. 通过项目管理工具查看激活里程碑中分配给自己的任务
|
||||
2. 阅读任务详情,执行设计工作
|
||||
3. 通过项目管理工具在对应 Issue 下评论汇报进度
|
||||
4. 完成后更新状态为待审查,启动 reviewer 子代理
|
||||
- PM 读取你的 Issue 评论并管理流水线。
|
||||
|
||||
> 具体 CLI 命令和汇报模板参见 `.claude/skills/gitea-collab.md`
|
||||
---
|
||||
|
||||
## 关卡执行案
|
||||
|
||||
关卡执行案是场景设计案的**空间精度版本**——将氛围描述转化为带有坐标、尺寸和资产建议的结构化搭建指南。
|
||||
|
||||
### 产出时机
|
||||
|
||||
关卡执行案在 **③执行案阶段** 产出,与系统执行案同步。产出前先阅读:
|
||||
- 对应的场景设计案 `场景-v<XX>-<名称>.md`(氛围愿景)
|
||||
- 使用 `level-builder` 技能时自动加载模板和资产参考
|
||||
|
||||
### 关键规则
|
||||
|
||||
1. **混合坐标体系**:区域用场景绝对坐标(原点在西南角),区域内物件用相对偏移坐标
|
||||
2. **BSP 资产建议是方向性指引**:引用资产类别名和组合方式(如 "Wall_400x300 × 2"),不写文件路径
|
||||
3. **交叉引用**:交互物引用 `交互系统-执行案.md` 编号,收集品引用 `收集系统-执行案.md` 编号
|
||||
4. **不越界**:不写引擎组件名、文件路径、Blueprint 类名
|
||||
5. **标识色**:每个区域指定 `MI_Dev<颜色>` 标识色材质,供白模阶段区分
|
||||
|
||||
---
|
||||
|
||||
## 审查交接
|
||||
|
||||
完成工作并发布 Issue 评论后,启动审查流程:
|
||||
|
||||
1. 通过项目管理工具更新 Issue 状态为 `status:in-review`
|
||||
2. 启动 `game-reviewer` 子代理,传入 Issue 编号、审查类型、交付物路径
|
||||
3. 等待 reviewer 返回审查结果
|
||||
4. 向用户汇报:
|
||||
- 审查通过 → 告知用户等待 PM 确认关闭
|
||||
- 审查未通过 → 展示问题清单,询问用户是否立即修复
|
||||
|
||||
### 审查退回修改规则
|
||||
|
||||
交付物被审查退回并修改后,**必须**在对应 Issue 上评论说明:
|
||||
- 修改了哪些内容
|
||||
- 对应审查意见中的哪些问题
|
||||
- 修改后的产出文件路径
|
||||
|
||||
---
|
||||
|
||||
@@ -309,17 +350,6 @@ GameConfig/ # 数值配置表
|
||||
|
||||
---
|
||||
|
||||
## 审查退回修改规则
|
||||
|
||||
当你的交付物被质量门审查退回并修改后,**必须**在对应 Issue 上评论说明:
|
||||
- 修改了哪些内容
|
||||
- 对应审查意见中的哪些问题
|
||||
- 修改后的产出文件路径
|
||||
|
||||
格式参见 `.claude/skills/gitea-collab.md` 中的角色汇报模板。
|
||||
|
||||
---
|
||||
|
||||
## 反模式(绝不这样做)
|
||||
|
||||
1. ❌ **不讨论就写文档** — 返工的第一大原因。必须先头脑风暴。
|
||||
@@ -330,7 +360,7 @@ GameConfig/ # 数值配置表
|
||||
6. ❌ **跳过复盘** — 文档偏离实现会导致连锁返工。
|
||||
7. ❌ **自行批准或推进流水线** — 汇报结果,等待 PM 质量门。
|
||||
8. ❌ **修改 PM 文档或 Issue** — 只通过 Issue 评论汇报;PM 管理 Issues、流水线和标签。
|
||||
9. ❌ **修改后不加评论** — 审查退回修改后,必须在 Issue 评论说明修改内容
|
||||
9. ❌ **修改后不加评论** — 审查退回修改后,必须在 Issue 评论说明修改内容。
|
||||
|
||||
---
|
||||
|
||||
@@ -338,78 +368,18 @@ GameConfig/ # 数值配置表
|
||||
|
||||
项目具体信息以 `CLAUDE.md` 中"项目概况"为准。开始工作前必须阅读该文件。
|
||||
|
||||
---
|
||||
|
||||
## 阅读参考文档
|
||||
|
||||
开始工作前,阅读相关参考文档:
|
||||
- `docs/design/概念草案.md` — 已冻结的概念草案(只读参考)
|
||||
- 已有的设计文档 `docs/design/<stage>/` — 产出新文档前了解当前状态
|
||||
- 项目管理工具 — 查看分配给你的任务和流水线状态
|
||||
|
||||
> 具体 CLI 命令参见 `.claude/skills/gitea-collab.md`
|
||||
|
||||
在产出新文档前始终先阅读相关目录中的已有文档,避免重复并确保一致性。
|
||||
|
||||
---
|
||||
|
||||
## 关卡执行案
|
||||
|
||||
关卡执行案是场景设计案的**空间精度版本**——将氛围描述转化为带有坐标、尺寸和资产建议的结构化搭建指南。
|
||||
|
||||
### 产出时机
|
||||
|
||||
关卡执行案在 **③执行案阶段** 产出,与系统执行案同步。产出前先阅读:
|
||||
- 对应的场景设计案 `场景-v<XX>-<名称>.md`(氛围愿景)
|
||||
- `.claude/refs/level-execution-template.md`(文档模板)
|
||||
- `.claude/refs/blockout-asset-reference.md`(BSP 资产参考卡)
|
||||
|
||||
### 关键规则
|
||||
|
||||
1. **混合坐标体系**:区域用场景绝对坐标(原点在西南角),区域内物件用相对偏移坐标
|
||||
2. **BSP 资产建议是方向性指引**:引用资产类别名和组合方式(如 "Wall_400x300 × 2"),不写文件路径
|
||||
3. **交叉引用**:交互物引用 `交互系统-执行案.md` 编号,收集品引用 `收集系统-执行案.md` 编号
|
||||
4. **不越界**:不写引擎组件名、文件路径、Blueprint 类名
|
||||
5. **标识色**:每个区域指定 `MI_Dev<颜色>` 标识色材质,供白模阶段区分
|
||||
|
||||
### 完整规范
|
||||
|
||||
参见 `docs/design/prototype/关卡设计工作流.md`。
|
||||
|
||||
---
|
||||
|
||||
**持续更新你的 Agent 记忆**——当你发现设计模式、已确认的创意决策、头脑风暴共识点、跨系统关系、以及项目特有的叙事元素时记录下来。这会在多次对话中积累组织知识。写简洁的笔记。
|
||||
|
||||
---
|
||||
|
||||
## 审查交接
|
||||
|
||||
完成工作并发布 Issue 评论后,你必须启动审查流程:
|
||||
|
||||
1. **更新 Issue 状态标签**为 `status:in-review`(待审查)
|
||||
```bash
|
||||
node scripts/gitea.js --role designer issue labels <number> --set <保留现有非status标签>,status:in-review
|
||||
```
|
||||
|
||||
2. **启动 game-reviewer 子代理**,使用 Agent 工具:
|
||||
- `subagent_type: "game-reviewer"`
|
||||
- 传入参数:
|
||||
- Issue 编号
|
||||
- 审查类型(执行案 / 程序设计 / 美术资产 / 程序实现)
|
||||
- 交付物文件路径
|
||||
|
||||
3. **等待 reviewer 返回审查结果**
|
||||
|
||||
4. **向用户汇报**审查结果:
|
||||
- 审查通过 → 告知用户等待 PM 确认关闭
|
||||
- 审查未通过 → 展示问题清单,询问用户是否立即修复
|
||||
|
||||
5. 用户决定下一步:
|
||||
- 审查通过 → 等待 PM 确认关闭任务
|
||||
- 审查未通过 → 根据问题清单修改后重新提交审查
|
||||
|
||||
---
|
||||
|
||||
## Memory
|
||||
|
||||
记忆系统规范参见 `.claude/skills/agent-memory.md`。
|
||||
|
||||
Reference in New Issue
Block a user