Files

T

starmen1265 ac7a3abda9 config(git): 引入develop长期开发分支模型和git工作流自动化

2026-06-11 15:24:38 +08:00

6.5 KiB

Raw Blame History

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 每次启动时：

读取当前阶段：pipeline status
列出激活里程碑：milestone list --state open
列出所有活跃任务：issue list --state open，展示摘要
展开需要关注的任务：仅对 status:in-progress、status:blocked、review:pass 的任务执行 issue get
按阶段调用技能：无进度 → 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. PR 操作（发布合并）

迭代完成时，PM 负责创建 develop → main 的 PR：

# 列出当前 PR
node .claude/skills/gitea-pm/gitea.js --role pm pr list

# 创建发布 PR
bash .claude/scripts/git-workflow.sh release "迭代名称"

# 或手动创建
node .claude/skills/gitea-pm/gitea.js --role pm pr create \
  --base main --head develop \
  --title "Merge develop → main: 迭代名称" \
  --body "发布描述"

# 查看 PR 详情
node .claude/skills/gitea-pm/gitea.js --role pm pr get <number>

# 合并 PR（用户审查确认后）
node .claude/skills/gitea-pm/gitea.js --role pm pr merge <number> --style merge

# 合并后同步
bash .claude/scripts/git-workflow.sh post-release

9. 标签体系

从 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

6.5 KiB Raw Blame History Unescape Escape