nWave-ai/nWave

nWave – 专为 Claude Code 设计的 AI 驱动功能交付助手

是什么

• 一组位于 Anthropic 的 Claude Code IDE 内的 AI 代理，引导开发者完成结构化的七步“波浪”工作流（discover → diverge → discuss → design → devops → distill → deliver）。
• 每个波浪由专用代理处理，生成文档、设计、测试、代码等成果物，人类在进入下一波浪前需审查。系统在无人类批准的情况下从不执行端到端流程。

如何工作

• 安装只需一个脚本，该脚本添加 nwave‑ai CLI 并将代理注册为 Claude Code 插件。CLI 可通过 uv（推荐）或 pipx 安装。
• 在 Claude Code 中通过斜杠命令调用代理，例如 /nw‑discover、/nw‑design、/nw‑deliver。一个管家命令 /nw‑buddy 可以告诉你下一步该从哪个波浪开始。
• 一个 DES（设计强制系统）层监控每个代理调用，强制执行 TDD 阶段、同行评审要求和其他严格性配置。它会阻止不安全的编辑并报告清晰消息。
• 可通过 /nw‑rigor（轻量、标准、严谨、详尽，或自定义配置）为每个项目调整严格性，让你在令牌成本与质量之间取得平衡。

核心概念

波浪	典型入口点	代理	目标
DISCOVER	新项目启动	product‑discoverer	探索市场/问题空间
DIVERGE	新项目头脑风暴	nw‑diverger	生成多种可能的解决方案
DISCUSS	任意项目	product‑owner	编写需求与用户旅程
DESIGN	所有项目	system‑designer, ddd‑architect, solution‑architect	架构与领域模型
DEVOPS	所有项目	platform‑architect	基础设施与部署计划
DISTILL	所有项目	acceptance‑designer	接受测试（Given-When-Then）
DELIVER	所有项目	software‑crafter	TDD 实现（RED→GREEN→COMMIT）

安装（5 分钟）

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

• 需要 Python 3.10+ 和正在运行的 Claude Code 实例。
• 脚本安装 CLI（nwave‑ai）并将代理复制到 ~/.claude/。
• 可选：使用 uv 实现更快、隔离的安装；pipx 也可用。

典型第一步

1. 打开 Claude Code 并运行 /nw‑buddy What should I do next? —— 伙伴会告诉你该从哪个波浪开始。
2. 按顺序运行波浪命令，例如：

   /nw‑diverge "authentication approaches"
   /nw‑discuss "login with email & password"
   /nw‑design --architecture=hexagonal
   /nw‑distill "user‑login"
   /nw‑deliver
   

3. 在批准下一波浪前，审查每个代理生成的成果物（Markdown 文档、设计图、测试文件）。

质量与令牌效率

• 严格性配置允许你选择语言模型大小（haiku, sonnet, opus），并决定是否运行变异测试、同行评审等。
• 轻量模式使用最小模型并跳过评审员，适合快速原型；详尽模式使用最大模型并运行完整的变异测试，适用于生产关键代码。

维护

• CLI 在 Claude Code 启动时检查更新；可通过 uv tool upgrade nwave‑ai && nwave‑ai install（或等效的 pipx 命令）升级。
• 通过 nwave‑ai uninstall 卸载 —— 它会移除代理、命令和 DES 钩子，但保留你的项目文件。

文档与社区

• 完整文档在 docs.nwave.ai —— 包含指南、参考文档，按发布版本维护。
• 快速入门教程：Your First Feature。
• Discord 社区用于支持和讨论。
• 问题和贡献通过 GitHub 仓库处理。

适用人群

• 希望获得 AI 辅助但依然掌控每一步的个人开发者。
• 希望在项目间标准化纪律性、AI 增强工作流（TDD、同行评审、基础设施即代码）的团队。
• 需要一种方式在利用 Claude Code 代码生成能力的同时强制执行工程最佳实践的组织。

---

以上所有信息均直接来自仓库的 README；未推断任何额外功能。