nWave
以人工审批为关卡，将产品想法逐步推进为经过测试的代码。
按维度查看评分与理由
证据显示工作流采用空权限、避免检出或执行 PR 内容，并使用严格 JSON 编码；项目钩子默认按仓库选择启用，七阶段流程要求人工审批，安装、更新、后台清理和卸载的外部效果也有说明。作者、贡献者和许可证归属清楚。扣分原因是推荐的远程脚本管道会直接执行 main 分支内容，安装会修改用户级 Claude/Codex 配置，自动更新检查和 buddy 读取项目时的数据边界未完整列出；隐私声明缺少策略正文或代码佐证，依赖主要使用下限而非锁定版本或哈希，也未展示完整的凭据轮换、日志脱敏及产物级回滚方案。
README、包版本、Commitizen 版本和发布说明基本一致，依赖、Python 版本、测试分组及离线安装路径都有定义；DES 消息表和 doctor 指引提供了具体失败解释。扣分原因是首选安装命令中的 raw GitHub URL 含有可疑的多余“}”，可能使关键路径失效；离线指南和实际实现未提供，依赖只有宽松下界，且若干遗留测试明确因架构迁移而跳过或放宽未定义名称检查，因此不能给一致性和可用性满分。
材料针对新项目、既有项目、缺陷、重构、团队推广、CI、离线环境及不同严谨度给出明确入口和场景，且清楚标示插件市场安装为功能降级、Claude Code/OpenCode/Codex 的支持边界。扣分原因是 DES 的步骤编号匹配已知会对日期等产生误报，需要人工豁免；跨平台细节主要转交未提供的安装指南，Windows 仅推荐 WSL，实际环境探测和兼容实现不可见。
README 的快速开始、波次模型、命令表、故障排查、更新、卸载、隐私、社区和破坏性变更组织良好；命名迁移规则、示例、已知限制、MIT 全文、版本与维护发行记录均明确。扣分原因是首选安装示例疑似拼写错误，许多关键说明仅链接到未随提示提供的文档；维护者姓名和问题渠道虽明确，但发布流程部分由未提供的私有仓库管理，且发行方身份未经企业注册验证，所以维护责任与更新路径并非完全可审计。
材料描述了按波次生成可审阅工件、单文件 feature-delta、结果注册表、验证器和可调文档密度，输出面向实际开发交付；rigor 配置明确比较模型、评审、TDD、变异测试和成本。扣分原因是未提供代理提示、生成工件样例或核心实现，故无法静态确认这些机制相对普通 Claude/Codex 工作流的实际增量价值与输出质量；成本仅为定性等级，没有令牌、时间或价格数据。
版本号、许可证和作者信息在 README、LICENSE 与 pyproject 之间相互印证，发布说明引用具体问题号、ADR、指南和命令，并明确区分实验 v4、未完成修复及降级安装方式。扣分原因是所引问题、ADR、测试文件、隐私政策、变更日志和实现代码未包含在证据中，无法独立核对大量功能、安全和测试声明；“不收集数据”“每一步执行成熟实践”等表述主要仍是项目自述，事实与宣传性推断的分隔不够系统。
- 不要直接使用当前 README 的 curl-to-shell 命令：URL 含有可疑的多余“}”，且从可变的 main 分支执行未固定、未校验哈希的脚本；应先审查并固定到本次修订。
- 安装会修改用户级代理目录和钩子配置，并启用版本检查及后台日志清理；使用前应备份配置、核对具体文件清单，并在测试仓库验证 disable/uninstall。
- “不收集用户数据”仅由 README 声明；在允许 buddy 读取敏感代码库前，应审查 PRIVACY.md、网络请求实现、日志内容与保留策略。
- 依赖采用开放下界且证据中没有锁文件或制品哈希；部署时应生成受控锁定、执行漏洞扫描并验证离线依赖来源。
这个 Agent 能做什么，适合哪些场景？
nWave 是一套面向软件交付的代理工作流，主要运行于 Claude Code，并明确支持 Codex CLI 和 OpenCode。它把功能开发划分为 DISCOVER、DIVERGE、DISCUSS、DESIGN、DEVOPS、DISTILL 和 DELIVER 七个波次，由产品、架构、平台、验收测试和软件开发等专用代理分别处理。每个波次都会在项目文件系统中生成需求、设计或测试等工件，用户审核批准后才能继续，因此它不是无人监督的一键式编码器。交付阶段采用 TDD，当前默认规范为 RED→GREEN→COMMIT，并由 DES 钩子检查阶段、文件操作和审计记录。项目提供 `nwave-ai` CLI、斜杠命令、40 个代理，以及可调节文档密度和工程严格度的配置。它适合愿意采用结构化交付流程的团队，但需要 Python 3.10+、受支持的编码宿主，并会在仓库和用户配置目录中安装代理、技能、命令及钩子。
安装后，/nw-buddy 读取当前项目，判断适合从哪个波次开始，并指出已有工件和下一步。绿地项目可从 /nw-discover 或 /nw-diverge 开始；需求由 /nw-discuss 整理，/nw-design 调用 system-designer、ddd-architect 和 solution-architect 产出架构与领域设计，/nw-devops 处理基础设施和部署，/nw-distill 编写 Given-When-Then 验收测试，/nw-deliver 通过 software-crafter 执行 TDD 实现。缺陷可直接进入 DISTILL 和 DELIVER，重构可直接进入 DELIVER。DES 在交付期间检查 Bash 和文件操作、TDD 阶段以及步骤标记，同时维护审计日志和会话状态。/nw-rigor 可在 lean、standard、thorough、exhaustive 和 custom 配置间切换；nwave-ai project enable|disable、mode 和 status 管理按项目启用状态。
- 从零建设产品的团队，希望先探索市场和问题空间，再经过需求、架构、验收测试和 TDD 实现。
- 在既有代码库中开发功能的工程师，需要从方案发散或需求讨论切入，并保留可审核的阶段工件。
- 修复缺陷的开发者，希望先用
/nw-distill建立失败的验收测试，再由/nw-deliver完成修复。 - 进行受测试保护的重构的团队，希望直接进入 DELIVER，并在已有绿色测试基础上修改实现。
- 需要按风险调整流程成本的团队，可对文档或配置使用 lean，对核心生产功能使用 thorough 或 exhaustive。
- 需要在 Claude Code 或 Codex CLI 中强制执行 TDD 阶段、文件操作约束和审计记录的工程团队。
这个 Agent 有哪些优点和局限？
- 七波次把市场探索、需求、架构、平台、验收测试和实现连接成一条明确且可按任务类型跳转的交付路径。
- 每个波次都要求人工审阅和批准，用户能够在关键决策点控制代理是否继续。
- DES 对交付阶段的 Bash、文件操作和 TDD 阶段进行检查，并提供审计记录及诊断信息。
- 提供 40 个专用代理和同行评审角色，而不是让单个通用代理承担全部产品与工程工作。
- 严格度和文档密度均可配置，团队可在 token 成本、审查深度、TDD 流程和变异测试之间取舍。
- 需要 Python 3.10+，并依赖 Claude Code、Codex CLI 或 OpenCode 等受支持宿主，不能作为独立服务直接部署。
- 完整体验涉及全局安装的钩子、用户目录配置和项目激活标记，采用成本高于普通提示词或单一编码命令。
- Claude Code 插件市场安装无法运行 DES，因此缺少阶段强制、TDD 验证、严格度配置和审计日志，只能作为降级预览。
- 不同宿主需要各自的安装集成；多宿主支持并不等同于无需调整的通用代理协议。
- v3.22.1 仍存在已知的提交元数据问题，部分生成元数据可能无法被 Git 识别为 trailer。
如何安装或部署这个 Agent？
要求 Python 3.10+，并准备 Claude Code；文档还提供 Codex CLI、OpenCode 和离线安装路径。README 发布的一步安装命令为：
sh -c "$(curl -fsSL https://raw.githubusercontent.com/nWave-ai/nWave/main}/scripts/install/install.sh)"该命令安装 nwave-ai CLI 并接入 Claude Code，优先使用 uv，也支持但不推荐 pipx。命令中的 main} 是源材料原样提供的地址。安装完成后重启 Claude Code。源材料未要求 API 密钥或其他凭据；离线或隔离环境可采用单独的离线安装流程。
如何使用这个 Agent？
重启宿主后，先在 Claude Code 中运行：
/nw-buddy What should I do next?
它会读取项目并建议入口。典型功能流程为：
/nw-diverge "user authentication approaches"
/nw-discuss "user login with email and password"
/nw-design --architecture=hexagonal
/nw-distill "user-login"
/nw-deliver每个波次完成后检查并批准工件，再进入下一阶段。可运行 /nw-rigor lean 或 /nw-rigor standard 调整质量成本。更新时运行 uv tool upgrade nwave-ai（或 pipx upgrade nwave-ai），随后执行 nwave-ai install。
这个 Agent 与同类方案有什么区别？
与 Claude Code 插件市场安装相比，官方推荐的 CLI 安装能够启用完整 DES 钩子，包括阶段强制、TDD 验证、严格度配置和审计日志；插件市场受 ${CLAUDE_PLUGIN_ROOT} 上游限制，只提供代理、命令和技能。Claude Code 是主要运行环境，但 Codex CLI 和 OpenCode 也有专门安装路径；迁移到这些宿主需要相应集成步骤。
常见问题
它会自动从需求一路运行到提交代码吗？
是否必须使用 Claude Code？
必须联网或提供 API 密钥吗？
DES 阻止文件写入或报告 TDD 阶段未完成时怎么办？
/nw-deliver 会话进行，或先结束该会话；如果子代理没有完成全部 TDD 阶段，应重新派发同一代理完成缺失阶段。卸载会删除项目文件吗？
nwave-ai uninstall 删除用户目录中的代理、命令、配置和 DES 钩子，随后可用 uv tool uninstall nwave-ai 或 pipx uninstall nwave-ai 删除 CLI；项目文件不受影响。