@fieldwangai/agentflow 0.1.153 → 0.1.154

package/skills/agentflow-workspace-ascii/SKILL.md

@@ -2,7 +2,7 @@
 name: agentflow-workspace-ascii
 description: >-
   AgentFlow Workspace ASCII 图展示技能。用于生成目录树、文本框图、流程草图等
-  等宽 ASCII 内容，并写入 display_ascii 节点的 workspace.graph.json。
+  等宽 ASCII 内容，并写入 workspace.flow.js 的 display.ascii 节点。
 ---
 
 # AgentFlow Workspace ASCII
@@ -11,21 +11,14 @@ description: >-
 
 ## 生成节点
 
-新增或更新 `workspace.graph.json` 中的 `display_ascii` instance：
-
-```json
-{
-  "definitionId": "display_ascii",
-  "label": "目录树",
-  "body": "app/\n|-- src/\n|-- package.json",
-  "input": [
-    { "type": "node", "name": "prev", "value": "" },
-    { "type": "text", "name": "content", "value": "app/\n|-- src/\n|-- package.json" }
-  ],
-  "output": [
-    { "type": "text", "name": "content", "value": "app/\n|-- src/\n|-- package.json" }
-  ]
-}
+在 `workspace.flow.js` 里新增或更新一个 `display.ascii` 节点：
+
+```js
+const tree = display.ascii("目录树", {
+  content: `app/
+|-- src/
+|-- package.json`,
+});
 ```
 
 `body`、`input.content.value`、`output.content.value` 使用同一份 ASCII 文本。

package/skills/agentflow-workspace-graph/SKILL.md

@@ -2,7 +2,7 @@
 name: agentflow-workspace-graph
 description: >-
   AgentFlow Workspace 画布编辑技能。用于在 Workspace 视图中创建或修改
-  workspace.graph.json，新增展示节点、上下文节点和连线；不修改正式 flow.yaml。
+  workspace.flow.js，新增展示节点、上下文节点和连线；不修改正式 flow.yaml。
 ---
 
 # AgentFlow Workspace Graph
@@ -11,61 +11,75 @@ description: >-
 
 ## 目标文件
 
-优先修改当前 Workspace 项目目录下的 `workspace.graph.json`。不要修改历史 `flow.yaml`，除非用户明确要求迁移或审计。
-
-`workspace.graph.json` 结构：
-
-```json
-{
-  "version": 1,
-  "instances": {
-    "node_id": {
-      "definitionId": "display_markdown",
-      "label": "标题",
-      "body": "展示内容",
-      "input": [
-        { "type": "node", "name": "prev", "value": "" },
-        { "type": "text", "name": "content", "value": "展示内容" }
-      ],
-      "output": [
-        { "type": "text", "name": "content", "value": "展示内容" }
-      ]
-    }
-  },
-  "edges": [
-    { "source": "a", "target": "b", "sourceHandle": "output-0", "targetHandle": "input-0" }
-  ],
-  "ui": {
-    "nodePositions": { "node_id": { "x": 320, "y": 180 } },
-    "nodeSizes": { "node_id": { "width": 760, "height": 520 } }
-  }
-}
+画布就是代码：改当前 Workspace 项目目录下的 **`workspace.flow.js`**。不要修改历史
+`flow.yaml`，也不要写 `workspace.graph.json`——那是已经退役的格式，写了不会被读。
+
+```
+workspace.flow.js      ← 改这个
+workspace.layout.json    坐标，平台维护，别碰
+workspace.nodes.json     图片等机器属性，平台维护，别碰
+workspace.state.json     运行产出，平台维护，别碰
+```
+
+坐标不用管：新节点平台会自动排布，写死坐标反而会覆盖用户调过的位置。
+
+## 写法
+
+```js
+import { agent, control, display, flow } from "agentflow/flow";
+
+const notes = display.markdown("项目结构分析", {
+  content: `# 项目结构分析
+
+- src/ 业务代码
+- bin/ CLI 入口`,
+});
+```
+
+| 位置 | 含义 |
+|------|------|
+| 第 1 个参数（字符串） | 节点显示名 |
+| 第 2 个参数（对象） | 输入引脚，每个键都是引脚名 |
+| 第 3 个参数（字符串） | body：agent 的 prompt、`tool.nodejs` 的命令 |
+| `const 变量名` | 节点 id |
+| `x.slotName` | 引用上游输出引脚 = 连一条数据线 |
+
+连线和控制流：
+
+```js
+const summary = agent.subAgent("总结", { source: notes.content }, `把上面的结构讲清楚`);
+const show    = display.markdown("总结", { content: summary.result });
+export const run = flow("Run", summary, show);
 ```
 
-## 节点使用规则
+只放一个展示节点、不需要跑的，不用写 `flow(...)`，声明出来就行。
 
-- 用 `display_markdown` 展示 Markdown 正文、分析报告、会议纪要、代码结构说明。
-- 用 `display_mermaid` 展示 Mermaid 图源码。
-- 用 `display_ascii` 展示 ASCII 图。
-- 用 `display_html` 展示可交互 HTML 原型或富 UI 片段。
-- 用 `display_image` 展示图片 URL、data URL 或图片路径。
-- 用 `display_chart` 展示 ChartSpec JSON 图表。
-- 用 `display_table` 展示结构化表格数据。
-- 用普通 Workspace 节点作为上下文节点时，保持 `instances` 结构与节点定义一致；它只属于 workspace graph。
-- 每个新增 instance 必须有 `ui.nodePositions`。
-- 展示节点建议写 `ui.nodeSizes`，避免内容区域过小。
+## 铁律
 
-## 连接语义
+1. 节点全部声明在**模块顶层**
+2. **禁一切控制流**：`if` / `for` / `while` / `?:` / `.map()` / `await` / 箭头函数 /
+   动态属性。这个文件永不执行、只被静态解析，出现这些就还原不出图。要写逻辑就建代码
+   节点 `nodes/<name>/index.mjs`
+3. 一个输出可接多个输入；**一个输入只能接一条边**；不能成环
+4. 改完跑 `agentflow flow dsl lint <flowDir>` 自查
 
-展示节点的输入：
+完整语法和全部可用节点见 **agentflow-flow-dsl** skill。
 
-- `input[0]` / `targetHandle: "input-0"`：node prev，用于连接上游上下文。
-- `input[1]`：text content，展示内容。
+## 展示节点选型
 
-展示节点的输出：
+- `display.markdown` — Markdown 正文、分析报告、会议纪要、代码结构说明
+- `display.mermaid` — Mermaid 图源码
+- `display.ascii` — ASCII 图
+- `display.html` — 可交互 HTML 原型或富 UI 片段
+- `display.image` — 图片 URL、data URL 或图片路径
+- `display.chart` — ChartSpec JSON 图表
+- `display.table` — 结构化表格数据
 
-- `output[0]` / `sourceHandle: "output-0"`：text content，可作为后续 agent 的上下文输入。
+内容写在 `content` 引脚上；平台会同时把它当作节点正文。展示节点的 `content` 输出可以
+接给后续 agent 当上下文。
 
 ## 输出要求
 
-当用户要求“生成/展示/放到 workspace 画布”时，直接编辑 `workspace.graph.json`。如果用户要求所见即所得的线上画布，随后使用 `agentflow-cli workspace-preview` 上传到服务器临时 Workspace；不要把临时项目当作正式源版本。完成后简要说明新增或修改了哪些 workspace 节点。
+用户要求「生成/展示/放到 workspace 画布」时，直接编辑 `workspace.flow.js`。需要所见即所得
+的线上画布，再用 `agentflow-cli workspace-preview --file <flowDir>` 上传到服务器临时
+Workspace；不要把临时项目当作正式源版本。完成后简要说明新增或修改了哪些节点。

package/skills/agentflow-workspace-html/SKILL.md

@@ -60,6 +60,11 @@ HTML 展示节点接收完整 HTML 文档或 HTML fragment：
 
 ## 节点写入
 
-新增或更新 `workspace.graph.json` 中的 `display_html` instance 时，`body`、`input.content.value`、`output.content.value` 使用同一份 HTML。
+在 `workspace.flow.js` 里写一个 `display.html` 节点，HTML 放 `content` 引脚：
 
-建议默认尺寸：宽 430-760，高 640-860，按原型复杂度调整。
+```js
+const proto = display.html("原型", { content: file("docs/proto.html") });
+```
+
+超过 3000 字符就像上面这样抽成 `docs/*.html`——整页 HTML 内联会把流程结构淹没。
+尺寸由平台维护，不要手写。

package/skills/agentflow-workspace-image/SKILL.md

@@ -47,6 +47,10 @@ description: >-
 
 ## 节点写入
 
-新增或更新 `workspace.graph.json` 中的 `display_image` instance 时，`body`、`input.src.value`、`output.src.value` 使用同一份图片 src。
+在 `workspace.flow.js` 里写一个 `display.image` 节点，图片地址放 `src` 引脚：
 
-建议默认尺寸：宽 520-760，高 420-680。
+```js
+const shot = display.image("截图", { src: "outputs/image.png" });
+```
+
+尺寸由平台维护，不要手写。

package/skills/agentflow-workspace-markdown/SKILL.md

@@ -2,7 +2,7 @@
 name: agentflow-workspace-markdown
 description: >-
   AgentFlow Workspace Markdown 展示技能。用于把分析、总结、文档、代码结构说明
-  生成 display_markdown 节点并写入 workspace.graph.json，作为后续 agent 上下文。
+  生成 display.markdown 节点并写入 workspace.flow.js，作为后续 agent 上下文。
 ---
 
 # AgentFlow Workspace Markdown
@@ -11,24 +11,18 @@ description: >-
 
 ## 生成节点
 
-新增或更新 `workspace.graph.json` 中的 `display_markdown` instance：
-
-```json
-{
-  "definitionId": "display_markdown",
-  "label": "项目结构分析",
-  "body": "# 项目结构分析\n\n...",
-  "input": [
-    { "type": "node", "name": "prev", "value": "" },
-    { "type": "text", "name": "content", "value": "# 项目结构分析\n\n..." }
-  ],
-  "output": [
-    { "type": "text", "name": "content", "value": "# 项目结构分析\n\n..." }
-  ]
-}
+在 `workspace.flow.js` 里新增或更新一个 `display.markdown` 节点：
+
+```js
+const structure = display.markdown("项目结构分析", {
+  content: `# 项目结构分析
+
+- src/ 业务代码`,
+});
 ```
 
-`body`、`input.content.value`、`output.content.value` 使用同一份 Markdown 内容。
+超过 3000 字符的正文抽成文件，写 `file("docs/structure.md")`。画布语法见
+**agentflow-workspace-graph** / **agentflow-flow-dsl**。
 
 ## 内容规范
 
@@ -37,8 +31,7 @@ description: >-
 - Mermaid 内容不要放进 Markdown 节点；用 `display_mermaid`。
 - ASCII 图不要放进 Markdown 节点；用 `display_ascii`。
 
-## 布局建议
+## 布局
 
-- 默认宽度 760，高度 520。
-- 多个 Markdown 节点按从左到右、从上到下排布。
-- label 放短标题，正文放 body/content。
+坐标和尺寸由平台维护（`workspace.layout.json`），不要手写。label 放短标题，正文放
+`content`。

package/skills/agentflow-workspace-mermaid/SKILL.md

@@ -2,7 +2,7 @@
 name: agentflow-workspace-mermaid
 description: >-
   AgentFlow Workspace Mermaid 展示技能。用于生成流程图、架构图、依赖图等
-  Mermaid 源码，并写入 display_mermaid 节点的 workspace.graph.json。
+  Mermaid 源码，并写入 workspace.flow.js 的 display.mermaid 节点。
 ---
 
 # AgentFlow Workspace Mermaid
@@ -11,21 +11,13 @@ description: >-
 
 ## 生成节点
 
-新增或更新 `workspace.graph.json` 中的 `display_mermaid` instance：
-
-```json
-{
-  "definitionId": "display_mermaid",
-  "label": "流程图",
-  "body": "flowchart TD\n  A[Start] --> B[Analyze]",
-  "input": [
-    { "type": "node", "name": "prev", "value": "" },
-    { "type": "text", "name": "content", "value": "flowchart TD\n  A[Start] --> B[Analyze]" }
-  ],
-  "output": [
-    { "type": "text", "name": "content", "value": "flowchart TD\n  A[Start] --> B[Analyze]" }
-  ]
-}
+在 `workspace.flow.js` 里新增或更新一个 `display.mermaid` 节点：
+
+```js
+const chart = display.mermaid("流程图", {
+  content: `flowchart TD
+  A[Start] --> B[Analyze]`,
+});
 ```
 
 `body`、`input.content.value`、`output.content.value` 使用同一份 Mermaid 源码。