Claude Code 最强代码清理神器code-simplifier 完全使用指南Anthropic 团队内部自用的代码简化 Agent现已开源。不改变任何功能只让你的代码更优雅、更易读、更可维护。一、code-simplifier 是什么code-simplifier是 Anthropic 官方开源的 Claude Code 插件——同一个工具Claude Code 团队自己每天都在用。它的定位非常纯粹在不改变代码功能的前提下简化代码实现提升清晰度、一致性和可维护性。用 Boris ChernyAnthropic 工程师的话说“We just open sourced the code-simplifier agent we use on the Claude Code team. Ask Claude to use the code simplifier agent at the end of a long coding session, or to clean up complex PRs.”核心原则一条铁律Never changes code functionality — only changes implementation.所有原始特性、输出和行为保持不变。它只关心怎么写不关心写什么。底层规格属性说明类型Claude Code 官方 Plugin / Agent底层模型Claude Opus最强推理能力工具集Read、Edit、Glob、Grep规则数量45 条重构规则分 8 大类别上下文自动读取项目CLAUDE.md 近期git diff策略迭代式重构一次聚焦一个问题二、三大安装方式方式一命令行安装推荐claude plugininstallcode-simplifier方式二在 Claude Code 会话中安装/plugin marketplace update claude-plugins-official /plugininstallcode-simplifier方式三社区版 Skill 安装更灵活如果你想把它当 Skill 用而不是 Agentnpx-yskillsaddpproenca/dot-skills--skillcode-simplifier--agentclaude-code或者手动下载mkdir-p~/.claude/skills/code-simplifier-pproenca-dot-skillscurl-Lhttps://claudskills.com/skills/code-simplifier-pproenca-dot-skills/SKILL.md\-o~/.claude/skills/code-simplifier-pproenca-dot-skills/SKILL.md安装路径macOS/Linux~/.claude/skills/code-simplifier/Windows%USERPROFILE%\.claude\skills\code-simplifier\安装完成后Claude Code 会在下次启动时自动发现它。三、如何使用四种实战场景场景 1长时间编码后一键清理最常用写完一个功能模块后让 code-simplifier 帮你回头看请用 code-simplifier 清理我们今天修改的代码或英文Run the code-simplifier agent on the changes we made todayClaude 会自动分析所有最近修改的文件并一次性完成清理。场景 2提交 PR 前的质量把关在创建 Pull Request 前确保代码符合质量标准用 code-simplifier 检查并优化这些变更然后再创建 PR英文Use the code-simplifier to review and clean up these changes before we create the PR场景 3重构后的规范化当你刚完成跨多个文件的大型重构需要确保模式一致性用 code-simplifier 统一我们刚重构文件中的代码模式英文Use code-simplifier to normalize the patterns in the files we just refactored场景 4指定模块清理针对特定文件或目录用 code-simplifier 处理我刚写的 auth 模块英文Use code-simplifier on the auth module I just built技术调用方式进阶由于 code-simplifier 本质是一个 Agent 而非传统 Skill正确的调用方式是通过Task Tool{subagent_type:code-simplifier:code-simplifier}而不是通过 Skill tool那样会报 “Unknown skill” 错误。四、它到底能做什么五大核心能力1. 保留功能铁律这是 code-simplifier 的第一原则绝不改变功能。所有原始特性、输出和行为完全保持不变只改实现方式不改业务逻辑运行后会自动验证功能未受损2. 遵循项目标准自动读取并遵循项目的编码规范项目根目录的CLAUDE.md—— 最高优先级.cursor/rules/*.md、.cursorrulesAGENTS.md、.github/copilot-instructions.md.editorconfig、.prettierrc、.eslintrc.*这意味着你的团队规范定义得越清晰code-simplifier 的表现就越好。3. 提升清晰度减少不必要的复杂度和嵌套消除冗余代码和过度抽象优化变量和函数命名合并相关逻辑移除描述明显代码的无用注释避免嵌套三元运算符—— 改用 switch 或 if/else 链选择清晰而非简洁—— 显式代码优于过度紧凑的代码4. 保持平衡不过度简化code-simplifier 很聪明知道什么不该做不会为了简化而牺牲代码清晰度不会创造过于 clever 的难以理解的方案不会将太多关注点塞进单个函数不会移除有助于代码组织的抽象不会为了行数更少而牺牲可读性5. 专注近期修改默认只关注最近修改的代码通过git diff/git status识别除非你显式指定其他范围。这使得它运行速度快不浪费 token精准定位需要清理的代码不影响已经稳定的旧代码五、45 条重构规则速览8 大类别code-simplifier 内置了 45 条重构规则按优先级和影响范围分为 8 大类类别优先级规则示例上下文发现Critical读取 CLAUDE.md了解项目标准行为保留Critical功能不变性验证、测试通过确认作用域管理High变量作用域最小化、减少全局依赖控制流优化High扁平化嵌套、early return、避免嵌套三元命名规范Medium清晰命名、统一命名风格死代码清理Medium移除未使用的变量、函数、导入重复消除Medium提取公共逻辑遵循三次重复才提取原则语言惯用法Low遵循各语言的最佳实践和惯用模式六、实战前后对比示例 1嵌套三元运算符 → 清晰条件链清理前conststatususer.active?user.verified?active-verified:active-unverified:user.suspended?suspended:inactive;清理后functiongetUserStatus(user){if(user.suspended)returnsuspended;if(!user.active)returninactive;returnuser.verified?active-verified:active-unverified;}conststatusgetUserStatus(user);示例 2复杂条件 → 提前返回清理前functionprocessOrder(order){if(order){if(order.itemsorder.items.length0){if(order.paymentStatuspaid){returnfulfillOrder(order);}else{thrownewError(Payment not completed);}}else{thrownewError(Order has no items);}}else{thrownewError(Invalid order);}}清理后functionprocessOrder(order){if(!order)thrownewError(Invalid order);if(!order.items?.length)thrownewError(Order has no items);if(order.paymentStatus!paid)thrownewError(Payment not completed);returnfulfillOrder(order);}七、最佳实践与注意事项五个最佳实践定期运行—— 不要等代码变乱才想起来用每次重要编码会话后跑一遍审查变更—— code-simplifier 很强但不是绝对可靠提交前务必 review 它的改动配置好 CLAUDE.md—— 编码标准定义得越清晰效果越好配合版本控制—— 在 git 跟踪的目录中运行方便对比和回滚与其他工作流结合—— 与 Plan mode、code-review agent、test runner 配合使用三个注意事项它不是 Skill是 Agent—— 需要通过 Task tool 或自然语言调用不能通过/code-simplifier调用社区版 Skill 可以Token 成本—— 需要重新处理已生成的代码建议选择性使用不要对每个小改动都跑运行前提交代码—— 这样方便对比和回滚git checkout -- file八、支持的语言code-simplifier 支持所有主流编程语言特别擅长TypeScript / JavaScript—— 前端/全栈首选Python—— 数据科学、后端开发Go—— 云原生、后端服务Rust—— 系统编程Java—— 企业级应用社区还贡献了框架专属版本Laravel/PHPlaravel-simplifierlaravelRustMCP marketplace 上的 Rust 专用变体九、一句话总结code-simplifier 就像一位不知疲倦的代码洁癖专家——它不会帮你写新功能但会让你的每一行代码都干净利落。在 AI 辅助编程的时代它的价值愈发明显AI 生成的代码往往倾向于过度完备而 code-simplifier 就是专门来消除这种冗余的。记住这个黄金时机每当你完成一个功能、准备提交 PR、或者结束一次长编码会话时——“Run the code-simplifier.”参考资源Anthropic 官方插件仓库Claude Code 官方文档 - SkillsClaude Code Agent SDKClaudSkills 社区注册表