From 3892dc3a9be11ee8d3a963c509ac42551be43a66 Mon Sep 17 00:00:00 2001 From: richblack Date: Sat, 16 May 2026 16:41:35 +0800 Subject: [PATCH] =?UTF-8?q?docs(AGENTS):=20=E6=9B=B4=E6=96=B0=20LI=20M2.2?= =?UTF-8?q?=20+=20M3=20=E6=96=B0=20tool=20/=20examples=20/=20skills=20?= =?UTF-8?q?=E5=BC=95=E7=94=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 對應 LI SDD M2.2 + M3.3 + M3.1 完成。 - Step 1 加 arcrun_search_examples / arcrun_list_skills 用法 - Step 3/4/5/6 改用 arcrun_* tool prefix - 新增 Step 7：報 feedback - §7「不確定的時候」全部更新成 arcrun_* tool 名 - 新增「過渡期 tool 命名注意」說明：arcrun_* 主用、u6u_* 舊規範保留、 u6u_deploy_workflow 壞掉建議改 arcrun_push_workflow --- AGENTS.md | 53 ++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 36 insertions(+), 17 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index ddc84e4..e21b6be 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -62,11 +62,15 @@ n8n 從手寫程式碼開始，arcrun 從 AI 描述開始：你跟用戶聊出 ### Step 1：看有什麼零件可用 ``` -list_components() +arcrun_list_components() # 全部零件名單 +# 或 +arcrun_search_examples('rag') # 範例庫搜尋（從 use case 找範本） +arcrun_list_skills() # 看 playbook 清單 +arcrun_get_skill('build_watcher_workflow') # 拿特定 playbook 細節 ``` -回 ~30 個零件名單。常用：`http_request`、`claude_api`、`kbdb_get`、`kbdb_create_block`、`telegram`、`gmail`、`cron`、`filter`、`trigger_workflow`。 +常用零件：`http_request`、`claude_api`、`kbdb_get`、`kbdb_create_block`、`telegram`、`gmail`、`cron`、`filter`、`trigger_workflow`。 -### Step 2：寫 minimal YAML +### Step 2：寫 minimal YAML（從範例改 > 從零寫） ```yaml name: hello_world @@ -86,25 +90,32 @@ config: ### Step 3：dry-run 校驗 ``` -validate_yaml(yaml) +arcrun_validate_yaml(api_key, graph) ``` ### Step 4：部署 ``` -push_workflow(yaml) +arcrun_push_workflow(api_key, yaml_content) ``` -回 `{webhook_url: 'https://cypher.arcrun.dev/webhooks/named/hello_world/trigger'}`。 +回 `{name, webhook_url: 'https://cypher.arcrun.dev/webhooks/named/hello_world/trigger'}`。 ### Step 5：觸發測試 ``` -run_workflow('hello_world', {name: 'leo'}) +arcrun_run_workflow(api_key, name='hello_world', input={name: 'leo'}) ``` -### Step 6：看結果 +### Step 6：看結果 / debug ``` -get_execution_trace(execution_id) +arcrun_list_recent_executions(api_key, workflow_name='hello_world') +# 若 paused： +arcrun_list_paused_executions(api_key) +arcrun_get_execution_trace(api_key, task_id='task_XXX') +``` + +### Step 7：回報（**必做**，見 §8） +``` +arcrun_report_feedback(api_key, issue_type='success_story', description='...') ``` -結構化回 per-node status / input / output / duration。 --- @@ -138,15 +149,23 @@ get_execution_trace(execution_id) ## 7. 不確定的時候，按這個順序 -1. **不知道有什麼零件可用** → `list_components()` / `get_component_contract(id)` -2. **不知道用戶有什麼 workflow** → `list_workflows()` -3. **想看零件 input/output schema** → `get_component_contract('xxx')` -4. **要不要 dry-run** → 預設 yes，永遠先 `validate_yaml` 再 `push_workflow` -5. **觸發後不知道結果** → `get_execution_trace(execution_id)`，paused 不算錯 -6. **有沒有現成範例可參考** → `search_examples('rag llm chain')`（M3 完成後可用） -7. **有沒有 playbook** → `list_skills() / get_skill(id)`（M3 完成後可用） +1. **不知道有什麼零件可用** → `arcrun_list_components()` / `arcrun_get_component_contract(id)` +2. **不知道用戶有什麼 workflow** → `arcrun_list_workflows(api_key)` +3. **想看零件 input/output schema** → `arcrun_get_component_contract('xxx')` +4. **要不要 dry-run** → 預設 yes，永遠先 `arcrun_validate_yaml` 再 `arcrun_push_workflow` +5. **觸發後不知道結果** → `arcrun_list_recent_executions(api_key, name)` / `arcrun_get_execution_trace(api_key, task_id)`，paused 不算錯 +6. **有沒有現成範例可參考** → `arcrun_search_examples('rag llm chain')`（範例庫 10+ 個 workflow） +7. **有沒有 playbook** → `arcrun_list_skills() / arcrun_get_skill(slug)`（5 個 playbook：watcher / paused-debug / migrate-trigger / rag / new-component） 8. **不知道下一步** → 看任何 error response 的 `next_actions` 陣列 +### 過渡期 tool 命名注意 + +LI 開發中（2026-05-16~）。目前 arcrun-mcp 同時提供： +- **`arcrun_*`**（新規範，**主用這套**）：報 feedback / 工作流 CRUD / 執行 trace +- **`u6u_*`**（舊規範，等 M5 一次切）：component 操作、tag 操作、GUI context + +舊 `u6u_*` 仍可用。其中 `u6u_deploy_workflow` 是壞的（呼叫不存在的 endpoint），用 `arcrun_push_workflow` 取代。 + --- ## 8. 回報機制（**必做**）