kiro 有無增加 global Agent, 或是 hook 之類的方法

[slps970093]

如題目
我需要讓龍蝦自動執行 kiro sdd 規劃的需求一個一個去給他完成，但我需要設定自定義的 global Agent

[thepagent]

Kiro 所有配置都在 ~/.kiro 下，有幾個要注意的

• Kiro CLI 不支持 SDD， Kiro IDE 才支持
• 預設 .kiro/steering/**/*.md 都會讀取
• 整個 homedir (/home/agent) PVC 持久化
• ~/.kiro/agents/*.json 定義你的 custom agent

因此

1. 你可以自行寫入 steering/ 下的任何 md, 新的session起來就會全部讀取
2. 即便kiro-cli 不支持SDD，你依然可以自己發揮想像力讓他寫到 steering 下例如 requirements.md design.md and tasks.md 方便你後續處理
3. 你可以設定 ~/.kiro/agents/default.json 讓他進一步讀取 ~/.kiro/skills/**/SKILL.md 進而調用SKILL
4. 整個 /home/agent 家目錄全部任你發揮，雖然PVC持久化，但記得備份到其他地方去。

default.json 範例：

% cat ~/.kiro/agents/default.json | jq -r .resources
[
  "file://README.md",
  "skill://.kiro/skills/**/SKILL.md",
  "skill:///home/agent/.kiro/skills/**/SKILL.md",
  "file://.kiro/rules/**/*.md",
  "file://.kiro/steering/**/*.md"
]

• kiro-cli doc https://kiro.dev/docs/cli/

[thepagent]

self-assigned. I'll write up doc/kiro-guidance.md

[thepagent]

Kiro CLI 如何決定預設 Agent 與載入哪個 Agent JSON

預設 Agent

直接執行 kiro-cli 時，使用內建的 kiro_default agent。可以用 --agent <名稱> 覆蓋。

Agent JSON 搜尋順序

1. .kiro/agents/<名稱>.json ← 本地（專案層級），優先
2. ~/.kiro/agents/<名稱>.json ← 全域（使用者層級），備援

兩邊都有同名 agent 時，本地的贏，並顯示警告。

Agent JSON 控制什麼

欄位	用途
tools	可用的工具（內建 + MCP）
allowedTools	哪些工具可以免確認直接執行
resources	載入的檔案、skills、知識庫
mcpServers	外部 MCP server 連線設定
prompt	系統層級的提示詞（字串或 file:// 指向外部檔案）
model	使用哪個模型（未設定則用預設）
hooks	生命週期事件觸發的指令（啟動、工具執行前後等）

資源載入方式

• file:// 資源 → agent 啟動時立即載入到 context
• skill:// 資源 → 啟動時只載入 metadata（name + description），agent 判斷需要時才按需載入完整內容
• knowledgeBase 資源 → 建立索引後透過語意搜尋取用

流程圖

┌──────────────────┐ ┌────────────────────────┐ ┌──────────────────┐
│ kiro-cli --agent │ ──> │ 搜尋 .kiro/agents/ │ ──> │ 載入 JSON 設定 │
│ <名稱> │ │ 再搜尋 ~/.kiro/agents/ │ │ + 資源 / skills │
└──────────────────┘ └────────────────────────┘ └──────────────────┘

簡單說：檔名去掉 .json 就是 agent 名稱，本地覆蓋全域，沒指定就用 kiro_default。

[thepagent]

另外，有任何跟Kiro有關的問題，最快的方式就是直接進入 kiro-cli之後

> check https://kiro.dev/docs/cli/ - 後面接你的問題

KIRO CLI 會自己查看文件，提供你最好的解答。

[thepagent]

DC https://discord.com/channels/1491295327620169908/1491365150664560881/1491585275292291163