用途:为单个 MCP 服务器生成一个项目级 Claude Code 子代理定义文件,使该服务器的工具、token 消耗与权限范围仅存在于该子代理内,避免在全局或项目 MCP 配置中为每次会话都加载其工具 schema。
主要能力:仅做增量操作,若目标代理文件已存在则切换为审计模式(对照模板规则报告差异,不做改动);一次只问一个问题并给出推荐默认值;绝不把密钥写入文件,认证值以 ${ENV_VAR} 引用,由用户在自己的 shell 环境设置。流程分五阶段:Phase 0 决策门槛(须同时满足有反复出现的任务类真正需要该服务器工具,以及否则会占用每次会话的 schema 与指令成本;若几乎每次会话都用该服务器,应改用项目 .mcp.json);Phase 1 收集 SERVER、TRANSPORT(http/stdio)与 URL_OR_COMMAND、HEADER_NAME/ENV_VAR、TRIGGER、TOOLS、MODEL(默认 sonnet,机械操作用 haiku,判断密集用 opus);Phase 2 依据 references/agent-template.md 生成 .claude/agents/{{SERVER}}-worker.md,无法确认的写 TODO(verify);Phase 3 强制冒烟测试,先 test -n "$ENV_VAR",再以只读任务派发一次;Phase 4 按固定格式输出报告。
使用方式:按上述阶段执行,生成文件须满足一代理一服务器、服务器配置只放代理 frontmatter、密钥仅 ${ENV_VAR}、description 说明何时派发、报告有硬上限、结果由独立上下文复核。
适用场景:某类任务反复需要某 MCP 服务器工具,但该服务器不应全局常驻时。
限制:agent frontmatter 的 mcpServers 支持取决于 Claude Code 版本,冒烟测试为准;浏览器登录类交互认证服务器在无头或定时派发中会失败,需记录;具体版本、价格与更多细节资料暂未提供。