Book of Kiro

Kiro 入門系列影片

Mon, 01 Jan 0001 00:00:00 +0000

Kiro 入門系列影片#

本系列影片涵蓋 Kiro IDE、Kiro CLI 和 Kiro 自主 Agent 的核心功能介紹，幫助您快速上手 Kiro 平台。

Kiro 特色功能#

在 Kiro 中使用 Spec-driven development - 規範驅動開發入門指南#

📺 在 Bilibili 觀看 | 時長：08:17

介紹 Kiro 獨有的 Spec-driven development（規範驅動開發）工作流程。

在 Kiro 中打造「專才」Agent - Kiro powers 原理與功能介紹#

📺 在 Bilibili 觀看 | 時長：07:26

介紹如何使用 Kiro powers 打造專業化的 Agent。

玩轉 Kiro 自主 Agent - 向 Kiro autonomous agent 提交任務的三種方式#

📺 在 Bilibili 觀看 | 時長：08:37

介紹向 Kiro autonomous agent 提交任務的三種方式。

Kiro IDE#

Kiro IDE功能介紹（一）- Steering, Agent Hooks, MCP#

📺 在 Bilibili 觀看 | 時長：10:23

飛書 Remote MCP 設定

Mon, 01 Jan 0001 00:00:00 +0000

飛書 Remote MCP 設定#

透過設定飛書 Remote MCP，可以在 Kiro 中直接操作飛書雲文件，實現文件搜尋、建立、編輯、評論等功能。

效果展示#

在 Kiro 中透過 MCP 呼叫飛書工具，自動產生技術文件：

以下為產生文件的部分章節截圖，展示了文件結構、流程圖和程式碼區塊等多種內容類型：

專案概述與架構圖

登入流程時序圖

資料庫表設計

一、前置準備#

1.1 建立飛書應用#

造訪飛書開放平台
建立自建應用
在憑證與基礎資訊頁面取得：
- App ID
- App Secret

1.2 設定重新導向 URL#

進入應用的安全設定頁面
在重新導向 URL 中新增：http://localhost:8080/callback
儲存設定

1.3 申請權限#

在權限管理頁面申請以下權限：

文件權限：

權限標識	說明
`docx:document:readonly`	查看新版文件
`docx:document:create`	建立新版文件
`docx:document:write_only`	編輯新版文件
`search:docs:read`	搜尋文件
`wiki:wiki:readonly`	查看所有知識庫
`wiki:node:read`	查看知識空間節點資訊

使用者權限：

開始使用

Mon, 01 Jan 0001 00:00:00 +0000

Kiro CLI 安裝與介紹#

Kiro CLI 是 Kiro 平台的命令列元件，提供高度互動式的終端機程式設計體驗。它支援自訂 Agent、複雜程式碼庫功能建構、工作流程自動化和精確的錯誤分析。

安裝 Kiro CLI#

在 macOS 和 Linux 系統上安裝：

curl -fsSL https://cli.kiro.dev/install | bash

Kiro CLI 的功能介紹#

💬 開始聊天#

登入後，直接使用 kiro-cli 指令即可開始聊天（kiro-cli 是 kiro-cli chat 指令的縮寫）。

您可以使用 kiro-cli chat --help 來查看額外的參數。

進入聊天後，您可以使用 /help 查看工作階段中的指令。下文中所有以 / 開頭的指令都是在工作階段中執行的。

📁 引用檔案或資料夾#

在聊天視窗中，檔案名稱會有自動補全的效果，您可以按下 Tab 來進行路徑自動補全。

只要告訴 Agent 需要讀取的檔案路徑，Agent 就會自動讀取檔案或資料夾中的資訊。

除了手動引用，您還可以使用自訂智慧代理來設定 Agent 預設讀取的檔案。

⏹️ 打斷 Agent#

在 Agent 工作的過程中可以隨時使用 Ctrl+C 或者 Ctrl+D 來打斷 Agent 的工作。

💾 儲存工作階段和載入工作階段#

使用 /save xxx 來儲存工作階段，使用 /load xxx.json 來載入工作階段。

自訂智慧代理

Mon, 01 Jan 0001 00:00:00 +0000

自訂智慧代理#

Kiro CLI 支援建立自訂智慧代理，讓您可以根據特定需求設定專門的開發助手。透過 JSON 設定檔，您可以定制 Agent 的行為、權限和預設上下文。

設定檔位置#

Kiro CLI 會把智慧代理的設定檔儲存在 ~/.kiro/agents/*.json 路徑中，您可以建立不同的 JSON 設定檔，從而建立自訂的智慧代理出來。

完整設定可以參考官方文件

📚 自動上下文#

在自訂智慧代理的設定檔中，可以設定 resource 欄位，設定一些檔案路徑，這些路徑的檔案會被自動包含在聊天中。

預設設定#

{
 "resources": [
 "file://README.md",
 "file://AGENTS.md",
 "file://AmazonQ.md",
 "file://.amazonq/rules/**/*.md",
 "file://.kiro/steering/**/*.md",
 "file://~/.kiro/steering/**/*.md"
 ]
}

所以每次和 CLI 聊天時，它都會自動包含 README 檔案，對已有的專案有所了解。

詳見官方文件

🔧 工具管理#

🚫 停用不需要的工具#

自訂智慧代理的設定檔中，可以設定 tools 欄位，包含了啟用哪些 tools。如果您有不想使用的 tools，可以從列表中刪除。

{
 "tools": [
 "fs_read",
 "fs_write",
 "execute_bash",
 "@git",
 "@rust-analyzer/check_code"
 ]
}

比如，如果不希望 AI 修改本地檔案，可以停用 fs_write 工具和 execute_bash 工具。

詳見官方文件

✅ 信任工具的執行#

自訂智慧代理的設定檔中，可以設定 allowedTools 欄位，包含了信任哪些 tools

Kiro 特色功能

Mon, 01 Jan 0001 00:00:00 +0000

Kiro 特色功能#

Kiro 不僅僅是一個 AI IDE，更是一個完整的智慧開發平台。以下三大特色功能讓 Kiro 在眾多開發工具中脫穎而出，為開發者提供前所未有的程式設計體驗。

📋 Spec 模式 — 結構化開發的革命#

❓ 什麼是 Spec？為什麼它這麼重要？#

傳統開發是不是經常是這種節奏：

“先幫我做個登入功能吧” —— 要求模模糊糊
好吧，先寫著再說
“啊對了，還要加密碼重置”
“郵件認證也別忘了加一下”
最後程式碼一團糟、文件跟不上、需求越改越亂……

😵‍💫 完全失控。而 Spec，就是來解決這個老問題的！
它會讓 AI 幫你整理模糊需求，變成一份結構清晰、條理清楚的規範文件。
——不再邊寫邊猜、不再回頭大改，你的專案，從一開始就走在正軌上。✅

🛠️ Spec 的三大階段（這真的很革命 🔥）#

1️⃣ Requirements（需求）階段 —— 明確"要做什麼"#

# 實際示例：Kiro 自動生成的需求定義

## 使用者故事
As a: 使用者
I want to: 使用郵箱地址和密碼登入
So that: 能使用服務的個性化功能

## 接受標準（EARS 語法）
When: 使用者訪問登入頁面時
The system shall: 顯示登入表單
With:
 - 郵箱地址輸入框
 - 密碼輸入框（以掩碼形式顯示）
 - "登入"按鈕
 - "忘記密碼"連結

When: 使用者輸入正確的認證資訊並點選登入按鈕時
The system shall: 將使用者重定向到儀表板頁面
And: 生成 JWT 權杖並啟動會話

When: 使用者輸入了錯誤的認證資訊時
The system shall: 顯示錯誤資訊
But: 出於安全考慮，不顯示具體錯誤原因

是不是很驚人？僅僅一句"寫個登入功能"，它就能把需求細化到如此詳細的程度，真是超神奇！

開始使用

Mon, 01 Jan 0001 00:00:00 +0000

開始使用 Kiro IDE#

🚀 快速上手 - 5 分鐘啟動 Kiro IDE！#

最速安裝指南（真的只要 5 分鐘）#

首先，我們來安裝 Kiro IDE。不過別緊張，和安裝普通 App 一樣簡單！

下載 Kiro IDE 造訪 https://kiro.dev/downloads 下載適合您系統的版本

安裝 IDE macOS：將下載的 Kiro.app 拖到 Applications 資料夾
Windows：雙擊下載的安裝程式執行
Linux：為 AppImage 新增執行權限後啟動

初次啟動時的設定（這裡超重要！）

🔐 登入方式選擇#

GitHub：如果你是個人開發者，選這個最輕鬆
Google：用 Gmail 帳號一鍵登入
AWS Builder ID：沒有 AWS 帳號？選這個就對了（而且完全免費）
AWS IAM Identity Center：適合在公司或團隊環境中使用

⚙️ 匯入 VS Code 設定#

選擇「Import VS Code Settings」可以直接繼承你現在的編輯器設定，包括擴充外掛、主題樣式都能原樣複用，真的很方便！

💻 啟用 Shell 整合（必選項！）#

出現提示時，請一定要點擊「Allow」！
這一步能讓 AI 直接執行終端機命令，解鎖全自動開發體驗 🚀

📂 來開啟你的第一個專案吧！#

# 如果你喜歡用終端機開啟專案的話：
cd my-project
kiro .

# 或者也可以從 Kiro 的選單列操作：
File > Open Folder > 選擇你的專案資料夾

開啟專案後，點擊左側邊欄那個 Kiro 的幽靈圖示。這就是 Kiro 的核心區域，也是你和 AI 開始對話的地方！👻

外掛管理

Mon, 01 Jan 0001 00:00:00 +0000

外掛管理#

外掛可以為 Kiro 提供額外的語言支援，實現跳轉到定義、跳轉到實現等功能。

從 Kiro 的外掛市集安裝#

在左側導覽列中，點擊 Extensions 圖示，介面左側顯示外掛面板，您可在面板中搜尋需要使用的外掛並安裝。

從 VSCode 的外掛市集安裝#

由於 Kiro 使用 OpenVSX Registry 管理外掛，有些 VSCode 中的外掛可能無法在 Kiro 外掛市集中找到。您可以從 VSCode 外掛市集中下載 VSIX 檔案然後手動安裝。

使用 Chrome 瀏覽器外掛下載外掛#

下載外掛最簡單的方式是安裝 Visual Studio Marketplace Downloader Chrome 瀏覽器外掛，安裝後在 Visual Studio Marketplace 會出現 Download 按鈕，點擊即可下載對應的外掛。

前往 Visual Studio Marketplace Downloader Chrome 瀏覽器外掛頁面安裝外掛。
前往 VS Code 的外掛市集。
搜尋你想要的外掛，例如：Deno。
在搜尋結果中，點擊你所需的外掛。你會前往該外掛的詳情頁。
點擊詳情頁中的 Download 按鈕即可下載外掛。

此方法下載的外掛檔案，副檔名為 .zip，重新命名副檔名為 .vsix 即可使用。

手動拼接 URL 下載外掛#

前往 VS Code 的外掛市集。
搜尋你想要的外掛，例如：Deno。
在搜尋結果中，點擊你所需的外掛。你會前往該外掛的詳情頁。
在詳情頁中，點擊 Version History。
結合外掛頁的 URL 和 Version History 中的資訊，提取出以下資訊（以 Deno 為例）：
- itemName：URL Query 中的 itemName 欄位，如 Deno 的 itemName 為 denoland.vscode-deno，並將小數點（.）前後的內容分成以下兩個欄位：
  - fieldA：denoland
  - fieldB：vscode-deno
- version：如截圖中的 3.43.3
使用提取出來的 3 個欄位的值替換下方 URL 中的同名欄位。
- 範本：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/${itemName.fieldA}/vsextensions/${itemName.fieldB}/${version}/vspackage
- 範例：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/denoland/vsextensions/vscode-deno/3.43.3/vspackage
在瀏覽器中輸入修改後的 URL，然後按下 Enter 鍵。瀏覽器開始下載該外掛。

在 Kiro 中安裝 VSIX 外掛#

在外掛面板選項中點擊 Install from VSIX 即可選擇本機外掛檔案進行安裝。

常見問題

Mon, 01 Jan 0001 00:00:00 +0000

Kiro IDE 常見問題#

重要提示：Agent 自主性設定（Autopilot vs Supervised 模式）和受信任命令管理已移至開始使用頁面，建議先閱讀該部分內容。

資料隱私與遙測#

如何關閉 Kiro IDE 的遙測功能？#

有兩種方法可以關閉遙測：

方法 1：透過設定介面

Settings → Application → Telemetry and Content → 關閉（Disabled）

方法 2：透過 settings.json 設定

{
 "telemetry": {
 "enabled": false
 },
 "usageStatisticsEnabled": false
}

如何為不同專案設定不同的隱私設定？#

Kiro 支援全域和專案級別的設定：

# 全域設定（適用於所有專案）
~/.kiro/settings.json

# 專案專屬設定（優先級更高）
.kiro/settings.json

注意：如果專案設定包含 API 金鑰等敏感資訊，建議將 .kiro/settings.json 新增到 .gitignore 檔案中。

聊天歷史記錄位置#

Kiro IDE 的聊天記錄儲存在哪裡？#

聊天記錄以 JSON 格式儲存在以下位置：

Windows: ~\AppData\Roaming\Kiro\User\globalStorage\kiro.kiroagent\<userid>\*.chat
macOS: ~/Library/Application Support/Kiro/User/globalStorage/kiro.kiroagent/<userid>/*.chat
Linux: ~/.config/Kiro/User/globalStorage/kiro.kiroagent/<userid>/*.chat

可以匯出聊天歷史記錄嗎？#

目前 Kiro 還沒有聊天會話匯出功能，但您可以直接存取上述路徑中的 JSON 檔案來取得原始聊天資料。

疑難排解

Mon, 01 Jan 0001 00:00:00 +0000

Kiro IDE 常見問題#

Error streaming response: Cannot read properties of undefined (reading ‘model’)#

請嘗試重新啟動 IDE 並檢查系統網路狀態

GitHub Issue: https://github.com/kirodotdev/Kiro/issues/1147

Error streaming response: EntryNotFound (FileSystemError)#

請升級至最新版 IDE，並在新建立的會話中互動。舊版本的 Kiro 建立的聊天會話可能存在此問題。

GitHub Issue: https://github.com/kirodotdev/Kiro/issues/3897

CPU/記憶體佔用過高#

確保升級到 v0.6.0 版本以上
確保設定中 Codebase Indexing 已停用

原因：Codebase Indexing 功能會對專案檔案進行索引，可能會佔用較多的 CPU 和記憶體資源，特別在專案較大時，資源佔用尤為明顯。如果不需要該功能，建議停用以提升效能。v0.6.0 版本預設停用了此功能，並在設定中提供了開關選項。

上下文選單中沒有 `#Codebase` 和 `#Repository Map` 選項#

這兩個選項需要在設定中啟用 Codebase Indexing 才能啟動。但是需要注意：啟用 Codebase Indexing 後可能會導致 CPU/記憶體佔用過高。Agentic Coding 時代基於 Local RAG 的 Codebase indexing 不再是必選項，它會消耗額外效能（CPU 和記憶體），召回效果不穩定，並且可以使用 fs_search tool 或類似的 CLI 代替，甚至效果更好。所以並不建議使用

常見問題

Mon, 01 Jan 0001 00:00:00 +0000

Kiro CLI 常見問題#

基本使用問題#

Kiro CLI 如何查看我是付費版還是免費版？#

登入後使用 kiro-cli whoami 查看。Builder ID 是免費版，IAM Identity Center 是付費版

Kiro CLI 如何登出？#

使用 kiro-cli logout 指令進行登出。

在 Windows 上透過 WSL 的方式來使用 Kiro CLI，消耗多少資源？#

Windows 上透過 WSL 的方式來使用 Kiro CLI 使用的資源非常有限。在 Windows 上安裝 WSL 並且安裝 Kiro CLI 之後的記憶體開銷很小。

有非互動式模式嗎？#

有。使用指令：kiro-cli chat --no-interactive --trust-all-tools

可以在容器中用嗎？#

可以。參考 auto-q 專案

可以在 CI/CD 流水線裡用嗎？#

請參考相關部落格在 GitLab 中進行設定，GitHub 等其他儲存庫可參考部落格中的流程。

需要注意：由於 Amazon Q Developer CLI 升級到了 Kiro CLI，所以部落格中的檔案路徑 ~/.local/share/amazon-q/ 應為 ~/.local/share/kiro-cli

Kiro × OpenClaw 整合指南

Mon, 01 Jan 0001 00:00:00 +0000

Kiro × OpenClaw 整合指南#

OpenClaw 是一個開源 AI Agent 執行環境，擅長多平台訊息處理、定時任務、裝置控制和外部系統整合。Kiro 擅長程式碼產生、架構設計和 AWS 雲端維運。兩者透過 ACP + MCP 雙協議實現雙向協作，各取所長。

方向	協議	核心價值
OpenClaw → Kiro	ACP	OpenClaw 獲得「深度思考和編碼」的能力
Kiro → OpenClaw	MCP	Kiro 獲得「觸達外部世界」的能力

一、OpenClaw 呼叫 Kiro#

當 OpenClaw 需要完成程式碼產生、架構分析、AWS CDK 範本等複雜編碼任務時，可以將任務委派給 Kiro。

1. 透過 acpx 呼叫（建議）#

OpenClaw 的 acpx（ACP 命令列用戶端）已內建支援 Kiro CLI 作為 coding agent（adapter: kiro-cli-chat acp），與 Codex、Claude Code、Gemini 等並列為 built-in agent。

安裝：

npm install -g acpx@latest
# 或無需安裝直接用
npx acpx@latest kiro 'fix the failing tests'

常用命令：

Kiro 技術部落格

Mon, 01 Jan 0001 00:00:00 +0000

Kiro 相關技術部落格#

以下收錄了 AWS 官方部落格中與 Kiro 相關的技術文章，按發布時間倒序排列。

基於Amazon Quick與Amazon Bedrock AgentCore打造對話式 FinOps助手#

日期：2026-05-28 | 分類：Artificial Intelligence

介紹如何將 AWS 帳單相關 API 透過 MCP 協議封裝為工具，部署到 Amazon Bedrock AgentCore Runtime，並接入 Amazon Quick Chat Agent。文中對 awslabs 的 billing-cost-management-mcp-server 做了改造，所有改造均透過 Kiro 以 Vibe Coding 的方式完成。

🔗 閱讀全文

基於 Amazon ECS Fargate 自建 Keycloak 作為 AWS IAM Identity Center 外部 IdP，為 Kiro 提供企業級 SSO 登入#

日期：2026-05-22 | 分類：Security, Identity & Compliance

Kiro 支援 Google、GitHub、AWS Builder ID、AWS IAM Identity Center（IdC）多種登入方式。本文聚焦 IdC 這條路徑，介紹如何基於 Amazon ECS Fargate 自建 Keycloak 作為外部身分提供商，適合需要把 Kiro 納入企業身分治理、按組織統一下發權限的團隊。

設定 MCP

Mon, 01 Jan 0001 00:00:00 +0000

設定 MCP#

MCP 是什麼？為什麼這麼厲害？#

MCP 是給 Kiro 的 AI 加上“特殊技能”的機制。比如：

能夠搜尋 AWS 官方文件
能夠操作 GitHub 儲存庫
能夠進行網頁搜尋
能夠連線資料庫這些能力就像外掛一樣，可以隨時新增進來，讓 AI 變得更加萬能，幫你搞定各種開發任務！

主要 MCP 伺服器的設定與使用方法#

1. AWS Documentation Server — 訪問 AWS 官方文件#

// 追加到 .kiro/settings/mcp.json

{
 "mcpServers": {
 "aws-docs": {
 "command": "uvx",
 "args": ["awslabs.aws-documentation-mcp-server@latest"],
 "env": {
 "FASTMCP_LOG_LEVEL": "ERROR" // 日誌級別設為最小，減少輸出
 },
 "disabled": false,
 "autoApprove": [
 "mcp_aws_docs_search_documentation", // 搜尋請求自動批准
 "mcp_aws_docs_read_documentation" // 讀取請求自動批准
 ]
 }
 }
}

實際使用示例：

# 只需在聊天中提問
"S3 的生命週期策略是什麼？"
"Lambda 函式的冷啟動如何最佳化？"
"DynamoDB partition key 設計的最佳實踐有哪些？"

# Kiro 會自動搜尋 AWS 官方文件並回答

必要的準備工作：

疑難排解

Mon, 01 Jan 0001 00:00:00 +0000

CLI 疑難排解#

CLI 常見錯誤及解決方案#

如何使用 GitHub/Google 登入#

執行 kiro-cli login 後即可選擇是否透過 GitHub 或 Google 登入，並彈出系統瀏覽器完成登入過程。

如果您使用沒有圖形介面的系統環境，執行 kiro-cli login 則只會顯示 Builder ID 登入方式或企業登入方式，您可以選擇 Builder ID 使用電子郵件註冊登入

執行 MCP Tool 時報錯#

報錯：Improperly formed request 或 An unexpected error occurred

通常是 MCP Tool 的描述格式不規範，特別是 input_schema 欄位，需要嚴格保證為合法的 JSON Schema

可以使用 /tools schema 子指令查看 MCP Tool 的描述，確認 input_schema 欄位是否合法

使用蘋果原生 Terminal 時當機#

建議使用 iTerm2 作為 Terminal 來使用 Kiro CLI。

如果需要排查當機原因，可以嘗試使用此腳本收集 Terminal 日誌後交給 Kiro CLI 來排查

快速鍵

Mon, 01 Jan 0001 00:00:00 +0000

Kiro IDE 快速鍵完全掌握指南#

🎯 必記！超實用的 Kiro 快速鍵 TOP10#

只要先記住這幾個，基本上你就能用好 Kiro 的 80% 功能了：

想做的事	Mac 快速鍵	Windows / Linux 快速鍵	會發生什麼？
把選中的程式碼新增到新的對話中	Cmd + L	Ctrl + L	將選中的程式碼直接新增到新的對話中，開始和 AI 對話
把選中的程式碼新增到目前對話	Cmd + Shift + L	Ctrl + Shift + L	將選中的程式碼直接新增到目前開啟的對話中
選中程式碼精準編輯	Cmd + I	Ctrl + I	在游標處啟動 AI，可以邊寫程式碼邊提問
命令面板	Cmd + Shift + P	Ctrl + Shift + P	開啟命令面板，存取 Kiro 所有功能
開啟檔案	Cmd + P	Ctrl + P	輸入檔案名稱的一部分就能快速開啟
儲存檔案	Cmd + S	Ctrl + S	老朋友了，必須記
專案內搜尋	Cmd + Shift + F	Ctrl + Shift + F	在整個專案裡搜尋文字內容
跳轉到定義	F12	F12	一鍵跳轉到函式或類別的定義處
修復錯誤	懸停錯誤 → Quick fix	相同	AI 會自動給出修復建議
開啟終端機	Ctrl + （反引號 `）	Ctrl + （反引號 `）	顯示或隱藏整合終端機
顯示/隱藏側邊欄	Cmd + B	Ctrl + B	顯示或隱藏側邊欄，適合想全螢幕操作時使用

💡 實用又方便的小技巧快速鍵#

# 多游標編輯（學會它效率翻 3 倍）
Option + 點擊（Mac）/ Alt + 點擊（Windows）
→ 可以在多個位置同時出現游標，同時編輯多個地方

# 移動整行程式碼（超級實用的小技巧）
Option + ↑/↓（Mac）/ Alt + ↑/↓（Windows）
→ 整行程式碼上下移動，排版修改超方便

# 複製整行（寫測試資料時超好用）
Option + Shift + ↑/↓（Mac）/ Alt + Shift + ↑/↓（Windows）
→ 直接複製目前行並插入上下位置

# 快速註解（最常用，沒有之一）
Cmd + /（Mac）/ Ctrl + /（Windows）
→ 選中程式碼一鍵註解/取消註解，除錯神技！

Autonomous Agent 功能介紹

Mon, 01 Jan 0001 00:00:00 +0000

Kiro Autonomous Agent 自主智慧代理#

Kiro Autonomous Agent 是 Kiro 平台的前沿元件，能夠獨立處理開發任務，保持上下文並從每次互動中學習。

Autonomous Agent 目前正在向 Kiro Pro、Pro+ 和 Power 使用者推出預覽版。團隊存取需要透過候補名單邀請。

🤖 核心特性#

自主工作能力#

讓 Kiro 自主處理開發任務，您可以保持專注或暫時離開，工作會繼續進行。

上下文保持#

回到任務時可以從中斷的地方繼續，無需重新建構上下文。

跨儲存庫執行#

建立任務後，Kiro 會處理跨所有儲存庫的規劃和實施。

並行執行不阻塞工作流程#

在隔離的沙箱環境中執行任務並開啟 Pull Request 供審查，工作在您專注於當前任務時繼續進行。

持續的上下文管理#

在任務、儲存庫和 Pull Request 之間保持上下文，並使用您的審查回饋來塑造未來的變更，使其更好地匹配您和團隊建構軟體的方式。

一次性多儲存庫變更#

規劃一次變更，讓 Kiro 建立協調的編輯和 Pull Request，將相關更新一起落地到各個儲存庫，而不是逐個處理。

👥 團隊協作功能#

Kiro Autonomous Agent 為團隊帶來上下文和協調，與您的工程團隊一起工作以放大影響力：

🚀 更快地協同發布#

在團隊中並行執行開發工作，使發布能夠以更少的停滯和協調拖累向前推進。

🔧 跨技術堆疊工作#

連接團隊的儲存庫、流水線和協作工具，在工作進展時將計畫、變更和理由保持在一個共享上下文中。

🎯 保護專注時間#

處理常規修復、後續工作和狀態更新，使工程師面臨更少的中斷，保持更長的深度工作時間區塊。

📚 從團隊中學習#

持續從您的程式碼庫、工單和回饋中學習，以更好地與團隊的開發模式保持一致。

🔐 安全與隔離#

沙箱環境：所有任務在隔離的環境中執行，確保安全性
Pull Request 工作流程：變更透過 PR 提交，保持程式碼審查流程
權限控制：遵循現有的儲存庫權限和存取控制

📋 使用場景#

個人開發者#

自動化重複性開發任務
跨專案維護一致性
在您專注於核心功能時處理輔助任務

團隊協作#

協調多儲存庫功能開發
自動化程式碼維護和更新
減少團隊間的協調開銷

企業級應用#

大規模程式碼庫管理
合規性和安全性檢查
跨團隊標準化實施

🚀 開始使用#

Autonomous Agent 目前處於預覽階段，僅對符合條件的使用者開放。

社群實踐

Mon, 01 Jan 0001 00:00:00 +0000

最佳實踐與社群經驗#

實踐使用示例#

專案初期設定的完美流程#

# 1. 在專案目錄開啟 Kiro
cd my-awesome-project
kiro .

# 2. 自動生成基礎 Steering 檔案
開啟 Kiro 面板 → 選擇 "Generate Steering Docs"
# 會自動生成 product.md、tech.md、structure.md

# 3. 新增專案特有的配置
cat > .kiro/steering/conventions.md << 'EOF'
# 開發規範

## 提交資訊規範
- feat: 新功能
- fix: Bug 修復
- docs: 文件變更
- style: 程式碼格式調整
- refactor: 重構
- test: 測試相關
- chore: 其他雜項

## 分支策略
- main: 生產環境
- develop: 開發環境
- feature/*: 新功能開發
- hotfix/*: 緊急修復

## 程式碼審查標準
- 測試透過
- 覆蓋率 80% 以上
- 無 ESLint 錯誤
- 文件已更新
EOF

# 4. 設定必備 Hooks
# 儲存時自動格式化
Hooks → + → 選擇 "儲存檔案時自動執行 ESLint 和 Prettier"

# 提交前安全掃描
Hooks → + → 選擇 "git commit 前掃描敏感資訊"

# 5. 配置 MCP 伺服器
cat > .kiro/settings/mcp.json << 'EOF'
{
 "mcpServers": {
 "web-search": {
 "command": "npx",
 "args": ["-y", "@modelcontextprotocol/server-bravesearch"],
 "env": {
 "BRAVE_API_KEY": "${BRAVE_API_KEY}"
 }
 }
 }
}
EOF

# 6. 設定團隊共享的 .gitignore
cat >> .gitignore << 'EOF'
# Kiro 配置檔案
.kiro/settings.json
.kiro/cache/
.kiro/logs/

# 但以下內容需要共享
!.kiro/steering/
!.kiro/hooks/
!.kiro/specs/
EOF

🎊 總結 - Kiro 改變開發方式#

用 Kiro 開始後帶來的變化#

編碼速度提升 3 倍

透過 Spec 整理需求 → AI 自動實作
複雜工作由 Hooks 自動完成
利用 MCP 減少查資料時間

質量顯著提升

統一編碼風格
自動生成測試
自動安全檢查

學習曲線更平緩

AI 支援不熟悉的技術
自然掌握最佳實踐
現場學習錯誤解決方案

3 個簡單步驟立刻開始體驗#

# 第一步：安裝（5分鐘）
從 https://kiro.dev 下載並安裝

# 第二步：開啟第一個專案（10分鐘）
開啟現有專案，生成 Steering 檔案

# 第三步：與 AI 對話（無限可能）
"幫我提出改進這個專案的建議"

社群實踐參考#

本文內容引用自官方 Discord 社群中的 best practice 頻道與飛書社群中的討論

為團隊訂閱 Kiro

Mon, 01 Jan 0001 00:00:00 +0000

為團隊訂閱 Kiro#

本指南將逐步介紹如何建立 Kiro 設定檔並透過 AWS IAM Identity Center 為使用者訂閱 Kiro 企業版。

前提條件#

在開始之前，請確保您具備以下條件：

AWS 帳戶

您需要一個 AWS 帳戶。如果您還沒有帳戶，可以建立 AWS 帳戶。

AWS 權限

作為 Kiro 管理員，您必須具有存取 AWS 中 Kiro 主控台的權限，以便訂閱和管理 Kiro 使用者。您需要的最低權限在策略：允許管理員設定 Kiro 並訂閱使用者中有詳細說明。

AWS IAM Identity Center

您必須在 AWS 帳戶中設定 IAM Identity Center 實例，並包含要訂閱 Kiro 的使用者身分。您的 IAM Identity Center 實例必須位於支援的 AWS 區域中。

使用者和群組

您可以將使用者和群組新增到 IAM Identity Center 的內建目錄，或新增到連接到 IAM Identity Center 的外部身分提供商 (IdP)。有關更多資訊，請參閱 IAM Identity Center 入門指南。

建立 Kiro 設定檔#

登入 AWS 管理主控台

常見問題

Mon, 01 Jan 0001 00:00:00 +0000

Kiro 企業版常見問題#

使用者管理#

企業使用者如何查詢員工使用情況？#

Kiro 提供以下方式查看使用情況：

Kiro usage dashboard。在 Kiro 企業管理主控台中，在設定介面啟用 Kiro usage dashboard，然後在企業管理主控台的 Dashboard 介面可以查看，只能看到整體情況。
Kiro user activity report。在 Kiro 企業管理主控台中，在設定介面啟用 Kiro user activity report，資料會以 CSV 格式儲存到 Amazon S3 上，可以看到每個人每一天的使用情況。如果您在設定過程中遇到了問題，通常是需要設定 Amazon S3 的權限，請參考此文件。

如何批次建立使用者並訂閱 Kiro？#

如果您需要一次性匯入大量使用者（例如團隊名單），可以使用社群工具 bulk-create-users 實作：

準備一個 CSV 檔案，包含使用者資訊（郵箱、姓名、群組、訂閱層級等）
使用 idc_manager.py create-users 批次建立 IAM Identity Center 使用者並傳送密碼重設郵件
使用 kiro_subscribe.py 根據 CSV 中的層級資訊批次訂閱 Kiro

整個流程支援 dry-run 預覽、冪等操作（已存在的使用者會自動跳過），詳見批次使用者管理指南。

如何將 Kiro 訂閱從一個 AWS 帳戶遷移到另一個帳戶？#

使用 bulk-create-users 提供的一鍵遷移命令：

python kiro_migrate.py \
 --source-profile source-account \
 --target-profile target-account \
 --region us-east-1

該命令會自動完成 5 個步驟：匯出來源帳戶的 Identity Store 和 Kiro 訂閱 → 匯入到目標帳戶 → 傳送密碼重設郵件 → 重建 Kiro 訂閱。所有步驟冪等，中斷後可安全重跑。

批次使用者管理

Mon, 01 Jan 0001 00:00:00 +0000

批次使用者管理與跨帳戶遷移#

社群工具 bulk-create-users 提供了批次建立 IAM Identity Center 使用者、訂閱 Kiro、以及跨帳戶遷移的能力。

前提條件#

Python 3.10+
AWS CLI 已設定憑證
IAM 權限：identitystore:*、sso:ListInstances
遷移場景需要來源帳戶和目標帳戶的 AWS 憑證（使用 --profile）

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

工具一覽#

腳本	用途
`idc_manager.py create-users`	從 CSV 批次建立使用者
`idc_manager.py reset-password`	傳送密碼重設郵件
`idc_manager.py export-store`	匯出 Identity Store（使用者、群組、成員關係）
`idc_manager.py import-store`	匯入 Identity Store 到另一個帳戶
`idc_manager.py export-subscriptions`	匯出 Kiro 訂閱（含使用者詳情）
`kiro_subscribe.py`	批次訂閱 Kiro（Pro / Pro+ / Power）
`kiro_migrate.py`	一鍵跨帳戶遷移

場景一：批次匯入新使用者#

1. 準備 CSV#

UserName,GivenName,FamilyName,DisplayName,Email,Groups,KiroTier
jsmith,John,Smith,John Smith,jsmith@example.com,KiroUsers,Kiro Pro
jdoe,Jane,Doe,Jane Doe,jdoe@example.com,"KiroUsers,KiroAdmins",Kiro Pro+

列名大小寫不敏感，Email 為必填，其餘可選。完整列名映射見 README。

從 Amazon Q Developer 遷移

Mon, 01 Jan 0001 00:00:00 +0000

遷移到 Kiro#

如果您已經訂閱 Amazon Q Developer Pro，並且想要遷移到 Kiro，可以參考以下步驟。

管理員操作#

升級訂閱#

首先，登入 Kiro 主控台，在左側面板選擇 Amazon Q Developer 訂閱介面，然後點擊 Upgrade to Kiro

選擇要進行升級的使用者或群組，然後點擊右上角選擇 Kiro Plan，然後點擊下一步

確認訂閱計畫無誤後，點擊右下角的 Upgrade 按鈕

完成後，會被重新導向到 Kiro 的使用者訂閱介面

至此即完成了訂閱的升級。原本 Amazon Q Developer Pro 的訂閱已被取消，被升級為了 Kiro 訂閱。

啟用資料統計和指標#

由於 Kiro 的資料指標和 Amazon Q Developer 的資料指標是兩套不同的系統，您還需要為 Kiro 啟動 Dashboard, Prompt Logging 和使用者級指標 (User Activity Report)。

使用者操作#

切換 Kiro IDE 訂閱#

管理員完成上述步驟後，使用者只需要退出 Kiro 用戶端並重新啟動，即可重新整理登入狀態，對話中也可以看到消耗的 Credit 以及耗時

vs. Cursor

Mon, 01 Jan 0001 00:00:00 +0000

Kiro vs. Cursor#

Cursor 是由 Anysphere 開發的 AI 驅動程式碼編輯器。Kiro 是由 AWS 開發的完整 AI 開發平台，包含 IDE、CLI 和 Autonomous Agent 三大元件。兩款工具都旨在提升開發者生產力。Cursor 是 Visual Studio Code 的分支，而 Kiro IDE 也基於 VS Code 構建，並提供了更廣泛的開發工具生態系統。

總結#

Kiro 是一個完整的 AI 開發平台，而 Cursor 是一個 AI 驅動的 IDE。兩者都能提升開發者生產力，但採用了不同的方法。以下是主要區別：

Kiro 的獨特優勢：

完整平台方案：包含 IDE、CLI 和 Autonomous Agent，提供全方位的開發體驗
Spec-driven development：結構化處理複雜開發任務的方法，將軟體開發過程正式化 - 這是 Kiro 獨有的功能
Agent Hooks：當 IDE 中發生特定事件時執行預定義 Agent 操作的自動觸發器
Autonomous Agent：前沿的自主智慧體，能夠獨立處理開發任務並跨儲存庫工作
靈活的自主性：既有 Autopilot 模式（自主完成端對端任務）也有 Supervised 模式（應用更改前人工審查）
CLI 整合：強大的命令列工具，支援自定義 Agent 和工作流程自動化

Cursor 的獨特優勢：

vs. Amazon Q Developer

Mon, 01 Jan 0001 00:00:00 +0000

Kiro vs. Amazon Q Developer IDE 外掛#

總結#

Kiro 和 Amazon Q Developer 都是 AWS 出品的 AI 開發工具。Kiro 是一個完整的 AI 開發平台（包含 IDE、CLI 和 Autonomous Agent），而 Amazon Q Developer 主要以 IDE 外掛形式提供。從整體使用者體驗而言，Kiro 提供更全面的解決方案，Amazon Q Developer 外掛則支援不同的 IDE，使用者無需更換原有 IDE。以下是主要區別：

Kiro 的獨特優勢：

完整平台方案：包含 IDE、CLI 和 Autonomous Agent，提供全方位的開發體驗
Spec Mode：結構化處理複雜開發任務的方法，將軟體開發過程正式化 - 這是 Kiro 獨有的功能
Agent Hooks：當 IDE 中發生特定事件時執行預定義代理操作的自動觸發器
Autonomous Agent：前沿的自主智慧體，能夠獨立處理開發任務並跨儲存庫工作
靈活的自主性：既有 Autopilot mode（自主修改）也有 Supervised mode（應用更改前審查）
CLI 整合：強大的命令列工具，支援自定義 Agent 和工作流程自動化
豐富的上下文引用：支援 #Docs、#Git、#Rules、#Terminals、#Web 等多種上下文引用方式

Amazon Q Developer 的獨特優勢：

Book of Kiro

Kiro 入門系列影片

Kiro 入門系列影片#

Kiro 特色功能#

在 Kiro 中使用 Spec-driven development - 規範驅動開發入門指南#

在 Kiro 中打造「專才」Agent - Kiro powers 原理與功能介紹#

玩轉 Kiro 自主 Agent - 向 Kiro autonomous agent 提交任務的三種方式#

Kiro IDE#

Kiro IDE功能介紹（一）- Steering, Agent Hooks, MCP#

飛書 Remote MCP 設定

飛書 Remote MCP 設定#

效果展示#

一、前置準備#

1.1 建立飛書應用#

1.2 設定重新導向 URL#

1.3 申請權限#

開始使用

Kiro CLI 安裝與介紹#

安裝 Kiro CLI#

Kiro CLI 的功能介紹#

💬 開始聊天#

📁 引用檔案或資料夾#

⏹️ 打斷 Agent#

💾 儲存工作階段和載入工作階段#

自訂智慧代理

自訂智慧代理#

設定檔位置#

📚 自動上下文#

預設設定#

🔧 工具管理#

🚫 停用不需要的工具#

✅ 信任工具的執行#

Kiro 特色功能

Kiro 特色功能#

📋 Spec 模式 — 結構化開發的革命#

❓ 什麼是 Spec？為什麼它這麼重要？#

🛠️ Spec 的三大階段（這真的很革命 🔥）#

1️⃣ Requirements（需求）階段 —— 明確"要做什麼"#

開始使用

開始使用 Kiro IDE#

🚀 快速上手 - 5 分鐘啟動 Kiro IDE！#

最速安裝指南（真的只要 5 分鐘）#

🔐 登入方式選擇#

⚙️ 匯入 VS Code 設定#

💻 啟用 Shell 整合（必選項！）#

📂 來開啟你的第一個專案吧！#

外掛管理

外掛管理#

從 Kiro 的外掛市集安裝#

從 VSCode 的外掛市集安裝#

使用 Chrome 瀏覽器外掛下載外掛#

手動拼接 URL 下載外掛#

在 Kiro 中安裝 VSIX 外掛#

常見問題

Kiro IDE 常見問題#

資料隱私與遙測#

如何關閉 Kiro IDE 的遙測功能？#

如何為不同專案設定不同的隱私設定？#

聊天歷史記錄位置#

Kiro IDE 的聊天記錄儲存在哪裡？#

可以匯出聊天歷史記錄嗎？#

疑難排解

Kiro IDE 常見問題#

Error streaming response: Cannot read properties of undefined (reading ‘model’)#

Error streaming response: EntryNotFound (FileSystemError)#

CPU/記憶體佔用過高#

上下文選單中沒有 #Codebase 和 #Repository Map 選項#

常見問題

Kiro CLI 常見問題#

基本使用問題#

Kiro CLI 如何查看我是付費版還是免費版？#

Kiro CLI 如何登出？#

在 Windows 上透過 WSL 的方式來使用 Kiro CLI，消耗多少資源？#

有非互動式模式嗎？#

可以在容器中用嗎？#

可以在 CI/CD 流水線裡用嗎？#

Kiro × OpenClaw 整合指南

Kiro × OpenClaw 整合指南#

一、OpenClaw 呼叫 Kiro#

1. 透過 acpx 呼叫（建議）#

上下文選單中沒有 `#Codebase` 和 `#Repository Map` 選項#