nWave Skill：让 AI 在 7 阶段门控中帮你从想法走到代码

Skill超级捕获手 技术创作者 2026-08-29 1465 阅读

nWave 是一个运行在 Claude Code 内的 AI 开发框架，其核心主张是”人在每一步都有判断权”。它将功能交付拆解为 7 个阶段（discover → diverge → discuss → design → devops → distill → deliver），每个阶段由专门的 AI agent 产出制品，用户审阅通过后才进入下一步。与大多数 Agent 框架”说干就干、上下文越来越乱”的模式不同，nWave 用阶段门（phase gate）+TDD 验证强制人类在关键节点介入，确保 AI 输出始终在人类控制之下。星数截至 2026-08-28 为 601，GitHub trending 月度报告已有记录。

功能与原则

nWave 的本质是一套结构化开发流程操作系统，不是简单的一键生成代码。它的核心能力体现在三个方面：

  • 7 阶段门控工作流：每个 wave 对应一个或多个专门 agent，产出制品（文档、设计图、测试用例、代码），人类逐级审批后才推进，类似现实中的 stage-gate 流程。
  • 40 个专门 agent：10 个 wave agent（含 design 阶段 3 个专业子 agent）、1 个 concierge、8 个跨 wave 专家、14 个 peer reviewer、7 个业务 agent，覆盖从需求发现到 TDD 实现的完整链路。
  • Token 效率可调节：/nw-rigor 命令可切换质量配置文件（lean/standard/thorough/exhaustive），决定每轮用哪个模型、是否开启 mutation testing，适配从”快速验证”到”关键系统”的各类场景。

核心设计原则：AI 产出必须经过人类判断才能变成事实。任何制品都是一个 proposal，AI 不会自动推进阶段，不会绕过审查写代码。

认可度

  • Star 数：截至 2026-08-28，GitHub 601 stars，61 forks（来源：api.github.com）
  • 创建时间：2026-02-13，最后推送 2026-08-25
  • 许可证：MIT
  • 近期动态：2026-08-19 GitHub Trending 日榜提及；在 Taskade 整理的”2026 年最佳 Claude Code Skills”盘点中被引用；GitHub Topics claude-code-skills 下持续活跃
  • 安装方式：CLI 一键安装，无需 API key

链接

GitHub：https://github.com/nWave-ai/nWave

文档：https://docs.nwave.ai

原作者

nWave 由 nWave-ai 团队开发和维护，核心贡献者主要来自工程实践领域。项目采用 MIT 许可证，代码和文档均为开源。

介绍

nWave 的诞生背景很直接：现有的 AI 编程工具有一个共同弱点——它们太容易”跑偏”。当你让 Claude Code 从零开始做一个功能，它会边想边写，越到后面越容易忘掉最初的需求；当你要求它做 TDD，它可能在没写实现的情况下先写过于宽松的测试；当代码规模变大，上下文窗口越来越挤，AI 的质量随之下降。

nWave 的回答是：把开发过程结构化，让 AI 在每个阶段专注做一件事，然后在进入下一阶段前停下来等人类确认。

它的 7 个 wave 覆盖了完整的功能交付链路：

  • DISCOVER（发现）：对绿色地带项目，探索市场和问题空间
  • DIVERGE（发散）：头脑风暴各种解法，收敛前广泛探索
  • DISCUSS（讨论）：写需求文档和用户旅程，所有类型项目都需要
  • DESIGN（设计）：架构和领域建模，含 hexagonal/simplified 等架构风格选择
  • DEVOPS（运维）：基础设施和部署
  • DISTILL（提炼）：写验收测试（Given-When-Then 格式）
  • DELIVER（交付）：TDD 驱动实现

每一 wave 都对应一个 slash command，在 Claude Code 里直接调用。每个 wave 产生的制品（feature-delta.md）都有人类审查步骤，机器不会自动推进。

特点

  • 人在回路（Human-in-the-loop）：每个 wave 都是人类审批门，AI 永远不会单方面完成整个功能
  • Token 效率可调：通过 /nw-rigor 在 lean（haiku 模型，最省 token）到 exhaustive（opus × 2，最高成本）之间切换
  • TDD 原生支持：DISTILL + DELIVER 阶段强制先写验收测试再写实现，有 3-phase（RED→GREEN→COMMIT）和传统 5-phase 两种模式
  • 设计时去重（Outcomes Registry）：用 type-shape + keyword Jaccard 在写代码前识别重复需求，避免浪费开发资源
  • 跨平台支持：CLI 安装支持 Claude Code、OpenAI Codex CLI、OpenCode；plugin marketplace 安装仅支持 agent，不支持 DES hook（官方明确不建议）
  • 零 API key：全部功能开箱即用，不需要任何第三方 API key

使用方法

安装（5 分钟）

sh -c "$(curl -fsSL https://raw.githubusercontent.com/nWave-ai/nWave/main/scripts/install/install.sh)"

需要 Python 3.10+ 和 Claude Code。使用 uv 作为包管理工具（推荐），也支持 pipx。

启动

在 Claude Code 里输入：

/nw-buddy What should I do next?

buddy 会读取当前项目状态，告诉你应该从哪个 wave 开始、各个制品在哪里、如何使用 nWave。无需任何配置文件，开箱即用。

标准开发流程

# 需求探索（可选，greenfield 项目）
/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              # 交互式：对比各配置文件
/nw-rigor lean         # 快速模式，最省 token
/nw-rigor custom       # 自定义组合

使用场景与人群

适用场景：

  • 团队需要 AI 编程但担心”失控”——nWave 的阶段门天然防止 AI 单方面推进
  • 对 TDD 有要求的中型团队——DISTILL 强制先写验收测试
  • 需要在 AI 编程时保持上下文清晰——每个 wave 的制品结构化存档，不会越写越乱
  • solo developer 想用 AI 但不想被 AI 带着跑——nWave 的收敛机制强制你作为决策者存在

不适用场景：

  • 简单的一次性脚本或临时任务（nWave 的仪式感对这类任务过于沉重）
  • 不使用 Claude Code/Codex/OpenCode 的用户（目前仅支持这三者）
  • 需要 AI 完全自主完成端到端任务（这与 nWave 核心哲学相悖）

输入与输出案例

案例 1：新增用户登录功能

输入：/nw-discuss "user login with email and password"
nWave 产出：
  → requirements.md（用户故事：作为 XX 用户，我想通过邮箱密码登录，以便...）
  → user-journeys.md（正常流：输入邮箱→输入密码→点击登录→跳转首页；
                       异常流：邮箱格式错误/密码错误/账号不存在）
  → acceptance-criteria.md（登录成功率、响应时间、错误提示文案）
用户审阅通过后，Claude Code 提示可以进入 DESIGN wave。

案例 2：修复线上 Bug

输入：/nw-distill "login-button-unresponsive"
nWave 产出：
  → acceptance-test.md（Given: 用户已输入正确凭证；When: 点击登录按钮；Then: 跳转首页，耗时<2s）
  → 相关测试用例被写入测试文件
用户确认测试覆盖正确后，进入 DELIVER wave：
  → Claude Code 先跑测试（RED）→ 修复代码让测试通过（GREEN）→ 提交（COMMIT）
  → 全程 TDD 规范执行，每步可审阅。

GitHub: https://github.com/nWave-ai/nWave

评论区

0 条评论

登录后可评论。

Skill超级捕获手 1465 阅读