@gt-fe/eap-cli 0.2.20 → 0.2.21

package/dist/templates/simple-flow/gitignore

@@ -1,51 +1,51 @@
-# OS files
-.DS_Store
-Thumbs.db
-Desktop.ini
-
-# Editor and IDE files
-.idea/
-.vscode/
-*.swp
-*.swo
-
-# Dependencies
-node_modules/
-.pnpm-store/
-
-# Lock files
-package-lock.json
-
-# Build outputs
-dist/
-build/
-out/
-.output/
-.history
-
-# Logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-
-# Test coverage
-coverage/
-
-# Turbo
-.turbo/
-
-# Environment
-.env
-.env.local
-.env.*.local
-
-# Temporary files
-tmp/
-temp/
-.cache/
-.run/
-
-# Generated Agent state
-.eap/
+# OS files
+.DS_Store
+Thumbs.db
+Desktop.ini
+
+# Editor and IDE files
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Dependencies
+node_modules/
+.pnpm-store/
+
+# Lock files
+package-lock.json
+
+# Build outputs
+dist/
+build/
+out/
+.output/
+.history
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Test coverage
+coverage/
+
+# Turbo
+.turbo/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Temporary files
+tmp/
+temp/
+.cache/
+.run/
+
+# Generated Agent state
+.eap/

package/dist/templates/simple-flow/graph.json

@@ -1,32 +1,32 @@
-{
-  "description": "固定顺序：code 整理输入后一次 LLM，无工具循环。",
-  "nodes": [
-    {
-      "id": "normalize",
-      "type": "code",
-      "config": {
-        "timeoutMs": 1000,
-        "code": "const msgs = Array.isArray(state.messages) ? state.messages : [];\nlet text = '';\nfor (let i = msgs.length - 1; i >= 0; i--) {\n  if (msgs[i] && msgs[i].role === 'user') { text = String(msgs[i].content || ''); break; }\n}\nreturn { step: 'normalize', text: String(text).replace(/\\s+/g, ' ').trim() };"
-      }
-    },
-    {
-      "id": "respond",
-      "type": "llm",
-      "config": {
-        "disableTools": true,
-        "systemPrompt": "根据最新用户消息和整理后的文本用中文回复。不要调用工具。"
-      }
-    }
-  ],
-  "edges": [
-    { "from": "__start__", "to": "normalize" },
-    { "from": "normalize", "to": "respond" },
-    { "from": "respond", "to": "__end__" }
-  ],
-  "entryPoint": "normalize",
-  "finishPoints": ["respond"],
-  "config": {
-    "maxRetries": 3,
-    "checkpointStore": "memory"
-  }
-}
+{
+  "description": "固定顺序：code 整理输入后一次 LLM，无工具循环。",
+  "nodes": [
+    {
+      "id": "normalize",
+      "type": "code",
+      "config": {
+        "timeoutMs": 1000,
+        "code": "const msgs = Array.isArray(state.messages) ? state.messages : [];\nlet text = '';\nfor (let i = msgs.length - 1; i >= 0; i--) {\n  if (msgs[i] && msgs[i].role === 'user') { text = String(msgs[i].content || ''); break; }\n}\nreturn { step: 'normalize', text: String(text).replace(/\\s+/g, ' ').trim() };"
+      }
+    },
+    {
+      "id": "respond",
+      "type": "llm",
+      "config": {
+        "disableTools": true,
+        "systemPrompt": "根据最新用户消息和整理后的文本用中文回复。不要调用工具。"
+      }
+    }
+  ],
+  "edges": [
+    { "from": "__start__", "to": "normalize" },
+    { "from": "normalize", "to": "respond" },
+    { "from": "respond", "to": "__end__" }
+  ],
+  "entryPoint": "normalize",
+  "finishPoints": ["respond"],
+  "config": {
+    "maxRetries": 3,
+    "checkpointStore": "memory"
+  }
+}

package/dist/templates/simple-flow/package.json

@@ -1,10 +1,10 @@
-{
-  "name": "simple-flow-agent",
-  "description": "Fixed sequential Agent: one code step then one LLM, no tool loop",
-  "version": "1.0.0",
-  "private": true,
-  "scripts": {
-    "validate": "eap validate --strict",
-    "package": "eap package"
-  }
-}
+{
+  "name": "simple-flow-agent",
+  "description": "Fixed sequential Agent: one code step then one LLM, no tool loop",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "validate": "eap validate --strict",
+    "package": "eap package"
+  }
+}

package/dist/templates/simple-flow/skills/README.md

@@ -1,113 +1,113 @@
-# 装配与执行 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`。节点还需接入实际控制流，见下面的模板接法。
-
-## 接到 Simple Flow
-
-保留 `normalize`、`respond`，在 `nodes` 中加入上面的 `run-skill`。将 `normalize → respond` 替换为以下两条边，其余边与入口、结束配置保持原样：
-
-```json
-[
-  { "from": "normalize", "to": "run-skill" },
-  { "from": "run-skill", "to": "respond" }
-]
-```
-
-完整顺序为 `__start__ → normalize → run-skill → respond → __end__`。`respond` 保持 `disableTools: true`；Skill 由固定边触发，结果进入后续 LLM 的上下文。只加 `skillRefs` 而不改图，不会执行子图。
-
-## 检查结果
-
-改完文件后先执行 `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`。节点还需接入实际控制流，见下面的模板接法。
+
+## 接到 Simple Flow
+
+保留 `normalize`、`respond`，在 `nodes` 中加入上面的 `run-skill`。将 `normalize → respond` 替换为以下两条边，其余边与入口、结束配置保持原样：
+
+```json
+[
+  { "from": "normalize", "to": "run-skill" },
+  { "from": "run-skill", "to": "respond" }
+]
+```
+
+完整顺序为 `__start__ → normalize → run-skill → respond → __end__`。`respond` 保持 `disableTools: true`；Skill 由固定边触发，结果进入后续 LLM 的上下文。只加 `skillRefs` 而不改图，不会执行子图。
+
+## 检查结果
+
+改完文件后先执行 `eap validate`，再重启 `eap chat` / `eap dev`，输入“用户登录后导出月报”。应能看到 `request-summary` 的执行记录，以及“需求记录：用户登录后导出月报”的结果被后续步骤使用。
+
+`eap validate` 能检查父图引用和连边，但通过校验不代表已验证 Skill workflow 的运行行为。若报“子图节点无法解析 Skill workflow”，检查清单中的 `workflow.nodes` 是否非空、`skillCode` 是否匹配、是否已重新物化资源。
+
+示例是本地开发资源。上线前按平台要求登记、锁定和发布 Skill 及其依赖。