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