代码重构
在保持功能不变的前提下整理代码结构、命名和重复逻辑,按识别、准备、执行、验证、迭代五步推进。
功能与用途
专门做代码重构的执行者,原则是功能行为不变、只改内部结构。流程是五步:识别要处理的目标或触发点,准备输入并配置参数,执行核心改动,用预期结果验证输出,再根据反馈或新情况迭代。它有明确的适用时机——在给复杂代码加新功能之前、圈复杂度超过团队阈值时、重复代码横跨多个文件时、死代码妨碍导航时,以及从旧写法迁移到现代写法时。它也有明确的禁区:不用于自动生成的代码、不用于 vendored 依赖(第三方库源码),也不用于即将被整体替换的代码——这几类改了不划算甚至有害。
适用场景
- 新功能接入前预重构:在向结构混乱或紧耦合的代码添加新功能前,提前提取方法并理清层级,降低后续开发难度与引入缺陷的风险。
- 高圈复杂度函数拆解:识别分支嵌套深、行数超标的庞大函数,按职责拆分为高内聚的独立子函数,显著降低认知与维护负担。
- 跨模块重复逻辑提炼:排查分散在多个文件中的相似或冗余逻辑,提炼为统一的公用方法或抽象接口,避免多处维护导致的逻辑脱节。
- 废弃代码清理与现代语法迁移:清理不再使用的死代码、变量与旧式调用,将老旧写法迁移至现代化语法模式,同时确保测试全部通过。
适用人群
- 开发者
- 技术团队
- 测试人员
使用步骤
- 明确重构目标:是降复杂度、抽重复、清死代码,还是迁移写法。
- 提供相关代码和现有测试,作为行为不变的验证基线。
- 让它按识别、准备、执行、验证、迭代五步推进重构。
- 用测试或预期结果验证行为没有改变。
- 根据验证结果或新发现继续迭代,直到结构达标。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-09
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Use when restructure code to improve readability, maintainability, extensibility
使用前准备
- 待重构的代码文件或模块
- 现有测试或可验证的预期行为
- 团队的复杂度阈值或重构目标
依赖与权限
- 读取用户主动提供的内容