ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

agents agent-teams 插件怎么启用:实验特性开关、teammateMode 配置与首次 /team-spawn

agents agent-teams 插件怎么启用:实验特性开关、teammateMode 配置与首次 /team-spawn agents agent-teams 插件怎么启用实验特性开关、teammateMode 配置与首次 /team-spawn【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents如果你的目标是在 Claude Code 里启用 agents 仓库中的agent-teams插件并第一次生成一个多智能体团队那么需要完成三件事打开 Agent Teams 实验特性开关、在~/.claude/settings.json里配置teammateMode显示模式、然后执行首次/team-spawn。这个插件依赖 Claude Code 的实验性 Agent Teams 特性插件 README 中明确以该特性为前置不满足条件时/team-spawn会直接停止执行。完成本文后你应该能在本地或 CI 环境中成功 spawn 一个团队并用/team-status看到成员与任务状态。打开实验特性开关CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS第一步是在你启动 Claude Code 的环境中导出环境变量export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1这个开关是/team-spawn的第一道 pre-flight 检查见 team-spawn 命令定义。检查未通过时的行为是确定的命令会提示 “Agent Teams requires the experimental feature flag. SetCLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1in your environment.”然后停止执行。/team-review、/team-debug、/team-feature这几个命令也执行同样的前置检查。因此如果你执行 spawn 类命令后看到这条提示而不是团队摘要问题就出在这个环境变量上回到 shell 重新 export 后再试。配置 teammateMode选择 teammate 的显示方式第二步是把显示模式写入~/.claude/settings.json{ teammateMode: tmux }文档中给出的三种取值及其适用条件来源插件 README 与 team-composition-patterns skill模式行为适用条件tmux每个 teammate 运行在一个 tmux pane 中开发场景、需要同时观察多个 agentREADME 标注为推荐iterm2每个 teammate 占一个 iTerm2 tab仅 macOSin-process所有 teammate 在同一进程中运行默认值无需 tmux适合 CI 或脚本化环境选tmux模式时有一个文档明确指出的坑如果 tmux 模式没有显示出 pane需要确认 tmux 已安装、且 spawn teammate 之前已经有一个 tmux session 在运行in-process模式不依赖 tmux是 CI 或脚本环境的替代选择来源team-composition-patterns/SKILL.md 的 Troubleshooting 一节。添加 marketplace 并安装 agent-teams 插件在 Claude Code 中先注册 marketplace/plugin marketplace add wshobson/agents这一步只是注册插件目录不会向上下文加载任何 agent 或工具来源docs/plugins.md 的 Installation 一节。然后安装插件本体/plugin install agent-teamsclaude-code-workflows注意两处文档的安装写法不完全一致agent-teams插件自己的 README 给出的是带 marketplace 限定的agent-teamsclaude-code-workflows而 docs/plugins.md 的插件目录表中写的是简写的/plugin install agent-teams。两种形式分别出自上述两个文档按你当前 Claude Code 版本的提示选择可用的即可不要自行改写插件名。安装后该插件的 agents、commands 和 skills 才会进入上下文。执行首次 /team-spawn/team-spawn的参数格式来自 team-spawn 命令定义/team-spawn preset|custom [--name team-name] [--members N] [--delegate]第一个位置参数预设名或custom进入交互式组队--name团队名缺省时按预设自动生成例如review-team--members N覆盖预设的默认成员数--delegatespawn 完成后进入委派模式。内置预设及默认组成预设默认成员组成默认团队名review33 个team-reviewer分别负责 security、performance、architecturereview-teamdebug33 个team-debugger各领一个假设debug-teamfeature31 个team-lead 2 个team-implementerfeature-teamfullstack4前端、后端、测试各 1 个team-implementer 1 个team-leadfullstack-teamresearch33 个general-purposeagent可做代码库搜索Grep、Glob、Read和联网搜索WebSearch、WebFetchresearch-teamsecurity44 个team-reviewer分别覆盖 OWASP、认证/访问控制、依赖供应链、密钥/配置security-teammigration41 个team-lead迁移计划 2 个team-implementer并行迁移流 1 个team-reviewer正确性校验migration-team指定custom时命令会交互式地询问团队规模2–5 人并逐人选择角色team-lead、team-reviewer、team-debugger、team-implementer未提供--name时还会询问团队名。README 的最佳实践建议先用预设如/team-spawn review并控制团队规模在 2–4 人更大的团队协调开销显著上升。一条最短的首次主路径例如并行研究/team-spawn research --name codebase-researchspawn 过程分三个阶段team-spawn 命令定义Phase 1 按预设或自定义结果配置团队Phase 2 用TeamCreate创建团队再逐个用Agent工具生成成员subagent_type形如agent-teams:team-lead、agent-teams:team-implementerresearch 预设用general-purposePhase 3 为每个成员创建占位任务并打印团队摘要摘要中会包含团队名、成员名与角色、当前显示模式tmux/iTerm2/in-process。文档还要求成员名不要直接复用team-lead这类角色名创建团队可能保留角色式名称应以Agent工具返回或~/.claude/teams/{team-name}/config.json中列出的实际名字称呼 teammate。验证 spawn 结果/team-spawn成功时的输出格式以下为文档给出的示例成员名和团队名是占位值实际输出随你的参数变化Team {team-name} spawned successfully! Members: - {member-1-name} ({role}) - {member-2-name} ({role}) - {member-3-name} ({role}) Use /team-status to monitor progress Use /team-delegate to assign tasks Use /team-shutdown to clean up看到 “spawned successfully” 摘要即说明团队创建完成。进一步的核对手段团队配置落在~/.claude/teams/{team-name}/config.json/team-status和/team-shutdown都从这个文件读取团队信息执行/team-status查看成员与任务表支持--tasks仅任务、--members仅成员、--json原始 JSON不传团队名时会检查~/.claude/teams/下的活跃团队存在多个团队时会列出让你选择。成员/任务表格输出文档示例具体行内容随实际任务变化Team: {team-name} Members: Name Role Status ───────────────────────────────────────── security-rev team-reviewer working on task #2 perf-rev team-reviewer idle arch-rev team-reviewer working on task #4 Tasks: ID Status Owner Subject ───────────────────────────────────────────────── #1 completed security-rev Review auth module #2 in_progress security-rev Review API endpoints Progress: 40% (2/5 completed)收尾清理与已知限制用完团队时用/team-shutdown做优雅关闭team-shutdown 命令定义向每个 teammate 发送shutdown_request、等待响应、收集最终结果。参数--force跳过等待响应--keep-tasks保留任务列表保存在~/.claude/tasks/{team-name}/。注意副作用除非设置了--keep-tasks清理阶段会调用TeamDelete删除团队和任务目录即团队状态文件会被移除这是预期行为而非故障。如果当时还有 in-progress 任务且未加--force命令会先警告 “Warning: {N} tasks are still in progress” 并列出任务确认后才继续。README 的最佳实践明确要求优先用/team-shutdown而不是手动杀进程。首次使用时可能遇到的两个已知问题都有文档依据特性开关未生效spawn 类命令在 pre-flight 检查处停止并提示设置CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1按前文第一步处理即可tmux 模式不显示 pane确认 tmux 已安装且 spawn 前已有 session 在运行不适合依赖 tmux 的环境如 CI改用in-process模式。另外两个来自文档的边界说明Explore/Plan类 agent 是只读的不能把实现类任务交给它们research 预设用的general-purpose不受此限spawn 出来的 teammate 没有会话历史team-lead分派任务时必须把完整上下文放进初始 prompt。【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表