235 lines
4.6 KiB
Markdown
235 lines
4.6 KiB
Markdown
---
|
||
name: "gitea-collab"
|
||
description: "通用协作技能 — 任务查询、进度汇报、审查操作。非 PM 角色使用。"
|
||
---
|
||
|
||
# Gitea 协作技能
|
||
|
||
> 通用协作技能，供策划、程序、美术、审查角色使用。
|
||
> 所有配置从 `gitea-config.json` 读取。
|
||
> 本文档不含 PM 专属命令。
|
||
|
||
---
|
||
|
||
## 1. CLI 工具
|
||
|
||
```bash
|
||
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. 任务查询（启动时使用）
|
||
|
||
### 查看激活里程碑
|
||
|
||
```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 <number>
|
||
```
|
||
|
||
---
|
||
|
||
## 4. 进度汇报
|
||
|
||
### 添加进度评论
|
||
|
||
```bash
|
||
node .claude/skills/gitea-collab/gitea.js --role <角色名> issue comment <number> --body "汇报内容"
|
||
```
|
||
|
||
### 查看已有评论
|
||
|
||
```bash
|
||
node .claude/skills/gitea-collab/gitea.js --role <角色名> issue comments <number>
|
||
```
|
||
|
||
### 查看任务依赖
|
||
|
||
```bash
|
||
node .claude/skills/gitea-collab/gitea.js --role <角色名> issue deps <number>
|
||
```
|
||
|
||
---
|
||
|
||
## 5. 审查操作（reviewer 使用）
|
||
|
||
### 评论审查结果
|
||
|
||
```bash
|
||
node .claude/skills/gitea-collab/gitea.js --role reviewer issue comment <number> --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 <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. 审查评论格式
|
||
|
||
### 通过
|
||
|
||
```markdown
|
||
## 审查通过 ✅
|
||
|
||
**审查类型**：[执行案/程序设计/美术资产/程序实现]
|
||
**审查日期**：YYYY-MM-DD
|
||
**审查者**：审查 Agent (ai-reviewer)
|
||
|
||
### 结论
|
||
[一句话总结]
|
||
|
||
### 检查通过项
|
||
- ✅ [检查项1]
|
||
- ✅ [检查项2]
|
||
```
|
||
|
||
### 未通过
|
||
|
||
```markdown
|
||
## 审查未通过 ❌
|
||
|
||
**审查类型**：[执行案/程序设计/美术资产/程序实现]
|
||
**审查日期**：YYYY-MM-DD
|
||
**审查者**：审查 Agent (ai-reviewer)
|
||
|
||
### 结论
|
||
[一句话总结]
|
||
|
||
### 问题清单
|
||
1. **[检查维度]**：[具体问题描述，附文档位置] — [修改建议]
|
||
```
|
||
|
||
---
|
||
|
||
## 7. PR 查询
|
||
|
||
非 PM 角色可以查看 PR 状态（创建和合并由 PM 负责）：
|
||
|
||
```bash
|
||
# 列出 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` 长期开发分支上工作：
|
||
|
||
```bash
|
||
# 开始工作时：确保在 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. 汇报模板
|
||
|
||
### 策划汇报
|
||
|
||
```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**: <ID>
|
||
**修改原因**: 质量门审查退回
|
||
|
||
### 修改内容
|
||
- [对应审查意见第X条]：[具体修改内容]
|
||
|
||
### 修改后产出
|
||
- path/to/output
|
||
```
|