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；未推斷任何額外功能。