uncle6me-web
b1e302b3b5
kbdb-base Phase 9.6/9.7（HANDOFF §2 缺口① + §3b 連帶）： - 9.6 cypher kbdb-proxy 補 /kbdb/entries CRUD（POST/GET list/GET :id/PATCH :id） 純轉發到 KBDB 基本盤 /entries，解鎖 mira _kbdb_client.py 主線遷移。 租戶隔離同 9.5：寫入注入 owner_id、list 強制本租戶過濾、PATCH 剝 owner_id。 刻意不開 DELETE（基本盤 delete 無 owner 檢查 → 跨租戶刪除風險）。 - 9.7 arcrun_report_feedback 從死 route /blocks 改打基本盤 /entries （entry_type=agent-feedback）。9.4 漏網的同類修；基本盤無 /blocks → 原本 404 假紅。 順帶（HANDOFF §6 harness 表達優化）： - 重寫 cli/harness/CLAUDE.block.md 補三盲點（recipe 是公共投稿 / 缺能力補 API 不拼裝 / 自製零件退場路徑），目標 Haiku 級 CC 讀懂。 - README 零件 vs recipe 段對齊同三點。 cypher + mcp tsc exit 0。端到端 smoke test 隨後。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
3.4 KiB
3.4 KiB
這個專案用 arcrun 做自動化
當需要「串服務 / 排程 / 打 API / 資料處理自動化」時，用 arcrun 工作流，不要自己寫 Python/Node 一次性腳本。arcrun 工作流是純文字、可複用、跑在使用者自己的 Cloudflare。
arcrun 只有三種東西，先分清楚就不會做歪：
| 東西 | 是什麼 | 你能做的 |
|---|---|---|
| 工作流（workflow） | 把零件/recipe 串起來的純文字流程 | 預設就寫這個，自由寫 |
| recipe | 打「一個固定外部 API」的設定（http_request + endpoint/header/body 模板） | 自由寫、而且該投稿（見下） |
| 零件（component） | WASM 程式（流程控制 / 資料處理 / http_request / auth），固定一小套 | 你不自製，由維護者管，走 GitHub PR |
一句話判準：打一個固定外部 endpoint → 寫 recipe；流程控制 / 資料處理 / 通用 HTTP → 用既有零件；其他 → 寫工作流串起來。
三個最常踩的坑（讀懂這三條，就不會像前人誤解四輪）
① recipe 是公共資產，發現缺的就自己做一個投稿，不必問人。
acr recipe push = 把 recipe 投稿到公共庫，不是存私人腳本。公開/私有只是 recipe 的一個屬性（同一身份可有公私版本並存），不是兩條不同的路。
→ 所以「想打某個 API 但沒有現成 recipe」時，正解是自己寫一個 recipe 並 push 上去（會 inject credential、push 時幫你檢查打不打得通）。這是被鼓勵的，別誤以為要自用、不上傳。
② 缺一個能力 → 去補 API（cypher endpoint），不准用 recipe / 多步工作流拼裝出來。 判準口訣：「這段邏輯換一個介面（CLI→MCP）要不要重寫？要重寫 → 它是『能力』，該長在 API。」
- ❌ 缺
upsert→ 在工作流裡拼「先查、沒有再建」、或寫個 recipe 假裝補上。 - ✅ 缺
upsert→ 去 API 加一個upsertendpoint，CLI/MCP/recipe 都呼叫它。 recipe 只負責「打一個固定外部 API」這件單純事；它不是用來補 arcrun 自己缺的能力的。缺能力就回報 / 補在 API，不要繞。
③ 已經有自製零件（例如 mira 的那幾個）→ 讓它退場，別再加新的。 你不該自製零件；既有的自製零件要往這三條退場：
claude_api之類「工作流回頭叫 LLM」→ 刪掉，需要 AI 判斷時是你（操盤的 CC）自己做，再叫工作流做確定性的下一步。arcrun 是 AI 用的工具，不是工具回頭用 AI。kbdb_*之類資料存取 → 改走已備好的acr kbdb薄殼 /kbdb_*MCP 工具（template + record 模型），不要當零件。- 純粹打某個固定外部 API 的假零件 → 改寫成 recipe 投稿（見①）。
其餘鐵律
- 先查能力再動手：
acr parts（看可用零件）、acr auth-recipe list（看支援的認證服務）、acr kbdb（資料存取）。 - 暴露資料要人類同意：部署對外 webhook / push recipe 會讓東西可被外部呼叫 → 停下來讓使用者明示同意，不替他決定公開。
- 誠實：沒打通就誠實說（缺 credential 標「未驗收：缺 X」），不假裝成功；完成以 HTTP 2xx / trace 為證，不口頭宣布。
開始前讀 arcrun-mindset Skill（世界觀）。使用者技術細節交給你，CLI 操作你來做。