meta-agent-creator

自定义 Agent 创建器

概述

子 Agent 是以带有 YAML frontmatter 的 Markdown 文件定义的专用 AI 助手。每个子 Agent 都在自己的上下文窗口中运行，拥有自定义系统提示词、特定工具访问权限和独立权限。当任务与某个子 Agent 的描述相匹配时，父对话会自动将任务委派给它，在保留主上下文的同时强制执行约束。

适用场景： 隔离高频操作（测试、日志）、为审查者设置只读访问权限、将简单任务分配给成本更低的模型、并行开展研究、创建可复用的团队工作流。

不适用场景： 需要频繁来回沟通的任务、快速定向修改、需要嵌套委派的工作流（子 Agent 无法再创建子 Agent）、收集新上下文成本较高且对延迟敏感的操作。

快速参考

模式	配置	要点
文件位置（项目）	.claude/agents/name.md	通过版本控制共享，优先级为 2
文件位置（用户）	~/.claude/agents/name.md	可用于所有项目，优先级为 3
必需字段	name、description	只有这两个字段是必需的
工具限制	tools: Read, Grep, Glob	允许列表；省略时继承所有工具
禁用工具	disallowedTools: Write, Edit	禁止列表；从继承的工具集中移除
模型选择	model: haiku	选项：sonnet、opus、haiku、inherit（默认值）
权限模式	permissionMode: dontAsk	控制权限提示行为
技能预加载	skills: [auth, api-patterns]	启动时注入；不会从父级继承
生命周期钩子	hooks: { PreToolUse: [...] }	有条件地验证或阻止工具使用
CLI 定义的 Agent	claude --agents '{...}'	仅限当前会话，优先级最高，JSON 格式
交互式创建	/agents 命令	通过 Claude 引导完成设置
主动触发	"Use proactively after..."	添加到描述中，以启用自动委派

常见错误

错误	正确做法
简单的清单审查也使用 opus	对只读审查和风格检查使用 haiku
系统提示词中未指定输出格式	添加结构化输出模板，以获得一致的结果
需要所有工具时仍显式列出工具	省略 tools 字段，以继承包括 MCP 在内的所有工具
期望子 Agent 获得父对话中的技能	在 skills 字段中明确列出技能
使用不含触发条件的通用描述	添加特定触发短语，例如 "Use proactively when..."
为单个 Agent 分配过多职责	设计职责明确、各有单一用途的 Agent
不谨慎地使用 bypassPermissions	优先使用 acceptEdits 或 dontAsk，以实现更安全的自动化
创建层级过深的 Agent 工作流	从主对话串联子 Agent；不支持嵌套

委派

• 发现 Agent 模式：使用 Explore Agent 查找 .claude/agents/ 中现有的 Agent
• 交互式创建：使用 /agents 命令，通过 Claude 生成内容来引导设置
• Agent 文件代码审查：使用 Task Agent 验证系统提示词和配置

参考资料

• Agent 配置：YAML 字段、文件位置和优先级顺序
• 工具选择：访问模式、常见组合和模型指南
• 模板：适用于常见工作流的即用型 Agent 模式