在理解了 OpenSpec（負責規格）與 Superpowers（負責紀律）的完美分工後，許多開發者會問：「那在實際的終端機（CLI）環境中，我到底該怎麼下指令？」
目前市面上支援代理（Agentic）能力的 AI 終端機工具眾多（例如 Claude Code、Cursor 的終端模式，或是各類 CLI 工具）。只要你的環境中已經安裝並啟動了這兩套框架，就可以透過「標準 Shell 指令」、「OpenSpec 專屬指令（以/ 開頭）」以及「自然語言指令」的混合使用，來推動整個專案。以下我們以**「為網站新增深色模式（Dark Mode）」**為例，帶你走過這五個關鍵階段的實際操作對話。
準備工作：初始化專案
在開始任何新功能之前，請先確保你的專案根目錄已經初始化了 OpenSpec。請在終端機輸入：
openspec init階段一：需求釐清與規格制定 (Clarify & Define)
在這個階段，我們的目標是把模糊的想法，轉化為結構化的 OpenSpec 規格文件。
1. 啟動腦力激盪 直接用自然語言告訴 AI 你的想法，這會自動觸發 Superpowers 的 brainstorming（腦力激盪）技能：
你： 我想要在網站的頁尾 (footer) 新增一個「深色模式」的切換開關。能不能幫我 brainstorm 一下需求和設計方案？ AI： 沒問題！在開始前我們需要釐清幾個細節：1. 使用者選擇的狀態要存在 LocalStorage 嗎？ 2. 預設要跟隨作業系統的顏色設定嗎？ 3. 專案目前的 CSS 變數架構是如何管理的？...
(請與 AI 進行問答，直到雙方對實作細節達成共識)
2. 建立新功能資料夾 共識達成後，使用 OpenSpec 指令建立該功能的專屬資料夾：
你： /opsx:new add-dark-mode AI： 已為您建立
openspec/changes/add-dark-mode/目錄。
3. 快速生成規格文件 接著，請 AI 將剛剛的討論結果固化成標準文件：
你： /opsx:ff AI： 正在根據對話紀錄生成文件... ✓ 生成
proposal.md✓ 生成specs/(具體需求場景) ✓ 生成design.md(技術設計方案) ✓ 生成tasks.md(高階實作清單)
階段二：建立隔離的開發環境 (Isolate Environment)
為了確保主分支（Main branch）的乾淨與安全，我們需要建立獨立的工作區。請觸發 Superpowers 的 using-git-worktrees 技能：
你： 規格文件都準備好了。請幫我建立一個隔離的 Git Worktree 來開發這個功能，並確保測試環境是乾淨的。 AI： 正在建立獨立的開發分支
feat/add-dark-mode與 Worktree... 正在執行基礎測試... 基準線確認為綠燈，環境已隔離完畢。
階段三：任務拆解與細化 (Deconstruct Tasks)
OpenSpec 產生的 tasks.md 通常是高階任務，我們需要呼叫 Superpowers 的 writing-plans 技能，將其拆解得更細碎。
你： 請讀取
openspec/changes/add-dark-mode/tasks.md。請使用你的計畫技能，將這些大任務拆解成非常小的「微型任務」（每個約 2-5 分鐘可完成），以便我們後續進行嚴格的 TDD 開發。 AI： 沒問題，已將計畫細化為：1. 在theme.css中定義深色 CSS 變數。 2. 建立ThemeToggle.test.tsx測試空殼。 3. 實作切換按鈕邏輯...等 8 個微型步驟。
階段四：紀律化的程式碼實作 (Disciplined Implementation)
這是整個流程中最關鍵的一步，也是極致發揮效能的秘訣：上下文衛生（Context Hygiene）。 為了防止 AI 被前面長篇大論的腦力激盪干擾，請先清空你的終端機對話紀錄。
1. 清空紀錄並重新載入規格 執行你習慣的清空畫面指令（如 /clear 或重啟 Session），然後輸入：
你： 請詳細閱讀
openspec/changes/add-dark-mode/目錄下的design.md以及你剛剛拆解的微型計畫清單。我們接下來將完全以這些文件為依據進行開發。
2. 開始 TDD 循環 指示 AI 啟動實作，觸發 test-driven-development 技能：
你： 開始執行微型計畫的第一項任務。請嚴格遵守 TDD (Red-Green-Refactor) 流程：先寫一個會失敗的測試，再寫實作碼讓它通過。 AI： 收到。正在建立
ThemeToggle.test.tsx測試檔... AI： 執行測試... 🔴 失敗 (Red)。 AI： 正在實作ThemeToggle.tsx核心邏輯... AI： 再次執行測試... 🟢 通過 (Green)。正在檢查是否需要重構...
(AI 會持續這個循環，直到回報所有微型任務皆已完成)
階段五：審查與收尾 (Review & Finalize)
1. 程式碼審查 完成實作後，請 AI 進行自我驗收：
你： 所有任務看來都完成了。請執行 Code Review，嚴格檢查目前的實作是否完全符合
openspec/changes/add-dark-mode/specs/中的需求定義。 AI： 正在比對規格與程式碼... 審查完畢，所有需求場景皆已滿足，無重大缺失。
2. 合併與清理 觸發 finishing-a-development-branch 技能來收尾：
你： 審查沒問題。請結束這個開發分支，將代碼合併回主分支，並清理 Worktree。 AI： 已成功合併至 main 分支，Worktree 已刪除並回到主目錄。
3. 規格歸檔 最後，將這次的開發文件歸檔，更新專案的全域狀態：
你： /opsx:archive AI： 已將
add-dark-mode歸檔至openspec/changes/archive/。專案全域規格已更新完成。
恭喜！透過這套指令流程，你不僅完成了一個新功能，還留下了一份完美的規格文件與高測試覆蓋率的程式碼，同時讓 AI 的記憶保持在最乾淨、最高效的狀態！
