Ultravibe Refactor

# Skill: ultravibe-refactor — 代码重构(自动生成) > ⚠️ 此文件由 generate-skill 自动生成,请勿手动修改。修改流程定义请编辑 `flows/refactor.json`。 ## 输入 - 用户描述 - 若 `.reports/checkpoint-summary.json` 存在→从 next_phase 续跑 ## 参考 - @see `.codex/skills/ultravibe-common/contract.md` - @see `.codex/skills/ultravibe-common/checkpoint.md` - @see `.codex/skills/ultravibe-common/scope.md` - @see `.codex/skills/ultravibe-common/citation.md` - @see `.codex/skills/ultravibe-common/preflight.md` - @see `.codex/skills/ultravibe-common/gate.md` ## 前置(每次进入/续跑) 1. 调 `npx tsx src/index.ts preflight-check` 机械前置检查 2. 调 `npx tsx src/index.ts checkpoint read`(续跑入口) 3. 调 `npx tsx src/index.ts timeout-check`(超时熔断) 4. 调 `npx tsx src/index.ts phase-enter` 进入当前阶段(失败→阻断,禁止进入不合法阶段) ## A-2 架构声明 **主会话只做编排,不执行具体工作。所有工作阶段(RF-1/RF-2)必须通过子代理执行。** 主会话职责: 1. phase-enter(验证入口) 2. dispatch-phase(生成阶段简报,交给子代理) 3. 等待子代理完成 4. phase-transition(验证出口+推进) 子代理职责: 1. 接收 dispatch-phase 简报 2. 执行阶段具体工作(写代码/测试/产物) 3. 调 subagent-phase-enter/transition(门禁链) ## 阶段 ### [RF-1] 基线快照 记录 baseline.json 含测试结果 1. 调 `uv phase-enter --phase RF-1` (失败→阻断) 2. 调 `npx tsx src/index.ts dispatch-phase --phase RF-1` 生成阶段简报→交给子代理 3. **子代理执行:** a. 调 `uv subagent-phase-enter --phase RF-1` (子代理入口门禁,必须第一个调用) d. 输出产物: .reports/baseline.json e. 调 `uv subagent-phase-transition --phase RF-1` (子代理出口门禁) 4. 调 `npx tsx src/index.ts phase-transition --phase RF-1` (失败→回灌;成功→推进) **失败策略:** retry **期望事件序列:** snapshot → run-tests ### [RF-2] 重构实施 按 target_files 白名单重构,保持行为不变 1. 调 `uv phase-enter --phase RF-2` (失败→阻断) 2. 调 `npx tsx src/index.ts dispatch-phase --phase RF-2` 生成阶段简报→交给子代理 3. **子代理执行:** a. 调 `uv subagent-phase-enter --phase RF-2` (子代理入口门禁,必须第一个调用) b. 每轮迭代前调 `uv iteration-check --phase RF-2 --current N` (迭代截断,上限 12) c. 读取前置产物: .reports/baseline.json e. 调 `uv subagent-phase-transition --phase RF-2` (子代理出口门禁) 4. 调 `npx tsx src/index.ts phase-transition --phase RF-2` (失败→回灌;成功→推进) **失败策略:** retry **期望事件序列:** run-tests ### [RF-3] 全量回归 run-tests 对比 baseline 确认无回归 1. 调 `uv phase-enter --phase RF-3` (失败→阻断) 2. run-tests 对比 baseline 确认无回归 3. 读取前置产物: .reports/baseline.json 5. 调 `npx tsx src/index.ts phase-transition --phase RF-3` (失败→回灌;成功→推进) **失败策略:** retry **期望事件序列:** run-tests ### [RF-4] 全局守卫 机械聚合 static+tests+scope,输出 guard-report.json 1. 调 `uv phase-enter --phase RF-4` (失败→阻断) 2. 机械聚合 static+tests+scope,输出 guard-report.json 4. 输出产物: .reports/guard-report.json 5. 调 `npx tsx src/index.ts phase-transition --phase RF-4` (失败→回灌;成功→推进) **失败策略:** rollback **期望事件序列:** guard-report ## 硬约束 - **phase-transition 是 checkpoint 推进的唯一入口**,LLM 不再手写 checkpoint - 工作阶段(RF-1/RF-2)必须通过子代理执行,主会话不做具体工作 - 不改 protected_files: .reports/baseline.json - 不改白名单外文件(范围蔓延由 check-scope 机械阻断) - 不自称完成,run-tests+check-scope+check-static 全绿才算完成 - 阶段间调 `context-summary` 压缩上下文,防止膨胀 ## 流程配置(唯一真值源) ```json { "id": "refactor", "name": "代码重构", "phases": [ { "id": "RF-1", "name": "基线快照", "description": "记录 baseline.json 含测试结果", "entry_gate": "type", "exit_gate": "none", "max_iterations": 1, "produces": [ ".reports/baseline.json" ], "consumes": [], "on_failure": "retry", "expected_events": [ "snapshot", "run-tests" ], "mandatory_subagent": true }, { "id": "RF-2", "name": "重构实施", "description": "按 target_files 白名单重构,保持行为不变", "entry_gate": "type", "exit_gate": "type", "max_iterations": 12, "produces": [], "consumes": [ ".reports/baseline.json" ], "on_failure": "retry", "expected_events": [ "run-tests" ], "mandatory_subagent": true }, { "id": "RF-3", "name": "全量回归", "description": "run-tests 对比 baseline 确认无回归", "entry_gate": "type", "exit_gate": "none", "max_iterations": 1, "produces": [], "consumes": [ ".reports/baseline.json" ], "on_failure": "retry", "expected_events": [ "run-tests" ] }, { "id": "RF-4", "name": "全局守卫", "description": "机械聚合 static+tests+scope,输出 guard-report.json", "entry_gate": "type", "exit_gate": "chain", "max_iterations": 1, "produces": [ ".reports/guard-report.json" ], "consumes": [], "on_failure": "rollback", "expected_events": [ "guard-report" ] } ], "default_whitelist": [], "protected_files": [ ".reports/baseline.json" ], "skip_phase": [], "on_failure": "terminate" } ```

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本