$npx -y skills add arch-team/devpace --skill pace-devUse 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 (/p
| 1 | # /pace-dev — 推进变更请求 |
| 2 | |
| 3 | 进入推进模式,开始或继续推进一个变更。 |
| 4 | |
| 5 | ## 输入 |
| 6 | |
| 7 | $ARGUMENTS: |
| 8 | - (空)→ 自动选择 state.md 中的"下一步" |
| 9 | - `<功能描述>` → 指定要推进的功能(自然语言匹配) |
| 10 | - `#<N>` → 按 CR 编号直接定位(如 `#3` → CR-003) |
| 11 | - `--last` → 定位上一个操作过的 CR(从 state.md 或最近 git log 推断) |
| 12 | - `--batch` → 连续推进模式:批量推进迭代内多个 S 复杂度 PF,最后统一审批 |
| 13 | |
| 14 | ## 执行路由 |
| 15 | |
| 16 | **重要**:根据 CR 的当前状态和类型,仅读取对应的 procedures 文件,不加载其他 procedures。 |
| 17 | |
| 18 | ### 固定加载 |
| 19 | |
| 20 | | 文件 | 说明 | |
| 21 | |------|------| |
| 22 | | `skills/pace-dev/dev-procedures-common.md` | 通用规则(始终加载) | |
| 23 | |
| 24 | ### 按 CR 状态加载 |
| 25 | |
| 26 | | CR 状态 | 加载文件 | 说明 | |
| 27 | |---------|---------|------| |
| 28 | | `created`(首次进入 developing) | `skills/pace-dev/dev-procedures-intent.md` | 意图检查点 + 复杂度评估 + 执行计划 | |
| 29 | | `developing`(已在推进中) | `skills/pace-dev/dev-procedures-developing.md` | 漂移检测 + 步骤隔离 + checkpoint | |
| 30 | | `verifying` / `in_review` | `skills/pace-dev/dev-procedures-gate.md` | Gate 通过反思 | |
| 31 | | `merged` / CR 新创建 | `skills/pace-dev/dev-procedures-postmerge.md` | 功能发现 + PF 溢出检查 | |
| 32 | |
| 33 | ### 按 CR 类型追加加载 |
| 34 | |
| 35 | | CR 类型 | 追加文件 | 说明 | |
| 36 | |---------|---------|------| |
| 37 | | `defect` / `hotfix` | `skills/pace-dev/dev-procedures-defect.md` | 特殊创建 + 修复后处理 | |
| 38 | |
| 39 | ## 流程 |
| 40 | |
| 41 | ### Step 1:定位变更请求 |
| 42 | |
| 43 | - `#N` 参数 → 直接读取 `.devpace/backlog/CR-00N.md`(编号补零匹配) |
| 44 | - `--last` 参数 → 从 state.md "进行中"项推断,或 `git log --oneline -5` 中最近操作的 CR |
| 45 | - 有自然语言参数 → 在 `.devpace/backlog/` 中按标题关键词匹配 |
| 46 | - 无参数 → 读取 `.devpace/state.md` 的"下一步" |
| 47 | - 未找到对应 CR → 自动创建(格式参考 Plugin `knowledge/_schema/entity/cr-format.md`)并更新 project.md 价值功能树(在匹配的 PF 行追加 `→ CR-xxx ⏳`) |
| 48 | - 找到被阻塞的 CR → 告知用户阻塞原因,建议替代 |
| 49 | |
| 50 | **CR 类型判断**: |
| 51 | - 用户意图为修复缺陷 → type:defect(触发词:"修复""fix""bug""缺陷") |
| 52 | - 用户意图为紧急修复 → type:hotfix(触发词:"紧急""hotfix""线上问题""生产故障") |
| 53 | - 其他 → type:feature(默认) |
| 54 | - defect/hotfix 必须填写 severity,由 Claude 根据描述自动建议 |
| 55 | |
| 56 | ### Step 2:加载上下文 |
| 57 | |
| 58 | 1. 读取 CR 文件:状态、质量检查、事件记录 |
| 59 | 2. 读取 `.devpace/rules/workflow.md`:当前阶段的准出条件 |
| 60 | 3. 读取 `.devpace/rules/checks.md`:质量检查检查项 |
| 61 | 4. 用 1 句话告知用户:"从 [上次进度] 继续。" |
| 62 | |
| 63 | ### Step 2.5:意图检查点 |
| 64 | |
| 65 | > 仅在 CR 状态为 created(首次进入 developing)时执行。已在 developing 或更后阶段的 CR 跳过此步。 |
| 66 | |
| 67 | 根据 CR 状态和类型,按上方执行路由表加载对应的 procedures 文件。根据变更复杂度(简单/标准/复杂)自适应执行意图明确。对用户只说"明确了范围,开始做。" |
| 68 | |
| 69 | ### Step 3:自治推进 |
| 70 | |
| 71 | 进入推进模式,自主工作。遵循推进模式行为约束(`rules/devpace-rules.md` §2)和按执行路由表加载的 procedures 文件(权威源): |
| 72 | |
| 73 | - 编码、测试、验证——不需要用户确认每一步 |
| 74 | - 质量检查不通过 → 自行修复重试 |
| 75 | - 每个原子步骤后:git commit + 更新 CR 事件 + 更新 state.md |
| 76 | |
| 77 | 停止条件(满足任一): |
| 78 | a. 所有自动质量检查通过 → 到达 in_review → 自动运行 `/pace-review` 逻辑 |
| 79 | b. 遇到需要用户决策的技术问题 → 询问用户 |
| 80 | c. 会话即将结束 → 保存 checkpoint |
| 81 | |
| 82 | ### Step 4:更新状态 |
| 83 | |
| 84 | 1. 更新 CR 文件(质量检查 checkbox、事件记录) |
| 85 | 2. 更新 `.devpace/state.md`(当前进度、下一步) |
| 86 | 3. 更新 project.md 功能树中关联 CR 的状态 emoji(如 ⏳→🔄→✅);如果 PF 的所有 CR 均 merged → PF 行 emoji 更新为 ✅ |
| 87 | |
| 88 | ## 输出 |
| 89 | |
| 90 | 推进结果摘要(3-5 行)。 |