AI 写代码有个通病:第一版能跑,但往往绕——嵌套三元、冗余抽象、过度紧凑的一行流。人类工程师会回头"收拾"代码,AI 通常不会。claude-plugins-official 里的 code-simplifier Agent 把"收拾"这件事自动化了:在严格保持功能不变的前提下简化与精炼近期修改过的代码——降嵌套、去冗余、提清晰度,同时警惕"过度简化"。本文按"定位 → 简化原则 → 项目标准 → 提示词工艺 → 总结"拆解这份官方 Agent 定义。
1、定位:功能不变前提下的精炼专家
提示词开篇定义人设:"expert code simplification specialist……在保持精确功能的前提下增强代码的清晰度、一致性与可维护性",并点明立场——优先可读、显式的代码,而非过度紧凑的方案,这是"多年专家工程师"拿捏的平衡。
两个关键设定值得注意。第一是 frontmatter 里的 model: opus——不像同系列其他 Agent 用 inherit 跟随宿主,这个 Agent 硬指定 Opus 档模型,简化判断需要更强的代码理解力,官方直接把模型档位写死。第二是作用域约定:默认只精炼近期修改过的代码,除非明确指示扩大范围——避免对整个代码库动刀引发大面积 diff。
它还被设定为自主且主动:代码写完或改完后立即精炼,不需要用户显式请求。这与其他"被叫来评审"的 Agent 形成对比——simplifier 是流水线的一环,不是一道关卡。
2、五条简化原则
提示词主体给出五条原则,每条带具体操作项。
- 保持功能——绝不改变代码做什么,只改变怎么做;所有原始特性、输出与行为必须原样保留。这条排在第一位且措辞最重,是整个 Agent 的安全底线
- 应用项目标准——遵循 CLAUDE.md 确立的编码规范:ES modules 加正确的 import 排序与扩展名、优先
function关键字而非箭头函数、顶层函数显式返回类型注解、React 组件显式 Props 类型、合理错误处理模式(尽量避免 try/catch)、一致的命名约定 - 增强清晰度——降低不必要的复杂度与嵌套、消除冗余代码与抽象、用清晰的变量函数名提升可读性、合并相关逻辑、删除复述显而易见代码的注释;明确禁止嵌套三元运算符——多条件场景优先 switch 或 if/else 链;选择清晰而非简短,显式代码常常优于过度紧凑
- 保持平衡——警惕过度简化:降低可读性、制造难以理解的"聪明"方案、把过多关注点塞进单个函数或组件、删掉有利于组织的合理抽象、为"少几行"牺牲可读性(嵌套三元、密集一行流)、让代码更难调试或扩展
- 聚焦范围——只精炼当前会话修改或触碰过的代码,除非明确要求更大范围
第三、四条构成一对张力:一条推着往简单走,一条拉着别过头。提示词没有给抽象的"度",而是用具体反例划界——嵌套三元、密集一行流这类东西被双向点名。
3、精炼流程
工作流程六步:识别近期修改的代码段 → 分析可提升优雅性与一致性的机会 → 应用项目最佳实践与编码规范 → 确认功能完全未变 → 验证精炼后的代码更简单、更可维护 → 只记录影响理解的重大变更。
最后一步有细节:只记录显著变更——不是每次微调都写说明,只对"影响理解"的改动做记录。这与自主运行的设定配套:Agent 在后台持续精炼,噪音必须压到最低,人类只在真正需要知道的地方被通知。
值得注意的是流程里没有"跑测试验证"环节——功能保持的验证责任交给了宿主环境(Claude Code 会话里的测试工具链),这个 Agent 只做代码变换本身,职责边界干净。
4、提示词工艺
写死模型档位。model: opus 是五份官方 Agent 定义里唯一硬指定模型的——简化看似简单,实则要求模型同时理解代码意图、副作用边界与项目规范,判断力不足的模型容易"简化出 bug"。这个 frontmatter 决策本身就是一份经验:给重判断力的子任务配重模型。
项目规范内嵌。第二条原则里的 ES modules、function 关键字等具体约定,显然源自某个真实项目的 CLAUDE.md——官方没有把它抽象成"遵循你的项目规范"一句话,而是直接写出可执行的条目。代价是这套约定偏 TypeScript/React 项目,用在其他栈上需要在 CLAUDE.md 里覆盖;收益是零配置即可跑,条目化的规则对模型的约束力远强于抽象指令。
反模式清单划界。"过度简化"是最难教的边界,提示词的办法是列反例:聪明方案、关注点堆叠、删有用抽象、为行数牺牲可读——模型对具体反例的识别远比领会抽象原则可靠,这与 comment-analyzer 的反面清单手法一致,是官方提示词的通用工艺。
5、总结
code-simplifier 是 Claude Code 官方插件市场里的代码精炼 Agent:五条原则(保功能 / 项目标准 / 增清晰 / 守平衡 / 限范围)构成约束框架,嵌套三元禁令与一行流反例划出具体红线,model: opus 写死重模型档,默认聚焦近期修改、自主运行、只记录重大变更——一个嵌入开发流水线的"自动收拾代码"环节。
它适合 AI 辅助开发的日常场景:让 Agent 写完代码后自动精炼一遍,人再接手;或在提交前手动点名"简化这段"。边界方面:功能保持依赖宿主测试兜底,重要变更仍需人工过目;内嵌项目规范偏 TypeScript/React,其他技术栈要在 CLAUDE.md 里补自己的约定,否则它可能把 Java 的 checked exception 或 Python 的 EAFP 风格"简化"掉;"近期修改"的判定依赖会话上下文,跨会话的历史代码需要显式圈定范围。对于"AI 写的代码要不要人再收拾一遍"这个高频痛点,这份官方提示词给出的答案是:让另一个 Opus 收拾,人只看 diff。


