cs-refactor

Installation
SKILL.md

cs-refactor

启动必读

开始任何判断或动作前,先执行 CodeStable preflight:读 .codestable/attention.md;缺失先 cs-onboard;不读外部 AI 入口替代(详见 .codestable/reference/execution-conventions.md)。

AI 自己重构有两个稳定失败模式:一是不知道模块真实需求和约束,改出来的东西功能不等价;二是一次吞掉的范围超过上下文承载,改到后面忘了前面的约束。这流程在"想优化"和"动手改"之间塞了扫描清单 + 方法库,让 AI 只接自己能稳定做对的活。

scan(扫优化点清单)→ design(和用户定做哪几条 + 顺序)→ apply(逐条执行,每步人工放行)

核心纪律:行为等价是底线。一旦会改外部可观察行为 → 不走 refactor,走 feature(需求变)或 issue(bug 修)。

架构 deepening 模式:用户说"架构优化 / 模块太浅 / seam 不对 / 可测试性差 / AI 难导航"时,仍走本技能三阶段,不生成 HTML。scan 用 codebase-design 词汇找 deepening opportunities;这是内嵌词汇引用,不切换到独立 codebase-design skill。候选项写进标准 {slug}-scan.md,用户勾选后再进 design/checklist/apply。

执行 gate(worktree + commit)

进入 apply 前运行 start gate,{slug} 为 refactor 目录名:

Installs
1.2K
GitHub Stars
1.0K
First Seen
Apr 23, 2026
cs-refactor — liuzhengdongfortest/codestable