用途：这是一份智能体（agent）编写指南，用于在创建、更新或改进专用 AI 智能体时提供参考，涵盖模型选择、聚焦领域定义、工具配置等环节。
主要能力：说明智能体的基本特征——运行于独立子进程、拥有明确聚焦领域、可选 Sonnet/Opus/Haiku 模型、可限制工具、可设置权限模式、拥有隔离上下文。提供三类设计模式：只读分析器、代码生成/修改器、工作流编排器。给出核心原则：聚焦领域要具体（5-15 条，避免“Python 编程”这类泛化表述）；模型默认选 Sonnet，简单只读分析用 Haiku，复杂推理才用 Opus；通过 allowed_tools 限制工具（如只读分析器用 Read、Glob、Grep、Bash）；权限模式常用 default，编辑流程可用 acceptEdits，规划可用 plan；支持在 YAML frontmatter 中定义 PreToolUse、PostToolUse、Stop 等智能体级钩子。
使用方式：智能体为单文件，存放于 ~/.claude/agents/agent-name.md，文件名需与 frontmatter 中的 name 一致。创建流程为：明确用途与范围、选择模型与工具、编写聚焦领域、定义方法与流程、撰写描述（150-500 字符）、创建文件、测试调用，并用 /audit-agent agent-name 验证。检查已有智能体可用 ls -la ~/.claude/agents/。
适用场景与限制：适合需要专门知识、不同模型、受限工具或隔离上下文的任务，可自动或手动调用。限制包括：智能体仅支持单文件，不支持子目录或引用文件，内容建议控制在 500 行以内；若需要引用文件或渐进式披露，应改用 skill。常见错误有聚焦领域模糊、模型选择不当、工具授权过宽、缺少方法说明、描述过短、名称不匹配、与已有智能体重叠、未指定 allowed_tools 等。
其他事实：该指南属于编写技能家族，相关技能包括 author-agent、author-skill、author-command、author-output-style，验证可用 audit-agent、audit-coordinator。具体收费、价格与平台信息暂未提供。