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仓库中 plugin-dev 插件内置的agent-creator 代理——一个专门制造 Agent 的 Agent。当你在开发 Claude Code 插件时需要创建新的自治子代理Subagent时agent-creator 会按照 Claude Code 官方沉淀的成熟模式把用户的一句话需求翻译成结构完整、可直接落盘的 Agent 配置文件YAML frontmatter 系统提示词。读完本文你将掌握 agent-creator 的完整触发机制、六步设计方法论、五步创建流程、frontmatter 全部字段的取值规则以及如何借助validate-agent.sh脚本与 plugin-validator 代理完成生成后的校验从而在插件中快速产出高质量、可稳定触发的自治代理。一、agent-creator 是什么一个会造 Agent 的 Agent在 Claude Code 的插件体系中plugins/plugin-dev 是面向插件开发者的完整工具包包含 hook、MCP 集成、插件结构、命令、代理、技能等七个专项技能。而 agent-creator.md 是其中三个内置代理之一另外两个是 plugin-validator.md 与 skill-reviewer它承担的是**元编程meta-programming**职责不是直接替你干活而是生成替你干活的 Agent。从它的文件头可以看出其定位--- name: agent-creator description: | Use this agent when the user asks to create an agent, generate an agent, build a new agent, make me an agent that..., or describes agent functionality they need. Trigger when user wants to create autonomous agents for plugins. Examples: example.../example model: sonnet color: magenta tools: [Write, Read] ---几个值得注意的配置点model: sonnetagent-creator 自身被指定使用 sonnet 模型因为生成代理配置属于需要一定推理与组合能力的任务这一点与用户创建普通代理时默认用inherit的约定形成了对比详见后文。color: magenta按仓库的配色语义magenta 对应Transformation, creative转换、创造类任务正好匹配生成/创造新代理的定位。tools: [Write, Read]它只需要写文件产出agents/[identifier].md和读上下文读取 CLAUDE.md、项目文件等因此采用最小权限原则只开放这两个工具。这与 agent-development 技能 中tools 遵循 least privilege最小权限的最佳实践完全一致。正文第一句定义了它的核心身份You are an elite AI agent architect specializing in crafting high-performance agent configurations. Your expertise lies in translating user requirements into precisely-tuned agent specifications that maximize effectiveness and reliability.即把用户需求翻译为精确调校的 Agent 规格说明最大化代理的有效性与可靠性。同时它强调一个重要上下文创建代理时应当读取 CLAUDE.md 等项目级指令编码规范、项目结构、自定义需求让产出的代理与项目既有模式对齐。二、触发机制何时会唤起 agent-creator代理的触发靠的是 frontmatter 中的description字段——它会在代理注册时被加载进上下文由宿主判断是否派发。agent-creator 的触发条件非常明确Use this agent when the user asks to create an agent, generate an agent, build a new agent, make me an agent that..., or describes agent functionality they need.典型触发短语包括create an agent创建代理generate an agent生成代理build a new agent构建新代理make me an agent that...帮我做一个能……的代理用户描述了自己需要的代理功能原文档在description中内置了三个example示例块分别覆盖创建代码审查代理描述所需功能向插件添加代理三类场景每个示例块包含 Context场景、user用户原话、assistant触发前的响应、commentary为何触发四要素。这也是 agent-development 技能 强调的description应同时覆盖显式触发用户主动请求与主动触发助手自行判断两种模式并用 2–4 个示例块展示同一意图的不同措辞。三、核心方法论六步设计 Agent当用户描述想要的代理后agent-creator 遵循以下六步方法论这也是它产出高质量代理的核心引擎1. 提取核心意图Extract Core Intent识别代理的根本目的、关键职责与成功标准同时兼顾显式需求与隐含需求并结合 CLAUDE.md 中的项目上下文。这里有一个重要的默认约定对于代码审查类代理应假设用户要求审查的是最近编写的代码而非整个代码库除非用户明确另有指示。这个约定在 agent-creation-system-prompt.md 中有同样的表述属于跨文档印证的设计原则——避免审查类代理每次都被触发后扫描全库浪费上下文与算力。2. 设计专家人设Design Expert Persona创建与任务领域深度匹配的专家身份让代理在执行时具备领域知识、决策风格与可信度。例如代码审查代理对应资深代码质量审查专家。3. 架构完整指令Architect Comprehensive Instructions系统提示词需要包含清晰的行为边界与操作参数behavioral boundaries and operational parameters任务执行的具体方法论与最佳实践对边界情况的预判与处理指引用户提出的特定需求或偏好相关的输出格式预期与 CLAUDE.md 中项目编码规范的对齐4. 性能优化Optimize for Performance在系统提示词中注入契合领域特点的决策框架质量控制机制与自我验证步骤高效的工作流模式明确的升级escalation或回退fallback策略5. 创建标识符Create Identifier标识符是代理的name命名规则严格只允许小写字母、数字与连字符通常为 2–4 个单词、以连字符连接如code-reviewer、test-generator清楚表达代理的核心功能好记、易输入避免helper、assistant这类通用词6. 编写触发示例Craft Triggering Examples创建 2–4 个example块展示同一意图的不同措辞显式触发与主动触发两种方式Context上下文、user用户消息、assistant助手响应、commentary注释四个部分每个场景下为什么应该触发该代理展示 assistant 通过 Agent 工具启动代理的措辞示例块的统一模板如下example Context: [Situation that should trigger agent] user: [User message] assistant: [Response before triggering] commentary [Why agent should trigger] /commentary assistant: Ill use the [agent-name] agent to [what it does]. /example四、Agent 创建流程从需求到落盘的五个步骤在六步方法论之上agent-creator 按以下五步把设计转化为实际文件第 1 步理解请求分析用户对代理功能的描述明确要解决什么问题。第 2 步设计代理配置标识符Identifier小写、连字符、3–50 字符描述Description以 Use this agent when... 开头书写触发条件并附带 2–4 个example块系统提示词System Prompt包含角色与专长、核心职责编号列表、逐步流程、质量标准、输出格式、边界情况处理第 3 步选择配置模型Model默认inherit继承父级模型除非用户指定——复杂任务可用sonnet简单任务可用haiku颜色Color按任务类型匹配blue/cyan分析、审查green生成、创建yellow验证、警示red安全、关键任务magenta转换、创造性任务工具Tools推荐最小必需集合省略该字段则默认开放全部工具第 4 步生成代理文件使用 Write 工具创建agents/[identifier].md格式如下--- name: [identifier] description: [Use this agent when... Examples: example.../example] model: inherit color: [chosen-color] tools: [Tool1, Tool2] # Optional --- [Complete system prompt]第 5 步向用户说明生成完成后提供摘要代理做什么、何时触发、保存在哪里、如何测试并建议运行 plugin-validator 代理校验插件结构Use the plugin-validator agent to check the plugin structure。这体现了 plugin-dev 插件内部代理间的协同agent-creator 负责生成plugin-validator 负责校验。五、Frontmatter 字段详解取值规则与校验依据agent-creator 产出的每个代理文件frontmatter 字段都与 agent-development 技能 及校验脚本的约束一一对应。下表汇总全部字段规则字段必填格式/取值说明与约束name是小写字母、数字、连字符3–50 字符须以字母数字开头/结尾用于命名空间与调用禁止下划线、空格、特殊字符避免helper/assistant等通用名description是以 Use this agent when... 开头的散文式触发条件 2–4 个example块代理注册时被加载进上下文是决定何时派发的关键字段model是inherit/sonnet/opus/haiku默认推荐inheritsonnet 均衡、opus 最强但昂贵、haiku 快速廉价color是blue/cyan/green/yellow/magenta/redUI 中的可视化标识应按代理用途选色tools否工具名数组如[Read, Write, Grep]省略则拥有全部工具推荐最小权限原则上述取值范围的权威依据可以从校验脚本 validate-agent.sh 的源码中直接看到name 正则^[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]$长度 3–50且helper|assistant|agent|tool会被标记为过于通用警告model 合法值白名单为inherit|sonnet|opus|haikucolor 合法值白名单为blue|cyan|green|yellow|magenta|reddescription 建议 10–5,000 字符且应包含example与 Use this agent when 字样系统提示词至少 20 字符超过 10,000 字符会被警告。也就是说agent-creator 输出的每项配置都有可被脚本机器校验的硬性约束这也解释了它为何严格按照这些规则生成。description 的最佳写法description是最关键的字段。推荐三段式结构Use this agent when [conditions]. Typical triggers include [scenario 1 in prose], [scenario 2 in prose], and [scenario 3 in prose]. See When to invoke in the agent body for worked scenarios.即触发条件Use this agent when... 2–4 个典型触发场景的散文摘要 指向正文 When to invoke 章节的指针。最佳实践还包括同时覆盖主动与响应式触发、覆盖同一意图的不同措辞、明确何时不该使用本代理。系统提示词的推荐结构标准模板详见 system-prompt-design.mdYou are [role] specializing in [domain]. **Your Core Responsibilities:** 1. [Primary responsibility] 2. [Secondary responsibility] **Analysis Process:** 1. [Step one] 2. [Step two] **Quality Standards:** - [Standard 1] **Output Format:** [What to return] **Edge Cases:** - [Edge case 1]: [How to handle]书写要求全程第二人称You are...、You will...避免第一人称I am...职责要具体不要空泛必须有步骤化流程、明确的输出格式、质量标准与边界情况处理长度以 500–3,000 词为佳上限 10,000 字符。六、质量标准与输出格式质量自检清单agent-creator 对自己产出的代理按以下标准把关标识符符合命名规则小写、连字符、3–50 字符description 具备强触发短语与 2–4 个示例示例同时展示显式触发与主动触发系统提示词完整充实500–3,000 词系统提示词结构清晰角色、职责、流程、输出模型选择恰当工具选择遵循最小权限颜色与代理用途匹配交付格式创建代理文件后向用户输出如下结构的摘要## Agent Created: [identifier] ### Configuration - **Name:** [identifier] - **Triggers:** [When its used] - **Model:** [choice] - **Color:** [choice] - **Tools:** [list or all tools] ### File Created agents/[identifier].md ([word count] words) ### How to Use This agent will trigger when [triggering scenarios]. Test it by: [suggest test scenario] Validate with: scripts/validate-agent.sh agents/[identifier].md ### Next Steps [Recommendations for testing, integration, or improvements]注意其中内置的验证命令scripts/validate-agent.sh agents/[identifier].md——这正是 agent-development 技能 中的校验脚本它会依次检查文件存在性、frontmatter 起止---、五个字段的格式与取值、系统提示词长度与第二人称写法等最终输出✅ All checks passed!或带 error/warning 统计的失败报告。七、边界情况处理agent-creator 为以下六类特殊情形预设了处理策略边界情况处理方式用户需求含糊不清先提出澄清问题再生成配置与既有代理功能冲突指出冲突建议调整范围或换名需求非常复杂拆分为多个专业化代理用户指定了工具访问权限在配置中遵从用户要求用户指定了模型使用指定模型而非默认inherit插件中尚无 agents/ 目录先创建agents/目录八、在插件中创建代理的完整工作流结合 agent-development 技能 与 agent-creation-prompt.md一个完整的代理落地流程是定义代理用途与触发条件选择创建方式AI 辅助生成或手动编写创建agents/agent-name.md文件编写包含全部必填字段的 frontmatter按最佳实践编写系统提示词在 description 中列出 2–4 个触发场景散文并在正文 When to invoke 章节详述用scripts/validate-agent.sh校验用真实场景测试触发在插件 README 中记录该代理AI 辅助生成的工作模式agent-creation-system-prompt.md 展示了更精细的 AI 辅助生成模式向 Claude 发送系统提示词 用户需求Claude 返回严格 JSON 对象{ identifier: pr-quality-reviewer, whenToUse: Use this agent when the user asks to review a pull request..., systemPrompt: You are an expert code quality reviewer...\n\n## When to invoke\n\n- **PR quality review request.** ... }其中whenToUse是单行散文放入 description 字段systemPrompt内含 When to invoke 章节放入正文。随后将 JSON 转换为带 frontmatter 的 Markdown 文件。agent-creator 正是这套模式的产品化形态——把上述提示词与流程内嵌为一个可被直接触发的代理。成品参考仓库提供了可直接参考的完整成品代理complete-agent-examples.md 包含四个生产级示例code-reviewer、test-generator、docs-generator、security-analyzer从触发描述到输出模板一应俱全可作为衡量 agent-creator 产出质量的基准。plugin-dev 插件自身的/plugin-dev:create-plugin工作流见 create-plugin.md也明确会在组件实现阶段调用 agent-creator 进行 AI 辅助代理生成随后用 plugin-validator 与各类校验脚本把关——这构成了生成 → 校验 → 测试 → 文档的闭环。九、写在最后agent-creator 的价值在于把 Claude Code 官方实践中沉淀的代理设计范式固化成一个可自动触发的元代理从一句话需求到结构完整的代理文件六步方法论保证设计质量五步流程保证落盘规范质量清单与validate-agent.sh保证机器可校验边界情况策略保证稳健。对插件开发者而言掌握 agent-creator 的用法等于拥有了一条可复用的高质量自治代理生产线——你可以先让它生成初版再按 agent-creation-prompt.md 中的迭代建议手动精调触发场景与系统提示词最终交付经得起校验与实战考验的代理组件。赞分享AI 插件开发工具插件系统【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址https://gitcode.com/GitHub_Trending/cl/claude-plugins-official点击查看免费下载相关推荐claude-howto 实战用 Claude Code 的 api-documenter 子代理自动化生成高质量 API 文档claude howto 实战用 Claude Code 的 api documenter 子代理自动化生成高质量 API 文档 导读 在 Claude Co教程文档终极指南如何用Next.js与Zod构建类型安全的API交互系统终极指南如何用Next.js与Zod构建类型安全的API交互系统 Next.js是一个强大的React框架它提供了丰富的功能来构建现代Web应用程序。而Zo教程文档用 Meta-Agent 批量生成 Claude Code 子代理.claude/agents/meta-agent.md 深度拆解与实战指南用 Meta Agent 批量生成 Claude Code 子代理.claude/agents/meta agent.md 深度拆解与实战指南 本文以本仓库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考