refactor(agents): Agent文档重构——去Gitea耦合+中文化+废弃引用清理
- 新建 .claude/skills/gitea-collab.md 抽取Gitea协作工具为独立skill - 重写3个Agent文件为中文,删除current.md/reports/等废弃引用 - Agent只描述项目管理逻辑(what),Gitea实现细节(how)迁移到skill - development-workflow.md清理废弃行,抽象Gitea为项目管理工具 - 删除无引用的规范文件(design-agent-specification等) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -2,6 +2,8 @@
|
||||
|
||||
> 本文档定义游戏项目的开发阶段、版本开发流水线、角色职责、产出标准和质量检查规则。
|
||||
> 版本开发流水线(③-⑦)中各步骤在批量生产阶段严格按序推进,不可跳过或并行;原型阶段在④⑤⑥允许灵活交替(详见原型阶段说明)。①②为阶段级前置,仅在阶段开始时执行一次,后续版本迭代中不重复执行。
|
||||
>
|
||||
> 项目管理工具当前使用 Gitea。所有操作命令和标签定义详见 `.claude/skills/gitea-collab.md`。
|
||||
|
||||
---
|
||||
|
||||
@@ -12,27 +14,26 @@
|
||||
| **策划** (Design) | 玩法设计、数值平衡、叙事、系统机制 | `docs/design/`、`GameConfig/` | 扫描 `docs/design/` 和 `GameConfig/` 目录中的文件 |
|
||||
| **程序** (Dev) | 系统实现、技术架构、Bug 修复 | `Source/`、`Content/`、`docs/technical/` | 扫描对应目录中的文件 |
|
||||
| **美术** (Art) | 美术需求分析、资产规格、风格指南 | `docs/art/`、`Content/` | 扫描对应目录中的文件 |
|
||||
| **PM** | 进度追踪、优先级建议、风险预警、流水线推进 | **Gitea Issues** + `docs/plans/reviews/` | 通过 Gitea CLI 读取 Issues + Milestones |
|
||||
| **PM** | 进度追踪、优先级建议、风险预警、流水线推进 | **项目管理工具**(当前为 Gitea Issues)+ `docs/plans/reviews/` | 通过项目管理工具读取任务和里程碑 |
|
||||
|
||||
### 协作规则
|
||||
|
||||
- **策划先行**:设计文档是其他角色的需求源
|
||||
- **程序读设计**:实现前必须先读取对应设计文档和配置表
|
||||
- **文档即交接**:Agent 之间不直接通信,通过共享文档目录 + Gitea Issue 评论交接
|
||||
- **文档即交接**:Agent 之间不直接通信,通过共享文档目录 + 任务 Issue 评论交接(参见 `.claude/skills/gitea-collab.md`)
|
||||
- **冲突时用户说了算**:玩法/数值/叙事的最终决定权在用户
|
||||
- **PM 是信息枢纽**:跨角色的信息同步和阻塞排查由 PM 负责
|
||||
- **会话启动先调 PM**:每次工作会话开始时,用户必须先调出 PM 执行进度追踪,确认当前状态后再进入具体工作
|
||||
- **用户驱动角色切换**:角色间的工作切换由用户手动触发,PM 不自动指派任务
|
||||
- **角色任务汇报**:各角色通过 Gitea Issue 评论汇报进度,PM 据此追踪
|
||||
- **角色任务汇报**:各角色通过项目管理工具在任务 Issue 下评论汇报进度,PM 据此追踪
|
||||
|
||||
### 进度汇报规则
|
||||
|
||||
- 进度管理唯一真实来源是 **Gitea Issues + Milestones**,通过 `scripts/gitea.js` CLI 操作
|
||||
- 进度管理唯一真实来源是 **项目管理工具**(当前为 Gitea Issues + Milestones)。具体操作参见 `.claude/skills/gitea-collab.md`
|
||||
- 各角色完成工作后在对应 Issue 下评论汇报,不更新本地 report 文件
|
||||
- PM 通过 Gitea CLI 读取 Issues 和评论验收各角色工作结果,给出行动建议
|
||||
- PM 通过项目管理工具读取任务和评论验收各角色工作结果,给出行动建议
|
||||
- 角色完成工作后汇报结果,PM 验收并建议关闭 Issue,用户确认后由 PM 关闭 Issue
|
||||
- 任务追踪使用唯一任务 ID(格式:`[角色前缀]-[三位数字]`),对应 Issue 标题前缀
|
||||
- `docs/plans/current.md` 和 `docs/plans/reports/` 已废弃,不再维护
|
||||
- 审查记录仍保留在本地 `docs/plans/reviews/`,同时在 Issue 评论中发布摘要和链接
|
||||
|
||||
---
|
||||
@@ -632,7 +633,6 @@ PM 在每次 `/plan` 调用时,先判断宏观阶段,再针对**当前版本
|
||||
| 检查项 | 判断方式 | 结果 |
|
||||
|--------|----------|------|
|
||||
| 项目处于哪个开发阶段? | 检查 `concept.md` → 检查核心玩法是否已有可玩原型 → 检查内容是否已完整 | 草案 / 原型 / 批量生产 / 测试发布 |
|
||||
| 阶段信息是否记录在 `current.md`? | 检查 `current.md` 中是否有阶段标注 | 如无则补充 |
|
||||
|
||||
### 版本流水线检查
|
||||
|
||||
|
||||
Reference in New Issue
Block a user