用途:在提取组件、合并重复逻辑、重命名变量、优化结构等重构场景中提供安全检查清单,防止丢失原始上下文。触发条件包括用户提到重构、提取、合并、优化结构、简化代码,涉及表格列、数据结构、配置项修改,或合并条件分支。
主要能力与流程:一是强制读取原始代码,要求用 Read 读取完整文件,条件分支需读取全部分支,禁止凭记忆或推测重构。二是制作对比清单,逐列或逐字段对照原始与重构结构,标出一致、改名、缺失等状态。三是验证检查点,覆盖表格列数/列顺序/列名、条件分支完整性、数据结构字段数量/类型/顺序。四是输出重构对比说明,列出合并、条件显示、删除、新增项。
常见陷阱及对应做法:假设驱动重构需读取两个分支原始代码;记忆重构需先读取原始代码确认顺序;跳过验证需执行验证清单;拆分子模块导致循环依赖需先提取共享方法到独立 Helper/Utils 类,再拆分子服务,优先方案是提取公共方法到独立工具类,应急可用 @Lazy 字段注入或函数式回调;提取状态管理时初始化冲突应将初始化/清空放在 close 而非 open,或由 open 接受参数传入;UI 组件重构需保留 title/header/footer 的 JSX 结构与条件渲染按钮,不将组件库组件降级为原生标签;复杂渲染逻辑不可简化为读取空字段;字段名推测重构应查看原始代码实际使用的字段名,优先必填字段,枚举映射需完整,并做防御性编程。
限制:资料未提供该规范的安装方式、依赖环境、适用语言版本或更新记录;部分规则涉及具体技术栈(Spring Boot、Go、Vue、TypeScript、React),需在对应项目中自行判断适用性。