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
+233
View File
@@ -0,0 +1,233 @@
---
name: "gitea-pm"
description: "PM 专属项目管理技能 — 任务创建/关闭/里程碑管理/Pipeline Tracker、会话启动、角色汇报模板。"
---
# Gitea PM 技能
> PM Agent 的专属技能,封装所有项目管理操作。
> 所有配置(连接信息、Token、角色映射、标签定义)从 `gitea-config.json` 读取。
> 本文档不含项目特定信息。
---
## 1. CLI 工具
```bash
node .claude/skills/gitea-pm/gitea.js --role pm <command> [subcommand] [options]
```
**`--json` 标志**:所有命令支持 `--json` 输出纯 JSON,供脚本解析。
---
## 2. 认证与角色映射
- `--role <角色名>` 自动解析 Token 和 Assignee(从 `gitea-config.json` 的 `roles` 配置)
- `--assigned <角色名>` 自动解析为 Gitea 用户名
- `--assignees <角色名,...>` 同上
- 环境变量 `GITEA_TOKEN` 优先级最高
---
## 3. PM 会话启动
PM 每次启动时:
1. **读取当前阶段**:`pipeline status`
2. **列出激活里程碑**:`milestone list --state open`
3. **列出所有活跃任务**:`issue list --state open`,展示摘要
4. **展开需要关注的任务**:仅对 `status:in-progress`、`status:blocked`、`review:pass` 的任务执行 `issue get`
5. **按阶段调用技能**:无进度 → project-initializer / 草图 → stage-sketch / 总路线 → stage-roadmap / 迭代 → stage-iteration
---
## 4. 命令速查
### 🔒 PM-only 命令
#### 任务创建
```bash
# 创建任务(assignee 自动从 --role 映射;如需指定其他角色,用 --assignees)
node .claude/skills/gitea-pm/gitea.js --role pm issue create \
--title "D-001 概念设计" \
--body "任务正文" \
--milestone <id|标题> \
--labels <id,...>
# 创建任务并指派给策划(显式指定)
node .claude/skills/gitea-pm/gitea.js --role pm issue create \
--title "D-001 概念设计" \
--assignees designer \
--milestone <id|标题>
# 设置标签
node .claude/skills/gitea-pm/gitea.js --role pm issue labels <number> --set <id,id,...>
# 设置依赖
node .claude/skills/gitea-pm/gitea.js --role pm issue block <blocker_number> <blocked_number>
node .claude/skills/gitea-pm/gitea.js --role pm issue unblock <blocker_number> <blocked_number>
```
#### 任务关闭(用户确认后)
```bash
node .claude/skills/gitea-pm/gitea.js --role pm issue close <number> --body "关闭说明"
```
#### 任务重开
```bash
node .claude/skills/gitea-pm/gitea.js --role pm issue reopen <number>
```
#### 里程碑管理
```bash
node .claude/skills/gitea-pm/gitea.js --role pm milestone create \
--title "标题" --description "描述"
node .claude/skills/gitea-pm/gitea.js --role pm milestone update <id> \
--title "..." --state closed
```
#### Pipeline Tracker
```bash
# 初始化
node .claude/skills/gitea-pm/gitea.js --role pm pipeline init
# 更新阶段
node .claude/skills/gitea-pm/gitea.js --role pm pipeline update <number> --field 阶段 --value "迭代阶段"
# 更新当前迭代
node .claude/skills/gitea-pm/gitea.js --role pm pipeline update <number> --field 当前迭代 --value "v1.4"
```
#### 标签初始化
```bash
node .claude/skills/gitea-pm/gitea.js --role pm label init
node .claude/skills/gitea-pm/gitea.js --role pm label create --name "名称" --color "#RRGGBB"
```
### 通用命令(PM 也用)
```bash
# 查询
node .claude/skills/gitea-pm/gitea.js --role pm issue list --state open
node .claude/skills/gitea-pm/gitea.js --role pm issue get <number>
node .claude/skills/gitea-pm/gitea.js --role pm issue comments <number>
node .claude/skills/gitea-pm/gitea.js --role pm issue deps <number>
node .claude/skills/gitea-pm/gitea.js --role pm milestone list --state open
node .claude/skills/gitea-pm/gitea.js --role pm label list
node .claude/skills/gitea-pm/gitea.js --role pm pipeline status
# 测试连通
node .claude/skills/gitea-pm/gitea.js --role pm test
```
---
## 5. 任务 ID 规范
格式:`[角色前缀]-[三位数字]`
| 前缀 | 角色 | `--assignees` 值(角色名) |
|------|------|--------------------------|
| `D` | 策划 | `designer` |
| `P` | 程序 | `dev` |
| `A` | 美术 | `artist` |
每个前缀从 001 独立编号。
---
## 6. Pipeline Tracker
Pipeline Tracker 是一个 Meta Issue,仅记录**无法从 Issue/Milestone 推导**的信息:
- **当前阶段**:草图阶段 / 总路线阶段 / 迭代阶段
- **当前迭代**:版本号(迭代阶段时填写)
- **阶段历史**:阶段转换记录表
**不记录**:里程碑详情、Issues 计数、流水线步骤状态、任务索引(这些从查询获取)。
---
## 7. 角色汇报模板
各角色完成工作后在对应 Issue 下评论。
### 策划汇报
```
## 策划汇报 — 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
```
### PM 确认关闭任务
```
## 任务完成 ✔
**完成日期**:YYYY-MM-DD
**产出**:path/to/output
**审查记录**:docs/plans/reviews/<task-ID>-审查记录.md
```
---
## 8. 标签体系
从 `gitea-config.json` 的 `labels` 字段定义。`label init` 命令从此配置创建标签。
### 标签类别
| 类别 | 前缀 | 用途 |
|------|------|------|
| status | `status:` | 任务状态(backlog/ready/in-progress/blocked/in-review/done) |
| review | `review:` | 审查结果(pass/fail) |
| stage | `stage:` | 开发阶段(sketch/roadmap/iteration) |
| gate | `gate:` | 旧标签,保留用于历史 Issue |