--- name: "gitea-collab" description: "通用协作技能 — 任务查询、进度汇报、审查操作。非 PM 角色使用。" --- # Gitea 协作技能 > 通用协作技能,供策划、程序、美术、审查角色使用。 > 所有配置从 `gitea-config.json` 读取。 > 本文档不含 PM 专属命令。 --- ## 1. CLI 工具 ```bash node .claude/skills/gitea-collab/gitea.js --role <角色名> [subcommand] [options] ``` **`--json` 标志**:所有命令支持 `--json` 输出纯 JSON。 --- ## 2. 角色参数 使用 `--role <角色名>` 参数,自动解析为 Token 和身份: | 角色 | `--role` 值 | |------|------------| | 策划 | `designer` | | 程序 | `dev` | | 美术 | `artist` | | 审查 | `reviewer` | **不需要记住 Gitea 用户名** — `--role` 自动处理认证和身份。 --- ## 3. 任务查询(启动时使用) ### 查看激活里程碑 ```bash node .claude/skills/gitea-collab/gitea.js --role <角色名> milestone list --state open ``` ### 查看分配给自己的活跃任务 ```bash # --assigned 用角色名,自动映射 node .claude/skills/gitea-collab/gitea.js --role <角色名> issue list --assigned <角色名> --state open ``` ### 查看任务详情 ```bash node .claude/skills/gitea-collab/gitea.js --role <角色名> issue get ``` --- ## 4. 进度汇报 ### 添加进度评论 ```bash node .claude/skills/gitea-collab/gitea.js --role <角色名> issue comment --body "汇报内容" ``` ### 查看已有评论 ```bash node .claude/skills/gitea-collab/gitea.js --role <角色名> issue comments ``` ### 查看任务依赖 ```bash node .claude/skills/gitea-collab/gitea.js --role <角色名> issue deps ``` --- ## 5. 审查操作(reviewer 使用) ### 评论审查结果 ```bash node .claude/skills/gitea-collab/gitea.js --role reviewer issue comment --body "## 审查通过 ✅ **审查类型**:[执行案/程序设计/美术资产/程序实现] **审查日期**:YYYY-MM-DD **审查者**:审查 Agent (ai-reviewer) ### 结论 [一句话总结] ### 检查通过项 / 问题清单 - ..." ``` ### 更新 Issue 标签 ```bash # 审查通过:移除 status:in-review,添加 review:pass node .claude/skills/gitea-collab/gitea.js --role reviewer issue labels --set <保留的非status标签ID>, # 审查未通过:移除 status:in-review,改为 status:blocked,添加 review:fail node .claude/skills/gitea-collab/gitea.js --role reviewer issue labels --set ,<保留标签ID>, ``` --- ## 6. 审查评论格式 ### 通过 ```markdown ## 审查通过 ✅ **审查类型**:[执行案/程序设计/美术资产/程序实现] **审查日期**:YYYY-MM-DD **审查者**:审查 Agent (ai-reviewer) ### 结论 [一句话总结] ### 检查通过项 - ✅ [检查项1] - ✅ [检查项2] ``` ### 未通过 ```markdown ## 审查未通过 ❌ **审查类型**:[执行案/程序设计/美术资产/程序实现] **审查日期**:YYYY-MM-DD **审查者**:审查 Agent (ai-reviewer) ### 结论 [一句话总结] ### 问题清单 1. **[检查维度]**:[具体问题描述,附文档位置] — [修改建议] ``` --- ## 7. 汇报模板 ### 策划汇报 ```markdown ## 策划汇报 — YYYY-MM-DD **任务ID**: D-XXX **状态**: 进行中 / 已完成 **产出**: path/to/output ### 完成内容 - ... ### 待确认 - ... ``` ### 程序汇报 ```markdown ## 程序汇报 — YYYY-MM-DD **任务ID**: P-XXX **状态**: 进行中 / 已完成 **产出**: path/to/output ### 完成内容 - ... ### 偏差/问题 - ... ``` ### 审查退回后修改汇报 ```markdown ## 修改汇报 — YYYY-MM-DD **任务ID**: **修改原因**: 质量门审查退回 ### 修改内容 - [对应审查意见第X条]:[具体修改内容] ### 修改后产出 - path/to/output ```