/pace-dev

description: >
  Use when user says "开始做", "帮我改", "实现", "修复", "继续推进", "编码", "写代码", "开发", "重构",
  "做个", "coding", "implement", "fix", "refactor", "build", /pace-dev, or explicitly requests to
  start/continue/resume coding work. "帮我改" only when target is code/UI/config.
  NOT for requirement changes (/pace-change), code review (/pace-review), tests (/pace-test),
  or production issues (/pace-feedback).
allowed-tools: AskUserQuestion, Read, Write, Edit, Glob, Bash
argument-hint: "[<功能描述>|#<CR编号>|--last]"
model: sonnet
context: fork
agent: pace-engineer
hooks:
  PreToolUse:
    - matcher:
        tool_name: "Write|Edit"
      hooks:
        - type: command
          command: "${CLAUDE_PLUGIN_ROOT}/hooks/skill/pace-dev-scope-check.mjs"
          timeout: 5

/pace-dev — 推进变更请求

进入推进模式，开始或继续推进一个变更。

输入

$ARGUMENTS：

• （空）→ 自动选择 state.md 中的"下一步"
• `<功能描述>` → 指定要推进的功能（自然语言匹配）
• `#<N>` → 按 CR 编号直接定位（如 `#3` → CR-003）
• `--last` → 定位上一个操作过的 CR（从 state.md 或最近 git log 推断）
• `--batch` → 连续推进模式：批量推进迭代内多个 S 复杂度 PF，最后统一审批

执行路由

**重要**：根据 CR 的当前状态和类型，仅读取对应的 procedures 文件，不加载其他 procedures。

固定加载

| 文件 | 说明 | |------|------| | `skills/pace-dev/dev-procedures-common.md` | 通用规则（始终加载） |

按 CR 状态加载

| CR 状态 | 加载文件 | 说明 | |---------|---------|------| | `created`（首次进入 developing） | `skills/pace-dev/dev-procedures-intent.md` | 意图检查点 + 复杂度评估 + 执行计划 | | `developing`（已在推进中） | `skills/pace-dev/dev-procedures-developing.md` | 漂移检测 + 步骤隔离 + checkpoint | | `verifying` / `in_review` | `skills/pace-dev/dev-procedures-gate.md` | Gate 通过反思 | | `merged` / CR 新创建 | `skills/pace-dev/dev-procedures-postmerge.md` | 功能发现 + PF 溢出检查 |

按 CR 类型追加加载

| CR 类型 | 追加文件 | 说明 | |---------|---------|------| | `defect` / `hotfix` | `skills/pace-dev/dev-procedures-defect.md` | 特殊创建 + 修复后处理 |

流程

Step 1：定位变更请求

• `#N` 参数 → 直接读取 `.devpace/backlog/CR-00N.md`（编号补零匹配）
• `--last` 参数 → 从 state.md "进行中"项推断，或 `git log --oneline -5` 中最近操作的 CR
• 有自然语言参数 → 在 `.devpace/backlog/` 中按标题关键词匹配
• 无参数 → 读取 `.devpace/state.md` 的"下一步"
• 未找到对应 CR → 自动创建（格式参考 Plugin `knowledge/_schema/entity/cr-format.md`）并更新 project.md 价值功能树（在匹配的 PF 行追加 `→ CR-xxx ⏳`）
• 找到被阻塞的 CR → 告知用户阻塞原因，建议替代

**CR 类型判断**：

• 用户意图为修复缺陷 → type:defect（触发词："修复""fix""bug""缺陷"）
• 用户意图为紧急修复 → type:hotfix（触发词："紧急""hotfix""线上问题""生产故障"）
• 其他 → type:feature（默认）
• defect/hotfix 必须填写 severity，由 Claude 根据描述自动建议

Step 2：加载上下文

1. 读取 CR 文件：状态、质量检查、事件记录 2. 读取 `.devpace/rules/workflow.md`：当前阶段的准出条件 3. 读取 `.devpace/rules/checks.md`：质量检查检查项 4. 用 1 句话告知用户："从 [上次进度] 继续。"

Step 2.5：意图检查点

> 仅在 CR 状态为 created（首次进入 developing）时执行。已在 developing 或更后阶段的 CR 跳过此步。

根据 CR 状态和类型，按上方执行路由表加载对应的 procedures 文件。根据变更复杂度（简单/标准/复杂）自适应执行意图明确。对用户只说"明确了范围，开始做。"

Step 3：自治推进

进入推进模式，自主工作。遵循推进模式行为约束（`rules/devpace-rules.md` §2）和按执行路由表加载的 procedures 文件（权威源）：

• 编码、测试、验证——不需要用户确认每一步
• 质量检查不通过 → 自行修复重试
• 每个原子步骤后：git commit + 更新 CR 事件 + 更新 state.md

停止条件（满足任一）： a. 所有自动质量检查通过 → 到达 in_review → 自动运行 `/pace-review` 逻辑 b. 遇到需要用户决策的技术问题 → 询问用户 c. 会话即将结束 → 保存 checkpoint

Step 4：更新状态

1. 更新 CR 文件（质量检查 checkbox、事件记录） 2. 更新 `.devpace/state.md`（当前进度、下一步） 3. 更新 project.md 功能树中关联 CR 的状态 emoji（如 ⏳→🔄→✅）；如果 PF 的所有 CR 均 merged → PF 行 emoji 更新为 ✅

输出

推进结果摘要（3-5 行）。