Polywave：在 Claude Code 中安全并行运行多个 AI 编码 Agent

核心能力与快速开始

★ 3 · Shell

能做什么

以协调协议方式让多个 AI 编码 Agent 安全并行：Scout 分析代码库并生成 IMPL 文档（含依赖图、接口契约、文件所有权表和 wave 结构），把每个待改文件分配给唯一 Agent；每个 Agent 在独立 git worktree 中运行以避免并发构建/测试的状态竞争；执行前需人工审阅并批准整体计划；设有适用性门控，任务无法干净拆分时输出 NOT SUITABLE 并停止；提供 scaffold agent 生成共享类型文件、wave agent 并行实现、integration agent 在合并后接线新导出；以钩子（SubagentStart、PreToolUse、SubagentStop 等）在工具边界强制 worktree 隔离，并用合并前提交计数做隔离失效检测。命令包括 scout、wave、auto、status、bootstrap、interview、program、amend 等。

适用场景

在 Claude Code（及兼容 Agent Skills 的 Cursor、GitHub Copilot 等工具）中对可清晰按文件切分、接口可在实现前定义的功能进行并行编码；适合构建/测试周期较长（文档称 >30 秒）时放大并行收益的场景；也可用于新项目结构设计（bootstrap）、结构化需求收集（interview）、多特性打包为并行 program，以及多 Agent 并行工作流的教学与研究参考。

项目形态

开发框架

部署方式

需先在本地克隆仓库并运行 install.sh 配置 Agent 权限、符号链接技能文件并安装钩子，然后安装 polywave-tools CLI（Homebrew tap、预编译二进制或 go install），再在目标项目中执行 polywave-tools init 与 verify-install，之后重启 Claude Code。未说明是否支持云端/托管部署。

主要依赖

Git 2.20+、jq 1.6+、Claude Code；强烈建议为所用技术栈配置语言服务器（如 gopls、rust-analyzer、pyright、typescript-language-server），否则 Agent 退回较慢的 grep 导航。文档称不需要 polywave-protocol 或 polywave-web。安装脚本会修改 Agent 权限与 hooks，可能需要相应环境权限。

使用限制

自身不是 Agent 运行时，不提供任务路由、Agent 间消息传递或跨会话记忆，需依托已有 Agent 运行环境。不适合无法干净分解为独立文件所有权的工作，此时会被判定为不适用。polywave-teams 为实验性替代执行层。未说明多用户并发、硬件要求、API 成本与用量限制。

许可证

NOASSERTION

最近推送

2026-09-29 10:22

资料检查：2026-09-30 07:00 · 卡片整理：2026-09-30 09:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容

职业应用

程序员

在 Claude Code 中并行运行多个 AI 编码 Agent 开发功能：先用 /polywave scout 分析代码库并生成文件所有权分配与 wave 结构计划，人工审阅后运行 /polywave wave 让各 Agent 在独立 git worktree 中并行实现互不重叠的文件，最后由 Orchestrator 合并并运行测试，从而避免并行编辑同一文件导致的合并冲突。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证