SuperAPI AI 工具集

dispatching-subagents

智能体与模型

查看项目

更新于 10-16 02:35

技能介绍

用途:帮助在 Claude Code 中决定如何启动子代理,并在需要批量执行时用无头方式扇出。资料给出三种机制:Agent 工具、Workflow 工具、以及 claude -p 子进程(scripts/headless_fanout.py)。

主要能力与差异:Agent 工具每次启动和完成各消耗一个父回合,并发上限 20(第 21 个报错不排队),子代理可继承会话前缀、MCP 连接器、钩子与自定义代理类型;Workflow 每次运行一个工具调用,并发为 min(16, vCPU−2),需用户明确同意;无头子进程每次运行一个 Bash 调用,受内存限制(约 210 MB/子进程),子代理上下文仅由传入内容决定,无 MCP、钩子或技能,但可提供每子进程的 total_cost_usd 与 token 账本。

选择顺序:子代理需要会话独有资源(MCP、上下文钩子、worktree、带守卫钩子的自定义代理类型)或需要迭代式逐次决策时用 Agent 工具;用户已同意且流程有阶段与门控时用 Workflow;十个以上输入可写入提示或文件、输出可脚本校验的独立任务用无头子进程;少于十个小型独立任务用 Agent 工具一次消息发出。

无头扇出用法:每行一个任务写入 tasks.jsonl,字段含 id、prompt,以及可选的 out、json_schema、model、tools、allow、deny、system_prompt、timeout。先干跑:python3 $S run tasks.jsonl --work RUN --schema schema.json --dry-run,再以后台 Bash 运行,默认 --tools Read,Grep,Glob,Write、1 次重试、每子进程 900 秒、并发 16,可用 --max-usd 限制花费。用 status 查看尝试、失败原因、成本与权限拒绝;重跑会跳过已完成任务。

限制与注意:子进程无钩子、无 CLAUDE.md、无技能、无 MCP、无会话记忆,需把所需内容放入提示或文件;写入需用 Edit(//绝对路径/**) 形式,Write(path) 与裸 Edit 会被拒;不要给持有令牌或可触达写 API 的子进程开放 Bash;每个子进程各自写缓存,公共前缀应放入 system_prompt;并发过高可能触发限流。资料未提供该技能的安装方式与收费信息。