# KIRO IDE 綜合筆記說明書

## 1. 總覽：新一代的 AI 代理程式設計環境

KIRO 是由 AWS 發布的一款全新的 AI 代理程式設計（Agentic IDE）產品，基於 VS Code 構建。它不僅僅是一個程式碼助理，更是一個能理解開發目標、跨文件工作、調試問題並執行端到端任務的 AI 代理。其核心理念是引入**規範驅動開發（Spec-Driven Development）**，旨在以前所未有的清晰度和速度，將創意轉化為可投入生產的系統。

- **定位**：AI 代理程式設計師，而非單純的程式碼助手。
- **內置模型**：目前主要支持 Claude 4.0 和 Claude 3.7 Sonnet。
- **目前狀態**：處於公開預覽階段，可免費使用。

## 2. 核心特色功能

### 2.1 兩種開發模式：Vibe vs. Spec

開啟專案時，KIRO 提供了兩種截然不同的工作模式：

- **Vibe 模式（先交流再構建）**：
- 類似於 Cursor 等現有的 AI IDE。
- 開發者直接下達指令，AI 助理立即開始生成程式碼。
- 適合快速、直接的開發任務。

- **Spec 模式（先規劃後構建）**：
- **KIRO 的最大亮點**。它引入了傳統軟體工程的標準化流程，使開發過程更加可控和結構化。
- AI 不會立即寫程式碼，而是先引導你完成以下三個階段，並生成對應的規範文件：
1. **需求分析 (`requirements.md`)**：根據你的初步想法，生成詳細的需求文檔，包含用戶故事（User Story）和驗收標準（Acceptance Criteria）。
2. **設計階段 (`design.md`)**：基於需求，制定全面的設計文檔，涵蓋技術棧選擇、系統架構、組件結構、API 接口、資料庫模式、測試策略和錯誤處理等。
3. **任務規劃 (`tasks.md`)**：將設計拆解成一系列具體的開發任務列表，每個任務都清晰描述了要編寫的程式碼和對應的功能需求。
- 完成規劃後，你可以點擊任務列表中的 `Start Task`，讓 AI 逐一完成編碼工作。

### 2.2 代理鉤子 (Agent Hooks)

Hooks 是 KIRO 的另一個創新功能。它是一種事件驅動的自動化工具，允許你在特定事件發生時（如保存文件、創建文件），自動觸發預定義的 AI 操作。

- **概念**：類似於程式設計中的回調（Callback）或 Git Hooks。
- **目的**：將重複性、流程性的工作自動化，消除瑣碎的手動檢查，確保團隊開發標準的一致性。
- **典型應用場景**：
- **自動化測試**：保存功能性程式碼後，自動檢查、創建或更新單元測試，並執行測試。
- **文件同步**：修改 API 端點時，自動更新相關的 `README.md` 文檔。
- **程式碼品質與安全**：在提交（commit）前，自動掃描程式碼中的語法錯誤或洩露的憑證。
- **模板程式碼生成**：創建新的 React 組件時，自動添加必要的 `import` 語句和框架程式碼。

### 2.3 其他功能

- **多模態上下文集成**：可以在聊天中直接貼上截圖，讓 AI 理解 UI 問題並進行修正。
- **MCP 服務集成**：已成為現代 AI IDE 的標準配置，可以集成更多外部服務。
- **代理引導 (Agent Guidance)**：可以設定規則，指導 KIRO 的行為以適應特定專案的產品願景、技術棧和架構。

## 3. 與其他工具的比較

- **相較於 Cursor, Windsurf**：
- 最大的不同在於 **Spec 模式**。傳統 AI IDE 缺乏前期系統性的需求管理、設計和任務規劃，而 KIRO 將其原生整合，使大型或複雜專案的開發更加可控。
- **與 Claude Code 協同工作**：
- KIRO 的 Spec 模式生成的詳細規範文件（`requirements.md`, `design.md`, `tasks.md`）可以被直接複製到 Claude Code 專案中。
- Claude Code 能夠讀取並理解這些高度結構化的文件，從而更精準、高效地完成後續的程式碼開發工作。這種「KIRO 規劃 + Claude Code 開發」的組合模式，被認為是一種非常強大的工作流程。

## 4. 價格與未來展望

- **預覽階段**：目前完全免費。
- **正式版收費**：預計推出免費版和高級版（Pro / Pro+），例如 Pro 版可能為每月 19 美金，提供 1000 次「任務」執行額度。
- **未來發展**：
- 預計會引入更多 AI 模型（如 Opus），特別是在規劃階段，推理能力更強的模型可能會帶來更好的效果。
- 隨著功能的完善，其自動化和專案管理能力將進一步增強。

## 5. 相關重量級產品：Amazon AgentCore

除了 KIRO，AWS 還發布了一個更底層的基礎設施——**Amazon AgentCore**。它是一個幫助企業構建、部署和運維 AI Agent 的全棧服務系統，可以被視為未來所有 AI 應用的數字基礎設施。

- **核心模塊**：
- **AgentCore Runtime**：支持多模態任務，可讓 Agent 持續運行長達 8 小時。
- **AgentCore Memory**：賦予 Agent 記憶系統，使其能夠記住對話和專案狀態。
- **AgentCore Gateway + Identity**：允許 Agent 直接調用企業內部的 API、資料庫和第三方 SaaS 工具，並具備身份驗證和權限控制，像一個真正的「數字員工」。

如果說 KIRO 是今日開發者手中的利器，那麼 AgentCore 則是 AWS 為未來 Agentic AI 時代佈局的超級平台。

## 6. 上手體驗總結

綜合多位體驗者的反饋，KIRO IDE 帶來了「耳目一新」的感覺。特別是其 Spec 模式，被認為是處理複雜任務或團隊協作時的「神器」。它將軟體工程的最佳實踐與 AI 的強大能力相結合，為開發流程帶來了前所未有的結構性和自動化水平。儘管目前仍處於預覽階段，偶爾會因用戶過多而出現限流問題，但其設計理念和功能潛力已獲得開發者社群的高度評價。