用途:该资料是 Claude Code 自定义智能体的创建指南。智能体是运行在独立上下文窗口中的专用 AI 助手,用于聚焦、自主地执行任务。
主要能力:讲解 YAML frontmatter 字段(name、description、tools、model、permissionMode、skills),文件存放位置(项目级 .claude/agents/agent-name.md 与个人级 ~/.claude/agents/agent-name.md),常用工具组合(如只读 Read, Grep, Glob;文件修改 Read, Write, Edit, Grep, Glob;Git 操作 Bash(git:*)),模型选择(haiku、sonnet、opus、inherit)及取舍。
使用方式:资料给出六阶段流程——需求收集、范围选择、描述撰写、工具配置、系统提示词设计、测试与迭代。创建文件示例:mkdir -p .claude/agents 与 touch .claude/agents/agent-name.md;个人级用 mkdir -p ~/.claude/agents。description 需包含角色、功能、调用时机与触发词,建议 50-150 词。系统提示词需自包含,因智能体看不到对话历史,应写明 When Invoked 步骤、检查清单、输出格式与约束。测试可用自然语言请求或显式调用,调试用 claude --debug,列出智能体用 /agents。
适用场景:代码审查、安全审计、性能分析、调试、测试运行、重构、PR 审查、代码库探索、依赖审计、文档检查、提交信息生成、部署前检查、迁移辅助等。
限制:资料未提供具体收费、价格或平台支持信息;工具权限应遵循最小化原则,避免使用 Bash 全权限与 bypassPermissions;description 模糊会导致智能体无法被发现。