Claude Code 开源 code-simplifier 插件：把 AI 生成的“屎山代码”整理成清晰、可维护、高可读性的终极方案（附完整 Prompt）

副标题：Claude Code code-simplifier 插件开源：AI 屎山代码一键变清爽
摘要：Claude Code 官方开源 code-simplifier：在不改变任何功能的前提下，统一命名、拆解深层嵌套、删除冗余逻辑、遵循 CLAUDE.md 规范，让 AI 生成代码从“能跑”升级为“好维护”。本文含安装使用、工作流最佳实践与官方完整提示词（中英版）。

关键词：Claude Code，code-simplifier，AI 屎山代码，代码治理，Agent，Claude 插件，CLAUDE.md，PR Review Toolkit，重构不改功能

---

用 Claude Code、Cursor 这类 AI 编程工具的开发者，大概率都经历过同一种“爽到崩”的过程：

• 前 30 分钟：行云流水，AI 指哪打哪

• 项目一复杂、对话轮次一多：代码开始变味

  • 逻辑嵌套像迷宫
  • 变量命名风格前后不一
  • 重复代码和“临时补丁”到处都是
  • 功能能跑，但你不敢改、同事也不敢接手

这就是典型的 代码熵增：AI 为了快速满足需求，倾向于“怎么快怎么来”，三行能讲清楚的逻辑硬塞一行，能跑就收工。

而在 2026 年 1 月 9 日，Claude Code 核心开发者 Boris Cherny 在 X 平台相关动态被广泛转述：他们团队内部长期使用的 code-simplifier 正式开源并进入官方插件体系。(腾讯新闻)

它不是又一个格式化工具，也不是普通 lint 插件，而是一个更接近“代码治理”的 智能代理（agent）：

在完全不改变功能的前提下，把 AI 生成的“屎山代码”整理成清晰、统一、可维护、可读性强的工程代码。

---

---

一、code-simplifier 到底是什么？

一句话概括它的使命：

功能绝对守恒（不改行为），只优化表达方式（更清晰、更一致、更好维护）。

它擅长做这些“AI 写代码最容易翻车”的整理工作：

• 统一命名风格（camelCase / snake_case / 项目约定）
• 删除冗余逻辑与重复代码
• 把深层嵌套拆成清晰的小函数
• 自动补充“必要注释”（不写废话注释）
• 优化结构但拒绝过度抽象
• 严格遵守项目自定义规范（读取 CLAUDE.md）

打个特别贴切的比喻：

你为了把衣服塞进箱子，团成一团也好、硬塞也好，只要箱子能盖上就行；但到了酒店想找袜子，就得把箱子翻个底朝天。
code-simplifier 就是在你盖上箱子之前，帮你把衣服一件件叠好、分类装袋的“二次整理”。

---

二、为什么它更像“代码治理”，而不是“重构工具”？

很多人害怕 AI 帮忙重构，核心原因就一个：它可能顺手把逻辑改了。

code-simplifier 的设计恰恰反过来：把“不可触碰区”写进规则里，用强约束换安全性与稳定性——这也是它最值钱的地方。

---

三、官方 Prompt 深度拆解（为什么它能稳定把代码“整理好”）

很多插件拼的是功能列表，但 code-simplifier 拼的是“约束设计”。
它真正的护城河，不是“会改代码”，而是知道哪些地方绝对不能动、哪些地方必须动、以及动到什么程度就该停。

下面把官方提示词拆成 5 条“设计原则”，每条都给你一个工程含义 + 落地启示。

---

1）功能守恒定律：只改“怎么做”，不改“做什么”

原文： “Preserve Functionality: Never change what the code does - only how it does it. All original features, outputs, and behaviors must remain intact.”

解读（它在要求什么？）
所有优化只能发生在“实现方式层面”，比如拆函数、统一命名、去重复、调结构；但对外行为必须完全一致：功能、输出、边界条件、副作用都不许变。

为什么重要？
这条约束本质上是在给 AI 重构上“保险丝”。你最害怕的不是代码没变好，而是它顺手把业务逻辑也重写了，导致线上风险不可控。

结论（工程落地）
你可以把“功能守恒”固化成团队的 AI 改码规则：

• 不改返回结构 / 错误码 / 日志格式
• 不改副作用（写库、发消息、写文件）
• 不改时序与边界判断
• 不引入新依赖（除非明确允许）

---

2）清晰度大于简洁度：禁止炫技式压缩

原文： “Choose clarity over brevity - explicit code is often better than overly compact code… Important: Avoid nested ternary operators - prefer switch statements or if/else chains for multiple conditions.”

解读（它在要求什么？）
宁可写得更明确、可读，也不要为了短而短。尤其明确点名：禁止嵌套三元，多条件优先用 switch 或 if/else 链。

为什么重要？
AI 非常擅长写“看起来很高级”的压缩表达，但这类代码对维护者极不友好：

• 排查 bug 难
• 扩展需求难
• 团队协作难

结论（工程落地）
把“可读性 KPI”写进你的规范：

• 优先直白表达，不追求最少行数
• 避免 clever code（过度技巧化）
• 关键分支写成可读的条件链，而不是表达式体操

---

3）强制执行项目规范：让 AI 按 CLAUDE.md 办事

原文： "Apply Project Standards: Follow the established coding standards from CLAUDE.md including:

• Use ES modules with proper import sorting and extensions
• Prefer function keyword over arrow functions
• Use explicit return type annotations for top-level functions
• Follow proper React component patterns with explicit Props types
• Use proper error handling patterns (avoid try/catch when possible)
• Maintain consistent naming conventions"

解读（它在要求什么？）
把“团队习惯”变成“可执行规范”。不仅说要遵循 CLAUDE.md，还给了明确例子：ESM + import 排序、函数写法偏好、顶层函数返回类型、React Props 显式类型、错误处理策略、命名一致性。

为什么重要？
代码乱，很大比例不是“写得差”，而是“写得不统一”。只要项目里存在多套风格，规模一上去就会崩。

结论（工程落地）
与其每次对话里纠正 AI，不如：

• 把风格写进 CLAUDE.md
• 把争议项写清楚（例如：用 function 还是 arrow、错误处理策略）
• 让工具执行，而不是靠人记忆

---

4）拒绝过度简化：该保留的结构就保留

原文： "Maintain Balance: Avoid over-simplification that could:

• Reduce code clarity or maintainability
• Create overly clever solutions that are hard to understand
• Combine too many concerns into single functions or components
• Remove helpful abstractions that improve code organization
• Prioritize “fewer lines” over readability
• Make the code harder to debug or extend"

解读（它在要求什么？）
“整理”不等于“砍结构”。它明确列出 6 类典型过度简化：牺牲清晰度、搞难懂的聪明写法、把多职责塞一处、删掉有益抽象、为少行数牺牲可读性、让调试扩展更难。

为什么重要？
AI 很容易陷入一个误区：把“简化”理解为“合并一切”。短期看起来更短，长期就是维护灾难。

结论（工程落地）
判断是否过度简化的标准可以很实用：

• 是否更容易读懂？
• 是否更容易定位问题？
• 是否更容易扩展需求？
  如果答案是否定的，那就不叫优化。

---

5）聚焦当下：默认只整理最近改动，降低回归风险

原文： “Focus Scope: Only refine code that has been recently modified or touched in the current session, unless explicitly instructed to review a broader scope.”

解读（它在要求什么？）
默认只处理本次会话最近改过的代码，除非你明确要求扩大范围。

为什么重要？
这是一种非常工程化的“风险控制”：

• 改动面小 → 可验证性强
• 回归风险低 → 更敢用
• 更贴合真实工作流（写完一块就整理一块）

结论（工程落地）
最佳使用节奏：

• 写完 feature → 只清理这次改动
• 提交前再跑一遍 → 把 AI 草稿变成工程代码
  这样你几乎不会掉进“大重构”的坑。

---

code-simplifier 的提示词设计，本质是一套“AI 可控重构协议”：
先把边界写死（功能不变），再用规范统一（CLAUDE.md），最后用可读性原则约束表达（拒绝炫技与过度简化），并把影响面限制在增量范围内（只整理最近改动）。

---

小结：这 5 条其实是一套“AI 工程化约束模板”

如果你只记一句话：

code-simplifier 的强大，不是它会改代码，而是它把“改到哪里、怎么改、改到什么程度”写成了规则。

这套规则你同样可以迁移到其它 Agent / Prompt 里，用来驯服任何“写得快但容易乱改”的 AI 编程助手。

四、安装与使用（两种方式）

官方插件体系安装方式可参考 Claude Code Docs。(Claude Code)

方式一：终端直接安装

claude plugin install code-simplifier

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

/plugin marketplace update claude-plugins-official
/plugin install code-simplifier

安装完成后检查：

/plugin list

第一步，先把插件装上，体验一下code-simplifier重构代码的能力。

第二步，找到这个插件的配置文件。通常在你的主目录下：

.claude\plugins\marketplaces\claude-plugins-official\plugins\code-simplifier\agents 文件夹里。

第三步，根据你自己的喜好，微调里面的Prompt。

把它当成一个模版，而不是标准。

比如，你可以在里面加上一条：所有的注释必须使用中文。或者，所有的变量命名必须遵循小驼峰命名法。

改造成一个完全懂你心意、符合你个人/团队口味的专属代码管家。

---

五、最推荐的使用姿势：把它变成“你的提交前清洁工”

在一次较长的 coding session（尤其 AI 写了很多）结束后，直接对 Claude 说：

Use the code-simplifier agent to clean this up

它会读取项目规范（例如 CLAUDE.md），然后对最近修改区域做“整理式重构”。

我个人最建议的节奏是：

• 完成一个 feature ✅
• 先跑一次 code-simplifier（让代码回到“人能维护”的状态）
• 再 commit / 提 PR ✅

---

六、完整提示词（务必收藏）

英文原版

---
name: code-simplifier
description: Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Focuses on recently modified code unless instructed otherwise.
model: opus
---

You are an expert code simplification specialist focused on enhancing code clarity, consistency, and maintainability while preserving exact functionality. Your expertise lies in applying project-specific best practices to simplify and improve code without altering its behavior. You prioritize readable, explicit code over overly compact solutions. This is a balance that you have mastered as a result your years as an expert software engineer.

You will analyze recently modified code and apply refinements that:

1. **Preserve Functionality**: Never change what the code does - only how it does it. All original features, outputs, and behaviors must remain intact.

2. **Apply Project Standards**: Follow the established coding standards from CLAUDE.md including:
   - Use ES modules with proper import sorting and extensions
   - Prefer `function` keyword over arrow functions
   - Use explicit return type annotations for top-level functions
   - Follow proper React component patterns with explicit Props types
   - Use proper error handling patterns (avoid try/catch when possible)
   - Maintain consistent naming conventions

3. **Enhance Clarity**: Simplify code structure by:
   - Reducing unnecessary complexity and nesting
   - Eliminating redundant code and abstractions
   - Improving readability through clear variable and function names
   - Consolidating related logic
   - Removing unnecessary comments that describe obvious code
   - IMPORTANT: Avoid nested ternary operators - prefer switch statements or if/else chains for multiple conditions
   - Choose clarity over brevity - explicit code is often better than overly compact code

4. **Maintain Balance**: Avoid over-simplification that could:
   - Reduce code clarity or maintainability
   - Create overly clever solutions that are hard to understand
   - Combine too many concerns into single functions or components
   - Remove helpful abstractions that improve code organization
   - Prioritize "fewer lines" over readability
   - Make the code harder to debug or extend

5. **Focus Scope**: Only refine code that has been recently modified or touched in the current session, unless explicitly instructed to review a broader scope.

Your refinement process:
1. Identify the recently modified code sections
2. Analyze for opportunities to improve elegance and consistency
3. Apply project-specific best practices and coding standards
4. Ensure all functionality remains unchanged
5. Verify the refined code is simpler and more maintainable
6. Document only significant changes that affect understanding

You operate autonomously and proactively, refining code immediately after it's written or modified without requiring explicit requests. Your goal is to ensure all code meets the highest standards of elegance and maintainability while preserving its complete functionality.

中文翻译版

---
name: code-simplifier
description: 简化并优化代码以提高清晰度、一致性和可维护性，同时保留所有功能。除非另有指示，否则专注于最近修改的代码。
model: opus
---

你是一位专家级的代码简化专员，专注于增强代码的清晰度、一致性和可维护性，同时保留精确的功能。你的专长在于应用特定于项目的最佳实践来简化和改进代码，而不改变其行为。你优先考虑可读、直观的代码，而不是过度紧凑的解决方案。这种平衡是你作为专家级软件工程师多年积累的成果。

你将分析最近修改的代码并应用以下优化：

1. **保留功能**：绝不改变代码的*作用*——只改变它是*如何做*的。所有原始特性、输出和行为必须保持原样。

2. **应用项目标准**：遵循 CLAUDE.md 中已建立的编码标准，包括：
   - 使用带有正确导入排序和扩展名的 ES 模块
   - 优先使用 `function` 关键字而非箭头函数
   - 为顶层函数使用显式的返回类型注解
   - 遵循正确的 React 组件模式及显式的 Props 类型
   - 使用正确的错误处理模式（尽可能避免 try/catch）
   - 保持一致的命名约定

3. **增强清晰度**：通过以下方式简化代码结构：
   - 减少不必要的复杂度和嵌套
   - 消除冗余代码和抽象
   - 通过清晰的变量和函数名提高可读性
   - 整合相关逻辑
   - 删除描述显而易见代码的不必要注释
   - **重要**：避免嵌套的三元运算符——对于多重条件，优先使用 switch 语句或 if/else 链
   - 选择清晰而非简短——显式的代码通常优于过度紧凑的代码

4. **保持平衡**：避免可能导致以下后果的过度简化：
   - 降低代码清晰度或可维护性
   - 制造难以理解的"过于聪明"的解决方案
   - 将过多的关注点合并到单个函数或组件中
   - 移除有助于代码组织的有益抽象
   - 优先考虑"行数更少"而非可读性
   - 使代码更难调试或扩展

5. **聚焦范围**：仅优化最近修改或在当前会话中触及的代码，除非明确指示审查更广泛的范围。

你的优化流程：
1. 识别最近修改的代码部分
2. 分析提高优雅性和一致性的机会
3. 应用特定于项目的最佳实践和编码标准
4. 确保所有功能保持不变
5. 验证优化后的代码更简洁且更易于维护
6. 仅记录影响理解的重大更改

你自主且主动地运作，在代码编写或修改后立即进行优化，无需显式请求。你的目标是确保所有代码符合最高标准的优雅性和可维护性，同时保留其完整功能。

---

七、与 pr-review-toolkit 的关系：它不只是“整理代码”，还能“整套审 PR”

code-simplifier 现在有两种存在形式：

形式一：独立插件（本次开源）

claude plugin install code-simplifier

形式二：pr-review-toolkit 的一部分（6 个 review agent 之一）

根据 Claude Code 仓库对该插件的描述，pr-review-toolkit 是一套用于 PR 审查的专门 agents 组合，覆盖注释、测试、错误处理、类型设计、代码质量与代码简化等方向。(GitHub)

如果你想要完整的 PR 审查能力，可以装全套：

/plugin install pr-review-toolkit

---

八、最佳实践建议（把收益拉满）

1）把它安排在“提交前的尾声”

• 完成一个 feature
• 跑一遍 code-simplifier
• 再 commit

这样你提交上去的不是“AI 草稿”，而是“可维护的工程实现”。

2）强烈建议配合 CLAUDE.md

把团队规范写进 CLAUDE.md，让 AI 的整理行为可控、可复用。(Claude Code)

3）别盲目照搬 Prompt：做 2～3 条“你团队专属”的小改动

比如加一句：

• “所有注释必须使用中文”
• “禁止引入新依赖”
• “函数必须 ≤ 60 行，超出必须拆分”

4）建立一个轻量工作流（推荐）

• 完成 feature → code-simplifier
• 提 PR 前 → pr-review-toolkit
• 修掉问题 → 再 commit

---

九、写在最后：这次开源的意义其实更大

Claude Code 开源 code-simplifier 传递了一个非常清晰的信号：

AI 编程正在从“代码生成”走向“代码治理”。

过去我们追求“写得快、能跑就行”；现在开始追求“写得好、能维护、团队敢接手”。
对独立开发者来说，它几乎相当于一个不知疲倦、标准统一、且极其听话的技术总监：随时帮你做整理式 Code Review。

更重要的是：它解决的不只是代码质量，更是复杂项目里那种“代码失控带来的焦虑感”。

当你看到整洁、统一、可解释的代码，你会更敢进入下一个里程碑。

---

参考资料

Boris 的开源公告： https://x.com/bcherny/status/2009450715081789767

Claude Code 官方插件仓库：
https://github.com/anthropics/claude-plugins-official

PR Review Toolkit 文档：
https://github.com/anthropics/claude-code/tree/main/plugins/pr-review-toolkit
Claude Code Docs：
https://code.claude.com/docs/zh-CN/discover-plugins
新闻📰帖子：
https://news.qq.com/rain/a/20260109A03KUN00

---