SuperAPI AI 工具集

deploy-agent-team

智能体与模型

查看项目

更新于 10-15 17:23

技能介绍

用途:当用户提出“部署一个团队”“让所有智能体一起做这件事”“协调专家”等需求时,该技能从 bopen-tools 工具包部署一支协调运作的专职智能体团队,各智能体并行处理独立任务,并通过共享任务列表和消息总线通信。

前置条件:智能体团队需要设置环境变量 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1,在 ~/.claude/settings.json 的 env 中加入 {"env": {"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"}},否则 TeamCreate 会失败。

权限配置:生成前先检查主会话权限设置,并在使用 Agent 工具前查看其 schema。当前版本可接受按次生成的 mode;若主机未暴露该字段,队友将继承主会话权限。不要为绕过提示而用 --dangerously-skip-permissions 启动主会话,除非处于明确可信且外部沙箱化的环境。权限与文件归属模型见 references/permissions-and-isolation.md。

可用智能体(部分):researcher、nextjs、native-desktop、designer、agent-builder、database、integration-expert、code-auditor、tester、documentation-writer、devops、optimizer、architecture-reviewer、mobile、payments、marketer、legal、mcp。完整名单及各智能体可提及的技能见 references/agent-roster.md。

生命周期:先分解任务,判断涉及领域、可并行与必须串行的部分及依赖关系;再调用 TeamCreate 创建团队;随后用 TaskCreate 预先建任务,用 TaskUpdate 的 addBlockedBy 设置依赖(如测试等待实现完成);接着用 Agent 生成队友,每个生成提示必须自包含,队友没有对话历史;然后通过 TaskList 查看进度,用 SendMessage 回复被阻塞的队友;最后发送 shutdown_request,等待 shutdown_response 后调用 TeamDelete。

任务分解模式:功能实现可并行 researcher、designer、nextjs/integration-expert、database,tester 与 documentation-writer 阻塞至实现完成;安全审计可并行 code-auditor 与 architecture-reviewer,修复与回归测试随后;发布准备可并行 code-auditor、tester、optimizer、documentation-writer、legal,devops 阻塞至全部完成。

关键规则:使用最安全有效的权限模式,只预批准队友确实需要的操作;生成提示自包含,包含仓库路径、约定和完整上下文;在提示中提及各智能体应使用的技能;一次只认领一个任务;消息中不要用 JSON,状态用 TaskUpdate;闲置属正常,发消息可唤醒;只有主会话能调用 TeamCreate,不能嵌套团队;必须先关闭再 TeamDelete;广播要克制。

故障排查:TeamCreate 失败检查环境变量;队友遇权限提示则在主会话预批准后重试;不认领任务检查 blockedBy;无响应发 SendMessage;TeamDelete 失败先逐个 shutdown;行为偏离先发消息纠正,严重时关闭重生成。