SuperAPI AI 工具集

orch-refine-code

编程与开发

查看项目

更新于 10-15 08:38

技能介绍

用途

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)。随后以小步方式重构,并在每一步之后重新运行测试。

工作方式

  1. 以上述设置运行 orch-pipeline 引擎。
  2. 对于死代码或重复代码的清扫,委托给 refactor-cleaner 代理(它会运行 knip / depcheck / ts-prune 并安全地移除)。
  3. 在 Gate 1(重构计划)和 Gate 2(提交前)处停止。
  4. 以 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]

限制

  • 不适用于行为需要改变的任务。
  • 不编写新的行为测试,依赖现有测试套件作为安全网。
  • 关于收费、价格、平台支持范围等信息,资料中暂未提供。