refactor(skills): Gitea技能拆分——gitea-pm/gitea-collab双技能+配置集中化+角色自动映射
This commit is contained in:
@@ -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
|
||||
```
|
||||
Reference in New Issue
Block a user