AI 插件开发工具插件系统【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址https://gitcode.com/GitHub_Trending/cl/claude-plugins-official点击查看免费下载本篇技术指南聚焦于claude-plugins-official仓库中plugins/code-simplifier插件的核心 Agent 定义文件 agents/code-simplifier.md完整拆解其作为代码简化专家的设计哲学、五项精炼原则、六步执行流程与自主触发机制。读完本文你将理解 Anthropic 官方如何在插件体系中构建一个只改写法、不改行为的代码精炼 Agent并掌握将其移植到自身 Claude Code 工作流或自行编写同类 Agent 的完整方法。一、插件与 Agent 的定位它是什么code-simplifier是仓库plugins/目录下的内部插件由 Anthropic 维护目录结构极简仅包含两个文件plugins/code-simplifier/ ├── agents/ │ └── code-simplifier.md # Agent 定义本文核心 └── LICENSE # Apache License 2.0与仓库根 README.md 描述的插件标准结构一致——插件可以包含commands/斜杠命令、agents/Agent 定义、skills/技能定义等可选目录。code-simplifier插件走的是纯 Agent 路线不提供任何斜杠命令或 Skill而是通过 agents/code-simplifier.md 这个 Agent 定义文件来承载全部能力。该 Agent 的职责一句话可以概括在代码刚被写入或修改之后立即以项目既有规范为标准自动对最近改动的代码进行精炼simplify refine目标是提升清晰度、一致性与可维护性同时绝不改变任何功能行为。这种写完即精炼的定位与仓库中另一个以审查为主的插件 code-review 形成互补code-review 面向 Pull Request 的事后审查含 CLAUDE.md 合规审计、bug 扫描、git blame 历史分析等而 code-simplifier 面向当下正在写的代码在提交之前就把质量基线拉高。二、文件结构解析Frontmatter 与主体2.1 FrontmatterYAML 元数据--- 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 ---三个字段各有讲究name: code-simplifierAgent 的唯一标识符。对照仓库中 validate-agent.sh 的校验规则可知name 必须由字母、数字、连字符组成以字母数字开头和结尾长度 3–50 字符且不能是 helper/assistant/agent/tool 这类过于泛化的名字——code-simplifier完全合规。description模型触发时看到的摘要直接点明简化精炼代码以提升清晰度、一致性、可维护性同时保留全部功能默认聚焦最近修改的代码。model: opus指定由 Opus 模型承载该 Agent。这与验证脚本中合法的inherit|sonnet|opus|haiku取值集合一致validate-agent.sh说明官方刻意用最强模型来执行这种需要细腻平衡的代码改写任务。2.2 主体一段完整的第二人称系统提示词Frontmatter 之后是完整的系统提示词正文采用第二人称You are…直接对 Agent 下达指令这与仓库 system-prompt-design.md 强调的用第二人称编写系统提示词的规范完全一致。同时它延续了同目录下 agent-creation-system-prompt.md 所倡导的具体而非泛化、每个指令都要有增量价值的编写原则。三、五项核心精炼原则Agent 的行为宪法系统提示词将 code-simplifier 的行为约束为五个编号原则这是整个 Agent 设计最值得研读的部分原则 1Preserve Functionality保功能Never change what the code does - only how it does it. All original features, outputs, and behaviors must remain intact.这是全部原则的基石只允许改变怎么写不允许改变做什么。所有原有功能、输出和行为必须原样保留。这一条划定了精炼的绝对边界——一旦改写导致行为漂移这次精炼就是失败的。原则 2Apply Project Standards套用项目规范精炼不是凭个人口味而是以CLAUDE.md中沉淀的项目编码标准为准绳。文档列举了六条典型规范可视为一份示例性标准清单使用 ES modules导入排序规范且带正确的文件扩展名优先使用function关键字而非箭头函数顶层函数使用显式返回类型注解遵循规范的 React 组件模式Props 使用显式类型使用恰当的错误处理模式尽可能避免 try/catch保持一致的命名约定需要说明的是这六条是文档给出的默认示例其实际生效范围取决于目标项目CLAUDE.md中真正写入的标准——code-simplifier的职责是读取并服从项目标准而非发明标准。原则 3Enhance Clarity提升清晰度通过结构化手段让代码更易读降低不必要的复杂度与嵌套层级消除冗余代码与多余抽象用清晰的变量名、函数名提升可读性合并相关逻辑consolidating related logic删除描述显而易见行为的冗余注释IMPORTANT 级硬性要求禁止嵌套三元运算符——多条件分支优先使用 switch 语句或 if/else 链明确清晰优先于精简显式代码通常优于过度紧凑的代码这条原则把简化从玄学变成了可执行的检查清单尤其是禁止嵌套三元这条直接给出了可被机械执行的判别标准。原则 4Maintain Balance维持平衡防止过度简化过度简化同样是错误文档列出六种必须避免的过简化形态降低代码清晰度或可维护性制造难以理解的过于聪明的解法把过多关注点塞进单个函数或组件删除本有助于组织代码的合理抽象为了更少行数牺牲可读性如嵌套三元、密集单行让代码更难调试或扩展原则 3 与原则 4 构成一对张力既要简化又不能过度简化。这正是专家与机械工具的分水岭——Agent 需要在清晰度与表达力之间做出有判断力的取舍。原则 5Focus Scope聚焦范围Only refine code that has been recently modified or touched in the current session, unless explicitly instructed to review a broader scope.默认只精炼当前会话中最近修改或触碰过的代码除非用户明确要求扩大范围。这条原则把 Agent 的介入控制在刚刚产生的改动上避免它漫无目的地重写整个代码库——既控制了风险也保证了响应速度。四、六步精炼流程Refinement Process文档给出了可复现的执行流水线Identify识别最近修改的代码段Analyze分析改进优雅度与一致性的机会Apply套用项目专属最佳实践与编码标准Ensure确认所有功能保持不变Verify验证精炼后的代码确实更简单、更可维护Document仅记录影响理解的重要变更注意第 4、5 步形成行为不变 质量提升的双重验收第 6 步则刻意限定文档记录范围——只为影响理解的变更写说明避免为琐碎改动制造噪音。这套流程与 system-prompt-design.md 推荐的Responsibilities → Process → Quality Standards → Output Format → Edge Cases标准结构高度同构是官方设计模式的又一个实证。五、自主运行模式写完即精炼文档结尾明确了 Agent 的运行姿态You operate autonomously and proactively, refining code immediately after its written or modified without requiring explicit requests.也就是说code-simplifier 是一个自主、主动的 Agent它不需要用户喊帮我简化一下而是在代码被写出或修改后立即介入精炼。仓库中 pr-review-toolkit/agents/code-simplifier.md 提供了该 Agent 的一个带触发场景的扩展变体其中三个example给出了典型的自主触发时机可作为理解其使用场景的参考新功能实现完成后例如刚为/api/users端点实现了认证功能写完一个逻辑块后用 Task 工具拉起 code-simplifier 对实现做精炼Bug 修复补丁落地后例如刚通过若干条件判断修复了空指针异常修复完成后让 Agent 确认修复符合最佳实践、维持代码质量性能优化重构后例如刚优化完排序算法让 Agent 确保优化后的代码依然清晰可维护。这三个场景共同勾勒出 code-simplifier 的典型生命周期位置它站在代码产生与代码提交/审查之间充当一道自动化的质量整形工序。六、如何安装与使用面向当前仓库code-simplifier位于本仓库的plugins/Anthropic 内部维护插件区。按照根目录 README.md 的通用说明插件可通过 Claude Code 的插件系统直接从本 marketplace 安装/plugin install code-simplifierclaude-plugins-official或通过/plugin Discover浏览查找。安装后code-simplifierAgent 即可按上述自主触发模式在编码会话中工作——只要当前会话中产生了新的代码改动它就会主动执行识别→分析→套用规范→验证功能不变→确认更简单的完整流水线。用户也可以在需要时显式要求它处理更大范围如整个文件或整个模块突破默认的最近修改范围限制。若要把它当作模板学习或改造可以直接阅读 agents/code-simplifier.md 的全文参考 complete-agent-examples.md 中分析型/生成型 Agent的骨架写法并可用 validate-agent.sh 校验自己编写的 Agent 文件结构frontmatter 字段、系统提示词长度、第二人称、流程与输出格式检查等。七、设计启示从 code-simplifier 提炼的 Agent 编写要点综合全文与仓库佐证code-simplifier 代表了 Anthropic 官方编写自动代码精炼 Agent的一整套方法论把边界写进人格用只改写法、不改行为和不制造过度简化双向锁死行为边界避免 Agent 越界重写或反向破坏代码质量用项目标准代替个人口味精炼动作一律对齐CLAUDE.md中的既有规范ES modules、函数声明、显式类型、React Props 类型、错误处理模式、命名约定保证输出风格与团队一致给出可执行的硬规则如禁止嵌套三元运算符多条件用 switch/if-else——把模糊的更清晰翻译成可判定的规则默认小范围、可显式放大默认只处理最近修改显式指令才扩大范围控制风险与开销自主主动无需显式请求定位为写完代码即触发的自动化质量工序无缝嵌入正常开发流程双重验收每一步都要求功能未变与确实更简单可维护同时成立最后仅记录影响理解的重要变更。这正是 agent-creation-system-prompt.md 中为 Agent 建立清晰行为边界、提供具体方法论、预期边界情况并提供处理指引原则的落地范本——当你需要为自己的项目编写自动精炼/自动重构类 Agent 时code-simplifier 是可直接参考的官方级蓝本。赞分享AI 插件开发工具插件系统【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址https://gitcode.com/GitHub_Trending/cl/claude-plugins-official点击查看免费下载相关推荐Claude Code PR Review Toolkit 之 code-simplifier在保持功能不变的前提下自动化代码简化Claude Code PR Review Toolkit 之 code simplifier在保持功能不变的前提下自动化代码简化 本指南围绕 PR ReviAI 应用AI 技能/插件开发工具ECC 的 Code Simplifier Agent 工程化实践在保持行为不变的前提下安全重构代码ECC 的 Code Simplifier Agent 工程化实践在保持行为不变的前提下安全重构代码 本指南围绕仓库 agents/code simplifi人工智能AI 技能AI 插件AI 评测Agent 评测MCP Clients开发工具StarRocks url_extract_parameter 函数详解从 URL 查询串中提取参数值StarRocks url_extract_parameter 函数详解从 URL 查询串中提取参数值 url_extract_parameter 是 Sta数据库OLAP数据仓库大数据湖仓一体数据分析上一篇OBS多路推流插件怎么用一次配置多平台同步开播的完整上手教程下一篇Scroll Reverser 完整指南独立控制 macOS 触控板与鼠标滚动方向的终极方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考