Claude Code Agent 开发指南
帮助你为 Claude Code 插件设计、编写和验证自主 Agent。
文档明确建议按最小权限限制 tools，并提醒插件信任风险；但默认省略 tools 时授予全部工具，且未规定用户确认、敏感数据处理、数据流披露、外部副作用控制或回滚方案，因此扣分。
结构、字段规则、流程、边界案例和验证步骤较完整；但本次仅静态阅读，未执行关键路径，且文档要求 description 使用自然语言触发示例，而 validate-agent.sh 另行要求 <example> 标签，存在规范不一致，异常反馈和可复现性证据有限，因此扣分。
目标受众、agent 创建场景、字段输入和触发条件描述清楚，覆盖主动与被动触发；但未充分定义不适用范围、竞争 agent 的触发冲突、中文支持或中国大陆网络环境适配，因此扣分。
包含版本号、清晰的信息架构、渐进式参考资料、示例、安装/目录说明、验证脚本，并可由仓库许可证和官方维护背景提供治理线索；但未提供该 skill 的变更日志、明确维护责任或独立更新路径，且存在验证脚本与文档要求不一致，因此扣分。
提供可直接复制的 frontmatter、系统提示词模板、完整示例、生成流程和验证命令，能够覆盖核心 agent 创建任务；但模板仍需人工替换和审查，示例的可运行性未被静态材料证明，且“production-ready”“battle-tested”等效用表述缺乏执行证据，因此按静态上限给分并扣减。
内容本身可审计，包含明确规则、脚本源码、示例和固定修订版本；但未提供已执行的 CI、测试结果或第三方复核证据，结论主要来自单一源文件集合，因此不超过静态上限。
- 不要把省略 tools 视为安全默认值；应为每个 agent 明确列出最小工具集，并在涉及写入、执行或外部服务时增加确认、范围和恢复说明。
- 在使用 validate-agent.sh 前核对其 <example> 检查与文档中的自然语言触发格式，避免按文档编写却被脚本警告或失败。
- “production-ready”“battle-tested”以及触发可靠性等表述未由本次静态材料中的执行结果证实，仍需实际验证。
- 未说明中文提示词、中文触发语义和中国大陆网络可达性，面向 FollowSkills 中文用户时应补充环境适配说明。
它能做什么 & 适用场景
这是一个面向 Claude Code 插件开发者的 Agent 创建指南。它说明如何组织 Agent 文件、编写 YAML frontmatter、设计触发条件和系统提示词，并选择模型、颜色与工具权限。内容还涵盖 Agent 的验证、触发测试、目录组织和命名空间。它适合需要新增或维护插件 Agent 的开发者，但不适用于一般任务自动化或独立的模型 API 集成。
指导用户创建 agents/agent-name.md 文件，填写 name、description、model 和 color 等字段，设计包含职责、分析流程、输出格式和边界情况的系统提示词，并提供命名、描述和提示词的验证规则。它还建议使用 scripts/validate-agent.sh 验证 Agent 文件、使用 scripts/test-agent-trigger.sh 测试触发行为，并在插件 README 中记录 Agent。
- Claude Code 插件开发者需要从用户需求生成一个新的自主 Agent 时，使用其 AI 辅助创建流程。
- 开发者手动创建代码审查、测试生成或 API 文档类 Agent 时，参考文件结构和 frontmatter 规则。
- 插件维护者需要改进 Agent 的触发描述，使其覆盖主动触发、用户请求和不同表述时，参考触发条件建议。
- 团队需要限制 Agent 的工具权限时，使用其最小权限原则和工具集合示例。
- 开发者需要验证 Agent 是否被正确加载、遵循流程并返回规定格式时，参考测试步骤和脚本。
优缺点一览
- 覆盖从 Agent 标识符到系统提示词、测试和文档记录的完整开发流程。
- 提供具体的 frontmatter 格式、字段约束和有效/无效示例。
- 强调触发条件、输出格式、质量标准和边界情况，便于形成可验证的 Agent 配置。
- 包含验证和触发测试脚本的使用说明。
- 内容明确面向 Claude Code 插件，迁移到其他 Agent 平台需要适配其加载、目录和调用机制。
- 源材料未展示验证脚本或完整示例文件的实际实现，无法据此确认脚本覆盖的测试范围。
- 指南本身不提供具体领域 Agent，也不执行 Agent 创建或测试操作。
- 安装所需的确切 marketplace 插件名称未在源材料中说明。
如何安装
该技能位于仓库的 plugins/plugin-dev/skills/agent-development/SKILL.md。README 说明整个插件目录可通过 Claude Code 的插件系统安装，命令格式为 /plugin install {plugin-name}@claude-plugins-official；源材料未提供该技能对应的确切 marketplace 插件名称，因此不能补写具体名称。
如何使用
在已安装并支持该插件技能的 Claude Code 环境中，提出类似“create an agent”“add an agent”“write a subagent”或“help me write agent frontmatter”的请求。技能将围绕 Agent 结构、触发条件、系统提示词、模型、颜色、工具限制和验证流程提供指导；源材料未规定独立的命令或 API 调用方式。