 Leo
|
56973558e2
|
docs(arcrun): AGENTS.md v1 — AI onboarding (LI SDD M1.1)
對應 SDD .agents/specs/llm-interface/ M1.1。
LI (LLM Interface) 第一份文件：任何 AI agent 載入這份就能用 arcrun，
不用讀 SDD 內部架構、不用 grep codebase、不用問人。
包含：
- 30 秒「what is arcrun」
- MCP 連線配置（Claude Desktop / Cursor / 自製 agent 通用）
- 5 個核心概念（Component / Cypher binding / FOREACH / Paused-resume / api_key）
- 你的第一個 workflow（list → validate → push → run → trace 5 步）
- URL 慣例 + CF self-fetch 死鎖警示
- 常見錯誤 + error_code → 下一步 mapping
- 「不確定的時候」標準流程
- report_feedback 規範（**必做**）
- KBDB 速覽 + cron watcher 範例
- meta-規範：寫 workflow 的 AI 自己的習慣
901 words / 263 lines（控制在 5-8K tokens 內），純繁體中文。
CI 自動同步 KBDB block (type=agent-onboarding) 之後再做（M1.1 另一個 subtask）。
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
|
2026-05-16 15:28:05 +08:00 |
|