@fieldwangai/agentflow 0.1.25

package/bin/lib/composer-script-ops.mjs

@@ -0,0 +1,233 @@
+/**
+ * Composer 脚本操作层：直接用 Node.js 修改 flow.yaml，无需 AI。
+ * 适用于确定性操作（改 label、body、role、value、连线、位置等）。
+ */
+import fs from "fs";
+import yaml from "js-yaml";
+
+// ─── YAML 读写 ─────────────────────────────────────────────────────────────
+
+function readFlowYaml(flowYamlAbs) {
+  const raw = fs.readFileSync(flowYamlAbs, "utf-8");
+  const doc = yaml.load(raw);
+  if (!doc || typeof doc !== "object") throw new Error("flow.yaml 解析失败或为空");
+  return { doc, raw };
+}
+
+function writeFlowYaml(flowYamlAbs, doc) {
+  const out = yaml.dump(doc, {
+    lineWidth: -1,
+    noRefs: true,
+    quotingType: "'",
+    forceQuotes: false,
+    sortKeys: false,
+  });
+  fs.writeFileSync(flowYamlAbs, out, "utf-8");
+}
+
+function ensureInstances(doc) {
+  if (!doc.instances || typeof doc.instances !== "object") {
+    doc.instances = {};
+  }
+  return doc.instances;
+}
+
+function ensureEdges(doc) {
+  if (!Array.isArray(doc.edges)) doc.edges = [];
+  return doc.edges;
+}
+
+function ensureUi(doc) {
+  if (!doc.ui || typeof doc.ui !== "object") doc.ui = {};
+  if (!doc.ui.nodePositions || typeof doc.ui.nodePositions !== "object") doc.ui.nodePositions = {};
+  return doc.ui;
+}
+
+// ─── 操作实现 ──────────────────────────────────────────────────────────────
+
+function opEditLabel(doc, params) {
+  const inst = ensureInstances(doc);
+  const { instanceId, value } = params;
+  if (!inst[instanceId]) throw new Error(`实例 ${instanceId} 不存在`);
+  inst[instanceId].label = value;
+  return `节点 ${instanceId} 的 label 已改为「${value}」`;
+}
+
+function opEditBody(doc, params) {
+  const inst = ensureInstances(doc);
+  const { instanceId, value } = params;
+  if (!inst[instanceId]) throw new Error(`实例 ${instanceId} 不存在`);
+  inst[instanceId].body = value;
+  return `节点 ${instanceId} 的 body 已更新`;
+}
+
+function opEditScript(doc, params) {
+  const inst = ensureInstances(doc);
+  const { instanceId, value } = params;
+  if (!inst[instanceId]) throw new Error(`实例 ${instanceId} 不存在`);
+  if (inst[instanceId].definitionId !== "tool_nodejs") {
+    throw new Error(`节点 ${instanceId} 的 definitionId 不是 tool_nodejs，不能设置 script 字段`);
+  }
+  inst[instanceId].script = value;
+  return `节点 ${instanceId} 的 script 已更新`;
+}
+
+function opEditRole(doc, params) {
+  const inst = ensureInstances(doc);
+  const { instanceId, value } = params;
+  if (!inst[instanceId]) throw new Error(`实例 ${instanceId} 不存在`);
+  inst[instanceId].role = value;
+  return `节点 ${instanceId} 的 role 已改为「${value}」`;
+}
+
+function opEditModel(doc, params) {
+  const inst = ensureInstances(doc);
+  const { instanceId, value } = params;
+  if (!inst[instanceId]) throw new Error(`实例 ${instanceId} 不存在`);
+  inst[instanceId].model = value;
+  return `节点 ${instanceId} 的 model 已改为「${value}」`;
+}
+
+function opEditInputValue(doc, params) {
+  const inst = ensureInstances(doc);
+  const { instanceId, inputName, value } = params;
+  if (!inst[instanceId]) throw new Error(`实例 ${instanceId} 不存在`);
+  const inputs = inst[instanceId].input;
+  if (!Array.isArray(inputs)) throw new Error(`实例 ${instanceId} 没有 input 数组`);
+  const slot = inputs.find((s) => s.name === inputName);
+  if (!slot) throw new Error(`实例 ${instanceId} 没有名为 ${inputName} 的输入`);
+  slot.value = value;
+  return `节点 ${instanceId} 输入 ${inputName} 的 value 已更新`;
+}
+
+function opEditOutputValue(doc, params) {
+  const inst = ensureInstances(doc);
+  const { instanceId, outputName, value } = params;
+  if (!inst[instanceId]) throw new Error(`实例 ${instanceId} 不存在`);
+  const outputs = inst[instanceId].output;
+  if (!Array.isArray(outputs)) throw new Error(`实例 ${instanceId} 没有 output 数组`);
+  const slot = outputs.find((s) => s.name === outputName);
+  if (!slot) throw new Error(`实例 ${instanceId} 没有名为 ${outputName} 的输出`);
+  slot.value = value;
+  return `节点 ${instanceId} 输出 ${outputName} 的 value 已更新`;
+}
+
+function opAddEdge(doc, params) {
+  const edges = ensureEdges(doc);
+  const { source, target, sourceHandle, targetHandle } = params;
+  if (!source || !target) throw new Error("连线需要 source 和 target");
+  const exists = edges.some(
+    (e) =>
+      e.source === source &&
+      e.target === target &&
+      (!sourceHandle || e.sourceHandle === sourceHandle) &&
+      (!targetHandle || e.targetHandle === targetHandle),
+  );
+  if (exists) return `边 ${source} → ${target} 已存在，跳过`;
+  const edge = { source, target };
+  if (sourceHandle) edge.sourceHandle = sourceHandle;
+  if (targetHandle) edge.targetHandle = targetHandle;
+  edges.push(edge);
+  return `已添加边 ${source} → ${target}`;
+}
+
+function opRemoveEdge(doc, params) {
+  const edges = ensureEdges(doc);
+  const { source, target, sourceHandle, targetHandle } = params;
+  const before = edges.length;
+  const filtered = edges.filter((e) => {
+    if (source && e.source !== source) return true;
+    if (target && e.target !== target) return true;
+    if (sourceHandle && e.sourceHandle !== sourceHandle) return true;
+    if (targetHandle && e.targetHandle !== targetHandle) return true;
+    return false;
+  });
+  doc.edges = filtered;
+  const removed = before - filtered.length;
+  return removed > 0 ? `已删除 ${removed} 条边` : "未找到匹配的边";
+}
+
+function opUpdatePosition(doc, params) {
+  const ui = ensureUi(doc);
+  const { instanceId, x, y } = params;
+  if (!ui.nodePositions[instanceId]) ui.nodePositions[instanceId] = {};
+  if (x != null) ui.nodePositions[instanceId].x = Number(x);
+  if (y != null) ui.nodePositions[instanceId].y = Number(y);
+  return `节点 ${instanceId} 位置已更新为 (${x}, ${y})`;
+}
+
+const OP_HANDLERS = {
+  "edit-label": opEditLabel,
+  "edit-body": opEditBody,
+  "edit-script": opEditScript,
+  "edit-role": opEditRole,
+  "edit-model": opEditModel,
+  "edit-input-value": opEditInputValue,
+  "edit-output-value": opEditOutputValue,
+  "add-edge": opAddEdge,
+  "remove-edge": opRemoveEdge,
+  "update-position": opUpdatePosition,
+};
+
+// ─── 公开接口 ──────────────────────────────────────────────────────────────
+
+/**
+ * 执行一个 script 类型步骤。
+ * @param {string} flowYamlAbs flow.yaml 绝对路径
+ * @param {{ op: string, params: object }} step
+ * @returns {{ success: boolean, message: string }}
+ */
+export function executeScriptOp(flowYamlAbs, step) {
+  const handler = OP_HANDLERS[step.op];
+  if (!handler) {
+    return { success: false, message: `未知操作: ${step.op}` };
+  }
+  try {
+    const { doc } = readFlowYaml(flowYamlAbs);
+    const message = handler(doc, step.params || {});
+    writeFlowYaml(flowYamlAbs, doc);
+    return { success: true, message };
+  } catch (e) {
+    return { success: false, message: e.message || String(e) };
+  }
+}
+
+/**
+ * 批量执行多个 script 操作（共享一次 YAML 读写）。
+ * @param {string} flowYamlAbs
+ * @param {Array<{ op: string, params: object }>} steps
+ * @returns {Array<{ success: boolean, message: string }>}
+ */
+export function executeScriptOpsBatch(flowYamlAbs, steps) {
+  const { doc } = readFlowYaml(flowYamlAbs);
+  const results = [];
+  for (const step of steps) {
+    const handler = OP_HANDLERS[step.op];
+    if (!handler) {
+      results.push({ success: false, message: `未知操作: ${step.op}` });
+      continue;
+    }
+    try {
+      const message = handler(doc, step.params || {});
+      results.push({ success: true, message });
+    } catch (e) {
+      results.push({ success: false, message: e.message || String(e) });
+    }
+  }
+  writeFlowYaml(flowYamlAbs, doc);
+  return results;
+}
+
+/**
+ * 检查一个操作名称是否属于已支持的 script 操作。
+ */
+export function isSupportedScriptOp(op) {
+  return op in OP_HANDLERS;
+}
+
+/**
+ * 返回所有支持的 script 操作名称列表。
+ */
+export function listScriptOps() {
+  return Object.keys(OP_HANDLERS);
+}

package/bin/lib/composer-skill-router.mjs

@@ -0,0 +1,384 @@
+/**
+ * Composer Skill Router：基于用户输入意图动态加载 SKILL.md 和 reference 文档。
+ *
+ * 意图分类：
+ *   query-explain  — 纯问答/解释（不修改文件）
+ *   add-instances  — 新增节点/实例
+ *   edit-fields    — 改已有节点内容
+ *   optimize-flow  — 优化/重构整体流程
+ *   optimize-nodes — 优化特定节点 prompt / body
+ *   create-flow    — 从零创建新流程
+ *
+ * 每种意图映射到需要注入的 skills 和 reference 文档。
+ */
+import fs from "fs";
+import path from "path";
+
+// ─── 意图模式定义 ─────────────────────────────────────────────────────────
+
+const INTENT_PATTERNS = [
+  {
+    id: "query-explain",
+    patterns: [
+      // 纯问答：问什么/怎么/为什么/是否/有没有
+      /^(?:这个|该|当前|选中)?.*(?:是什么|是啥|啥意思|怎么(?:工作|运行|执行|回事)|为什么|为啥|哪些|有没有|有多少|能不能|是否|如何|有什么)/i,
+      // 动词主导：解释/说明/介绍/查看/展示/分析
+      /(?:解释|说明|介绍|描述|分析|查看|看看|展示|显示|告诉|帮我看|帮我理解)/i,
+      // 名词主导：逻辑/作用/功能/原理
+      /(?:逻辑|作用|功能|用途|含义|意义|目的|原理|机制|区别|流程图|概览|概述).*(?:是|呢|吗|？|\?)/i,
+      // 英文
+      /(?:explain|describe|what\s+(?:does|is|are)|how\s+does|why\s+(?:does|is)|show\s+me|tell\s+me|walk.*through)/i,
+      // "X的逻辑/功能/作用"
+      /(?:脚本|script|body|prompt|代码|内容|节点|node).{0,15}(?:是什么|什么意思|做什么|干什么|逻辑|功能|作用|怎么样)/i,
+    ],
+  },
+  {
+    id: "create-flow",
+    patterns: [
+      /(?:新建|创建|新增|生成|搭建|设计).*(?:流程|流水线|pipeline|flow|agentflow)/i,
+      /(?:从零|从头|从无到有).*(?:搭|建|写|做)/i,
+      /create\s+(?:a\s+)?(?:new\s+)?(?:flow|pipeline)/i,
+    ],
+  },
+  {
+    id: "add-instances",
+    patterns: [
+      /(?:新增|添加|加入|插入|增加|加个|加一个|补充|补一个).*(?:节点|实例|node|instance|步骤|环节)/i,
+      /(?:加|添|增|补).*(?:分支|条件|判断|循环|环|if|toBool|agent_toBool|anyOne)/i,
+      /add\s+(?:a\s+)?(?:new\s+)?(?:node|instance|step)/i,
+    ],
+  },
+  {
+    id: "edit-fields",
+    patterns: [
+      /(?:改|修改|更新|调整|编辑|更换|换成|设为|设置|改为|替换|重写).*(?:节点|label|body|role|标签|名称|角色|内容|描述|文案|prompt|提示词|输入|输出|value|值)/i,
+      /(?:节点|label|body|role|标签|角色|内容|文案|prompt|提示词).*(?:改|修改|更新|调整|编辑|换|设|替换|重写)/i,
+      /edit\s+(?:node|label|body|role|content)/i,
+      /(?:把|将).{0,30}(?:改成|换成|设为|更新为|修改为|替换为)/i,
+    ],
+  },
+  {
+    id: "optimize-nodes",
+    patterns: [
+      /(?:优化|改善|提升|改进|完善|精炼|润色|增强).*(?:节点|node|body|prompt|提示词|描述|文案|内容)/i,
+      /(?:节点|node|body|prompt|提示词).*(?:优化|改善|提升|改进|完善|精炼|润色|增强)/i,
+      /(?:让|使).{0,20}(?:节点|node|prompt|body).{0,20}(?:更好|更准|更清晰|更高效)/i,
+      /optimize\s+(?:node|prompt|body)/i,
+    ],
+  },
+  {
+    id: "optimize-flow",
+    patterns: [
+      /(?:优化|改善|提升|改进|完善|重构|重新设计|简化|精简).*(?:流程|流水线|pipeline|flow|拓扑|结构|架构|整体)/i,
+      /(?:流程|流水线|pipeline|flow|拓扑|结构|架构|整体).*(?:优化|改善|提升|改进|完善|重构|重新设计|简化|精简)/i,
+      /(?:重新|重).*(?:规划|设计|组织|编排).*(?:流程|节点|步骤)/i,
+      /optimize\s+(?:flow|pipeline|topology)/i,
+      /refactor/i,
+    ],
+  },
+];
+
+// 意图 → 需要加载的 skills 和 references
+const INTENT_RESOURCES = {
+  "query-explain": {
+    skills: [],
+    references: [],
+  },
+  "create-flow": {
+    skills: ["agentflow-flow-add-instances"],
+    references: ["flow-control-capabilities.md", "flow-layout.md"],
+  },
+  "add-instances": {
+    skills: ["agentflow-flow-add-instances"],
+    references: ["flow-control-capabilities.md", "flow-layout.md"],
+  },
+  "edit-fields": {
+    skills: ["agentflow-flow-edit-node-fields"],
+    references: ["flow-prompt-handler-check.md"],
+  },
+  "optimize-nodes": {
+    skills: ["agentflow-flow-edit-node-fields", "agentflow-flow-add-instances"],
+    references: ["flow-prompt-handler-check.md", "flow-control-capabilities.md"],
+  },
+  "optimize-flow": {
+    skills: ["agentflow-flow-add-instances", "agentflow-flow-edit-node-fields"],
+    references: ["flow-control-capabilities.md", "flow-layout.md", "flow-prompt-handler-check.md"],
+  },
+};
+
+// ─── 文件缓存 ─────────────────────────────────────────────────────────────
+
+const _fileCache = new Map();
+const CACHE_TTL_MS = 60_000;
+
+function readFileCached(absPath) {
+  const now = Date.now();
+  const cached = _fileCache.get(absPath);
+  if (cached && now - cached.ts < CACHE_TTL_MS) return cached.content;
+  try {
+    const content = fs.readFileSync(absPath, "utf-8");
+    _fileCache.set(absPath, { content, ts: now });
+    return content;
+  } catch {
+    return null;
+  }
+}
+
+// ─── 意图检测 ─────────────────────────────────────────────────────────────
+
+/**
+ * 分析用户输入，返回匹配的意图 ID 列表（按优先级排序，去重）。
+ * 可能返回多个意图（如"优化节点并新增一个分支"同时匹配 optimize-nodes 和 add-instances）。
+ * @param {string} userPrompt
+ * @returns {string[]}
+ */
+export function detectIntents(userPrompt) {
+  if (!userPrompt || typeof userPrompt !== "string") return [];
+  const text = userPrompt.trim();
+  if (!text) return [];
+
+  const matched = [];
+  for (const { id, patterns } of INTENT_PATTERNS) {
+    for (const re of patterns) {
+      if (re.test(text)) {
+        matched.push(id);
+        break;
+      }
+    }
+  }
+  return [...new Set(matched)];
+}
+
+/**
+ * 将意图列表归类为注入策略类别。
+ * @param {string[]} intents
+ * @returns {"query" | "edit-node" | "add-node" | "add-flow" | "edit-flow" | "generic"}
+ */
+export function classifyIntentCategory(intents) {
+  if (!intents || intents.length === 0) return "generic";
+  // 纯 query（无任何编辑意图混入）
+  const editIntents = intents.filter(i => i !== "query-explain");
+  if (editIntents.length === 0) return "query";
+  // 混合 query + 编辑 → 按编辑侧分类
+  if (editIntents.includes("create-flow")) return "add-flow";
+  if (editIntents.includes("optimize-flow")) return "edit-flow";
+  if (editIntents.includes("add-instances")) return "add-node";
+  if (editIntents.includes("edit-fields") || editIntents.includes("optimize-nodes")) return "edit-node";
+  return "generic";
+}
+
+// ─── 加载 skill 和 reference 内容 ─────────────────────────────────────────
+
+/**
+ * 根据意图列表加载对应的 SKILL.md 和 reference 文档内容。
+ *
+ * @param {string[]} intents - detectIntents 返回的意图 ID 列表
+ * @param {string} packageRoot - AgentFlow 包根目录
+ * @returns {{ skills: Array<{id: string, content: string}>, references: Array<{name: string, content: string}>, skillsHint: string, hasContext: boolean }}
+ */
+export function loadResourcesForIntents(intents, packageRoot) {
+  if (!intents || intents.length === 0) {
+    return { skills: [], references: [], skillsHint: "", hasContext: false };
+  }
+
+  const skillIds = new Set();
+  const refNames = new Set();
+
+  for (const intent of intents) {
+    const res = INTENT_RESOURCES[intent];
+    if (!res) continue;
+    for (const s of res.skills) skillIds.add(s);
+    for (const r of res.references) refNames.add(r);
+  }
+
+  const skills = [];
+  for (const id of skillIds) {
+    const absPath = path.join(packageRoot, "skills", id, "SKILL.md");
+    const content = readFileCached(absPath);
+    if (content) {
+      const body = stripFrontmatter(content);
+      skills.push({ id, content: body, absPath });
+    }
+  }
+
+  const references = [];
+  for (const name of refNames) {
+    const absPath = path.join(packageRoot, "reference", name);
+    const content = readFileCached(absPath);
+    if (content) {
+      references.push({ name, content, absPath });
+    }
+  }
+
+  const skillsHint = buildSkillsHint(intents, skills, references);
+
+  return {
+    skills,
+    references,
+    skillsHint,
+    hasContext: skills.length > 0 || references.length > 0,
+  };
+}
+
+// ─── 构建注入到 prompt 的文本块 ───────────────────────────────────────────
+
+// 已知 reference / skill 的一行摘要（compact 模式注入）
+const RESOURCE_SUMMARIES = {
+  "agentflow-flow-add-instances": "新增 instance 与边的规则、handle 速查、布局原则、节点类型选择",
+  "agentflow-flow-edit-node-fields": "编辑已有 instance 字段白名单、tool_nodejs script 规则",
+  "flow-control-capabilities.md": "控制节点语义、handle 索引、循环模式（check→fix→re-check）",
+  "flow-layout.md": "ui.nodePositions 布局原则（主链 x+=280、分支 y±200）",
+  "flow-prompt-handler-check.md": "USER_PROMPT 中读写描述与节点 input/output edge 一致性",
+};
+
+/**
+ * Compact 注入：仅给绝对路径 + 一行摘要，agent 按需 Read。
+ * 比 buildSkillInjectionBlock 省 ~20-30KB/step。
+ * @param {Array<{id: string, content: string, absPath: string}>} skills
+ * @param {Array<{name: string, content: string, absPath: string}>} references
+ * @returns {string}
+ */
+export function buildSkillCompactInjectionBlock(skills, references) {
+  const parts = [];
+  if (skills.length === 0 && references.length === 0) return "";
+
+  parts.push("### 编辑技能与参考文档（按需 Read 绝对路径）");
+  parts.push("");
+  for (const s of skills) {
+    const summary = RESOURCE_SUMMARIES[s.id] || "";
+    parts.push(`- **skill** \`${s.id}\` — ${summary}`);
+    parts.push(`  路径：${s.absPath}`);
+  }
+  for (const r of references) {
+    const summary = RESOURCE_SUMMARIES[r.name] || "";
+    parts.push(`- **reference** \`${r.name}\` — ${summary}`);
+    parts.push(`  路径：${r.absPath}`);
+  }
+  parts.push("");
+  parts.push("**默认不需要 Read** — 节点 schema 表与阶段规则已覆盖 90% 场景。仅当遇到上述摘要明确涉及的特殊情况时再 Read 对应文件。");
+  return parts.join("\n");
+}
+
+/**
+ * 为单步 prompt 构建完整的 skill + reference 注入块。
+ * @param {Array<{id: string, content: string}>} skills
+ * @param {Array<{name: string, content: string}>} references
+ * @returns {string}
+ */
+export function buildSkillInjectionBlock(skills, references) {
+  const parts = [];
+
+  if (skills.length > 0) {
+    parts.push("### 相关编辑技能（请严格遵循）");
+    parts.push("");
+    for (const s of skills) {
+      parts.push(`<skill name="${s.id}">`);
+      parts.push(s.content.trim());
+      parts.push("</skill>");
+      parts.push("");
+    }
+  }
+
+  if (references.length > 0) {
+    parts.push("### 参考文档");
+    parts.push("");
+    for (const r of references) {
+      parts.push(`<reference name="${r.name}">`);
+      parts.push(r.content.trim());
+      parts.push("</reference>");
+      parts.push("");
+    }
+  }
+
+  return parts.join("\n");
+}
+
+/**
+ * 为多步模式的 flowContext.skillsHint 构建精简版。
+ */
+function buildSkillsHint(intents, skills, references) {
+  const lines = [];
+
+  if (intents.includes("add-instances") || intents.includes("create-flow")) {
+    lines.push("- 新增实例与边：遵循 skill `skills/agentflow-flow-add-instances/SKILL.md`（内容已注入上下文）");
+  }
+  if (intents.includes("edit-fields") || intents.includes("optimize-nodes")) {
+    lines.push("- 仅改已有实例文案/占位等：遵循 `skills/agentflow-flow-edit-node-fields/SKILL.md`（内容已注入上下文）");
+  }
+  if (intents.includes("optimize-flow")) {
+    lines.push("- 流程结构优化：参考 `reference/flow-control-capabilities.md` 和 `reference/flow-layout.md`（内容已注入上下文）");
+  }
+
+  lines.push(
+    "- **节点类型选择（必须遵守）**：**确定性任务 → tool_nodejs；非确定性任务 → agent_subAgent**。" +
+    "确定性 = 相同输入必出相同输出、可用普通代码完整描述（CLI/npm、读写文件、转换格式、调 API）。" +
+    "非确定性 = 需语义理解或创造（代码翻译/生成、源码/文本理解、多步决策、创意写作）。" +
+    "醒目输出 → tool_print。" +
+    "反例：『Android 转 RN』『代码 review』必须 agent。"
+  );
+  lines.push(
+    "- **tool_nodejs 必须写 script 字段**：script 是实际执行的命令代码，body 仅为文档注释（有 script 时不执行）。" +
+    "禁止 tool_nodejs 只有 body 没有 script（body 中的自然语言不会被执行）。" +
+    "如果无法写出完整可执行的 script，必须改用 agent_subAgent。"
+  );
+
+  return lines.join("\n");
+}
+
+// ─── 辅助 ─────────────────────────────────────────────────────────────────
+
+function stripFrontmatter(content) {
+  const match = content.match(/^---\n[\s\S]*?\n---\n?/);
+  return match ? content.slice(match[0].length) : content;
+}
+
+/**
+ * 为规划器提供精简的 skill 上下文摘要（不含完整文档内容，仅规则要点）。
+ * @param {string[]} intents
+ * @returns {string}
+ */
+export function buildPlannerSkillContext(intents) {
+  if (!intents || intents.length === 0) return "";
+
+  const parts = ["## 编辑技能约束（规划时须遵守）"];
+
+  if (intents.includes("add-instances") || intents.includes("create-flow")) {
+    parts.push(
+      "- 新增节点：须从 builtin/pipelines/new/flow.yaml 拷贝同类 definitionId 的实例模板；" +
+      "不要自造 input/output 顺序和 name；每个新 instanceId 须在 ui.nodePositions 写入坐标（主链从左到右 x 递增 280，起始 x:100 y:300；分支 y 错开 200）；" +
+      "默认不连线，仅当用户明确要求时才在 edges 中增加边。"
+    );
+    parts.push(
+      "- 节点类型选择：**确定性任务 → tool_nodejs；非确定性任务 → agent_subAgent**。" +
+      "确定性 = 相同输入永远相同输出（CLI/npm/读写文件/转换/调 API）；" +
+      "非确定性 = 需语义理解或创造（代码翻译/生成、理解源码、多步决策、创意写作）；" +
+      "醒目输出 → tool_print。反例：『Android 转 RN』『代码 review』必须 agent。"
+    );
+    parts.push(
+      "- tool_nodejs 的 script 与 body 区分：script 是实际执行的命令（必填），body 仅为文档注释（有 script 时不执行）；" +
+      "禁止 tool_nodejs 只写 body 不写 script（自然语言不会被执行）；如果无法写出完整可执行的 script，必须改用 agent_subAgent。"
+    );
+    parts.push("- 每个节点单一职责，不要把多个操作塞进同一个 body。");
+  }
+
+  if (intents.includes("edit-fields") || intents.includes("optimize-nodes")) {
+    parts.push(
+      "- 修改已有节点：可改白名单字段（label、body、role、script、input[].value、output[].value）；" +
+      "禁改 definitionId、instanceId 键名、input/output 数组结构与顺序、edges。"
+    );
+    parts.push(
+      "- **tool_nodejs 的 script 必须写**：`definitionId: tool_nodejs` 的节点核心是 `script`（实际执行的 shell/node 命令），" +
+      "`body` 有 script 时不执行。优化 tool_nodejs 节点时务必检查并完善 `script` 字段，禁止只在 `body` 里写自然语言描述。" +
+      "如果无法写出可执行 script，应建议改用 `agent_subAgent`。"
+    );
+  }
+
+  if (intents.includes("optimize-flow")) {
+    parts.push(
+      "- 流程优化可能涉及：调整拓扑（改边）、增删节点、改 body 内容、调整布局坐标。" +
+      "如果需要多种操作，拆成多个步骤（先改内容再连线，先加节点再连线）。"
+    );
+  }
+
+  return parts.join("\n");
+}