Ultravibe Refactor
Refactors code within the approved file scope, captures a test baseline, and verifies the changes with regression tests and scope checks.
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
前置(每次进入/续跑)
-
调
npx tsx src/index.ts preflight-check机械前置检查 -
调
npx tsx src/index.ts checkpoint read(续跑入口) -
调
npx tsx src/index.ts timeout-check(超时熔断) -
调
npx tsx src/index.ts phase-enter进入当前阶段(失败→阻断,禁止进入不合法阶段)
A-2 架构声明
主会话只做编排,不执行具体工作。所有工作阶段(RF-1/RF-2)必须通过子代理执行。
主会话职责:
- phase-enter(验证入口)
- dispatch-phase(生成阶段简报,交给子代理)
- 等待子代理完成
- phase-transition(验证出口+推进)
子代理职责:
- 接收 dispatch-phase 简报
- 执行阶段具体工作(写代码/测试/产物)
- 调 subagent-phase-enter/transition(门禁链)
阶段
[RF-1] 基线快照
记录 baseline.json 含测试结果
- 调
uv phase-enter --phase RF-1(失败→阻断) - 调
npx tsx src/index.ts dispatch-phase --phase RF-1生成阶段简报→交给子代理 - 子代理执行:
a. 调
uv subagent-phase-enter --phase RF-1(子代理入口门禁,必须第一个调用) d. 输出产物: .reports/baseline.json e. 调uv subagent-phase-transition --phase RF-1(子代理出口门禁) - 调
npx tsx src/index.ts phase-transition --phase RF-1(失败→回灌;成功→推进) 失败策略: retry 期望事件序列: snapshot → run-tests
[RF-2] 重构实施
按 target_files 白名单重构,保持行为不变
- 调
uv phase-enter --phase RF-2(失败→阻断) - 调
npx tsx src/index.ts dispatch-phase --phase RF-2生成阶段简报→交给子代理 - 子代理执行:
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(子代理出口门禁) - 调
npx tsx src/index.ts phase-transition --phase RF-2(失败→回灌;成功→推进) 失败策略: retry 期望事件序列: run-tests
[RF-3] 全量回归
run-tests 对比 baseline 确认无回归
- 调
uv phase-enter --phase RF-3(失败→阻断) - run-tests 对比 baseline 确认无回归
- 读取前置产物: .reports/baseline.json
- 调
npx tsx src/index.ts phase-transition --phase RF-3(失败→回灌;成功→推进) 失败策略: retry 期望事件序列: run-tests
[RF-4] 全局守卫
机械聚合 static+tests+scope,输出 guard-report.json
- 调
uv phase-enter --phase RF-4(失败→阻断) - 机械聚合 static+tests+scope,输出 guard-report.json
- 输出产物: .reports/guard-report.json
- 调
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压缩上下文,防止膨胀
流程配置(唯一真值源)
{
"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"
}
Related skills
- Downloads
- Security audit
- Review
- Last updated
- 6d ago
- Current version
- v0.1.0
- License
- MIT-0
