SuperAPI AI 工具集

cs-refactor-ff

编程与开发

查看项目

更新于 10-15 20:30

技能介绍

用途:面向明显很小的重构,例如单函数变长、组件里抽 composable、合并一段重复代码,避免为小改动走完整三阶段流程。

启动前须执行 CodeStable preflight:读 .codestable/attention.md,缺失先 cs-onboard,不用外部 AI 入口替代。

入场 3 条硬检查(任一不过退 cs-refactor):行为真的不变;范围小(不超 1 个文件、单文件不超 100 行、改动点不超 3 处);有测试能自证(单测/集成测/类型检查可覆盖),无测试则先做 characterization test。

执行 gate:改前运行 start gate,{slug} 为 refactor 目录名: python3 .codestable/tools/codestable-worktree-gate.py --root . --json start --unit .codestable/refactors/YYYY-MM-DD-{slug} gate 不通过不动代码;override 需先在 unit 目录写 worktree-override.md(reason/scope/approval)。提交前运行同命令 commit gate。

方法约束:不读完整方法库,但每处改动须对应经典重构方法,如 Extract Function、Extract Variable、Guard Clauses、Decompose Conditional、Extract Composable/hook、Memoization、Cancellation;想不出对应方法则退完整流程。

流程:一次对齐(一句话说明方法、文件/函数、改动点数、影响范围并确认);按方法直接改,不产出 design doc/checklist;自证(先进入 cs-code-review 做独立 diff 评审,Critical/Important 未清零不进 commit;跑测试与类型检查/lint;grep 清理旧引用);一句话汇报。

文件产出:默认不建 .codestable/refactors/ 目录。仅用户明确要求留档时,建 .codestable/refactors/{YYYY-MM-DD}-{slug}/{slug}-refactor-note.md,写汇报加做了什么/为什么,不写 design/checklist。

跳出条件:改动点增至 5+、涉及多文件、出现清单外动作、无测试覆盖、用户追加行为改动、自证失败且非简单修正,均应停下并切回 cs-refactor 从 scan 开始。

不做:不写 scan/design/checklist;不跨多文件改;不做需人工目视的改动(前端渲染/交互/性能感知);不碰公开接口(需 Parallel Change)。常见坑:把“小”判得太宽、跳过入场检查、自证偷懒、改中顺手改邻居、把行为改动伪装成重构。相关文件:cs-refactor/SKILL.md、cs-refactor/reference/methods.md、.codestable/reference/system-overview.md。