@xtalpi/agentic-lab-skills 0.0.9 → 0.0.11

package/skills/lab-flow-designer/embedded-template/SKILL.md

@@ -1,88 +1,103 @@
----
-name: embedded-flow-example
-description: >-
-  示意流程注册包。仅作 lab-flow-designer 内置版式样例，演示 SKILL/pools/valves/scripts 目录与章节结构。
-  Do not install as a standalone skill; copy layout to your output directory and replace name with the output folder name.
-metadata:
-  version: "1.0.0"
-  generated_by: lab-flow-designer
-  generated_at: "2026-06-20"
----
-
-# 示意流程
-
-## 概述
-
-示意流程用于演示「数据池 + 门控」协作时的文档写法：记录从入口池进入门控，经 **compound / chemical_record 类查询** 与规则校验后写入出口池。生成真实流程注册包时，本段替换为流程说明中的业务摘要。
-
-## 核心概念
-
-### 数据池（Pool）
-
-Pool 存多条记录，每池有独立 Schema，字段随阶段可不同。
-
-### 门控（Valve）
-
-每个门控对应一个脚本，导出 `Processer`，实现 `start` 与 `complete`。`this.context` 能力以本 skill 的 [references/agentic-lab-sdk.md](../references/agentic-lab-sdk.md) 为准；门控文档结构见 [valves/示例数据与校验门控.md](valves/示例数据与校验门控.md)。
-
-## 流程图
-
-（与 lab-flow-designer 约定一致：**池 = 矩形 `[…]`，门控 = 六边形 `{{…}}`**。）
-
-```mermaid
-flowchart LR
-  in_pool[入口池]
-  gate{{示例数据与校验门控}}
-  out_pool[出口池]
-  in_pool --> gate --> out_pool
-```
-
-**连接关系：**
-
-1. `入口池` → `示例数据与校验门控`：待处理记录进入门控
-2. `示例数据与校验门控` → `出口池`：校验与回填完成后写入出口池
-
-## 节点清单
-
-### Pool 节点（数据池）
-
-| 名称 | 文件 | 用途 |
-|------|------|------|
-| 入口池 | [pools/入口池.md](pools/入口池.md) | 流程入口数据 |
-| 出口池 | [pools/出口池.md](pools/出口池.md) | 流程出口数据 |
-
-### Valve 节点（门控）
-
-| 名称 | 文件 | 脚本 | 类型 |
-|------|------|------|------|
-| 示例数据与校验门控 | [valves/示例数据与校验门控.md](valves/示例数据与校验门控.md) | [scripts/示例数据与校验门控.js](scripts/示例数据与校验门控.js) | 自动化 |
-
-## 门控执行规范
-
-每个 Valve 的 JavaScript 脚本导出 `Processer` 类，必须实现 `start` / `complete`。由流程说明生成真实流程注册包时，脚本**仅实现文档明确要求**的逻辑与字段处理，须遵循主 `SKILL.md`「门控脚本编写指引」；下方代码块仅示意类骨架。
-
-```javascript
-class Processer {
-  constructor(context) {
-    this.context = context;
-  }
-
-  async start(params) {
-    // params: { valve_id, pool_ids }
-    // 从入口池拉取数据，执行处理逻辑
-    // 返回中间结果
-  }
-
-  async complete(params) {
-    // params: { valve_id, tickets }
-    // 将数据分发到出口池，更新状态
-    // 返回最终结果
-  }
-}
-```
-
-## 使用方式
-
-1. 查看各 Pool 的 [pools/](pools/) 目录了解数据表结构
-2. 查看各 Valve 的 [valves/](valves/) 目录了解门控逻辑和脚本路径
-3. 执行门控时，调用对应脚本的 `Processer` 类
+---
+name: embedded-flow-example
+description: >-
+  示意流程注册包。仅作 lab-flow-designer 内置版式样例，演示 SKILL/pools/valves/scripts 目录与章节结构。
+  Do not install as a standalone skill; copy layout to your output directory and replace name with the output folder name.
+metadata:
+  version: "1.0.0"
+  generated_by: lab-flow-designer
+  generated_at: "2026-06-20"
+---
+
+# 示意流程
+
+## 概述
+
+示意流程用于演示「数据池 + 门控」协作时的文档写法：记录从入口池进入门控，经 **compound / chemical_record 类查询** 与规则校验后写入出口池。生成真实流程注册包时，本段替换为流程说明中的业务摘要。
+
+## 核心概念
+
+### 数据池（Pool）
+
+Pool 存多条记录，每池有独立 Schema，字段随阶段可不同。
+
+### 门控（Valve）
+
+每个门控对应一个脚本，导出 `Processer`，实现 `start` 与 `complete`。`this.context` 能力以本 skill 的 [references/agentic-lab-sdk.md](../references/agentic-lab-sdk.md) 为准；门控文档结构见 [valves/示例数据与校验门控.md](valves/示例数据与校验门控.md)。
+
+## 流程图
+
+（与 lab-flow-designer 约定一致：**池 = 矩形 `[…]`，门控 = 六边形 `{{…}}`**。）
+
+```mermaid
+flowchart LR
+  in_pool[入口池]
+  gate{{示例数据与校验门控}}
+  out_pool[出口池]
+  in_pool --> gate --> out_pool
+```
+
+**连接关系：**
+
+1. `入口池` → `示例数据与校验门控`：待处理记录进入门控
+2. `示例数据与校验门控` → `出口池`：校验与回填完成后写入出口池
+
+## 节点清单
+
+### Pool 节点（数据池）
+
+| 名称 | 文件 | 用途 |
+|------|------|------|
+| 入口池 | [pools/入口池.md](pools/入口池.md) | 流程入口数据 |
+| 出口池 | [pools/出口池.md](pools/出口池.md) | 流程出口数据 |
+
+### Valve 节点（门控）
+
+| 名称 | 文件 | 脚本 | 类型 |
+|------|------|------|------|
+| 示例数据与校验门控 | [valves/示例数据与校验门控.md](valves/示例数据与校验门控.md) | [scripts/示例数据与校验门控.js](scripts/示例数据与校验门控.js) | 自动化 |
+
+## 门控执行规范
+
+每个 Valve 的 JavaScript 脚本导出 `Processer` 类，必须实现 `start` / `complete`（人工触发）或 `run`（自动触发）。由流程说明生成真实流程注册包时，脚本**仅实现文档明确要求**的逻辑与字段处理，须遵循主 `SKILL.md`「门控脚本编写指引」；下方代码块仅示意类骨架。
+
+```javascript
+class Processer {
+  constructor(context) {
+    this.context = context;
+  }
+
+  async start(params) {
+    // params: { valve_id, pool_ids }
+    // 从入口池拉取数据，执行处理逻辑
+    // 返回中间结果
+  }
+
+  async complete(params) {
+    // params: { valve_id, tickets }
+    // 将数据分发到出口池，更新状态
+    // 返回最终结果
+  }
+}
+```
+
+**自动触发门控**使用 `run` 替代 `start` + `complete`（详见 [references/agentic-lab-processer.md](../references/agentic-lab-processer.md)）：
+
+```javascript
+class Processer {
+  constructor(context) {
+    this.context = context;
+  }
+
+  async run(params) {
+    // params: { valve_id, pool_ids }
+    // 查询入口池 → 执行业务逻辑 → 获取出口池 → 映射 new_tickets
+  }
+}
+```
+
+## 使用方式
+
+1. 查看各 Pool 的 [pools/](pools/) 目录了解数据表结构
+2. 查看各 Valve 的 [valves/](valves/) 目录了解门控逻辑和脚本路径
+3. 执行门控时，调用对应脚本的 `Processer` 类

package/skills/lab-flow-designer/embedded-template/pools//345/205/245/345/217/243/346/261/240.md

@@ -1,12 +1,21 @@
-# 入口池
-
-## 概述
-
-流程入口池，存放尚未经门控处理的记录。
-
-## Schema
-
-| 字段 | 字段标题 | 字段描述 | 字段类型 | 属性 | 默认值 |
-|------|----------|----------|----------|------|--------|
-| id | ID | 业务主键 | string |  | - |
-| detail | Detail | 业务明细 JSON | json |  | - |
+# 入口池
+
+## 概述
+
+流程入口池，存放尚未经门控处理的记录。
+
+## Schema
+
+| 字段 | 字段标题 | 字段描述 | 字段类型 | 属性 | 默认值 |
+|------|----------|----------|----------|------|--------|
+| id | ID | 业务主键 | string |  | - |
+| detail | Detail | 业务明细 JSON | json |  | - |
+
+## 模型引用
+
+> 本池无关联 3D 模型，本节仅作版式示意。实际生成时，无模型引用的池省略本节。
+
+| 属性 | 值 |
+|------|-----|
+| 名称 | example-pool-model |
+| 版本 | 1.0.0 |

package/skills/lab-flow-designer/embedded-template/pools//345/207/272/345/217/243/346/261/240.md

@@ -1,12 +1,21 @@
-# 出口池
-
-## 概述
-
-流程出口池，存放经门控处理后的记录。
-
-## Schema
-
-| 字段 | 字段标题 | 字段描述 | 字段类型 | 属性 | 默认值 |
-|------|----------|----------|----------|------|--------|
-| id | ID | 业务主键 | string |  | - |
-| detail | Detail | 业务明细 JSON | json |  | - |
+# 出口池
+
+## 概述
+
+流程出口池，存放经门控处理后的记录。
+
+## Schema
+
+| 字段 | 字段标题 | 字段描述 | 字段类型 | 属性 | 默认值 |
+|------|----------|----------|----------|------|--------|
+| id | ID | 业务主键 | string |  | - |
+| detail | Detail | 业务明细 JSON | json |  | - |
+
+## 模型引用
+
+> 本池无关联 3D 模型，本节仅作版式示意。实际生成时，无模型引用的池省略本节。
+
+| 属性 | 值 |
+|------|-----|
+| 名称 | example-pool-model |
+| 版本 | 1.0.0 |

package/skills/lab-flow-designer/embedded-template/scripts//347/244/272/344/276/213/346/225/260/346/215/256/344/270/216/346/240/241/351/252/214/351/227/250/346/216/247.js

@@ -1,142 +1,142 @@
-/**
- * 示例门控脚本：结构对齐本 skill 主 SKILL.md 与 embedded-template；API 对齐 references/agentic-lab-sdk.md
- * 输入输出类型对齐 references/agentic-lab-processer.md（参数与返回值均为 snake_case）。
- * 业务规则以用户提供的流程说明 Markdown 为准（「数据查询方式」「字段映射」「数据处理规则」等）。
- *
- * 门控执行顺序：前置处理(start) → 人工处理(页面) → 后置处理(complete)
- *
- * 列表类查询：流程说明未要求分页时，显式 limit/offset（见主 SKILL「门控脚本编写指引 → 分页与查全量」）。
- *
- * 类型安全：ticket.detail 值为任意 JSON 类型（string/number/null/array/object），
- * 禁止直接调 .trim()/.split() 等 String 方法——须先 String() 转换（见「编写指引 §5」）。
- */
-
-// --- Artifact Version ---
-const __ARTIFACT_VERSION__ = '1.0.0';
-const __ARTIFACT_SKILL__ = 'lab-flow-designer';
-
-const DEFAULT_QUERY_LIMIT = 999999;
-
-// orbit_link 由流程文档门控脚本配置项中的 PageUrl 与门控前置处理中的 bookid 组合生成
-const PAGE_URL = 'http://10.249.133.129:9048/?view=book&book={bookid}';
-const BOOK_ID = '1';
-
-// --- 类型安全辅助函数（detail 值可为任意 JSON 类型，须先转换再操作）---
-function str(v) {
-  return v != null ? String(v) : '';
-}
-function num(v, fallback) {
-  const n = Number(v);
-  return Number.isFinite(n) ? n : (fallback !== undefined ? fallback : 0);
-}
-
-class Processer {
-  constructor(context) {
-    this.context = context;
-    console.info(`[Processer] v${__ARTIFACT_VERSION__} (skill: ${__ARTIFACT_SKILL__})`);
-  }
-
-  // --- 前置处理 → start ---
-  // params: { valve_id, pool_ids }
-  // returns: { orbit_link, ticket_ids }
-  async start(params) {
-    const { valve_id, pool_ids } = params;
-    const { list: tickets } = await this.context.ticket.list({
-      pool_id__in: pool_ids,
-      limit: DEFAULT_QUERY_LIMIT,
-      offset: 0,
-    });
-
-    const compoundIdList = [
-      ...new Set(
-        tickets
-          .map((t) => t.detail?.cmpd_id || t.detail?.compound_id)
-          .filter(Boolean)
-      ),
-    ];
-
-    let stockRecords = [];
-    if (compoundIdList.length > 0) {
-      const filter = { 'cas.$in': compoundIdList };
-      const stockResponse = await this.context.compound.getStockFromXfcSh({
-        filter,
-      });
-      stockRecords = stockResponse.data || [];
-    }
-
-    const stations = await this.context.station.list();
-    const processIds = tickets
-      .flatMap((t) => t.detail?.process_ids || [])
-      .filter(Boolean);
-    const processes =
-      processIds.length > 0
-        ? await this.context.process.list({
-            processIds,
-            limit: DEFAULT_QUERY_LIMIT,
-            offset: 0,
-          })
-        : [];
-
-    // --- 规则 1.1～1.4：按 valves/示例数据与校验门控.md「数据处理规则」写回 detail（以下为示意）---
-    for (const ticket of tickets) {
-      const d = ticket.detail || {};
-      const stock = stockRecords.filter((r) => str(r.cas) === str(d.cmpd_id));
-
-      if (stock.length) {
-        d.available_amount_mg = stock.reduce(
-          (s, r) => s + num(r.latest_amount_mg, 0),
-          0
-        );
-      }
-      d._stations_count = stations.length;
-      d._processes_preview = processes;
-      ticket.detail = d;
-    }
-
-    await this.context.ticket.update(tickets);
-
-    const orbit_link = PAGE_URL.replace('{bookid}', BOOK_ID);
-
-    return {
-      orbit_link,
-      ticket_ids: tickets.map((t) => t.id),
-    };
-  }
-
-  // --- 后置处理 → complete ---
-  // params: { valve_id, tickets }
-  // returns: { new_tickets }
-  async complete(params) {
-    const { valve_id, tickets } = params;
-
-    const nextPools = await this.context.pool.getNext(valve_id);
-    const outPool = nextPools.find((p) => p.name === '出口池');
-
-    if (!outPool) {
-      throw new Error(
-        `未找到出口池；nextPools=${nextPools.map((p) => p.name).join(',')}`
-      );
-    }
-
-    // 将入口池的tickets更新为”已完成”状态，避免重复处理
-    const finished = tickets.map((t) => ({
-      ...t,
-      status: 'finished',
-    }));
-    await this.context.ticket.update(finished);
-
-    // 按出口池 schema 映射为新 tickets，由引擎自动创建（不在脚本内调用 ticket.append）
-    const new_tickets = finished.map((t) => ({
-      flow_id: t.flow_id,
-      pool_id: outPool.id,
-      order_id: t.order_id,
-      detail: t.detail,
-      status: 'created',
-      parent_ticket_id: t.id,
-    }));
-
-    return {
-      new_tickets,
-    };
-  }
-}
+/**
+ * 示例门控脚本：结构对齐本 skill 主 SKILL.md 与 embedded-template；API 对齐 references/agentic-lab-sdk.md
+ * 输入输出类型对齐 references/agentic-lab-processer.md（参数与返回值均为 snake_case）。
+ * 业务规则以用户提供的流程说明 Markdown 为准（「数据查询方式」「字段映射」「数据处理规则」等）。
+ *
+ * 门控执行顺序：前置处理(start) → 人工处理(页面) → 后置处理(complete)
+ *
+ * 列表类查询：流程说明未要求分页时，显式 limit/offset（见主 SKILL「门控脚本编写指引 → 分页与查全量」）。
+ *
+ * 类型安全：ticket.detail 值为任意 JSON 类型（string/number/null/array/object），
+ * 禁止直接调 .trim()/.split() 等 String 方法——须先 String() 转换（见「编写指引 §5」）。
+ */
+
+// --- Artifact Version ---
+const __ARTIFACT_VERSION__ = '1.0.0';
+const __ARTIFACT_SKILL__ = 'lab-flow-designer';
+
+const DEFAULT_QUERY_LIMIT = 999999;
+
+// orbit_link 由流程文档门控脚本配置项中的 PageUrl 与门控前置处理中的 bookid 组合生成
+const PAGE_URL = 'http://10.249.133.129:9048/?view=book&book={bookid}';
+const BOOK_ID = '1';
+
+// --- 类型安全辅助函数（detail 值可为任意 JSON 类型，须先转换再操作）---
+function str(v) {
+  return v != null ? String(v) : '';
+}
+function num(v, fallback) {
+  const n = Number(v);
+  return Number.isFinite(n) ? n : (fallback !== undefined ? fallback : 0);
+}
+
+class Processer {
+  constructor(context) {
+    this.context = context;
+    console.info(`[Processer] v${__ARTIFACT_VERSION__} (skill: ${__ARTIFACT_SKILL__})`);
+  }
+
+  // --- 前置处理 → start ---
+  // params: { valve_id, pool_ids }
+  // returns: { orbit_link, ticket_ids }
+  async start(params) {
+    const { valve_id, pool_ids } = params;
+    const { list: tickets } = await this.context.ticket.list({
+      pool_id__in: pool_ids,
+      limit: DEFAULT_QUERY_LIMIT,
+      offset: 0,
+    });
+
+    const compoundIdList = [
+      ...new Set(
+        tickets
+          .map((t) => t.detail?.cmpd_id || t.detail?.compound_id)
+          .filter(Boolean)
+      ),
+    ];
+
+    let stockRecords = [];
+    if (compoundIdList.length > 0) {
+      const filter = { 'cas.$in': compoundIdList };
+      const stockResponse = await this.context.compound.getStockFromXfcSh({
+        filter,
+      });
+      stockRecords = stockResponse.data || [];
+    }
+
+    const stations = await this.context.station.list();
+    const processIds = tickets
+      .flatMap((t) => t.detail?.process_ids || [])
+      .filter(Boolean);
+    const processes =
+      processIds.length > 0
+        ? await this.context.process.list({
+            processIds,
+            limit: DEFAULT_QUERY_LIMIT,
+            offset: 0,
+          })
+        : [];
+
+    // --- 规则 1.1～1.4：按 valves/示例数据与校验门控.md「数据处理规则」写回 detail（以下为示意）---
+    for (const ticket of tickets) {
+      const d = ticket.detail || {};
+      const stock = stockRecords.filter((r) => str(r.cas) === str(d.cmpd_id));
+
+      if (stock.length) {
+        d.available_amount_mg = stock.reduce(
+          (s, r) => s + num(r.latest_amount_mg, 0),
+          0
+        );
+      }
+      d._stations_count = stations.length;
+      d._processes_preview = processes;
+      ticket.detail = d;
+    }
+
+    await this.context.ticket.update(tickets);
+
+    const orbit_link = PAGE_URL.replace('{bookid}', BOOK_ID);
+
+    return {
+      orbit_link,
+      ticket_ids: tickets.map((t) => t.id),
+    };
+  }
+
+  // --- 后置处理 → complete ---
+  // params: { valve_id, tickets }
+  // returns: { new_tickets }
+  async complete(params) {
+    const { valve_id, tickets } = params;
+
+    const nextPools = await this.context.pool.getNext(valve_id);
+    const outPool = nextPools.find((p) => p.name === '出口池');
+
+    if (!outPool) {
+      throw new Error(
+        `未找到出口池；nextPools=${nextPools.map((p) => p.name).join(',')}`
+      );
+    }
+
+    // 将入口池的tickets更新为”已完成”状态，避免重复处理
+    const finished = tickets.map((t) => ({
+      ...t,
+      status: 'finished',
+    }));
+    await this.context.ticket.update(finished);
+
+    // 按出口池 schema 映射为新 tickets，由引擎自动创建（不在脚本内调用 ticket.append）
+    const new_tickets = finished.map((t) => ({
+      flow_id: t.flow_id,
+      pool_id: outPool.id,
+      order_id: t.order_id,
+      detail: t.detail,
+      status: 'created',
+      parent_ticket_id: t.id,
+    }));
+
+    return {
+      new_tickets,
+    };
+  }
+}