用途：管理 Claude Code 中的智能体（agent）与 Task 工具工作流，适用于编写 agent 文件、配置工具或模型、调试失败或循环的 agent，以及多智能体编排。仅在任务自主、非交互且只返回一份最终报告时才创建或编辑 agent；需求、选项与确认留在主对话中，agent 不能使用 AskUserQuestion 或等待用户。
文件与配置：项目级 agent 位于 .claude/agents/，会覆盖 ~/.claude/agents/。name 使用唯一 kebab-case；description 说明何时调用；tools 为逗号列表或省略以继承全部；model 可取 sonnet、opus、haiku 或 inherit。正文以 XML 撰写（<role>、<constraints>、<workflow>、<output_format>），不用 markdown 标题，工具遵循最小权限。当 agent 需调用 $find-docs 或 $exa-search 时添加 Skill，这些技能需本地 CLI 时添加 Bash；外部查询中不得放入密钥。
使用方式：优先用 /agents 创建或删除，否则直接编辑 markdown 文件。编写或重写提示词见 writing-agent-prompts.md，文件格式、工具、模型与 Task 调用见 agents.md；修改配置、工具、模型或 Task / run_in_background / resume 见 agents.md；调试失败或循环 agent 见 debugging-agents.md；多智能体协调见 orchestration-patterns.md；恢复、重试与通信见 error-handling-and-recovery.md；长时运行上下文见 context-management.md；信任新 agent 前先评测见 evaluation-and-testing.md。完成标准：frontmatter 有效、正文为 XML、工具最小权限、description 可触发、model 匹配任务，并在代表性任务上测试后再宣称可用。限制：资料未提供具体平台版本、授权或收费信息。