核心原则：一条铁律

Never changes code functionality — only changes implementation.

所有原始特性、输出和行为保持不变。它只关心"怎么写"，不关心"写什么"。

底层规格

二、三大安装方式

方式一：命令行安装（推荐）

方式二：在 Claude Code 会话中安装

方式三：社区版 Skill 安装（更灵活）

如果你想把它当 Skill 用，而不是 Agent：

或者手动下载：

安装路径：

• macOS/Linux：~/.claude/skills/code-simplifier/
• Windows：%USERPROFILE%\.claude\skills\code-simplifier\

安装完成后，Claude Code 会在下次启动时自动发现它。

三、如何使用？四种实战场景

场景 1：长时间编码后一键清理（最常用）

写完一个功能模块后，让 code-simplifier 帮你"回头看"：

或英文：

Claude 会自动分析所有最近修改的文件，并一次性完成清理。

场景 2：提交 PR 前的质量把关

在创建 Pull Request 前，确保代码符合质量标准：

英文：

场景 3：重构后的规范化

当你刚完成跨多个文件的大型重构，需要确保模式一致性：

英文：

场景 4：指定模块清理

针对特定文件或目录：

英文：

技术调用方式（进阶）

由于 code-simplifier 本质是一个 Agent 而非传统 Skill，正确的调用方式是通过 Task Tool：

而不是通过 Skill tool（那样会报 “Unknown skill” 错误）。

四、它到底能做什么？五大核心能力

1. 保留功能（铁律）

这是 code-simplifier 的第一原则：绝不改变功能。

• 所有原始特性、输出和行为完全保持不变
• 只改实现方式，不改业务逻辑
• 运行后会自动验证功能未受损

2. 遵循项目标准

自动读取并遵循项目的编码规范：

• 项目根目录的 CLAUDE.md —— 最高优先级
• .cursor/rules/*.md、.cursorrules
• AGENTS.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 大类：

六、实战前后对比

示例 1：嵌套三元运算符 → 清晰条件链

清理前：

清理后：

示例 2：复杂条件 → 提前返回

清理前：

清理后：

七、最佳实践与注意事项

五个最佳实践

1. 定期运行 —— 不要等代码变乱才想起来用，每次重要编码会话后跑一遍
2. 审查变更 —— code-simplifier 很强，但不是绝对可靠，提交前务必 review 它的改动
3. 配置好 CLAUDE.md —— 编码标准定义得越清晰，效果越好
4. 配合版本控制 —— 在 git 跟踪的目录中运行，方便对比和回滚
5. 与其他工作流结合 —— 与 Plan mode、code-review agent、test runner 配合使用

三个注意事项

1. 它不是 Skill，是 Agent —— 需要通过 Task tool 或自然语言调用，不能通过 /code-simplifier 调用（社区版 Skill 可以）
2. Token 成本 —— 需要重新处理已生成的代码，建议选择性使用，不要对每个小改动都跑
3. 运行前提交代码 —— 这样方便对比和回滚：git checkout -- <file>

八、支持的语言

code-simplifier 支持所有主流编程语言，特别擅长：

• TypeScript / JavaScript —— 前端/全栈首选
• Python —— 数据科学、后端开发
• Go —— 云原生、后端服务
• Rust —— 系统编程
• Java —— 企业级应用

社区还贡献了框架专属版本：

• Laravel/PHP：laravel-simplifier@laravel
• Rust：MCP marketplace 上的 Rust 专用变体

九、一句话总结

code-simplifier 就像一位不知疲倦的代码洁癖专家——它不会帮你写新功能，但会让你的每一行代码都干净利落。在 AI 辅助编程的时代，它的价值愈发明显：AI 生成的代码往往倾向于"过度完备"，而 code-simplifier 就是专门来消除这种冗余的。

记住这个黄金时机： 每当你完成一个功能、准备提交 PR、或者结束一次长编码会话时——

“Run the code-simplifier.”