@xtalpi/agentic-lab-skills 0.0.10 → 0.0.11

package/skills/lab-flow-designer/templates//344/270/232/345/212/241/346/265/201/347/250/213/346/226/207/346/241/243/346/250/241/346/235/277.md

@@ -1,192 +1,192 @@
-# 业务执行手册描述
-
-# （流程名称）
-
-***
-
-## 1. 流程元信息
-
-| 属性   | 值 |
-| ---- | --- |
-| 流程标识 | （机器可读 ID，如 `fragment`，小写字母、数字、下划线） |
-| 流程名称 | （人类可读名称） |
-| 版本   | （如 1.0.0） |
-| 业务摘要 | （1～3 句说明业务目标与边界） |
-
-***
-
-## 2. 记录（Record）
-
-**记录**是沿数据池与门控流转的最小业务单元：一条记录对应（描述最小流转单元，例如「一个化合物的分装任务」）。字段分两类：
-
-* **入口字段**：进入流程时即应具备（或由上游写入）。
-* **富化字段**：在特定门控的检查或回填过程中逐步写入；下文按门控分组列出。
-
-### 2.1 入口字段（必填与选填）
-
-| 字段名 | 类型 | 必填 | 说明 |
-| ----- | ---- | -- | --- |
-| （例：Order ID） | text | Y | （字段说明） |
-| （例：Target Amount） | number | Y | （字段说明，注明单位如 mg） |
-| （例：Status） | text | N | （枚举/布尔字段须列出可选值） |
-
-### 2.2 门控「（门控 1 显示名称）」可能写入的字段
-
-| 字段名 | 类型 | 说明 |
-| ----- | ---- | --- |
-| （例：Available Amount） | number | （字段含义与来源） |
-| （例：Source Barcode） | text | （字段含义与来源） |
-
-### 2.3 门控「（门控 2 显示名称）」可能写入的字段
-
-| 字段名 | 类型 | 说明 |
-| ----- | ---- | --- |
-| （按需继续添加...） | | |
-
-> **提示**：每个会修改记录的门控都需要一个对应的富化字段小节（§2.x）。若门控不写入新字段，可显式写「无新增字段」。
-
-***
-
-## 3. 数据池（Stash）
-
-数据池是**记录的容器**：记录只在门控驱动下从一个池进入另一个池。
-
-| 显示名称 | 逻辑 ID | 角色 | 池中记录的业务含义 |
-| ------- | ------- | --- | ------------- |
-| （例：待处理池） | `stash_input` | 入口池 | （业务含义） |
-| （例：处理中池） | `stash_processing` | 中间池 | （业务含义） |
-| （例：异常池） | `stash_error` | 异常池 | （业务含义） |
-| （例：完成池） | `stash_done` | 终点池 | （业务含义） |
-
-> **提示**：显示名称须与门控 YAML 中的 `input`/`output` 池名逐字一致（含标点、中间点「·」等）。逻辑 ID 仅使用小写字母、数字、下划线。
-
-### 3.1 数据池模型引用（按需）
-
-> 若数据池关联 3D 模型，在此列出模型信息。无关联模型时省略本节。
-
-| 池显示名称 | 模型名称 | 模型版本 |
-| --------- | ------- | ------- |
-| （例：待处理池） | （例：reactor_v2） | （例：1.0.0） |
-
-***
-
-## 4. 池间流转（拓扑）
-
-```mermaid
-graph LR
-    stash_input["待处理池"]
-    gate_1{{"门控 1 名称"}}
-    stash_processing["处理中池"]
-
-    stash_input --> gate_1 --> stash_processing
-```
-
-> **提示**：数据池使用矩形 `["..."]`，门控使用六边形 `{{"..."}}`。
-
-**文字补充**
-
-* **（门控 1 名称）**：入口为「（入口池名）」；出口为（列出各出口分支语义）。
-* **（门控 2 名称）**：（描述入口池集合和出口分支；合流门控须写明多入口来源）。
-
-***
-
-## 5. 门控（Valve）
-
-每个门控是**检查—路由**节点：对输入池中待处理的记录执行业务规则，并依据结果将记录路由到**唯一匹配的输出池**。
-
-查询约定：
-- （例：默认最大查询条数 3000，即 limit: 3000）
-
-约定字段：
-
-* `valve_id`：文档内稳定标识。
-* `order`：建议执行顺序，与拓扑中依赖关系一致。
-* `input`：`primary` 为主输入池；`secondary` 为合流时的第二输入池。
-* `output`：每条包含目标池与路由条件。
-
-### 5.1 （门控 1 显示名称）
-
-```yaml
-valve_id: valve_1
-name: （门控显示名称，须与拓扑边标签一致）
-order: 1
-input:
-  primary: （入口池显示名称）
-output:
-  - Stash: （出口池 A 显示名称）
-    condition: （路由条件，须引用 §2 中的字段名）
-  - Stash: （出口池 B 显示名称）
-    condition: （路由条件）
-```
-
-#### 触发方式
-
-（自动触发 / 人工触发）
-
-**化合物数据查询方式**（若本门控需要查询外部数据）
-
-（说明查哪类库、用哪些入口字段作键、返回什么、汇总规则等）
-
-**字段映射表**（若存在库表/API 列与门控加工字段对应）
-
-| 门控加工数据 | 库字段 |
-| --------- | ----- |
-| （例：性状） | （例：chemistProperty） |
-
-**数据处理规则**
-
-| 序号 | 规则摘要 | 条件要点 | 业务动作或结果 |
-| --- | ------- | ------- | ----------- |
-| 1.1 | （简述） | （条件，须引用字段名） | （动作或路由结果） |
-| 1.2 | （简述） | （条件） | （动作或路由结果） |
-
-**操作员步骤**（若为人工门控）
-
-1. （步骤描述，可执行、可验收）
-2. （...）
-
-**模型引用**（若本门控关联 3D 模型，无则省略）
-
-| 属性 | 值 |
-|------|-----|
-| 名称 | （模型名称） |
-| 版本 | （模型版本） |
-
-***
-
-### 5.2 （门控 2 显示名称）
-
-```yaml
-valve_id: valve_2
-name: （门控显示名称）
-order: 2
-input:
-  primary: （入口池显示名称）
-  secondary: （合流时的第二入口池，无合流则删除此行）
-output:
-  - Stash: （出口池显示名称）
-    condition: （路由条件）
-```
-
-#### 触发方式
-
-（自动触发 / 人工触发）
-
-**数据处理规则**
-
-| 序号 | 规则摘要 | 条件要点 | 业务动作或结果 |
-| --- | ------- | ------- | ----------- |
-| 2.1 | （简述） | （条件） | （动作或路由结果） |
-
-> **提示**：按需复制门控子节，每个门控至少包含 YAML 代码块和触发方式。需查询外部数据的加「查询方式」和「字段映射表」，含计算/判定的加「数据处理规则」，人工触发门控加「操作员步骤」，关联 3D 模型的加「模型引用」。
-
-***
-
-## 6. 知识库 / 外部主数据（按需）
-
-> 若门控规则依赖外部主数据（如化合物知识库、设备资源库等），在此列出字段语义。无外部依赖时可写「本流程不依赖外部主数据」。
-
-| 逻辑键 | 字段含义 | 类型/取值说明 |
-| ----- | ------- | ----------- |
-| （例：Compound ID） | （含义） | text |
-| （例：latest_amount_mg） | （含义） | number |
+# 业务执行手册描述
+
+# （流程名称）
+
+***
+
+## 1. 流程元信息
+
+| 属性   | 值 |
+| ---- | --- |
+| 流程标识 | （机器可读 ID，如 `fragment`，小写字母、数字、下划线） |
+| 流程名称 | （人类可读名称） |
+| 版本   | （如 1.0.0） |
+| 业务摘要 | （1～3 句说明业务目标与边界） |
+
+***
+
+## 2. 记录（Record）
+
+**记录**是沿数据池与门控流转的最小业务单元：一条记录对应（描述最小流转单元，例如「一个化合物的分装任务」）。字段分两类：
+
+* **入口字段**：进入流程时即应具备（或由上游写入）。
+* **富化字段**：在特定门控的检查或回填过程中逐步写入；下文按门控分组列出。
+
+### 2.1 入口字段（必填与选填）
+
+| 字段名 | 类型 | 必填 | 说明 |
+| ----- | ---- | -- | --- |
+| （例：Order ID） | text | Y | （字段说明） |
+| （例：Target Amount） | number | Y | （字段说明，注明单位如 mg） |
+| （例：Status） | text | N | （枚举/布尔字段须列出可选值） |
+
+### 2.2 门控「（门控 1 显示名称）」可能写入的字段
+
+| 字段名 | 类型 | 说明 |
+| ----- | ---- | --- |
+| （例：Available Amount） | number | （字段含义与来源） |
+| （例：Source Barcode） | text | （字段含义与来源） |
+
+### 2.3 门控「（门控 2 显示名称）」可能写入的字段
+
+| 字段名 | 类型 | 说明 |
+| ----- | ---- | --- |
+| （按需继续添加...） | | |
+
+> **提示**：每个会修改记录的门控都需要一个对应的富化字段小节（§2.x）。若门控不写入新字段，可显式写「无新增字段」。
+
+***
+
+## 3. 数据池（Stash）
+
+数据池是**记录的容器**：记录只在门控驱动下从一个池进入另一个池。
+
+| 显示名称 | 逻辑 ID | 角色 | 池中记录的业务含义 |
+| ------- | ------- | --- | ------------- |
+| （例：待处理池） | `stash_input` | 入口池 | （业务含义） |
+| （例：处理中池） | `stash_processing` | 中间池 | （业务含义） |
+| （例：异常池） | `stash_error` | 异常池 | （业务含义） |
+| （例：完成池） | `stash_done` | 终点池 | （业务含义） |
+
+> **提示**：显示名称须与门控 YAML 中的 `input`/`output` 池名逐字一致（含标点、中间点「·」等）。逻辑 ID 仅使用小写字母、数字、下划线。
+
+### 3.1 数据池模型引用（按需）
+
+> 若数据池关联 3D 模型，在此列出模型信息。无关联模型时省略本节。
+
+| 池显示名称 | 模型名称 | 模型版本 |
+| --------- | ------- | ------- |
+| （例：待处理池） | （例：reactor_v2） | （例：1.0.0） |
+
+***
+
+## 4. 池间流转（拓扑）
+
+```mermaid
+graph LR
+    stash_input["待处理池"]
+    gate_1{{"门控 1 名称"}}
+    stash_processing["处理中池"]
+
+    stash_input --> gate_1 --> stash_processing
+```
+
+> **提示**：数据池使用矩形 `["..."]`，门控使用六边形 `{{"..."}}`。
+
+**文字补充**
+
+* **（门控 1 名称）**：入口为「（入口池名）」；出口为（列出各出口分支语义）。
+* **（门控 2 名称）**：（描述入口池集合和出口分支；合流门控须写明多入口来源）。
+
+***
+
+## 5. 门控（Valve）
+
+每个门控是**检查—路由**节点：对输入池中待处理的记录执行业务规则，并依据结果将记录路由到**唯一匹配的输出池**。
+
+查询约定：
+- （例：默认最大查询条数 3000，即 limit: 3000）
+
+约定字段：
+
+* `valve_id`：文档内稳定标识。
+* `order`：建议执行顺序，与拓扑中依赖关系一致。
+* `input`：`primary` 为主输入池；`secondary` 为合流时的第二输入池。
+* `output`：每条包含目标池与路由条件。
+
+### 5.1 （门控 1 显示名称）
+
+```yaml
+valve_id: valve_1
+name: （门控显示名称，须与拓扑边标签一致）
+order: 1
+input:
+  primary: （入口池显示名称）
+output:
+  - Stash: （出口池 A 显示名称）
+    condition: （路由条件，须引用 §2 中的字段名）
+  - Stash: （出口池 B 显示名称）
+    condition: （路由条件）
+```
+
+#### 触发方式
+
+（自动触发 / 人工触发）
+
+**化合物数据查询方式**（若本门控需要查询外部数据）
+
+（说明查哪类库、用哪些入口字段作键、返回什么、汇总规则等）
+
+**字段映射表**（若存在库表/API 列与门控加工字段对应）
+
+| 门控加工数据 | 库字段 |
+| --------- | ----- |
+| （例：性状） | （例：chemistProperty） |
+
+**数据处理规则**
+
+| 序号 | 规则摘要 | 条件要点 | 业务动作或结果 |
+| --- | ------- | ------- | ----------- |
+| 1.1 | （简述） | （条件，须引用字段名） | （动作或路由结果） |
+| 1.2 | （简述） | （条件） | （动作或路由结果） |
+
+**操作员步骤**（若为人工门控）
+
+1. （步骤描述，可执行、可验收）
+2. （...）
+
+**模型引用**（若本门控关联 3D 模型，无则省略）
+
+| 属性 | 值 |
+|------|-----|
+| 名称 | （模型名称） |
+| 版本 | （模型版本） |
+
+***
+
+### 5.2 （门控 2 显示名称）
+
+```yaml
+valve_id: valve_2
+name: （门控显示名称）
+order: 2
+input:
+  primary: （入口池显示名称）
+  secondary: （合流时的第二入口池，无合流则删除此行）
+output:
+  - Stash: （出口池显示名称）
+    condition: （路由条件）
+```
+
+#### 触发方式
+
+（自动触发 / 人工触发）
+
+**数据处理规则**
+
+| 序号 | 规则摘要 | 条件要点 | 业务动作或结果 |
+| --- | ------- | ------- | ----------- |
+| 2.1 | （简述） | （条件） | （动作或路由结果） |
+
+> **提示**：按需复制门控子节，每个门控至少包含 YAML 代码块和触发方式。需查询外部数据的加「查询方式」和「字段映射表」，含计算/判定的加「数据处理规则」，人工触发门控加「操作员步骤」，关联 3D 模型的加「模型引用」。
+
+***
+
+## 6. 知识库 / 外部主数据（按需）
+
+> 若门控规则依赖外部主数据（如化合物知识库、设备资源库等），在此列出字段语义。无外部依赖时可写「本流程不依赖外部主数据」。
+
+| 逻辑键 | 字段含义 | 类型/取值说明 |
+| ----- | ------- | ----------- |
+| （例：Compound ID） | （含义） | text |
+| （例：latest_amount_mg） | （含义） | number |