@gt-fe/eap-cli 0.2.19 → 0.2.21

package/dist/templates/single-agent-with-tools/skills/README.md

@@ -1,119 +1,119 @@
-# 装配与执行 Skill
-
-四种执行模式都可以装配 Skill，但装配与执行是两个步骤。
-
-## 普通 SKILL.md 目录
-
-1. 把含 `SKILL.md` 的目录放到 `skills/<name>/`，可同时包含 `scripts/`、`references/`。文件夹名与 frontmatter 的 `name` 保持一致；不要嵌套版本目录。
-2. 在根级 `agent.manifest.json` 的 `skillRefs` 中追加 `{ "code": "<name>", "version": "1.0.0" }`，保留已有引用。本地版本来自 `SKILL.md` frontmatter，省略时为 `1.0.0`。
-3. 确认 `eap.config.json` 的 `localSkillDirectories` 包含 `"./skills"`，重启本地运行以重新物化资源。
-
-这种装配只需要 `SKILL.md`，无需额外 JSON 清单。可调用工具的 LLM 会获得 Skill 目录信息，通过 `read_file` 阅读正文、通过 `execute_command` 执行脚本。`disableTools: true` 的节点不能这样读取或执行 Skill。模型按文档使用脚本，不等于 Runtime 执行结构化 workflow。
-
-## 作为子图执行的完整最小样例
-
-本例创建 `request-summary`，由一个 code 节点整理用户请求，输出以“需求记录：”开头的助手消息。须设 `emitReply: true`，否则 `reply` 只出现在 tool 结果 JSON 里。不调用外部工具。
-
-```text
-skills/
-  request-summary/
-    SKILL.md
-    skill.manifest.json
-```
-
-创建 `skills/request-summary/SKILL.md`：
-
-```markdown
----
-name: request-summary
-description: 整理用户原始请求，生成需求记录。
-version: 1.0.0
----
-
-把用户请求中的连续空白整理成一个空格，输出需求记录。
-结构化执行入口在同目录 skill.manifest.json 的 workflow 字段中。
-```
-
-创建 `skills/request-summary/skill.manifest.json`：
-
-```json
-{
-  "code": "request-summary",
-  "name": "request-summary",
-  "version": "1.0.0",
-  "workflow": {
-    "nodes": [
-      {
-        "id": "record-request",
-        "type": "code",
-        "config": {
-          "timeoutMs": 1000,
-          "emitReply": true,
-          "code": "const messages = Array.isArray(state.messages) ? state.messages : []; let input = ''; for (let i = messages.length - 1; i >= 0; i--) { if (messages[i].role === 'user') { input = String(messages[i].content || ''); break; } } return { reply: '需求记录：' + input.replace(/\\s+/g, ' ').trim() };"
-        }
-      }
-    ],
-    "edges": [
-      {
-        "from": "__start__",
-        "to": "record-request"
-      },
-      {
-        "from": "record-request",
-        "to": "__end__"
-      }
-    ],
-    "entryPoint": "record-request",
-    "finishPoints": [
-      "__end__"
-    ]
-  }
-}
-```
-
-在 Agent 的 `skillRefs` 中追加：
-
-```json
-{ "code": "request-summary", "version": "1.0.0" }
-```
-
-这里的 `skill.manifest.json` 为子图提供结构化定义。当前 Runtime 从该清单的 `workflow`（也支持 `graph` / `definitionSnapshot`）读取图对象，**不会自动读取 Skill 目录中的独立 `graph.json`，也不会把 SKILL.md 的自然语言步骤编译成图**。
-
-父图的节点必须绑定该 Skill：
-
-```json
-{
-  "id": "run-skill",
-  "type": "subgraph",
-  "config": { "skillCode": "request-summary" }
-}
-```
-
-`skillCode` 必须与 `skillRefs[].code` 一致；不能只填写 `type: subgraph`。节点还需接入实际控制流，见下面的模板接法。
-
-## 接到 ReAct
-
-默认图通过 `read_file` / `execute_command` 使用普通 Skill，可看到 `📦 skill:…` 和工具执行记录。默认 `shouldContinue` 只返回 `call_tools` 或 `finish`，其中 `call_tools` 必须进入 `type: tool`；不能把该目标直接改为 subgraph。
-
-若先验证结构化 Skill 的执行，可把它作为 ReAct 前的**固定预处理步骤**：
-
-1. 在 `nodes` 中加入上面的 `run-skill`。
-2. 将 `__start__ → agent` 替换为下面两条边。
-3. 把 `entryPoint` 从 `agent` 改为 `run-skill`；工具循环、条件边和结束配置保持原样。
-
-```json
-[
-  { "from": "__start__", "to": "run-skill" },
-  { "from": "run-skill", "to": "agent" }
-]
-```
-
-顺序为 `__start__ → run-skill → agent ⇄ tools`，Skill 的需求记录进入 Agent 上下文。这个例子每次请求都执行 Skill，不代表模型自主选择 Skill。要达到“Agent 决定进入某个 Skill，完成后返回推理”的产品形态，需要额外的选择与条件路由；不能仅靠 `skillRefs` 或修改 `call_tools` 分支实现。
-
-## 检查结果
-
-改完文件后先执行 `eap validate`，再重启 `eap chat` / `eap dev`，输入“用户登录后导出月报”。应能看到 `request-summary` 的执行记录，以及“需求记录：用户登录后导出月报”的结果被后续步骤使用。
-
-`eap validate` 能检查父图引用和连边，但通过校验不代表已验证 Skill workflow 的运行行为。若报“子图节点无法解析 Skill workflow”，检查清单中的 `workflow.nodes` 是否非空、`skillCode` 是否匹配、是否已重新物化资源。
-
-示例是本地开发资源。上线前按平台要求登记、锁定和发布 Skill 及其依赖。
+# 装配与执行 Skill
+
+四种执行模式都可以装配 Skill，但装配与执行是两个步骤。
+
+## 普通 SKILL.md 目录
+
+1. 把含 `SKILL.md` 的目录放到 `skills/<name>/`，可同时包含 `scripts/`、`references/`。文件夹名与 frontmatter 的 `name` 保持一致；不要嵌套版本目录。
+2. 在根级 `agent.manifest.json` 的 `skillRefs` 中追加 `{ "code": "<name>", "version": "1.0.0" }`，保留已有引用。本地版本来自 `SKILL.md` frontmatter，省略时为 `1.0.0`。
+3. 确认 `eap.config.json` 的 `localSkillDirectories` 包含 `"./skills"`，重启本地运行以重新物化资源。
+
+这种装配只需要 `SKILL.md`，无需额外 JSON 清单。可调用工具的 LLM 会获得 Skill 目录信息，通过 `read_file` 阅读正文、通过 `execute_command` 执行脚本。`disableTools: true` 的节点不能这样读取或执行 Skill。模型按文档使用脚本，不等于 Runtime 执行结构化 workflow。
+
+## 作为子图执行的完整最小样例
+
+本例创建 `request-summary`，由一个 code 节点整理用户请求，输出以“需求记录：”开头的助手消息。须设 `emitReply: true`，否则 `reply` 只出现在 tool 结果 JSON 里。不调用外部工具。
+
+```text
+skills/
+  request-summary/
+    SKILL.md
+    skill.manifest.json
+```
+
+创建 `skills/request-summary/SKILL.md`：
+
+```markdown
+---
+name: request-summary
+description: 整理用户原始请求，生成需求记录。
+version: 1.0.0
+---
+
+把用户请求中的连续空白整理成一个空格，输出需求记录。
+结构化执行入口在同目录 skill.manifest.json 的 workflow 字段中。
+```
+
+创建 `skills/request-summary/skill.manifest.json`：
+
+```json
+{
+  "code": "request-summary",
+  "name": "request-summary",
+  "version": "1.0.0",
+  "workflow": {
+    "nodes": [
+      {
+        "id": "record-request",
+        "type": "code",
+        "config": {
+          "timeoutMs": 1000,
+          "emitReply": true,
+          "code": "const messages = Array.isArray(state.messages) ? state.messages : []; let input = ''; for (let i = messages.length - 1; i >= 0; i--) { if (messages[i].role === 'user') { input = String(messages[i].content || ''); break; } } return { reply: '需求记录：' + input.replace(/\\s+/g, ' ').trim() };"
+        }
+      }
+    ],
+    "edges": [
+      {
+        "from": "__start__",
+        "to": "record-request"
+      },
+      {
+        "from": "record-request",
+        "to": "__end__"
+      }
+    ],
+    "entryPoint": "record-request",
+    "finishPoints": [
+      "__end__"
+    ]
+  }
+}
+```
+
+在 Agent 的 `skillRefs` 中追加：
+
+```json
+{ "code": "request-summary", "version": "1.0.0" }
+```
+
+这里的 `skill.manifest.json` 为子图提供结构化定义。当前 Runtime 从该清单的 `workflow`（也支持 `graph` / `definitionSnapshot`）读取图对象，**不会自动读取 Skill 目录中的独立 `graph.json`，也不会把 SKILL.md 的自然语言步骤编译成图**。
+
+父图的节点必须绑定该 Skill：
+
+```json
+{
+  "id": "run-skill",
+  "type": "subgraph",
+  "config": { "skillCode": "request-summary" }
+}
+```
+
+`skillCode` 必须与 `skillRefs[].code` 一致；不能只填写 `type: subgraph`。节点还需接入实际控制流，见下面的模板接法。
+
+## 接到 ReAct
+
+默认图通过 `read_file` / `execute_command` 使用普通 Skill，可看到 `📦 skill:…` 和工具执行记录。默认 `shouldContinue` 只返回 `call_tools` 或 `finish`，其中 `call_tools` 必须进入 `type: tool`；不能把该目标直接改为 subgraph。
+
+若先验证结构化 Skill 的执行，可把它作为 ReAct 前的**固定预处理步骤**：
+
+1. 在 `nodes` 中加入上面的 `run-skill`。
+2. 将 `__start__ → agent` 替换为下面两条边。
+3. 把 `entryPoint` 从 `agent` 改为 `run-skill`；工具循环、条件边和结束配置保持原样。
+
+```json
+[
+  { "from": "__start__", "to": "run-skill" },
+  { "from": "run-skill", "to": "agent" }
+]
+```
+
+顺序为 `__start__ → run-skill → agent ⇄ tools`，Skill 的需求记录进入 Agent 上下文。这个例子每次请求都执行 Skill，不代表模型自主选择 Skill。要达到“Agent 决定进入某个 Skill，完成后返回推理”的产品形态，需要额外的选择与条件路由；不能仅靠 `skillRefs` 或修改 `call_tools` 分支实现。
+
+## 检查结果
+
+改完文件后先执行 `eap validate`，再重启 `eap chat` / `eap dev`，输入“用户登录后导出月报”。应能看到 `request-summary` 的执行记录，以及“需求记录：用户登录后导出月报”的结果被后续步骤使用。
+
+`eap validate` 能检查父图引用和连边，但通过校验不代表已验证 Skill workflow 的运行行为。若报“子图节点无法解析 Skill workflow”，检查清单中的 `workflow.nodes` 是否非空、`skillCode` 是否匹配、是否已重新物化资源。
+
+示例是本地开发资源。上线前按平台要求登记、锁定和发布 Skill 及其依赖。

package/dist/templates/single-agent-with-tools/tools/http-weather/toolset.manifest.json

@@ -1,73 +1,73 @@
-{
-  "code": "http-weather",
-  "version": "1.0.0",
-  "name": "天气预报",
-  "type": "http",
-  "description": "官方脚手架默认装配。Open-Meteo 公开天气 HTTP，无需 API Key。本地 eap chat（mode=mcp）由 DevHttpExecutor 按 pathTemplate 直连；生产由 Gateway 受控出站。",
-  "toolRuntime": "server",
-  "category": "general",
-  "riskLevel": "low",
-  "gateway": {
-    "baseUrl": "https://api.open-meteo.com",
-    "allowedHosts": [
-      "api.open-meteo.com",
-      "geocoding-api.open-meteo.com"
-    ],
-    "timeout": 15
-  },
-  "tools": [
-    {
-      "name": "geocode_place",
-      "description": "按地名解析经纬度。查预报前先调用。返回 results[].name / latitude / longitude / country。",
-      "method": "GET",
-      "pathTemplate": "https://geocoding-api.open-meteo.com/v1/search?name={name}&count=5&language=zh&format=json",
-      "timeout": 15,
-      "input": {
-        "type": "object",
-        "required": [
-          "name"
-        ],
-        "properties": {
-          "name": {
-            "type": "string",
-            "description": "城市或地名，例如 上海、Beijing"
-          }
-        }
-      }
-    },
-    {
-      "name": "get_forecast",
-      "description": "按经纬度查询当前天气与逐日预报。latitude / longitude 须来自 geocode_place。weather_code 为 WMO 天气代码。",
-      "method": "GET",
-      "pathTemplate": "/v1/forecast?latitude={latitude}&longitude={longitude}&current=temperature_2m,relative_humidity_2m,apparent_temperature,weather_code,wind_speed_10m&daily=weather_code,temperature_2m_max,temperature_2m_min,precipitation_sum&timezone=auto&forecast_days={forecast_days}",
-      "timeout": 15,
-      "input": {
-        "type": "object",
-        "required": [
-          "latitude",
-          "longitude"
-        ],
-        "properties": {
-          "latitude": {
-            "type": "number",
-            "description": "纬度"
-          },
-          "longitude": {
-            "type": "number",
-            "description": "经度"
-          },
-          "forecast_days": {
-            "type": "integer",
-            "minimum": 1,
-            "maximum": 16,
-            "description": "预报天数。省略时由 Open-Meteo 默认 7 天"
-          }
-        }
-      }
-    }
-  ],
-  "metadata": {
-    "owner": "agent-template",
-    "source": "open-meteo http"
-  }
-}
+{
+  "code": "http-weather",
+  "version": "1.0.0",
+  "name": "天气预报",
+  "type": "http",
+  "description": "官方脚手架默认装配。Open-Meteo 公开天气 HTTP，无需 API Key。本地 eap chat（mode=mcp）由 DevHttpExecutor 按 pathTemplate 直连；生产由 Gateway 受控出站。",
+  "toolRuntime": "server",
+  "category": "general",
+  "riskLevel": "low",
+  "gateway": {
+    "baseUrl": "https://api.open-meteo.com",
+    "allowedHosts": [
+      "api.open-meteo.com",
+      "geocoding-api.open-meteo.com"
+    ],
+    "timeout": 15
+  },
+  "tools": [
+    {
+      "name": "geocode_place",
+      "description": "按地名解析经纬度。查预报前先调用。返回 results[].name / latitude / longitude / country。",
+      "method": "GET",
+      "pathTemplate": "https://geocoding-api.open-meteo.com/v1/search?name={name}&count=5&language=zh&format=json",
+      "timeout": 15,
+      "input": {
+        "type": "object",
+        "required": [
+          "name"
+        ],
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "城市或地名，例如 上海、Beijing"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_forecast",
+      "description": "按经纬度查询当前天气与逐日预报。latitude / longitude 须来自 geocode_place。weather_code 为 WMO 天气代码。",
+      "method": "GET",
+      "pathTemplate": "/v1/forecast?latitude={latitude}&longitude={longitude}&current=temperature_2m,relative_humidity_2m,apparent_temperature,weather_code,wind_speed_10m&daily=weather_code,temperature_2m_max,temperature_2m_min,precipitation_sum&timezone=auto&forecast_days={forecast_days}",
+      "timeout": 15,
+      "input": {
+        "type": "object",
+        "required": [
+          "latitude",
+          "longitude"
+        ],
+        "properties": {
+          "latitude": {
+            "type": "number",
+            "description": "纬度"
+          },
+          "longitude": {
+            "type": "number",
+            "description": "经度"
+          },
+          "forecast_days": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 16,
+            "description": "预报天数。省略时由 Open-Meteo 默认 7 天"
+          }
+        }
+      }
+    }
+  ],
+  "metadata": {
+    "owner": "agent-template",
+    "source": "open-meteo http"
+  }
+}

package/dist/templates/single-agent-with-tools/tools/web-search/toolset.manifest.json

@@ -1,41 +1,41 @@
-{
-  "code": "web-search",
-  "version": "1.0.0",
-  "name": "网络搜索",
-  "type": "mcp",
-  "description": "官方脚手架示例，默认未装配，上线前删除。Exa 公开网页检索。url 里的 ${EXA_API_KEY} 由本地 Runtime 展开。生产由 Gateway 注入凭据。",
-  "toolRuntime": "server",
-  "category": "general",
-  "riskLevel": "low",
-  "server": {
-    "transport": "streamable_http",
-    "url": "https://mcp.exa.ai/mcp?exaApiKey=${EXA_API_KEY}&tools=web_search_exa",
-    "timeout": 30
-  },
-  "tools": [
-    {
-      "name": "web_search_exa",
-      "description": "搜索公开网页。天气、新闻、外部事实用本工具。",
-      "input": {
-        "type": "object",
-        "required": [
-          "query"
-        ],
-        "properties": {
-          "query": {
-            "type": "string",
-            "minLength": 1
-          },
-          "numResults": {
-            "type": "number"
-          }
-        },
-        "additionalProperties": false
-      }
-    }
-  ],
-  "metadata": {
-    "owner": "agent-template",
-    "source": "exa mcp"
-  }
-}
+{
+  "code": "web-search",
+  "version": "1.0.0",
+  "name": "网络搜索",
+  "type": "mcp",
+  "description": "官方脚手架示例，默认未装配，上线前删除。Exa 公开网页检索。url 里的 ${EXA_API_KEY} 由本地 Runtime 展开。生产由 Gateway 注入凭据。",
+  "toolRuntime": "server",
+  "category": "general",
+  "riskLevel": "low",
+  "server": {
+    "transport": "streamable_http",
+    "url": "https://mcp.exa.ai/mcp?exaApiKey=${EXA_API_KEY}&tools=web_search_exa",
+    "timeout": 30
+  },
+  "tools": [
+    {
+      "name": "web_search_exa",
+      "description": "搜索公开网页。天气、新闻、外部事实用本工具。",
+      "input": {
+        "type": "object",
+        "required": [
+          "query"
+        ],
+        "properties": {
+          "query": {
+            "type": "string",
+            "minLength": 1
+          },
+          "numResults": {
+            "type": "number"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  ],
+  "metadata": {
+    "owner": "agent-template",
+    "source": "exa mcp"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gt-fe/eap-cli",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "description": "EAP CLI 工具 — Agent 项目创建、开发、测试、发布",
   "type": "module",
   "bin": {
@@ -23,7 +23,7 @@
     "react": "^18.3.1",
     "react-markdown": "^9.0.1",
     "remark-gfm": "^4.0.0",
-    "@gt-fe/eap-sdk": "0.2.19"
+    "@gt-fe/eap-sdk": "0.2.21"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",