Leo
fac7d6c9bb
leo：「arcrun_get_skill 放在 MCP 裡，現在人類說『幫我用 arcrun 寫 xxx』， Haiku 會說『arcrun 是什麼？我看看』然後發現有個 arcrun mcp 就去執行？ 如果不會，要寫什麼在外面讓它一聽到就知道要用這些資源？」 實測答案：**不會**。 ① 總管寫的指引沒有任何入口指向它（真實 AI 找不到） ② MCP 五個 skill 沒有「怎麼寫意圖工作流」這支 ③ AI 只看到 41 個工具名 → 自己猜 → 很可能直接 push_workflow 瞎編， 或去讀 registry/examples 那 8/13 引用不存在零件的壞範例 兩件修法： 1. registry/skills/write_intent_workflow.md — 把指引變成 AI 拿得到的 skill （範本全取自實跑 verdict=success 的四支 workflow；含「查詢現在回假 found」的已知限制警告） 2. mcp-handler.ts instructions 開場指路 — instructions 是唯一「AI 一連上就必看」的欄位 ⇒ 開場就寫明五步順序（先讀 write_intent_workflow → whoami → 查零件 → list_skills → 缺件怎麼補） ＋邊只有兩種、第一個節點是 input、不要因查不到就改寫 code ⚠️ 靜態常數：KBDB 掛了也必出現（守「不擋連線」鐵律） 驗：tsc 零錯誤。⏳ 待部署後由 leo 真的問 haiku「幫我用 arcrun 做 X」驗證它會不會自己讀 skill。
Arcrun Skill Library
給 AI 操盤手用的 playbook（pattern + 流程指引）。 比 examples 更高層 — examples 是「可直接用的 YAML」，skills 是「面對 X 問題該怎麼想 + 該用什麼 example」。
對應 SDD:
matrix/arcrun/.agents/specs/llm-interface/Milestone 3.1
結構
每個 skill 是一份 markdown：
{skill-name}.md
Skill 清單
| Skill | 何時用 |
|---|---|
build_watcher_workflow |
用戶想「每 X 分鐘掃資料，找到符合的處理」 |
debug_paused_workflow |
workflow 卡 paused 不動了 |
migrate_http_to_trigger_workflow |
看到舊 workflow 用 http_request 自打，CF self-fetch 死鎖 |
rag_with_arcrun |
用戶想做「問問題 + 用我的資料回答」 |
add_new_wasm_component |
缺零件需要寫新的（TinyGo WASM） |
CI 自動同步
GH Actions 監聽本目錄變動 → PATCH 每個 skill 進 KBDB type=agent-skill block。
MCP arcrun_list_skills(tag?) / arcrun_get_skill(slug) 給 AI 查。