面向 Claude Code 的最佳实践指南与参考合集,涵盖子代理、命令、Skills、Hooks、记忆与工作流。
nWave-ai/nWave
在 Claude Code 中运行的 AI 智能体工作流,把功能从构想带到可测试代码,每个阶段之间由人工审核。
- Star
- 632
- Fork
- 67
- 未关闭 Issue
- 33
- 最近提交
- 前天
这是什么?
nWave 是运行在 Claude Code 中的一组 AI 智能体,把功能开发拆成七个阶段:discover、diverge、discuss、design、devops、distill 和 deliver。每个阶段由专门的智能体产出文档,例如需求、架构或 Given-When-Then 形式的验收测试,开发者审核通过后才进入下一阶段。
项目提供 nwave-ai 命令行工具,把智能体、命令和钩子安装到 ~/.claude/ 下。其中的 DES 钩子在实现阶段强制执行 TDD 阶段门禁,并可阻止交付会话之外的源码修改。项目按仓库显式启用,通过 /nw-rigor 可以在精简到极严格之间调整审查深度和 TDD 强度。此外还提供功能文档校验器和 outcomes 注册表,用于在设计阶段发现重复规则。
安装器支持 Claude Code、OpenCode 和 OpenAI Codex CLI,要求 Python 3.10 及以上版本,Windows 用户需通过 WSL 使用。
核心功能
- 01覆盖从探索到 TDD 交付的七个阶段,阶段之间设有人工审核门禁。
- 02为需求、架构、验收测试和代码实现分别配置专门智能体。
- 03DES 钩子强制执行 TDD 阶段,并阻止交付会话外的源码修改。
- 04严谨度配置(从 lean 到 exhaustive)控制智能体模型、同行评审和变异测试。
- 05提供功能文档校验器和 outcomes 注册表,用于设计阶段检查。
- 06支持 Claude Code、OpenCode 和 Codex CLI。
适用场景
- 在已有代码库中新增功能,先编写需求和验收测试再实现。
- 在动手编码前进行结构化的设计评审。
- 多名开发者借助 AI 协作同一项目时,统一执行 TDD 规范。
- 根据变更风险高低,调整审查和测试的严格程度。
快速上手
- 1
确认已安装 Python 3.10+ 和 Claude Code
- 2
运行 README 中的官方安装脚本
- 3
安装完成后重启 Claude Code
- 4
在 Claude Code 中向 buddy 询问下一步该做什么
/nw-buddy What should I do next?
使用前须知
- nWave 需要在 Claude Code 中运行,因此必须先安装 Claude Code。
- Windows 用户必须使用 WSL。
- 插件市场安装方式不受支持,因为 DES 强制机制在该方式下无法工作。
- v3.22.1 中 #78 提交元数据修正尚未完成。
收录于专题
标签
常见问题
- nWave 是什么?
- 在 Claude Code 中运行的 AI 智能体工作流,把功能从构想带到可测试代码,每个阶段之间由人工审核。 nWave 是运行在 Claude Code 中的一组 AI 智能体,把功能开发拆成七个阶段:discover、diverge、discuss、design、devops、distill 和 deliver。每个阶段由专门的智能体产出文档,例如需求、架构或 Given-When-Then 形式的验收测试,开发者审核通过后才进入下一阶段。
- nWave 可以免费使用吗?用的什么许可证?
- nWave 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- nWave 还在维护吗?
- 活跃维护中。nWave 最近一次提交是在 2026年11月5日。
- nWave 适合用来做什么?
- 在已有代码库中新增功能,先编写需求和验收测试再实现。 在动手编码前进行结构化的设计评审。 多名开发者借助 AI 协作同一项目时,统一执行 TDD 规范。 根据变更风险高低,调整审查和测试的严格程度。
- nWave 怎么安装和运行?
- 确认已安装 Python 3.10+ 和 Claude Code 运行 README 中的官方安装脚本 安装完成后重启 Claude Code 在 Claude Code 中向 buddy 询问下一步该做什么: /nw-buddy What should I do next?
- 在哪里获取 nWave?
- 源代码和安装说明在 GitHub 上:https://github.com/nWave-ai/nWave
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
面向 Claude Code 和 Codex 的智能体编排层,提供多智能体集群、可学习记忆、向量检索与跨机器联邦协作。
基于 Elixir 的开源 AI 智能体系统,多个智能体协同从一个高层目标出发构建、验证并演进软件。
一组面向 Claude Code、Codex 等编程智能体的技能集,涵盖需求追问、TDD、调试、规划与代码审查。
开源、本地优先的 AI 工作台,可视化构建智能体,连接模型与 MCP 工具,并在对话或自动化中运行。
superpowers AI 编程技能框架的完整中文版,外加 4 个中国原创技能,可安装到 26 款 AI 编程工具。