用途
该技能用于帮助用户创建专用 Claude Code 子代理(subagent),并遵循官方最佳实践与标准。子代理是具有聚焦专业领域、独立上下文窗口和自定义工具访问权限的专用 AI 助手。当用户想要创建新子代理、自定义代理、专用 AI 助手,或提到创建、设计、构建代理或子代理时,可使用本技能。
主要能力
- 提供从理解用途到测试调用的完整创建流程:理解目标用途、选择存储位置、选择模型、定义工具访问、编写系统提示词、测试调用。
- 定义子代理文件格式:Markdown 文件加 YAML frontmatter,包含必填字段 name、description,以及可选字段 model、tools。
- 说明文件位置:项目级(.claude/agents/,优先级最高,可随版本控制与团队共享)、用户级(~/.claude/agents/,跨项目可用,不通过 git 共享)、插件级(随插件打包分发)。
- 提供描述编写最佳实践:使用“Use PROACTIVELY”或“MUST BE USED”以支持自动委派,明确专业领域、文件类型、框架或技术,区分于相似代理。
- 提供模型选择指南:haiku(快速经济)、sonnet(均衡,默认)、opus(高级推理)、inherit(沿用主模型)。
- 提供工具限制配置与常见工具组合,如只读分析(Read, Grep, Glob)、代码修改(Read, Write, Edit, Grep, Glob)、开发工作流(Read, Write, Edit, Bash, Grep, Glob)等,并列出可用工具。
- 给出系统提示词结构:核心身份、专家目的、能力(按类别组织)、行为特征、知识库、响应方法、示例交互。
- 说明调用方式:自动委派(优先)与显式调用。
- 提供两个完整示例:test-runner 子代理与 database-optimizer 子代理,包含完整 frontmatter 与系统提示词。
- 提供创建清单(13 项)、测试步骤(重启 Claude Code、/agents 命令检查、测试自动委派与显式调用、验证工具访问、监控性能)以及 CLI 动态测试示例。
- 列出常见问题:子代理未激活、工具访问被拒、性能问题及其排查方向。
使用方式
按技能所述工作流创建子代理:先明确其应处理的具体任务或领域,再选择项目级或用户级位置,选择合适模型,定义工具访问范围,编写详细系统提示词,最后测试自动委派与显式调用是否生效。文件需保存到 .claude/agents/ 或 ~/.claude/agents/ 等正确位置。
适用场景
适用于为团队或个人创建专用 Claude Code 子代理,例如代码审查、数据分析、测试执行、数据库优化等聚焦型 AI 助手,也适用于通过项目级文件与团队共享代理配置。
限制
具体平台支持范围、收费、价格、实际效果等资料未提供;工具可用性以 Claude Code 实际支持为准。