docs(mcp): GUIDE/README 全面改教 arcrun_*,清掉死 u6u_ 工具名

死文件治理:GUIDE.md(25 處)與 README.md(21 處)仍在教 u6u_* 工具名,
含本 PR 已刪的 4 個 tool(deploy/execute/get/list_workflows),下個 CC 照著走會撞牆。

- 全部 u6u_* → 現役 arcrun_*(component/tag/gui 那批用新名)
- 已刪 tool 改指現役:execute→run、deploy→push、get/list_workflows→crud 版
- 修正因換工具而失真的流程與參數:沙盒測試段改為 arcrun_validate_yaml(部署前
  schema 驗證)→ arcrun_push_workflow(部署)→ arcrun_run_workflow(觸發,帶
  api_key/name/input);get_workflow 參數 workflow_id→name
- 順帶把兩處品牌 prose "u6u" 改 "Arcrun"
- grep 確認兩檔零 u6u

brand.ts:釐清 ARCRUN_TOOL_PREFIX 覆蓋僅內部 rebrand 過渡 / 測試鉤子,
Workers runtime 無 process 全域基本不生效、勿當對外特性。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
This commit is contained in:
Claude
2026-07-07 05:37:54 +00:00
parent 5fc7277c3c
commit 53080ffa53
3 changed files with 79 additions and 66 deletions
+46 -39
View File
@@ -3,8 +3,7 @@
> Arcrun 是 **AI 優先(AI-First** 的工作流自動化平台。
> 跟 AI 描述你的意圖,Arcrun 幫你把它變成可重複執行、不需要 AI 的自動化工作流。
>
> 註:本指南部分工具仍以舊 `u6u_` 前綴記載(registry/component 管理那組);現役 workflow 工具是
> `arcrun_*`(見 `mcp/src/tools/`)。連線設定見 `mcp/README.md`(用 `acr mcp-setup`)。
> 註:所有工具一律 `arcrun_*` 前綴(見 `mcp/src/tools/`)。連線設定見 `mcp/README.md`(用 `acr mcp-setup`)。
---
@@ -23,7 +22,7 @@
## 核心概念:三元組(Triplet)
u6u 的一切都建立在「三元組」上。三元組是描述業務邏輯的最小單位,格式極度簡單,AI 不會出錯,人也能一眼看懂。
Arcrun 的一切都建立在「三元組」上。三元組是描述業務邏輯的最小單位,格式極度簡單,AI 不會出錯,人也能一眼看懂。
### 格式
@@ -55,7 +54,7 @@ system sends telegram-notification
### 為什麼這麼簡單?
因為 AI 擅長理解意圖,三元組擅長表達意圖。你跟 AI 說「去抓銀行匯率,用 Telegram 通知我」,AI 把它拆成三元組,u6u 查零件庫、組裝、執行。第一次需要 AI,之後自動跑,不再花 Token。
因為 AI 擅長理解意圖,三元組擅長表達意圖。你跟 AI 說「去抓銀行匯率,用 Telegram 通知我」,AI 把它拆成三元組,Arcrun 查零件庫、組裝、執行。第一次需要 AI,之後自動跑,不再花 Token。
---
@@ -66,13 +65,15 @@ system sends telegram-notification
AI 產出 Workflow_Plan_YAML(每次規劃新專案)
u6u_search_components(查零件庫)
arcrun_search_components(查零件庫)
有缺件?→ AI 產出 Component_Plan_YAML → u6u_publish_component
有缺件?→ AI 產出 Component_Plan_YAML → arcrun_publish_component
u6u_execute_workflow(沙盒測試
arcrun_validate_yaml(部署前 schema 驗證
u6u_deploy_workflow(正式部署)
arcrun_push_workflow(正式部署)
arcrun_run_workflow(觸發執行,帶 input
(選填)建立 tag,為工作流與零件分類
```
@@ -214,7 +215,7 @@ workflow:
## Component_Plan_YAML 格式
**產出時機:** 只有當 `u6u_search_components` 回報有缺件時,AI 才會產出此 YAML。不是每次都需要。
**產出時機:** 只有當 `arcrun_search_components` 回報有缺件時,AI 才會產出此 YAML。不是每次都需要。
### 格式說明
@@ -325,7 +326,7 @@ components:
### 步驟二:確認零件完整性
呼叫 `u6u_search_components`,傳入所有 triplet
呼叫 `arcrun_search_components`,傳入所有 triplet
```json
{
@@ -339,38 +340,45 @@ components:
回應會告知哪些零件已存在、哪些缺失。若有缺件,先完成[零件開發流程](#零件component開發流程)。
### 步驟三:沙盒測試
### 步驟三:部署前 schema 驗證
```json
// u6u_execute_workflow
// arcrun_validate_yaml
{
"triplets": [
"system fetches exchange-rate",
"system parses rate-data",
"system sends telegram-notification"
],
"context": {
"currency_pair": "USD/TWD",
"chat_id": "123456789"
}
"yaml_content": "workflow:\n name: exchange-rate-notify\n ..."
}
```
### 步驟四:正式部署
```json
// u6u_deploy_workflow
// arcrun_push_workflow
{
"api_key": "ak_xxx",
"yaml_content": "workflow:\n name: exchange-rate-notify\n ..."
}
```
部署成功後,系統回傳 `workflow_id`,並自動記錄 metadata 至 KBDB。
### 步驟五:加上 Tag(選填)
### 步驟五:觸發執行
```json
// u6u_tag_resource
// arcrun_run_workflow — 觸發已部署的 workflowinput 帶進 trigger context
{
"api_key": "ak_xxx",
"name": "exchange-rate-notify",
"input": {
"currency_pair": "USD/TWD",
"chat_id": "123456789"
}
}
```
### 步驟六:加上 Tag(選填)
```json
// arcrun_tag_resource
{
"resource_type": "workflow",
"resource_id": "wf-abc123",
@@ -381,9 +389,8 @@ components:
### 查詢已部署的工作流
```
u6u_list_workflows → 列出所有工作流
u6u_list_workflows(tag=finance) → 按 tag 篩選
u6u_get_workflow(workflow_id) → 取得特定工作流 metadata
arcrun_list_workflows → 列出所有工作流
arcrun_get_workflow(name) → 取得特定工作流 metadata
```
---
@@ -392,12 +399,12 @@ u6u_get_workflow(workflow_id) → 取得特定工作流 metadata
### 步驟一:確認缺件
`u6u_search_components` 回報缺件後,AI 產出 Component_Plan_YAML。存入 `components/` 目錄。
`arcrun_search_components` 回報缺件後,AI 產出 Component_Plan_YAML。存入 `components/` 目錄。
### 步驟二:發佈零件
```json
// u6u_publish_componentAPI Config 方式)
// arcrun_publish_componentAPI Config 方式)
{
"component_id": "system-fetches-exchange-rate",
"api_config": {
@@ -408,7 +415,7 @@ u6u_get_workflow(workflow_id) → 取得特定工作流 metadata
```
```json
// u6u_publish_componentGherkin 方式)
// arcrun_publish_componentGherkin 方式)
{
"component_id": "system-sends-confirmation-email",
"gherkin": "Feature: 訂單確認信\n Scenario: ..."
@@ -418,7 +425,7 @@ u6u_get_workflow(workflow_id) → 取得特定工作流 metadata
### 步驟三:加上 Tag(選填)
```json
// u6u_tag_resource
// arcrun_tag_resource
{
"resource_type": "component",
"resource_id": "system-fetches-exchange-rate",
@@ -429,9 +436,9 @@ u6u_get_workflow(workflow_id) → 取得特定工作流 metadata
### 查詢已發佈的零件
```
u6u_list_components → 列出所有零件
u6u_list_components(tag=payment) → 按 tag 篩選
u6u_get_component(component_id) → 取得特定零件 metadata
arcrun_list_components → 列出所有零件
arcrun_list_components(tag=payment) → 按 tag 篩選
arcrun_get_component(component_id) → 取得特定零件 metadata
```
---
@@ -444,19 +451,19 @@ Tag 是用戶自訂的標籤,可附加至工作流或零件,用於分類與
```json
// 建立 tag
// u6u_create_tag
// arcrun_create_tag
{ "name": "finance", "description": "金融相關" }
// 列出所有 tag
// u6u_list_tags(無需參數)
// arcrun_list_tags(無需參數)
{}
// 刪除 tag(不影響已打上此 tag 的資源關聯)
// u6u_delete_tag
// arcrun_delete_tag
{ "tag_name": "deprecated-tag" }
// 為資源加上 tag
// u6u_tag_resource
// arcrun_tag_resource
{
"resource_type": "workflow", // 或 "component"
"resource_id": "wf-abc123",
@@ -464,7 +471,7 @@ Tag 是用戶自訂的標籤,可附加至工作流或零件,用於分類與
}
// 移除資源的 tag
// u6u_untag_resource
// arcrun_untag_resource
{
"resource_type": "component",
"resource_id": "system-fetches-exchange-rate",