實戰 Cookbook

把前面學到的東西組合起來,對應你工作上真的會碰到的情境。

場景一:讀懂一個陌生專案

cd ~/some-repo
kiro-cli chat

❯ 我剛接手這個專案。幫我:1) 說明它的用途與架構 2) 列出主要進入點 3) 指出我該先讀哪幾個檔

場景二:修 bug 並驗證

❯ 執行測試,挑出失敗的那幾個,找出根因並修好,修完再跑一次確認綠燈

場景三:補測試

❯ src/services/ 底下哪些檔沒有測試?幫沒覆蓋到的補上單元測試並執行

場景四:安全的重構

先切到模式二(寫檔免核准、shell 走白名單):

kiro-cli chat --trust-tools=read,write,grep,glob,code

❯ 把 callback 風格的非同步程式改寫成 async/await,保持行為不變,改完跑測試

場景五:一次跑多個專案(燒整批任務)

#!/usr/bin/env bash
projects=(~/proj/a ~/proj/b ~/proj/c)
for p in "${projects[@]}"; do
  ( cd "$p" && kiro-cli chat --trust-all-tools --no-interactive \
      "更新依賴、修掉警告、跑測試,最後輸出一份變更摘要" \
      > kiro-run.log 2>&1 ) &
done
wait
echo "全部完成 ✓"

每個專案各自在背景跑,log 分開存,對話也照目錄各自隔離。

場景六:平行分析再彙整

❯ 平行分析 auth、payment、search 三個模組的安全風險,完成後彙整成一份報告

Kiro 會開 subagent 把三條分析同時跑,再 fan-in 收成一份報告。記得父 agent 要先設好 crew 信任(細節看 Subagent 那章)。

場景七:CI 裡的 headless 自動化

在 CI 的 step 裡:

kiro-cli chat --no-interactive --trust-tools=read,grep,shell \
  "跑 lint 與測試,如果有失敗就總結原因並以非零碼結束"

場景八:邊做邊存進度

❯ /chat save 重構-訂單模組

隔天回來接著做:

kiro-cli chat --resume
# 或
kiro-cli chat
/chat load 重構-訂單模組

下一章來看:出事的時候怎麼查。