用途
orch-refine-code 用于编排一次「保持行为不变的重构」(behavior-preserving refactor)。它的目标是在不改变代码外部行为的前提下改善代码结构。
其命名结构为 actor · action · target:orch · refine · code,即「编排 · 精炼 · 代码」。它是 orch-pipeline 中共享引擎的轻量封装(thin wrapper)。
适用场景
当需求是「相同行为、更好结构」时使用本技能,典型任务包括:
- 抽取模块(extract modules)
- 消除重复(remove duplication)
- 清理死代码(kill dead code)
- 减少嵌套(reduce nesting)
- 为清晰性重命名(rename for clarity)
与同类技能的区分
如果行为本身需要发生任何改变,则本技能不适用,应改用 orch-change-feature 或 orch-fix-defect。
操作设置
- 默认规模下限:standard —— 重构通常涉及多个文件。
- 阶段掩码(phase mask):0 → 2(规划重构)→ 4(保持测试通过)→ 5 → 6。
- 不编写新的行为测试;现有测试套件即安全网。
第一步(阶段 4)
在改动代码之前,先确认相关测试存在且为绿色(通过)。如果测试覆盖较薄,应先补充特征测试(characterization tests)。随后以小步方式重构,并在每一步之后重新运行测试。
工作方式
- 以上述设置运行 orch-pipeline 引擎。
- 对于死代码或重复代码的清扫,委托给 refactor-cleaner 代理(它会运行 knip / depcheck / ts-prune 并安全地移除)。
- 在 Gate 1(重构计划)和 Gate 2(提交前)处停止。
- 以 refactor: 前缀提交——diff 必须是行为中性的。
示例
orch-refine-code: extract the NWS HTTP client out of poller.py → confirm tests green → plan extraction [GATE 1: approve] → move in small steps, tests green throughout → code-review → commit refactor: [GATE 2: confirm]
限制
- 不适用于行为需要改变的任务。
- 不编写新的行为测试,依赖现有测试套件作为安全网。
- 关于收费、价格、平台支持范围等信息,资料中暂未提供。