@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/347/244/272/344/276/213.md

@@ -1,207 +1,207 @@
-# 业务执行手册描述
-
-# Fragment 分装流程
-
-***
-
-## 1. 流程元信息
-
-| 属性   | 值 |
-| ---- | --- |
-| 流程标识 | `fragment` |
-| 流程名称 | Fragment 分装 |
-| 版本   | 1.0.0 |
-| 业务摘要 | 将化合物从源瓶按目标量分装到 1～3 个目标瓶；同一记录可走自动化或人工路径，最终在「已分装」状态结束。 |
-
-***
-
-## 2. 记录（Record）
-
-**记录**是沿数据池与门控流转的最小业务单元：一条记录对应一个化合物的分装任务。字段分两类：
-
-* **入口字段**：进入流程时即应具备（或由上游写入）。
-* **富化字段**：在特定门控的检查或回填过程中逐步写入；下文按门控分组列出。
-
-### 2.1 入口字段（必填与选填）
-
-| 字段名 | 类型 | 必填 | 说明 |
-| ----- | ---- | -- | --- |
-| Ticket ID | text | Y | 系统分配，单个池子里唯一 |
-| ALO Order ID | text | Y | 上层订单号 |
-| Compound ID | text | Y | 化合物编号，用于查询知识库 |
-| CAS | text | N | CAS 号 |
-| MW | number | Y | 分子量 (g/mol)，须大于 0 |
-| Salt Form | text | Y | 盐型，如 Free Base、HCl、Na |
-| Target Amount 1 (mg) | number | Y | 目标瓶 1 目标量 |
-| Tolerance 1 (mg) | number | Y | 目标瓶 1 允许误差，默认 0.5 mg |
-| Target Amount 2 (mg) | number | N | 目标瓶 2 目标量 |
-| Target Amount 3 (mg) | number | N | 目标瓶 3 目标量 |
-
-### 2.2 门控「数据完整性与需求量门控」可能写入的字段
-
-| 字段名 | 类型 | 说明 |
-| ----- | ---- | --- |
-| Requested Amount | number | 需求总量 (mg)，为 Target Amount 1 + 2 + 3 的和 |
-| Available Amount | number | 从化合物管理系统查询相同 CAS 号且 Status = 可用的 Latest Amount 总和 |
-| Source Barcode | text | 源瓶条码；来自化合物库查询 |
-| 是否缺料 | 枚举 | 缺料 / 充足 |
-| 性状 (Chemist) | 枚举 | 粉末 / 液体 / 固体等，默认从化合物库查询 |
-| 可舀粉判断 (Feasibility of Dispensing) | text | 是否可以舀粉 |
-
-### 2.3 门控「查看结果与复核更新」可能写入的字段
-
-| 字段名 | 类型 | 说明 |
-| ----- | ---- | --- |
-| Actual Amount 1 | number | 第一个目标瓶自动化称量量 |
-| Actual Amount 2 | number | 第二个目标瓶自动化称量量 |
-| Actual Amount 3 | number | 第三个目标瓶自动化称量量 |
-| 执行状态 | 枚举 | 执行完成 / 执行失败 |
-| 执行方式 | 枚举 | Automated / Manual，该门控默认为 Automated |
-| 人工确认状态 | 枚举 | 成功 / 失败，由人工最终确认 |
-| 执行失败原因 | text | 人工填写的备注 |
-
-***
-
-## 3. 数据池（Stash）
-
-| 显示名称 | 逻辑 ID | 角色 | 池中记录的业务含义 |
-| ------- | ------- | --- | ------------- |
-| 待分装化合物池 | `stash_input` | 入口池 | 上层下发、尚未经首道门控处理 |
-| 已领取·可自动化的化合物池 | `stash_auto` | 中间池 | 可走自动称粉路径且非缺料 |
-| 已领取·不可自动称量的化合物池 | `stash_manual` | 中间池 | 不可自动称粉，但非缺料 |
-| 上机实验池 | `stash_on_machine` | 中间池 | 已提交设备执行或等待结果 |
-| 完成实验池 | `stash_success` | 中间池 | 自动化路径下称量结果在容差内通过 |
-| 失败实验池 | `stash_failure` | 中间池 | 自动化失败或终检未通过 |
-| 人工完成物料池 | `stash_manual_done` | 中间池 | 人工路径完成称量与回填 |
-| 缺料化合物池 | `stash_missing` | 异常池 | 无可用源瓶或库存不足 |
-| 已分装化合物池 | `stash_done` | 终点池 | 交货确认完成，流程结束 |
-
-> **提示**：本流程数据池未关联 3D 模型，故省略模型引用。
-
-***
-
-## 4. 池间流转（拓扑）
-
-```mermaid
-graph LR
-    stash_input["待分装化合物池"]
-    gate_1{{"数据完整性与需求量门控"}}
-    stash_auto["已领取·可自动化的化合物池"]
-    stash_manual["已领取·不可自动称量的化合物池"]
-    stash_missing["缺料化合物池"]
-    gate_3{{"查看结果与复核更新"}}
-    stash_on_machine["上机实验池"]
-    stash_success["完成实验池"]
-    stash_failure["失败实验池"]
-
-    stash_input --> gate_1
-    gate_1 --> stash_auto
-    gate_1 --> stash_manual
-    gate_1 --> stash_missing
-
-    stash_on_machine --> gate_3
-    gate_3 --> stash_success
-    gate_3 --> stash_failure
-```
-
-**文字补充**
-
-* **数据完整性与需求量门控**：唯一入口为「待分装化合物池」；出口为三选一（可自动化 / 不可自动称量 / 缺料）。
-* **查看结果与复核更新**：仅从「上机实验池」进入；出口为「完成实验池」或「失败实验池」（按各目标瓶实际量与容差比较）。
-
-***
-
-## 5. 门控（Valve）
-
-每个门控是**检查—路由**节点：对输入池中待处理的记录执行业务规则，并依据结果将记录路由到**唯一匹配的输出池**。
-
-查询约定：
-- 默认最大查询条数 3000，即（limit: 3000）
-
-### 5.1 数据完整性与需求量门控
-
-```yaml
-valve_id: valve_1
-name: 数据完整性与需求量门控
-order: 1
-input:
-  primary: 待分装化合物池
-output:
-  - Stash: 已领取·可自动化的化合物池
-    condition: 可舀粉判断为 true，且 Source Barcode 非空
-  - Stash: 已领取·不可自动称量的化合物池
-    condition: 可舀粉判断为 false，且 Source Barcode 非空
-  - Stash: 缺料化合物池
-    condition: 是否缺料 = 缺料
-```
-
-#### 触发方式
-
-人工触发
-
-**化合物数据查询方式**
-
-查询化合物库存的可用量：使用输入池 Compound ID 作为索引，通过 XFC 上海系统接口查询化合物库存（`compound.getStockFromXfcSh`），查找 status = 可用的记录，返回可用量字段的值并汇总加和。
-
-查询化合物属性：使用输入池 Compound ID 通过 XFC 上海系统接口查询化合物相关属性。
-
-**字段映射表**
-
-| 门控加工数据 | chemical_record 表字段 |
-| --------- | -------------------- |
-| 性状 (Chemist) | chemistProperty |
-| 可舀粉判断 (Feasibility of Dispensing) | feasibilityOfDipensing |
-| 固体颗粒过大 (Large Particle) | largeParticle |
-| 流动性差 (Poor Flowability) | poorFlowability |
-
-**数据处理规则**
-
-| 序号 | 规则摘要 | 条件要点 | 业务动作或结果 |
-| --- | ------- | ------- | ----------- |
-| 1.1 | 汇总需求量 | 始终 | Requested Amount = Target Amount 1 + 2 + 3 |
-| 1.2 | 是否缺料判定 | Requested Amount > Available Amount | 是否缺料 = 缺料 |
-| 1.3 | 容差默认 | Target Amount N > 0 且 Tolerance N 为空 | Tolerance 默认 0.5 mg |
-| 1.4 | 缺料标记 | Source Barcode 为空 | 是否缺料 = 缺料 |
-
-***
-
-### 5.2 查看结果与复核更新
-
-```yaml
-valve_id: valve_3
-name: 查看结果与复核更新
-order: 3
-input:
-  primary: 上机实验池
-output:
-  - Stash: 完成实验池
-    condition: 对每个 Target Amount > 0 的档位，均有 Actual，且 |Actual - Target| ≤ 对应 Tolerance
-  - Stash: 失败实验池
-    condition: 任一档位偏差超出容差或其它执行失败情形
-```
-
-#### 触发方式
-
-人工触发
-
-**数据处理规则**
-
-| 序号 | 规则摘要 | 条件要点 | 业务动作或结果 |
-| --- | ------- | ------- | ----------- |
-| 3.1 | 执行方式 | 本门控处理自动化回传 | 执行方式 = Automated |
-| 3.2 | 实际量 | Target Amount N > 0 | 写入 Actual Amount N（来自设备或复核） |
-| 3.3 | 偏差 | 某档实际量与目标量之差大于该档 Tolerance | 计入失败分支 |
-| 3.4 | 执行状态 | 全部档位满足容差 | 执行状态 = 执行完成 |
-| 3.5 | 执行失败 | 存在超差或设备失败 | 执行状态 = 执行失败，填写执行失败原因 |
-
-***
-
-## 6. 知识库 / 外部主数据
-
-| 逻辑键 | 字段含义 | 类型/取值说明 |
-| ----- | ------- | ----------- |
-| Compound ID | 与记录中化合物编号对应 | text |
-| latest_amount_mg | 最新可用库存 (mg) | number |
-| 性状 | 物理性状 | 粉末 / 液体 / 固体 等 |
-| 可分装判断 | 是否可分装 | bool |
-| Source Barcode | 推荐源瓶条码；空表示无可分装源瓶 | text |
+# 业务执行手册描述
+
+# Fragment 分装流程
+
+***
+
+## 1. 流程元信息
+
+| 属性   | 值 |
+| ---- | --- |
+| 流程标识 | `fragment` |
+| 流程名称 | Fragment 分装 |
+| 版本   | 1.0.0 |
+| 业务摘要 | 将化合物从源瓶按目标量分装到 1～3 个目标瓶；同一记录可走自动化或人工路径，最终在「已分装」状态结束。 |
+
+***
+
+## 2. 记录（Record）
+
+**记录**是沿数据池与门控流转的最小业务单元：一条记录对应一个化合物的分装任务。字段分两类：
+
+* **入口字段**：进入流程时即应具备（或由上游写入）。
+* **富化字段**：在特定门控的检查或回填过程中逐步写入；下文按门控分组列出。
+
+### 2.1 入口字段（必填与选填）
+
+| 字段名 | 类型 | 必填 | 说明 |
+| ----- | ---- | -- | --- |
+| Ticket ID | text | Y | 系统分配，单个池子里唯一 |
+| ALO Order ID | text | Y | 上层订单号 |
+| Compound ID | text | Y | 化合物编号，用于查询知识库 |
+| CAS | text | N | CAS 号 |
+| MW | number | Y | 分子量 (g/mol)，须大于 0 |
+| Salt Form | text | Y | 盐型，如 Free Base、HCl、Na |
+| Target Amount 1 (mg) | number | Y | 目标瓶 1 目标量 |
+| Tolerance 1 (mg) | number | Y | 目标瓶 1 允许误差，默认 0.5 mg |
+| Target Amount 2 (mg) | number | N | 目标瓶 2 目标量 |
+| Target Amount 3 (mg) | number | N | 目标瓶 3 目标量 |
+
+### 2.2 门控「数据完整性与需求量门控」可能写入的字段
+
+| 字段名 | 类型 | 说明 |
+| ----- | ---- | --- |
+| Requested Amount | number | 需求总量 (mg)，为 Target Amount 1 + 2 + 3 的和 |
+| Available Amount | number | 从化合物管理系统查询相同 CAS 号且 Status = 可用的 Latest Amount 总和 |
+| Source Barcode | text | 源瓶条码；来自化合物库查询 |
+| 是否缺料 | 枚举 | 缺料 / 充足 |
+| 性状 (Chemist) | 枚举 | 粉末 / 液体 / 固体等，默认从化合物库查询 |
+| 可舀粉判断 (Feasibility of Dispensing) | text | 是否可以舀粉 |
+
+### 2.3 门控「查看结果与复核更新」可能写入的字段
+
+| 字段名 | 类型 | 说明 |
+| ----- | ---- | --- |
+| Actual Amount 1 | number | 第一个目标瓶自动化称量量 |
+| Actual Amount 2 | number | 第二个目标瓶自动化称量量 |
+| Actual Amount 3 | number | 第三个目标瓶自动化称量量 |
+| 执行状态 | 枚举 | 执行完成 / 执行失败 |
+| 执行方式 | 枚举 | Automated / Manual，该门控默认为 Automated |
+| 人工确认状态 | 枚举 | 成功 / 失败，由人工最终确认 |
+| 执行失败原因 | text | 人工填写的备注 |
+
+***
+
+## 3. 数据池（Stash）
+
+| 显示名称 | 逻辑 ID | 角色 | 池中记录的业务含义 |
+| ------- | ------- | --- | ------------- |
+| 待分装化合物池 | `stash_input` | 入口池 | 上层下发、尚未经首道门控处理 |
+| 已领取·可自动化的化合物池 | `stash_auto` | 中间池 | 可走自动称粉路径且非缺料 |
+| 已领取·不可自动称量的化合物池 | `stash_manual` | 中间池 | 不可自动称粉，但非缺料 |
+| 上机实验池 | `stash_on_machine` | 中间池 | 已提交设备执行或等待结果 |
+| 完成实验池 | `stash_success` | 中间池 | 自动化路径下称量结果在容差内通过 |
+| 失败实验池 | `stash_failure` | 中间池 | 自动化失败或终检未通过 |
+| 人工完成物料池 | `stash_manual_done` | 中间池 | 人工路径完成称量与回填 |
+| 缺料化合物池 | `stash_missing` | 异常池 | 无可用源瓶或库存不足 |
+| 已分装化合物池 | `stash_done` | 终点池 | 交货确认完成，流程结束 |
+
+> **提示**：本流程数据池未关联 3D 模型，故省略模型引用。
+
+***
+
+## 4. 池间流转（拓扑）
+
+```mermaid
+graph LR
+    stash_input["待分装化合物池"]
+    gate_1{{"数据完整性与需求量门控"}}
+    stash_auto["已领取·可自动化的化合物池"]
+    stash_manual["已领取·不可自动称量的化合物池"]
+    stash_missing["缺料化合物池"]
+    gate_3{{"查看结果与复核更新"}}
+    stash_on_machine["上机实验池"]
+    stash_success["完成实验池"]
+    stash_failure["失败实验池"]
+
+    stash_input --> gate_1
+    gate_1 --> stash_auto
+    gate_1 --> stash_manual
+    gate_1 --> stash_missing
+
+    stash_on_machine --> gate_3
+    gate_3 --> stash_success
+    gate_3 --> stash_failure
+```
+
+**文字补充**
+
+* **数据完整性与需求量门控**：唯一入口为「待分装化合物池」；出口为三选一（可自动化 / 不可自动称量 / 缺料）。
+* **查看结果与复核更新**：仅从「上机实验池」进入；出口为「完成实验池」或「失败实验池」（按各目标瓶实际量与容差比较）。
+
+***
+
+## 5. 门控（Valve）
+
+每个门控是**检查—路由**节点：对输入池中待处理的记录执行业务规则，并依据结果将记录路由到**唯一匹配的输出池**。
+
+查询约定：
+- 默认最大查询条数 3000，即（limit: 3000）
+
+### 5.1 数据完整性与需求量门控
+
+```yaml
+valve_id: valve_1
+name: 数据完整性与需求量门控
+order: 1
+input:
+  primary: 待分装化合物池
+output:
+  - Stash: 已领取·可自动化的化合物池
+    condition: 可舀粉判断为 true，且 Source Barcode 非空
+  - Stash: 已领取·不可自动称量的化合物池
+    condition: 可舀粉判断为 false，且 Source Barcode 非空
+  - Stash: 缺料化合物池
+    condition: 是否缺料 = 缺料
+```
+
+#### 触发方式
+
+人工触发
+
+**化合物数据查询方式**
+
+查询化合物库存的可用量：使用输入池 Compound ID 作为索引，通过 XFC 上海系统接口查询化合物库存（`compound.getStockFromXfcSh`），查找 status = 可用的记录，返回可用量字段的值并汇总加和。
+
+查询化合物属性：使用输入池 Compound ID 通过 XFC 上海系统接口查询化合物相关属性。
+
+**字段映射表**
+
+| 门控加工数据 | chemical_record 表字段 |
+| --------- | -------------------- |
+| 性状 (Chemist) | chemistProperty |
+| 可舀粉判断 (Feasibility of Dispensing) | feasibilityOfDipensing |
+| 固体颗粒过大 (Large Particle) | largeParticle |
+| 流动性差 (Poor Flowability) | poorFlowability |
+
+**数据处理规则**
+
+| 序号 | 规则摘要 | 条件要点 | 业务动作或结果 |
+| --- | ------- | ------- | ----------- |
+| 1.1 | 汇总需求量 | 始终 | Requested Amount = Target Amount 1 + 2 + 3 |
+| 1.2 | 是否缺料判定 | Requested Amount > Available Amount | 是否缺料 = 缺料 |
+| 1.3 | 容差默认 | Target Amount N > 0 且 Tolerance N 为空 | Tolerance 默认 0.5 mg |
+| 1.4 | 缺料标记 | Source Barcode 为空 | 是否缺料 = 缺料 |
+
+***
+
+### 5.2 查看结果与复核更新
+
+```yaml
+valve_id: valve_3
+name: 查看结果与复核更新
+order: 3
+input:
+  primary: 上机实验池
+output:
+  - Stash: 完成实验池
+    condition: 对每个 Target Amount > 0 的档位，均有 Actual，且 |Actual - Target| ≤ 对应 Tolerance
+  - Stash: 失败实验池
+    condition: 任一档位偏差超出容差或其它执行失败情形
+```
+
+#### 触发方式
+
+人工触发
+
+**数据处理规则**
+
+| 序号 | 规则摘要 | 条件要点 | 业务动作或结果 |
+| --- | ------- | ------- | ----------- |
+| 3.1 | 执行方式 | 本门控处理自动化回传 | 执行方式 = Automated |
+| 3.2 | 实际量 | Target Amount N > 0 | 写入 Actual Amount N（来自设备或复核） |
+| 3.3 | 偏差 | 某档实际量与目标量之差大于该档 Tolerance | 计入失败分支 |
+| 3.4 | 执行状态 | 全部档位满足容差 | 执行状态 = 执行完成 |
+| 3.5 | 执行失败 | 存在超差或设备失败 | 执行状态 = 执行失败，填写执行失败原因 |
+
+***
+
+## 6. 知识库 / 外部主数据
+
+| 逻辑键 | 字段含义 | 类型/取值说明 |
+| ----- | ------- | ----------- |
+| Compound ID | 与记录中化合物编号对应 | text |
+| latest_amount_mg | 最新可用库存 (mg) | number |
+| 性状 | 物理性状 | 粉末 / 液体 / 固体 等 |
+| 可分装判断 | 是否可分装 | bool |
+| Source Barcode | 推荐源瓶条码；空表示无可分装源瓶 | text |