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:
@@ -35,7 +35,7 @@
|
||||
│ ① Read AGENTS.md │ ② MCP tool calls
|
||||
▼ ▼
|
||||
┌────────────────────────┐ ┌──────────────────────────────────┐
|
||||
│ AGENTS.md │ │ arcrun-mcp (擴張 u6u-mcp) │
|
||||
│ AGENTS.md │ │ arcrun-mcp (擴張 arcrun-mcp) │
|
||||
│ (repo + KBDB block) │ │ 25 tools, 5 categories │
|
||||
└────────────────────────┘ └──────────────┬───────────────────┘
|
||||
│
|
||||
@@ -93,9 +93,10 @@
|
||||
|
||||
#### 1.1 命名與部署
|
||||
|
||||
- **Server URL**: `https://mcp.arcrun.dev/mcp`(新增 route,對應 `mcp.finally.click` 既有 worker)
|
||||
- **過渡**:u6u-mcp Worker rename `arcrun-mcp`,雙路由(finally.click + arcrun.dev)並存 90 天
|
||||
- **Tool prefix**: 統一 `arcrun_*`(既有 `u6u_*` 加 alias 對應,舊名 deprecation 公告)
|
||||
- **Server URL**: `https://mcp.arcrun.dev/mcp`(唯一 URL)
|
||||
- **舊 URL**:`mcp.finally.click` 直接退場(leo 2026-05-16 拍板,理由:「finally.click 是還沒申請新網址的暫用,那是一個服務,arcrun 是底層」)
|
||||
- **Worker rename**:`u6u-mcp` → `arcrun-mcp`(wrangler name 改),repo 路徑 `matrix/u6u-mcp/` → `matrix/arcrun-mcp/`
|
||||
- **Tool prefix**: 統一 `arcrun_*`(單一 rename,**不保留 `u6u_*` alias**,不留 deprecation 期。用戶量還很少,一次切換可接受。切換前在 mira / telegram 公告)
|
||||
|
||||
#### 1.2 Tool 完整清單(25 個,5 類)
|
||||
|
||||
@@ -402,7 +403,7 @@ config:
|
||||
|
||||
### 4.1 人類 GUI 能做的事 × LI 對應
|
||||
|
||||
| 人類在 u6u-gui 做的 | LI MCP 工具 | 對等? |
|
||||
| 人類在 arcrun-gui 做的 | LI MCP 工具 | 對等? |
|
||||
|---|---|---|
|
||||
| 看現有 workflow 列表 | `arcrun_list_workflows` | ✅ |
|
||||
| 點開 workflow 看 YAML | `arcrun_get_workflow` | ✅ |
|
||||
@@ -527,14 +528,29 @@ Even "success" stories help — they tell us what's working.
|
||||
|
||||
---
|
||||
|
||||
## 6. Migration plan(u6u-mcp → arcrun-mcp)
|
||||
## 6. Migration plan(u6u-mcp → arcrun-mcp 一次切換)
|
||||
|
||||
### 6.1 不破壞
|
||||
### 6.1 切換方式
|
||||
|
||||
- u6u-mcp Worker rename `arcrun-mcp`(wrangler name 改)
|
||||
- 兩個 hostname 並存:`mcp.finally.click` + `mcp.arcrun.dev`(route 加一條)
|
||||
- 舊 tool 名(`u6u_*`)保留,加 alias 對應新名(`arcrun_*`)
|
||||
- 90 天 deprecation 期,舊 tool call → 回 warning hint「`u6u_X` → 改用 `arcrun_X`」
|
||||
leo 2026-05-16 拍板:u6u branding 整體退場,**單一 rename,不留 alias 也不留 deprecation 期**。
|
||||
|
||||
- Worker 部署 name 改:`u6u-mcp` → `arcrun-mcp`(wrangler.toml)
|
||||
- 路由改:`mcp.finally.click/*` → `mcp.arcrun.dev/*`(DNS + worker route 同步切)
|
||||
- 舊 URL 退場:`mcp.finally.click` 不保留(要嘛 410 Gone,要嘛 301 redirect 到 arcrun.dev landing 一個說明頁)
|
||||
- Tool 名一次改:所有 `u6u_*` rename 成 `arcrun_*`,**舊名直接消失**
|
||||
- repo 路徑改:`matrix/u6u-mcp/` → `matrix/arcrun-mcp/`
|
||||
|
||||
### 6.2 切換前須做
|
||||
|
||||
- [ ] 全 monorepo `grep u6u_` 確認所有 client(mira / 自家腳本 / leo 自己的 IDE 配置)
|
||||
- [ ] 公告:在 mira 河道 + telegram 通知「ak_xxx 用戶請更新 MCP 配置:URL → mcp.arcrun.dev」
|
||||
- [ ] 切換當天 worker 部署兩個 name(過渡 1 天可回滾),確認流量切完才把舊 worker disable
|
||||
|
||||
### 6.3 為什麼不做 deprecation
|
||||
|
||||
- 用戶量極少(dogfood 階段,主要是 leo 自己)
|
||||
- 留 alias 會讓新 AI agent 學到舊名,違背「LI 一致性」原則
|
||||
- 90 天監控成本 > 一次切換 + 公告
|
||||
|
||||
### 6.2 新增 tools(按 phase)
|
||||
|
||||
@@ -570,7 +586,7 @@ Phase 3(auto-loop):
|
||||
- 開始收 data
|
||||
|
||||
### Milestone 2:gap-fill(1 週)
|
||||
- u6u-mcp 補上 6 個 Phase 1 tools
|
||||
- arcrun-mcp 補上 6 個 Phase 1 tools
|
||||
- 新 endpoints 在 cypher-executor 加
|
||||
- 每個 tool 結構化 error contract
|
||||
|
||||
@@ -585,22 +601,32 @@ Phase 3(auto-loop):
|
||||
- leo 收到第一份週報
|
||||
|
||||
### Milestone 5:rename + cleanup(1 週)
|
||||
- u6u-mcp → arcrun-mcp 公開
|
||||
- arcrun-mcp → arcrun-mcp 公開
|
||||
- 舊 tool 加 deprecation warning
|
||||
- AGENTS.md 同步 KBDB
|
||||
|
||||
---
|
||||
|
||||
## 8. 開放決策(待 leo)
|
||||
## 8. 決策紀錄
|
||||
|
||||
| 決策 | 推薦 | 理由 |
|
||||
### 8.1 已拍板(2026-05-16 leo)
|
||||
|
||||
| 決策 | 結果 | 理由 |
|
||||
|---|---|---|
|
||||
| MCP server URL | `mcp.arcrun.dev`(route 並存 `mcp.finally.click` 90 天) | 品牌統一 |
|
||||
| 擴張 u6u-mcp vs 建新 | 擴張 + rename | 不 fork,零移轉痛 |
|
||||
| AGENTS.md 位置 | `arcrun/AGENTS.md` + KBDB 自動同步 | 兩面都拿到 |
|
||||
| feedback 是否要 auth | 要(驗 ak_ 存在即可,不查餘額) | 防 spam |
|
||||
| LI 是否包含 KBDB MCP | 部分(abstracted),KBDB MCP 另立 SDD | 範圍清楚 |
|
||||
| Telemetry 保留多久 | 90 天 hot + 1 年 cold archive | 平衡 cost 與 review |
|
||||
| MCP server URL | `mcp.arcrun.dev` 單一 URL,舊 `mcp.finally.click` 直接退場 | finally.click 是還沒申請新網址的暫用,那是一個服務,arcrun 是底層 |
|
||||
| u6u branding | 整體退場改 arcrun(repo / worker / tool 命名一次 rename) | u6u 不存在了 |
|
||||
| Deprecation 期 | 不留(一次切換 + 公告) | 用戶量極少,留 alias 反而讓新 AI 學到舊名 |
|
||||
| 擴張 vs 建新 | 擴張既有 u6u-mcp(rename 成 arcrun-mcp) | 不 fork,零移轉痛 |
|
||||
| AGENTS.md 位置 | repo `arcrun/AGENTS.md` + 自動同步 KBDB block | 兩面都拿到(git-access 也 OK,純 MCP 也 OK) |
|
||||
| feedback 寫入 auth | 要(驗 ak_ 存在即可,不查餘額) | 防 spam |
|
||||
|
||||
### 8.2 仍可商議(小議題)
|
||||
|
||||
| 議題 | 建議 |
|
||||
|---|---|
|
||||
| LI 是否包含 KBDB MCP | 部分(abstracted),KBDB MCP 另立 SDD `kbdb-llm-interface` |
|
||||
| Telemetry 保留多久 | 90 天 hot + 1 年 cold archive |
|
||||
| AGENTS.md 第一版用中文還是英文 | 中文(leo 自家 + mira 一致),英文版 v2 開源時補 |
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user