用途
claude-agents 用于创建和校验扩展 Claude Code 的专用子代理（subagent）。当需要创建代理、编写代理 frontmatter、配置子代理，或出现“create agent”“agent.md”“subagent”“Task”等触发词时使用本技能。
代理与技能的区别
- 代理：具有特定专长的专用子代理，通过 Task 工具（subagent_type 参数）调用，位于 agents/ 目录，为单个带 frontmatter 的 .md 文件。
- 技能：带指令的能力包，由模型根据上下文自动触发，位于 skills/ 目录，为包含 SKILL.md 与资源的目录。
主要能力
- 提供模板：basic.md（简单代理）、advanced.md（含全部配置选项的完整代理）。
- 提供脚手架脚本：./scripts/scaffold-agent.sh security-reviewer -t reviewer。
- 定义代理原型：分析器（只读检查）、实现者（构建与修改代码）、审查者（提供反馈）、测试者（创建与管理测试）、研究者（查找与综合信息）、部署者（处理基础设施）。
- 定义 frontmatter 字段：name（必填，kebab-case，与文件名一致）、description（必填，说明何时使用、触发词与示例）、model（可选：inherit|haiku|sonnet|opus）、tools（可选，限制工具，默认继承全部）、skills（可选，自动加载的技能，不被继承）、permissionMode（可选：default|acceptEdits|bypassPermissions）。
- 模型选择建议：inherit 为推荐默认，适配父上下文；haiku 用于快速探索与简单任务；sonnet 为均衡成本与能力（省略时默认）；opus 用于需要细致判断、安全/架构审查或不可逆决策的场景。
- 工具配置理念：不要过度限制，仅在存在明确安全理由时限制工具。限制时的基线工具为 Glob, Grep, Read, Skill, Task, TaskCreate, TaskUpdate, TaskList, TaskGet。
使用方式
工作流分为四个阶段：
- 发现：明确代理提供的专长、触发关键词、作用范围（做什么、不做什么）以及存放位置（个人 ~/.claude/agents/、项目 agents/ 或插件）。
- 设计：选择代理原型与配置，编写 frontmatter。
- 实现：编写 frontmatter 与系统提示，包含角色定义、分步流程、输出格式与约束。
- 校验：按检查清单验证 YAML frontmatter、命名规范、描述质量、系统提示质量与工具配置。
描述字段是代理被发现的关键：以触发条件开头（“Use this agent when...”），包含 3-5 个触发关键词，添加 2-3 个用户请求到助手委派的示例，避免模糊描述。
代理作用域与优先级：项目 agents/（最高，通过 git 共享给团队）、个人 ~/.claude/agents/（中等，仅自己可见）、插件 <plugin>/agents/（最低，插件用户可见）。同名时项目代理覆盖个人代理。
测试方式：在 agents/ 创建代理文件，在 Claude Code 中输入“Use the [agent-name] agent to [task]”，Claude 通过 Task 工具调用，然后检查结果。可用 claude --debug 调试代理加载。
适用场景
- 需要为 Claude Code 添加具有特定专长的子代理时。
- 需要规范代理 frontmatter、命名、描述与工具配置时。
- 需要按原型（分析、实现、审查、测试、研究、部署）设计代理时。
- 需要排查代理未被调用、调用错误代理或工具权限不正确等问题时。
限制
- 本技能面向 Claude Code 的代理机制，代理通过 Task 工具调用，与自动触发的技能不同。
- 代理的 skills 字段不会被继承，需显式声明。
- 限制工具时需包含基线工具，否则可能影响代理正常工作。
- 资料未提供具体收费、价格或平台支持信息。