# KIRO IDE 實戰應用指南 這份指南將深入探討 KIRO 在實際開發中的應用流程，整合其兩大核心功能：**規格 (Specs)** 與 **鉤子 (Hooks)**，幫助您了解如何最大化利用這個 AI 優先的開發環境。 ## 1. 核心理念：Vibe vs. Spec 雙模式開發 KIRO 提供了兩種截然不同的開發模式，您可以根據專案需求選擇： - **Vibe 模式 (先聊天後建構)**： - 也被戲稱為 **"YOLO 模式"**。 - 流程類似於 Cursor 等其他 AI IDE，您直接下達指令，AI 立即修改程式碼。 - 適合探索想法、快速迭代和需求尚不清晰的場景。 - **Spec 模式 (先規劃後建構)**： - 也被戲稱為 **"過度工程模式 (Overengineer Mode)"**。 - 這是 KIRO 的最大亮點。它引入了結構化的開發流程，雖然速度較慢，但**極大地提升了 AI 輸出的準確性和可靠性**，減少了來回溝通修改的時間。 - 適合功能想得比較透徹、需要前期規劃的專案，或以結構化方式建構功能的場景。 --- ## 2. 起手式：從代理引導 (Agent Steering) 開始 在開始大型功能開發前，強烈建議先執行 **Agent Steering**。這一步會讓 KIRO 分析您的整個專案，產生指導 AI 行為的上下文文件，確保後續所有操作都基於對專案的充分理解。 1. KIRO 會掃描您的程式碼庫。 2. 在 `.kiro/steering/` 目錄下生成三個核心文件： - `product.md`：應用程式的產品願景和核心功能描述。 - `structure.md`：專案的目錄結構、路由模式、命名慣例等。 - `tech.md`：使用的技術棧、框架版本、腳本命令等。 3. 這些文件都是 **Markdown 格式**，您可以隨時手動編輯或要求 AI 更新，以確保 AI 的認知與專案保持同步。 --- ## 3. Spec 模式深度解析：從想法到實作的三部曲 Spec 模式會將您的一個簡單提示（Prompt）轉化為一個嚴謹的三步驟開發流程。 ### **第一步：生成需求 (`requirements.md`)** 當您輸入一個功能需求（例如：「為我的產品增加匿名評論功能」）後，KIRO 不會馬上寫程式碼。 - 它會先生成一份 `requirements.md` 文件。 - 文件內容包含： - **用戶故事 (User Stories)**：將您的需求轉化為多個「身為一個用戶，我想要...」的標準格式。 - **驗收標準 (Acceptance Criteria)**：為每個用戶故事定義具體的、可驗證的完成標準，涵蓋各種邊界情況。 - **優勢**：這個步驟能**將一個模糊的提示變得清晰**，明確 AI 即將要做的假設。您可以審查這份文件，若不符預期，可以要求 KIRO 修改，或直接手動編輯文件。 ### **第二步：生成設計 (`design.md`)** 當您對需求文件感到滿意後，便可進入設計階段。 - KIRO 會**先分析現有的程式碼庫**，以理解當前的架構和技術棧。 - 接著，它會生成一份非常詳細的 `design.md` 文件，可能包含： - **架構總覽**：系統如何擴展現有功能。 - **數據流圖**：用戶操作的數據傳遞路徑。 - **技術棧確認**：確認使用的資料庫、前端框架等。 - **API 端點** 和 **數據庫結構 (Schemas)** 的定義。 - **TypeScript 接口 (Interfaces)**。 - 甚至可以使用 **Mermaid** 語法生成流程圖。 - **優勢**：在 AI 動手前，您就能**精確地知道它將要如何實作**，徹底解決了傳統 AI 工具「盲盒式」開發的問題。 ### **第三步：生成實作計畫 (`tasks.md`)** 設計確認後，KIRO 會將設計文檔拆解成一份可執行的任務清單。 - 生成 `tasks.md` 文件。 - 這份清單包含了**一系列帶有子任務的詳細步驟**，例如： 1. 建立後端 API 端點。 2. 更新數據庫模型。 3. 建立前端 React 組件。 4. 為組件編寫單元測試（即使您沒要求）。 5. 實現全面的錯誤處理。 - **優勢**：任務被拆解得非常細緻，您可以逐一執行，並且每個任務都與最初的需求相關聯。 --- ## 4. 執行與互動 在 `tasks.md` 文件中，您可以點擊每個任務旁的 `Start Task` 來讓 KIRO 開始編碼。 - **任務佇列**：您可以一次點擊多個任務，它們會被加入到執行佇列中，KIRO 會自動一個接一個完成。 - **同步性**：KIRO 的目標是讓 Spec 文件與您的程式碼庫保持同步。當您手動修改程式碼後，可以要求 KIRO 更新 Spec；反之亦然。 ### **重要注意事項** - **命令授權**：在執行任務時，KIRO 可能會請求運行終端命令（如 `npm run dev`）。您需要手動**授權**（Run）或**拒絕**（Reject）。您可以選擇信任某個特定命令，以便未來自動執行。 - **需要監督**：您不能完全放手讓它跑。有時開發伺服器啟動後，KIRO 會卡住等待，需要您手動停止它才會繼續下一步。 - **單一執行佇列**：這是目前 KIRO 的一個主要痛點。**所有任務（包括 Spec 任務和 Hooks）都共享同一個佇列**。這意味著當一個耗時的任務正在執行時，您無法同時執行其他操作，會感覺有點慢。 --- ## 5. 自動化的利器：代理鉤子 (Agent Hooks) Hooks 是 KIRO 的另一個殺手級功能，它是一種**事件驅動的自動化工具**，類似 "If This Then That"。 - **觸發事件**：監聽如**文件創建、保存、刪除**等事件。 - **執行操作**：當事件觸發時，在後台自動執行一個預設的 AI 指令。 ### **創建與應用** 1. **用自然語言描述**：您只需用白話描述您想要的鉤子，例如：「當我更新 package.json 的 scripts 時，自動更新 README.md 文件中的可用腳本列表」。 2. **KIRO 生成鉤子**：AI 會為您生成一個更複雜的系統提示 (System Prompt) 和配置文件。 3. **共享與協作**：鉤子會被保存為專案中的一個文件（在 `.kiro/hooks/` 目錄下），這意味著您可以將它**提交到 Git**，與團隊共享。這對於確保整個團隊的開發規範一致性（如：每次提交前自動格式化、添加單元測試）非常有幫助。 ### **實用案例** - **文檔同步**：當您保存一個 API 文件時，自動更新相關的 Postman collection 或文檔。 - **自動化測試**：當您保存一個 React 組件時，自動為其創建或更新單元測試文件。 - **程式碼優化**：當您保存程式碼時，自動檢查是否有可優化的地方。 --- ## 6. 其他功能與定價 - **MCP 伺服器**：KIRO 提供了清晰的 UI 來管理 MCP 伺服器，而不是藏在設定深處。 - **Autopilot 模式**：一個開關按鈕，開啟後 KIRO 在修改文件前不會請求批准，體驗更接近其他 AI IDE。 - **上下文窗口**：可以添加文件、程式碼、URL、圖片等多種上下文。 - **模型選擇**：目前由 Claude 驅動，支持 Sonnet 3.7 和 4.0。 - **定價**： - **預覽期間**：完全免費。 - **未來定價**： - **免費版**：每月 50 次互動。 - **Pro 版 ($19/月)**：每月 1,000 次互動。 - **Pro+ 版 ($39/月)**：每月 3,000 次互動。 --- ## 7. 總結：優缺點與權衡 ### **優點** 👍 - **極高的準確性**：Spec 模式通過結構化流程，顯著提高了 AI 輸出的可靠性。 - **強大的自動化**：Hooks 功能是自動化重複性任務和保證團隊一致性的利器。 - **清晰的開發流程**：在 AI 動手前就清楚了解它的完整計畫，避免了意外的修改。 - **優秀的 UI 整合**：將 Spec、Hooks、MCP 等複雜功能以直觀的 UI 呈現。 ### **缺點** 👎 - **速度偏慢**：由於其詳盡的分析和單一執行佇列，整體感覺比其他工具慢。 - **資源消耗大**：運行時可能會讓電腦發熱，被形容為一隻「鉛做的鬼魂 (lead ghost)」。 - **預覽版不穩定**：目前仍是預覽版，偶爾會遇到 bug 或 UI 無響應的情況。 ### **最終權衡** KIRO 提供的是一種**用速度換取可靠性**的開發體驗。如果您厭倦了與 AI 反复拉扯、修正它的錯誤，並希望將軟體工程的最佳實踐融入 AI 開發流程，那麼 KIRO 帶來的結構化和準確性將會讓您印象深刻。