Arcrun

Leo/Arcrun

Fork 0

Commit Graph

Author	SHA1	Message	Date
uncle6me-web	7e87a3336b	3.8 新增 write_recipe skill——recipe 指路終於有目的地 📋 SDD：workflow-discovery task 3.8（3.7 的 suggestion 指 skill write_recipe，之前是空地——指路會指到不存在的 skill）。 - registry/skills/write_recipe.md：從真 code 反推，不是憑空教學—— schema＝routes/recipes.ts RecipeDefinition（canonical_id/endpoint/method/auth_service…）；真範例＝api-recipe-seeds.ts 的 telegram_send（URL path 注入）＋gmail_send（service account）； auth recipe 必填欄位（required_secrets 的 help_url 必填）照 POST /auth-recipes 驗證邏輯；常犯錯收錄實錄（sheets append PUT→POST、telegram auth recipe 漏種、金鑰只准名字 D36） - INDEX.md 補 write_recipe 入口；「/cypher/search 假 found」坑改標已修（2026-07-31） - write_intent_workflow.md §6 status 表改 not_found 契約＋suggestion/similar_* 欄說明安裝器 seed：registry/skills/*.md 由 sync-registry-to-kbdb.py 自動收，新檔即納入。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-31 11:56:30 +08:00
Leo	fac7d6c9bb	AI 一連上 MCP 就知道從哪開始（leo 追問揪出的最後一哩） 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。	2026-07-30 22:29:28 +08:00

Author

SHA1

Message

Date

uncle6me-web

7e87a3336b

3.8 新增 write_recipe skill——recipe 指路終於有目的地

📋 SDD：workflow-discovery task 3.8（3.7 的 suggestion 指 skill write_recipe，
之前是空地——指路會指到不存在的 skill）。

- registry/skills/write_recipe.md：從真 code 反推，不是憑空教學——
  schema＝routes/recipes.ts RecipeDefinition（canonical_id/endpoint/method/auth_service…）；
  真範例＝api-recipe-seeds.ts 的 telegram_send（URL path 注入）＋gmail_send（service account）；
  auth recipe 必填欄位（required_secrets 的 help_url 必填）照 POST /auth-recipes 驗證邏輯；
  常犯錯收錄實錄（sheets append PUT→POST、telegram auth recipe 漏種、金鑰只准名字 D36）
- INDEX.md 補 write_recipe 入口；「/cypher/search 假 found」坑改標已修（2026-07-31）
- write_intent_workflow.md §6 status 表改 not_found 契約＋suggestion/similar_* 欄說明

安裝器 seed：registry/skills/*.md 由 sync-registry-to-kbdb.py 自動收，新檔即納入。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-31 11:56:30 +08:00

Leo

fac7d6c9bb

AI 一連上 MCP 就知道從哪開始（leo 追問揪出的最後一哩）

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。

2026-07-30 22:29:28 +08:00

2 Commits