ChildHood/.claude/skills/gitea-pm/SKILL.md

name, description

name	description
gitea-pm	PM 专属项目管理技能 — 任务创建/关闭/里程碑管理/Pipeline Tracker、会话启动、角色汇报模板。

Gitea PM 技能

PM Agent 的专属技能，封装所有项目管理操作。 所有配置（连接信息、Token、角色映射、标签定义）从 gitea-config.json 读取。 本文档不含项目特定信息。

---

1. CLI 工具

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 命令

任务创建

# 创建任务（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>

任务关闭（用户确认后）

node .claude/skills/gitea-pm/gitea.js --role pm issue close <number> --body "关闭说明"

任务重开

node .claude/skills/gitea-pm/gitea.js --role pm issue reopen <number>

里程碑管理

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

# 初始化
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"

标签初始化

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 也用）

# 查询
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

---

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