用途:用于 TypeScript 代码重构,例如整理文件、抽取常量或类型、拆分模块、重命名符号等,前提是必须证明行为不变。
主要能力与流程:其一,入口分两种。需求含糊(如“清理一下”)时先做只读普查,输出按价值/风险排序的债务计划,每行是一次可执行的原子重构;用户指定改动则直接进入契约环节。其二,Gate 1 在动文件前先打印重构契约,写明单次变换、允许改动的文件集合、作为判定依据的测试命令、动手前的绿色基线结果,以及被触及符号的导入方数量与清单。基线不绿、导入方扇出过大无法保持原子性时,应停下或交回分解计划。其三,执行阶段每次提交只做一个变换,各次提交之间测试必须通过;用 tsc 报错列出调用点,而非凭阅读预判完整改动;提交前用 git diff --stat 核对是否越界,越界文件直接还原。其四,Gate 2 在宣布完成前打印等价性证据,包括前后测试结果、是否改过测试、公开 API 的 .d.ts 差异、是否存在 as/any 或动态键等“洗白”手法、性能影响、最可能改变行为的调用点及为何未变、diff 范围。最后交由代码质量审查者与缺陷扫描者按 diff 复核,推送前运行仓库完整测试套件,而非只跑快速判定子集。
限制:资料未提供该技能的具体安装方式、支持平台与价格信息;其规则引用 rules/code-style.md、rules/typescript-strict.md、rules/worktree-authoring.md 及 references/characterization-harness.md、references/smells.md 等文件,这些文件内容未随资料提供,故无法在此展开。建议在 git worktree 中编辑仓库文件,并优先运行真实测试而非仅做类型检查。