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