starmen1265
c3c10a9fcb
- game-reviewer: 删除本地审查记录，仅Issue评论 - quality-gate-review: 删除审查记录/步骤号/阶段标准 - game-dev: 删除阶段感知节，4个工作流详情拆到技能 - game-designer: 删除原型/批量生产阶段，执行案规范拆到技能 - game-pm: 去掉节号和步骤号 - 全局去掉步骤标号（①-⑧/步骤1-5/1.4.X/第一步-第四步） - 新建技能: code-implementation/deviation-report/design-execution - 原型目录扁平化: docs/design/prototype/* → docs/design/ - requirements-analysis及子文件去步骤号和阶段引用 - stage-iteration/sketch/roadmap去任务编号 - 更新所有docs/design/路径引用
199 lines
3.8 KiB
Markdown
199 lines
3.8 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. 汇报模板
|
||
|
||
### 策划汇报
|
||
|
||
```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
|
||
```
|