SuperAPI AI 工具集

custom-agent-definitions

智能体与模型

查看项目

更新于 10-15 23:49

技能介绍

用途:该技能用于在 Claude Code 中定义和配置自定义智能体(custom agent)。当需要新建 .claude/agents/ 下的 .md 智能体定义文件、配置单个智能体的模型/工具/上下文,或编写限定工具访问的只读、受限写入智能体时使用。若需要让多个已定义智能体协同工作,则应改用 agent-teams。

主要能力:自定义智能体可拥有独立的模型、工具与上下文配置,定义方式为 YAML frontmatter 加 Markdown 系统提示词,可放在 .claude/agents/ 或插件的 agents/ 目录。关键字段包括 name、description、model(如 sonnet、opus)、context(fork 或默认)、permissionMode、maxTurns、background、memory、skills、mcpServers、tools、disallowedTools 及生命周期日期。context: fork 会创建独立上下文副本,智能体可见父级历史但改动不影响父级,适合探索性研究与并行调查。工具访问可用 allowed-tools 白名单或 disallowedTools 黑名单,二者可组合使用。agent 字段用于在通过 Agent 工具委派时指定偏好的智能体类型。

使用方式与最佳实践:遵循最小权限原则,只授予必要工具;探索性工作使用 context: fork 隔离;白名单与安全黑名单结合;描述需清晰说明职责与边界;模型选择上开发流程用 sonnet,深度推理分析用 opus。失败需显式上报,遇到阻塞应提交并推送进行中的工作、开草稿 PR 并说明被拒工具,避免单词式总结。只读扇出宜使用不带 Skill 工具的轻量智能体,因为带 Skill 的智能体在首次工具调用前会承担约 25k token 的上下文开销。

限制:资料未提供具体安装命令、收费信息或平台支持范围;完整 YAML 示例见 REFERENCE.md,相关主题包括 agent-teams、parallel-agent-dispatch、meta-audit 及 .claude/rules/agent-development.md。