SuperAPI AI 工具集

agent-builder

智能体与模型

查看项目

更新于 10-15 20:09

技能介绍

用途:为 Claude Code 创建子代理(subagent)定义文件,路径为项目级 .claude/agents/ 或用户级 ~/.claude/agents/,优先级为 CLI 参数 > 项目 > 用户 > 插件。

主要能力:生成带 YAML frontmatter 的 Markdown 代理文件。frontmatter 支持 11 个字段:name(必填,kebab-case,最长 64 字符,与文件名一致)、description(必填,第三人称主动语态,含 Use when 子句)、tools(逗号分隔白名单,省略则继承全部)、disallowedTools(黑名单)、model(haiku/sonnet/opus/inherit)、permissionMode、maxTurns、skills、mcpServers、hooks、memory。正文为系统提示,子代理仅接收该提示与环境信息,不接收完整 Claude Code 系统提示。

使用方式:按工作流五阶段执行——UNDERSTAND、ACQUIRE、RESEARCH、AUTHOR、VALIDATE;参考 frontmatter.md、prompt.md、workflow.md、validation.md 与 agent.template.md。工具可按只读(Read, Glob, Grep)、可写(Read, Edit, Write, Glob, Bash)、编排(Task(worker, researcher), Read)或省略字段继承全部来配置。命名建议角色型、动作型或领域型,避免 helper、processor、agent 等泛化名。

适用场景:构建新代理、配置工具权限、编写代理系统提示与校验代理定义。

限制:代理背景色需通过 /agents 界面交互设置,不是 frontmatter 字段;Task(agent_type) 限制仅主线程可用;description 应避免 might、could、should、probably 等模糊词。其余细节暂未提供。