refactor(skills): Gitea技能拆分——gitea-pm/gitea-collab双技能+配置集中化+角色自动映射

This commit is contained in:
DESKTOP-2K5TJI4\admin
2026-06-08 14:02:10 +08:00
parent d36991299c
commit 37b8996fae
16 changed files with 1685 additions and 688 deletions
+201
View File
@@ -0,0 +1,201 @@
---
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
**审查记录**:docs/plans/reviews/<task-ID>-审查记录.md
**审查者**:审查 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
**审查记录**:docs/plans/reviews/<task-ID>-审查记录.md
**审查者**:审查 Agent (ai-reviewer)
### 结论
[一句话总结]
### 检查通过项
- ✅ [检查项1]
- ✅ [检查项2]
```
### 未通过
```markdown
## 审查未通过 ❌
**审查类型**:[执行案/程序设计/美术资产/程序实现]
**审查日期**:YYYY-MM-DD
**审查记录**:docs/plans/reviews/<task-ID>-审查记录.md
**审查者**:审查 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
```