用途:在不改变可观察行为的前提下重构现有代码,使代码更易理解、修改和测试。重构不是大范围清理的许可,每次编辑都应视为有证据、有边界、可验证的行为保持变换。
主要能力:按用户范围选择模式。宽泛请求(如“重构这个模块”)先检查并提出安全的重构切片,等待批准后再大范围编辑;窄请求(指定文件、函数、重复块、死符号)直接实现最小安全切片并验证;仅审查请求分别转交 code-auditor 或 code-quality-review。重构类型包括模块拆分、函数/方法提取、重复代码合并、命名清理、注释清理和死代码移除。
使用方式:先阅读仓库指引(AGENTS.md、code_map.md、包文档、邻近测试),确定目标与非目标;收集调用点、导出、测试和框架入口等证据;编辑前运行最窄的相关检查建立基线;规划切片并声明不可变项(行为、API、数据格式、错误语义、日志、顺序);优先使用语言感知工具(TypeScript 语言服务、ts-morph、jscodeshift、ast-grep、rope、OpenRewrite、IDE 重构等);手动编辑保持 diff 小且局部;验证并检查 diff;最后报告范围、基线、计划、编辑、验证和残余风险。
适用场景:模块职责混杂需拆分、函数含多个小行为需提取、重复逻辑需合并、命名或注释掩盖意图、代码疑似无用需移除。
限制:宽泛范围、公共 API 或生成契约变更、基线缺失或失败、死代码证据不足、需新增依赖或迁移策略时应停止并请求批准;动态框架和公共包中的死代码移除属高风险;不自动安装未安装的工具;若最佳结果是“不动这段代码”,应说明原因。