用途：该技能定义设计 Claude Code 智能体文件（.claude/agents/*.md）的最佳实践，适用于撰写或评审 agent Markdown 文件。agent 文件定义可复用的角色，可作为子智能体或队友被创建；核心原则是 agent 文件定义能力而非生命周期，何时、如何运行由团队负责人的 spawn 提示控制。
主要原则：一、定义能力而非生命周期，避免把工作流阶段、输入格式和通信方式写死；二、每个领域一个 agent，而非按阶段拆分（如用 security-specialist 替代 security-planner 加 security-reviewer）；三、设计聚焦的领域，既不过窄（耦合单一步骤）也不过宽（无明确专长）；四、撰写详细 description，便于 Claude 判断委派时机；五、限制工具权限，只授予领域所需工具，如只读 agent 仅用 Read、Grep、Glob、Bash，实现类 agent 才加 Write、Edit；六、不硬编码交互模式，输出格式可定义，但输入与交付机制交由团队负责人；七、注意上下文窗口隔离，队友各自独立、互不可见，agent 文件需包含足够领域知识；八、团队中每个队友应拥有不同文件或目录，避免冲突。
文件结构：必填 frontmatter 含 name、description、tools；可选含 model、permissionMode、maxTurns、skills、memory。正文 Markdown 即系统提示，建议包含角色声明、分析流程、输出格式、规则约束。反模式包括创建阶段专属 agent、硬编码工作流依赖、过度指定模型。提交前应按清单校验描述具体性、工具最小化、无工作流耦合、无硬编码通信、领域可复用、角色清晰、输出格式明确。