docs(llm-interface): apply leo's decisions — drop u6u + finally.click
leo 2026-05-16 拍板（除 dual-hostname 外照原設計）： 1. MCP URL: 單一 mcp.arcrun.dev，mcp.finally.click 直接退場（不並存） - 理由：finally.click 是還沒申請新網址的暫用，那是一個服務，arcrun 是底層 2. u6u branding 整體退場： - u6u-mcp repo → arcrun-mcp - u6u-gui repo → arcrun-gui - u6u_* tool prefix → arcrun_* - 一次切換，不留 alias，不留 deprecation 期 - 理由：u6u 不存在了 SDD 三件套同步更新： - requirements.md: 開放問題章節改決策紀錄；移除「保留 15 tool deprecation」自相矛盾 - design.md: §1.1 命名 + §6 migration plan + §8 決策表全部改成「單一切換」 - tasks.md: M5 重組成 6 個 sub-step（準備 / repo rename / tool rename / 舊 URL 退場 / 文件 / 連動 SDD 追蹤） 連動但不在本 SDD 範圍： - matrix/arcrun/.agents/specs/u6u-core-mvp/ 改名 - matrix/arcrun/.agents/specs/u6u-platform-evolution/ 改名 （M5.6 列出，另起 task 追蹤） Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
@@ -8,7 +8,7 @@
|
||||
## 背景
|
||||
|
||||
arcrun 是 n8n-like workflow 平台，平台本身的 end-user 有兩類：
|
||||
- **人類**：透過 u6u-gui canvas / arcrun.dev landing 操作
|
||||
- **人類**：透過 arcrun-gui canvas / arcrun.dev landing 操作
|
||||
- **AI agent**：透過 MCP / API 操作（Claude Code、Cursor、Codex、自製 agent 等）
|
||||
|
||||
過去設計集中在「人」（UI / docs）。AI 對 arcrun 的「可用性」沒被當第一公民。
|
||||
@@ -76,8 +76,8 @@ LI 不是「新建一個 service」，是**跨 5 個既有系統的橫向 layer*
|
||||
|---|---|---|
|
||||
| **arcrun cypher-executor** | 31 HTTP 路由 | 哪些對外、哪些 AI 該看得到 |
|
||||
| **arcrun registry** | component 管理 Worker | discovery layer |
|
||||
| **u6u-mcp** | 15 MCP tools（HTTP→MCP 薄包裝） | 主擴張面（gap-fill） |
|
||||
| **u6u-gui** | 人類 canvas IDE | 取其 endpoint 觀念，不取其 UI 元素 |
|
||||
| **arcrun-mcp**（目前 `matrix/u6u-mcp/`，本 SDD M5 改名） | 15 MCP tools（HTTP→MCP 薄包裝） | 主擴張面（gap-fill） |
|
||||
| **arcrun-gui**（目前 `matrix/u6u-gui/`，本 SDD M5 改名） | 人類 canvas IDE | 取其 endpoint 觀念，不取其 UI 元素 |
|
||||
| **kbdb** | 50 個 HTTP 路由 | KBDB 該不該直接給 AI、用什麼姿勢 |
|
||||
| **arcrun CLI (acr)** | Node CLI | LI 不依賴 CLI（CLI 是人的工具） |
|
||||
|
||||
@@ -103,7 +103,7 @@ LI 不是「新建一個 service」，是**跨 5 個既有系統的橫向 layer*
|
||||
|
||||
### FR-2：完整 CRUD + Discovery 對等
|
||||
|
||||
人類在 u6u-gui 能做的 8 個動作（list_workflows / get / update / execute / search_components / get_component / list_templates / list_credentials），**MCP 至少同等覆蓋**，不能有「人類能做但 AI 不能做」的 gap。
|
||||
人類在 arcrun-gui 能做的 8 個動作（list_workflows / get / update / execute / search_components / get_component / list_templates / list_credentials），**MCP 至少同等覆蓋**，不能有「人類能做但 AI 不能做」的 gap。
|
||||
|
||||
### FR-3：Dry-run 是預設行為
|
||||
|
||||
@@ -174,10 +174,12 @@ LI 不是「新建一個 service」，是**跨 5 個既有系統的橫向 layer*
|
||||
|
||||
### NFR-1：向下相容
|
||||
|
||||
LI 是新層，不破壞既有：
|
||||
- u6u-mcp 既有 15 tool 全保留（廢棄走標準 deprecation）
|
||||
- u6u-gui 不動
|
||||
- cypher-executor 既有路由不改 contract
|
||||
LI 在「擴張」階段（M1-M4）不破壞既有：
|
||||
- M1-M4 階段：arcrun-mcp 既有 15 tool 保留，新增 13 個 tool（pre-rename）
|
||||
- arcrun-gui 不動
|
||||
- cypher-executor 既有路由不改 contract（只加新 endpoint）
|
||||
|
||||
M5（rename）階段是 breaking change（leo 拍板），需事前公告。
|
||||
|
||||
### NFR-2：transport 不鎖死
|
||||
|
||||
@@ -193,7 +195,7 @@ MCP 主，但 HTTP 同等可用（讓沒 MCP 客戶端的 agent 也可用）。
|
||||
|
||||
### NFR-5：覆蓋率可量化
|
||||
|
||||
- 「人類在 u6u-gui 能做但 MCP 不能做」清單必須能列出
|
||||
- 「人類在 arcrun-gui 能做但 MCP 不能做」清單必須能列出
|
||||
- 每次 LI 改動後，這份清單往 0 收斂
|
||||
|
||||
---
|
||||
@@ -225,18 +227,20 @@ MCP 主，但 HTTP 同等可用（讓沒 MCP 客戶端的 agent 也可用）。
|
||||
| AI 不照 AGENTS.md 規範用 | implicit telemetry 不依賴自覺，仍能收 data |
|
||||
| MCP tool 設計錯誤越改越亂 | 每個 tool 有 contract test，error_code enum 版本化 |
|
||||
| feedback 雜訊太多無法 review | review workflow 用 LLM 聚合，不靠人讀原始 |
|
||||
| u6u-mcp 重構搞壞既有 | 走 deprecation，舊 tool 留 90 天 |
|
||||
| arcrun-mcp 重構搞壞既有用戶 | 用戶量還很少（dogfood 階段），一次切換可接受；切換前公告 |
|
||||
| KBDB telemetry 量爆掉 | sample rate / 老資料自動 archive |
|
||||
|
||||
---
|
||||
|
||||
## 開放問題（待 leo 決策）
|
||||
## 決策（2026-05-16 leo 拍板）
|
||||
|
||||
1. **deployment 名稱**：MCP server URL 用 `mcp.arcrun.dev` 還是沿用 `mcp.finally.click`？
|
||||
- 推薦：`mcp.arcrun.dev`（品牌一致，符合 mira CLAUDE.md §1.7）
|
||||
2. **新 MCP vs 擴張 u6u-mcp**：在現有 u6u-mcp 加 tool，還是建 `arcrun-mcp` 取代？
|
||||
- 推薦：先擴張 u6u-mcp（避免 fork 痛），長期可改名
|
||||
3. **AGENTS.md 放哪**：`arcrun/AGENTS.md` repo 根？還是 KBDB block？或兩個地方都？
|
||||
- 推薦：repo `arcrun/AGENTS.md` + KBDB 自動同步 block（讓沒 git access 的 AI 也能讀）
|
||||
4. **feedback 寫入是否需 auth**：AI report bug 要不要 api_key？
|
||||
- 推薦：要（防 spam），但 tier 低（只要驗 ak_ 存在）
|
||||
1. **deployment 名稱**：✅ `mcp.arcrun.dev` 單一 URL
|
||||
- `mcp.finally.click` 直接退場，不並存
|
||||
- 理由（leo）：「finally.click 是還沒申請新網址的暫用，那是一個服務，arcrun 是底層」
|
||||
2. **u6u branding 整體退場**：✅ u6u 命名全部改 arcrun
|
||||
- `u6u-mcp` repo → `arcrun-mcp`
|
||||
- `u6u-gui` repo → `arcrun-gui`
|
||||
- 工具命名 `u6u_*` → `arcrun_*`（**單一 rename，不留 alias 也不留 deprecation 期**）
|
||||
- 理由：「u6u 不存在，改成 Arcrun」
|
||||
3. **AGENTS.md 位置**：✅ repo `arcrun/AGENTS.md` + 自動同步 KBDB block（兩面都拿到）
|
||||
4. **feedback 寫入需 auth**：✅ 驗 ak_ 存在即可（防 spam，tier 低不查餘額）
|
||||
|
||||
Reference in New Issue
Block a user