Claude Code 插件 Agent 开发指南
帮助开发者为 Claude Code 插件设计、编写和验证自主 Agent。
内容明确建议按最小权限限制 tools，并说明省略 tools 将获得全部工具；但未规定用户确认、敏感数据处理、外部副作用披露、回滚或失败恢复，因此扣分。仓库来源和 Anthropic 官方组织身份可支持基本归属，但不构成安全性证明。
技能提供了结构规则、验证脚本、触发测试步骤和边界案例，主路径具有可理解性；但本次仅静态阅读，未见覆盖关键路径的提交测试或可复现执行证据，且部分“exact”及“production-ready”表述无法验证，因此受静态上限限制并扣分。
目标用户、适用场景、触发词、输入结构和预期 agent 文件格式较清楚；但非适用范围和负面触发条件不完整，缺少中文使用指导，也未说明中国大陆网络环境下文档或 Claude Code 依赖的可达性，因此扣分。
文档分为概览、字段、设计、示例、验证和资源，渐进式结构较好，并提供版本号、示例及脚本路径；但缺少安装/依赖说明、已知限制、变更记录、明确维护责任和更新路径。许可证信息仅能从仓库上下文得知，技能自身未声明，因此扣分。
提供可直接复制的 frontmatter、系统提示词、触发示例和创建流程，能够覆盖创建 agent 的核心需求；但示例和“battle-tested”“production-ready”等价值主张没有静态可验证的运行结果，且生成内容仍需用户审查和实际测试，因此扣分。
源文件本身可审计，包含规则、脚本和示例，支持有限追溯；但没有足够的第三方执行证据、关键路径测试套件或交叉验证，本评估也未执行任何脚本，因此只能给予低分。
- tools 未声明时 agent 默认拥有全部工具；创建或复制示例时应显式限制权限，并在执行写入、Bash 或其他外部副作用前确认。
- 文档建议测试触发和验证脚本，但本材料未提供已执行结果；不要将“production-ready”或“battle-tested”视为已验证事实。
- 引用的 references/、examples/ 和 scripts/ 路径依赖仓库布局，使用前应确认文件存在、脚本可执行且规则与当前 Claude Code 版本一致。
- 未提供中文触发示例或中国大陆网络可达性说明。
它能做什么 & 适用场景
这是一个面向 Claude Code 插件开发者的 Agent 开发技能，涵盖文件结构、YAML frontmatter、触发条件和系统提示词设计。它说明如何选择模型、颜色和工具权限，并提供 AI 辅助与手动创建两种方法。内容还包括标识符、描述和系统提示词的验证规则，以及触发测试和组织方式。它适合需要在插件中添加可自动处理复杂多步骤任务的 Agent 的开发者。
指导用户创建位于插件 agents/ 目录中的 Markdown Agent 文件；编写 name、description、model、color 和可选 tools 字段；设计系统提示词、触发示例、输出格式和边界条件；按照给定规则验证标识符、描述和系统提示词；使用文档列出的 validate-agent.sh 与 test-agent-trigger.sh 脚本进行验证和触发测试；最后在插件 README 中记录 Agent。
- 为 Claude Code 插件新增代码审查、测试生成或安全分析 Agent 的开发者。
- 需要为复杂多步骤任务定义自主处理流程、职责和输出格式的插件作者。
- 希望通过 description 中的多个示例改善 Agent 触发条件的开发者。
- 需要限制 Agent 工具权限、选择模型或为多个 Agent 设计颜色区分的团队。
- 想在发布前验证 Agent 文件结构、触发行为和边界情况的维护者。
优缺点一览
- 覆盖从结构设计到验证和测试的完整 Agent 开发流程。
- 提供可直接参考的 frontmatter、系统提示词和最小 Agent 模板。
- 明确标识符、描述、模型、颜色和工具权限的格式与最佳实践。
- 包含 AI 辅助生成和手动创建两种工作方式。
- 内容针对 Claude Code 插件的 Agent 目录、命名空间和自动发现机制，迁移到其他客户端需要调整。
- 来源没有说明该技能的独立安装流程。
- 来源没有提供实际测试结果或兼容平台列表。
- 许可证在仓库元数据中标为 unknown。
如何安装
README 记录了 Claude Code 的安装方式，但没有提供此技能的独立安装命令。可先按 README 的推荐方式安装 Claude Code，例如在 macOS/Linux 执行 curl -fsSL https://claude.ai/install.sh | bash，然后进入项目目录运行 claude。该技能文件位于 plugins/plugin-dev/skills/agent-development/SKILL.md；单独复制或注册该技能的步骤未在来源中说明。
如何使用
在 Claude Code 中提出与 Agent 开发相关的请求，例如：Create an agent for reviewing API security issues in this plugin、How should I write the agent frontmatter and triggering examples? 或 Validate this agent's system prompt and tool permissions. 技能覆盖的触发主题包括创建或添加 Agent、Agent frontmatter、when-to-use 描述、示例、工具、颜色和自主 Agent。