clearai-dsh 0.1.0

package/presets/clearai/template/skills/data-qa-analysis/checklists/readiness_check.md

@@ -0,0 +1,62 @@
+# 数据 QA & 分析交付自检清单（Readiness Checklist：Workflow01-05）
+
+> 在宣布“数据对齐/稳态/代价&波动/BiC 改进空间完成”前，必须通过以下所有检查。
+
+## 0. 上游依赖（来自结构 skill）
+- [ ] 已具备 `products/extracted/unit_inventory.md`（存在性三态 + 观测单元/流转关系 + 资源接口），且内容覆盖关键单元。
+- [ ] 已具备 `products/extracted/entity_map.json`（topology-only），节点=观测单元/支持设施/边界，边=物质或信号流/资源接口，且每条边带 evidence（不含通道号）。
+
+## 1. 执行计划与交付分区 (Plan & Delivery)
+- [ ] 已在执行第一个 workflow 前输出“覆盖本次所有 workflows（仅限本 skill）的统一 plan”并获得用户确认（确认后再执行）。
+- [ ] plan 已逐 workflow 列出 01-05，且每一步明确标注强制产出物清单（含文件路径）。
+- [ ] plan 已显式声明产物分区：过程文件/中间产物输出至 `lab/`，最终交付输出至 `products/`，且每一步标明输出落点。
+- [ ] plan 包含“产出物对照表”，并已逐条对照所选 workflows 的 `## 产出物` 清单逐行复制（无漏项、无概括省略）；可选项也已明确 Yes/No 与原因。
+- [ ] 若执行中新增/删除 workflow 或调整交付物，已更新统一 plan 并再次获得用户确认（有记录可追溯）。
+- [ ] 最终交付物（workflows 声明的 `products/extracted/*`）已按 plan 约定落在 `products/`（推荐 `products/extracted/*`）。
+
+## 2. 数据源与血缘 (Lineage)
+- [ ] 已完成数据源盘点：`products/extracted/data_source_inventory.md` 字段完整（路径模式/来源系统/粒度/时间范围/表头结构/编码/单位等）。
+- [ ] 已绘制 `products/extracted/data_lineage.mmd`，且已声明 Pattern 选型（P0~P5）并解释每个 stage 的输入/输出与关键动作。
+- [ ] 已明确 `products/extracted/merge_contract.md`：按时间 outer join / 去重规则 / 冲突优先级（同通道同时间）/ 多行表头处理策略可复现。
+- [ ] 已输出 `products/extracted/mother_table_aligned.csv`，且后续所有分析均以其作为唯一母表输入。
+- [ ] 若存在多张母表：已输出并维护 `products/extracted/mother_table_registry.md`（母表用途/边界/粒度/关系清楚）。
+
+## 3. 通道语义与测量口径 (Tag Semantics & Metric-of-Record)
+- [ ] 已输出 `products/extracted/data_dictionary.md`，通道语义/单位/角色(PV/MV/KPI)/来源优先级清楚。
+- [ ] 已输出 `products/extracted/cleaning_rules.yaml`，并覆盖：时间解析/去重/物理越限/冻结值/缺口处理等。
+- [ ] 已输出 `products/extracted/missing_tags.md`，并明确区分：
+  - ObjectNotConfirmed（观测对象存在性未确认，禁止写成无测量通道）
+  - Schema 缺失（列缺失）
+  - 语义缺失（描述/单位缺失）
+  - 数据缺失（值缺失/NaN）
+- [ ] “设备编号≠测量通道”：已通过 `products/extracted/tag_map.csv` / `products/extracted/entity_map_enriched.json` 固化 metric-of-record（对象→测量通道），且 tag 可在母表列名/通道清单中验证存在。
+- [ ] 任何“可能无测量通道/需代理”结论都满足：对象存在性为 State_A/State_B 且已尝试映射仍无任何可用 tag，并附证据链与候选代理规则。
+
+## 4. 稳态与代表性 (Steady State)
+- [ ] 已先输出 `products/extracted/data_status_report.md`（时间范围/间隔/连续段/重复时间点/稳态关键通道齐全性），并确认满足稳态分析条件。
+- [ ] 已先输出并确认 `products/extracted/steady_state_basis.md`（有效判据：负荷阈值 + 过渡窗口剔除 + 连续性/NaN/阈值依据/验证计划），且确认记录发生在生成 mask/table 之前。
+- [ ] 已输出 `products/extracted/steady_state_rules.yaml` 且与 basis 一致。
+- [ ] 已输出 `products/extracted/steady_state_table.csv`，并确认后续所有分析均使用该文件（不是母表/原始导出）。
+- [ ] 已输出 `products/extracted/steady_state_segments.csv` 并检查稳态段连续性与关键通道齐全性。
+- [ ] 已输出 `products/extracted/steady_state_summary.md` 与 `products/extracted/steady_state_validation.md`（抽检记录可追溯）。
+
+## 5. 代价与波动分析 (Cost & Variability)
+- [ ] 已在 `products/extracted/subsystem_registry.md` 固化：最大代价口径（含资源规格，如 power@kW / reagent@gradeA）、子系统边界/负荷口径、共享项分摊规则。
+- [ ] 已完成“资源规格消耗方覆盖完整性检查”（expected vs metered 差集与处理策略）并写入 `products/extracted/subsystem_registry.md`。
+- [ ] 已输出 `products/extracted/consumption_summary.md`（按子系统 + 系统总计），且外推假设与风险已显式声明。
+- [ ] 已输出 `products/extracted/load_distribution.csv`，包含 `subsystem_id`，并基于 `reference_hours` 外推基准期小时与消耗基线。
+- [ ] 波动分析覆盖范围完整：SSC/Q/L（系统+子系统）+ 系统状态 PV + 控制/干预动作 MV/CO；并对“均值接近 0 的变量”做 CV 防错。
+- [ ] `products/extracted/variability_summary.md` 已按 unit 逐一诊断（每节含：波动形态、影响假设、可验证假设、下一步核对动作）。
+- [ ] 已输出 `products/extracted/workflow06_figures.md`（必选图表索引：口径 + 文件落点可追溯）。
+
+## 6. Best-in-Class 与改进空间 (BiC & Improvement Space)
+- [ ] 若系统强耦合，BiC 使用系统级 P20 先选最优时段集合，再进行单元归因（避免“单元最优拼不出系统最优”）。
+- [ ] 外推计算采用“绝对量差/逐负荷段累计”或逐时累计，避免 `avg(A/B)*avg(B)` 偏差。
+- [ ] 并行冗余单元（A/B 两路）已按物理意义合并后再计算（如两路并行回路消耗相加）。
+- [ ] 外推假设（基准期运行小时、单位成本【如启用】、权重口径）已显式声明并与边界契约一致。
+
+---
+
+**自检结论**:
+- [ ] 通过 (Ready to Submit)
+- [ ] 需返工 (Needs Rework)

package/presets/clearai/template/skills/data-qa-analysis/templates/best_in_class_report.md.tpl

@@ -0,0 +1,56 @@
+# Best-in-Class (BiC/P20) 与改进空间报告模板
+
+**对象系统**: ${SYSTEM_NAME}
+**分析周期**: ${DATE_RANGE}
+**数据集**: ${DATASET_DESC}（稳态口径：${STEADY_STATE_DESC}）
+
+---
+
+## 1. 口径与定义
+
+### 1.1 系统边界
+${BOUNDARY_SUMMARY}
+
+### 1.2 KPI 定义
+- 系统负荷：${LOAD_DEF}
+- 系统消耗：${CONS_DEF}
+- 系统单位代价：${SSC_DEF}
+
+### 1.3 标杆定义（P20）
+${BIC_DEF}
+
+---
+
+## 2. 分负荷段标杆（系统级）
+
+| 负荷段 | 样本数 | 平均负荷 | 单位代价P20 | 单位代价P50 | 备注 |
+|---|---:|---:|---:|---:|---|
+| ${BIN_1} | ${N_1} | ${LOAD_AVG_1} | ${P20_1} | ${P50_1} | - |
+
+---
+
+## 3. 系统最优时段集合（System_BiC Hours）
+- 定义：系统单位代价(t) ≤ P20(负荷段(t))
+- 样本占比：${BIC_HOUR_RATE}
+
+---
+
+## 4. 单元归因（在 System_BiC Hours 内）
+
+| 单元 | 当前均值消耗 | BiC集合内均值消耗 | 绝对差 | 长周期节省(物理量) | 长周期节省(成本，可选) | 备注 |
+|---|---:|---:|---:|---:|---:|---|
+| ${UNIT_1} | ${CUR_1} | ${BIC_1} | ${DIFF_1} | ${SAVE_Q_1} | ${SAVE_C_1} | - |
+
+---
+
+## 5. 外推假设
+- 基准期运行小时：${HOURS_REF} h
+- 单位成本（如启用）：${UNIT_COST}
+
+---
+
+## 6. Pitfalls（必读反例）
+- 系统级 vs 单元级：${PITFALL_COUPLING}
+- 比值平均陷阱：`avg(A/B) * avg(B) != avg(A)`（需使用绝对差/逐段累计）
+- 负荷段过宽：${PITFALL_BINNING}
+- 并行冗余单元未合并：${PITFALL_PARALLEL}

package/presets/clearai/template/skills/data-qa-analysis/templates/cleaning_rules_draft.yaml.tpl

@@ -0,0 +1,56 @@
+# 清洗规则草案 (Cleaning Rules Draft)
+# Purpose: 观测/实验母表的质量门槛与可复现清洗契约
+
+rules:
+  - id: "R001"
+    target_field: "${TIME_COL}"
+    action: "drop_invalid_time"
+    condition: "time_parse_failed == true"
+    reason: "Invalid timestamp"
+
+  - id: "R002"
+    target_field: "${TIME_COL}"
+    action: "drop_duplicates"
+    params:
+      subset: ["${TIME_COL}"]
+      keep: "first"
+    reason: "Duplicate timestamps"
+
+  - id: "R003"
+    target_field: "${TAG_FIELD}"
+    action: "normalize_tag"
+    params:
+      replace:
+        "-": "_"
+      strip_suffix: [".PV", ".MV", ".OUT", ".VALUE", ".SP", ".OP"]
+      upper: true
+    reason: "Normalize tag naming for matching (do not erase PV/MV semantics in final schema)"
+
+  - id: "R004"
+    target_field: "${SENSOR_FIELD}"
+    action: "set_null"
+    condition: "value < ${PHYS_MIN} or value > ${PHYS_MAX}"
+    reason: "Physical limits exceeded (sensor failure)"
+
+  - id: "R005"
+    target_field: "${SENSOR_FIELD}"
+    action: "detect_freeze"
+    params:
+      window_points: ${FREEZE_WINDOW_POINTS}
+      tolerance: ${FREEZE_TOL}
+    reason: "Sensor freeze / stuck value"
+
+  - id: "R006"
+    target_field: "all_sensors"
+    action: "ffill"
+    params:
+      limit: ${FFILL_LIMIT}
+    reason: "Short communication gaps (only if domain-approved)"
+
+  - id: "R007"
+    target_field: "${STEADY_STATE_FLAG}"
+    action: "pre_filter_transient"
+    params:
+      window_minutes: ${WINDOW_MINUTES}
+      policy: "${TRANSIENT_POLICY}"
+    reason: "Pre-filter startup/shutdown/calibration transient segments before KPI analysis"

package/presets/clearai/template/skills/data-qa-analysis/templates/data_dictionary.md.tpl

@@ -0,0 +1,13 @@
+# 数据字典 (Data Dictionary)
+
+## 模板说明
+用于观测/实验母表的通道语义固化。建议“通道-语义-单位-角色-来源”一次写清楚，避免后续口径漂移。
+
+| 通道 (Tag) | 物理含义 (Meaning) | 单位 (Unit) | 角色 (PV/MV/SP/KPI) | 采样频率 | 正常范围 | 设计值 | 告警限LL/L/H/HH | 来源优先级 | 备注 |
+|---|---|---|---|---|---|---|---|---|---|
+| `${TAG_1}` | ${MEANING_1} | ${UNIT_1} | ${ROLE_1} | ${FREQ_1} | ${RANGE_1} | ${DESIGN_1} | ${ALARM_1} | ${SOURCE_1} | ${REMARK_1} |
+| `${TAG_2}` | ${MEANING_2} | ${UNIT_2} | ${ROLE_2} | ${FREQ_2} | ${RANGE_2} | ${DESIGN_2} | ${ALARM_2} | ${SOURCE_2} | ${REMARK_2} |
+
+## 补充说明
+- **通道归一化规则**：${NORMALIZATION_RULES}
+- **缺失值语义**：${MISSING_VALUE_CODES}

package/presets/clearai/template/skills/data-qa-analysis/templates/data_source_inventory_and_lineage.md.tpl

@@ -0,0 +1,146 @@
+# 数据源盘点与数据血缘模板 (Data Source Inventory & Lineage)
+
+## 模板说明
+用于观测/实验数据项目的“数据源盘点 + 母表血缘 + 合并契约”交付。目标是让任何 KPI/稳态/标杆结论都 **可追溯**。
+
+**对象系统**: ${SYSTEM_NAME}
+**分析日期**: ${DATE}
+**负责人**: ${OWNER}
+
+---
+
+# 1. 数据源清单 (Inventory)
+
+> 填写原则：先覆盖全量，再逐步标注“已纳入母表/未纳入但可补充/仅用于解释”。
+
+| 数据源ID | 路径/文件模式 | 来源系统 | 数据类型 | 粒度/频率 | 时间范围 | 时间列 | 主键 | 编码 | 单位状态 | 表头结构 | 备注 |
+|---|---|---|---|---|---|---|---|---|---|---|---|
+| S01 | ${PATH_1} | ${SYSTEM_1} | 时序模拟量 | 1min | ${RANGE_1} | ${TIME_COL_1} | - | gbk/utf-8 | 未统一/已统一 | 单行/多行 | - |
+| S02 | ${PATH_2} | ${SYSTEM_2} | 报警/事件 | event | ${RANGE_2} | ${TIME_COL_2} | ${KEY_2} | - | - | - | - |
+
+## 1.1 表头行定义（如存在多行表头）
+若存在多行表头，请在此定义每一行含义（示例）：
+- 第1行：列名/通道（Tag）
+- 第2行：通道清单描述（Meaning）
+- 第3行：要点（Key points）
+- 第4行：方案/说明抽取描述（Protocol summary）
+- 第5-11行：设计值/正常范围/告警限/仪器量程（如有）
+
+---
+
+# 2. 母表定义 (Mother Table)
+
+**母表路径**: ${MOTHER_TABLE_PATH}
+
+## 2.1 一行代表什么？
+- [ ] 时间点（连续观测常见）
+- [ ] 实验批次/轮次
+- [ ] 事件/报警
+- [ ] 其他：${ROW_SEMANTIC}
+
+## 2.2 母表关键字段
+- 时间列：${MOTHER_TIME_COL}
+- 时间解析：${TIME_PARSE_RULE}
+- 连续性定义：相邻间隔 ≤ ${CONTINUOUS_GAP} 视为连续
+
+## 2.3 母表包含哪些信息层？
+- [ ] 数据层（时间点 → 通道值）
+- [ ] 元数据层（通道 → 描述/单位/量程/设计值/告警限）
+- [ ] 两者混合（多行表头 + 数据行）
+
+---
+
+# 3. 数据血缘 (Lineage)
+
+## 3.0 母表合成模式选择（必填，避免误解“母表如何来的”）
+> 说明：不同项目拿到的上游数据形态不同，母表合成链路也不同。请从下列 Pattern 中选择最符合本项目实际情况的一种，并写明理由与各 stage 的输入/输出文件名模式（用占位路径表达即可）。
+
+- 选用 Pattern：${PATTERN_ID}（P0/P1/P2/P3/P4/P5）
+- 选型理由：${PATTERN_REASON}
+- Stage 列表（输入/输出文件名模式 + 关键加工动作）：${STAGE_LIST}
+
+Pattern 速查（填写时只需选一种）：
+- **P0**：只拿到现成母表或等价对齐宽表（仍需补齐 Spec+Contract）
+- **P1**：分阶段合并 `raw_history_exports/ → history_merged/ → project_merged/ → products/extracted/mother_table_aligned.csv`
+- **P2**：已有项目级宽表直对齐 `project_merged/ → products/extracted/mother_table_aligned.csv`
+- **P3**：直连历史库查询对齐 `historian_query → aligned_wide_table → products/extracted/mother_table_aligned.csv`
+- **P4**：多观测段多母表 `mother_segment_* → system_mother`
+- **P5**：增量追加滚动重算 `monthly_append/ → rolling_merged → products/extracted/mother_table_aligned.csv`
+
+## 3.1 血缘图（Mermaid）
+
+> 画你项目实际采用的那一种即可；边上必须标注关键动作（outer join/dedup/priority/meta header/alignSpec 等）。
+
+### 示例块：Pattern P1（分阶段合并）
+
+```mermaid
+flowchart LR
+  rawHistoryExports["raw_history_exports/ (raw)"] -->|"concat+sort+dedup + metaHeaderExtract"| historyMerged["history_merged/ (stage1)"]
+  historyMerged -->|"outerJoinOnTime + priorityRule + tagNormalize"| projectMerged["project_merged/ (stage2)"]
+  projectMerged -->|"alignSpec + protectAllTags + dataTableOnly"| motherAligned["products/extracted/mother_table_aligned.csv (aligned)"]
+
+  supplementWide["supplement_wide_table.csv (optional)"] -.->|"outerJoinOnTime + fillNA_byPriority"| projectMerged
+```
+
+### 示例块：Pattern P2（已有项目级宽表直对齐）
+
+```mermaid
+flowchart LR
+  projectMerged["project_merged/ (existing artifacts)"] -->|"alignSpec + protectAllTags + dataTableOnly"| motherAligned["products/extracted/mother_table_aligned.csv (aligned)"]
+```
+
+### 示例块：Pattern P3（直连历史库查询对齐）
+
+```mermaid
+flowchart LR
+  historianQuery["historian_query(tags,time_range)"] -->|"timeAlign+resample + tagNormalize"| alignedWide["aligned_wide_table.csv"]
+  alignedWide -->|"alignSpec + protectAllTags + dataTableOnly"| motherAligned["products/extracted/mother_table_aligned.csv (aligned)"]
+```
+
+## 3.2 节点说明
+| 节点 | 含义 | 生成方式 | 负责人 | 版本/日期 |
+|---|---|---|---|---|
+| raw_history_exports/ | ${RAW_HISTORY_DESC} | 原始导出（可选：按月/按系统） | - | - |
+| history_merged/ | ${HISTORY_MERGED_DESC} | concat+dedup（仅对 Pattern P1 常见） | - | - |
+| project_merged/ | ${PROJECT_MERGED_DESC} | outer join + priority + tagNormalize | - | - |
+| mother_table_aligned.csv | ${MOTHER_DESC} | alignSpec（对齐母表） | - | - |
+
+---
+
+# 4. 合并契约 (Merge Contract)
+
+## 4.1 合并主键与方式
+- 合并主键：${MERGE_KEY}（如时间列）
+- 合并方式：outer join / left join / union all
+
+## 4.2 冲突优先级（同 Tag + 同时间）
+必须明确一条“可复现规则”：
+- 优先级顺序：${PRIORITY_ORDER}
+- 填空策略：${FILL_STRATEGY}（如“历史优先，补充填空”）
+
+## 4.3 去重规则（同时间多行）
+- 去重字段：${DEDUP_FIELDS}
+- 保留策略：keep=first/last 或聚合（avg/median）
+
+## 4.4 编码与单位
+- 编码：${ENCODING_POLICY}
+- 单位统一：${UNIT_POLICY}
+
+---
+
+# 5. 质量审计摘要 (Quick Audit)
+
+| 检查项 | 结果 | 备注 |
+|---|---|---|
+| 时间列可解析率 | ${TIME_PARSE_RATE} | - |
+| 重复时间点比例 | ${DUP_TIME_RATE} | - |
+| 缺失率Top10通道 | ${MISSING_TOP10} | - |
+| 多源重叠通道数 | ${OVERLAP_TAGS} | - |
+
+---
+
+# 6. 示例链路（可选，用于展示写法）
+示例链路（仅用于展示结构，不要依赖任何特定项目路径）：
+- Pattern P1：`lab/data/raw_history_exports/*` → `lab/data/history_merged/*` → `lab/data/project_merged/*` → `products/extracted/mother_table_aligned.csv`
+- Pattern P2：`lab/data/project_merged/*` → `products/extracted/mother_table_aligned.csv`
+- Pattern P3：`historian_query(...)` → `lab/data/aligned_wide_table.csv` → `products/extracted/mother_table_aligned.csv`

package/presets/clearai/template/skills/data-qa-analysis/templates/data_status_report.md.tpl

@@ -0,0 +1,60 @@
+# 数据状况报告模板（稳态前必备）
+
+**对象系统**: ${SYSTEM_NAME}
+**母表**: ${MOTHER_TABLE}
+**分析日期**: ${DATE}
+
+---
+
+## 1. 基本信息
+| 项目 | 值 |
+|---|---|
+| 总时间点数 | ${N_POINTS} |
+| 时间范围 | ${T_START} ~ ${T_END} |
+| 覆盖时长 | ${COVERAGE} |
+| 采样期望 | ${EXPECTED_SAMPLING} |
+
+---
+
+## 2. 时间间隔与连续性
+
+### 2.1 时间间隔分布（相邻点差分）
+| 指标 | 值 |
+|---|---:|
+| P50 | ${GAP_P50} |
+| P90 | ${GAP_P90} |
+| P95 | ${GAP_P95} |
+| Max | ${GAP_MAX} |
+
+### 2.2 连续段统计（连续性定义：相邻间隔 ≤ ${CONTINUOUS_GAP}）
+| 指标 | 值 |
+|---|---:|
+| 连续段数量 | ${N_SEGMENTS} |
+| 最长连续段 | ${MAX_SEGMENT} |
+| 最短连续段 | ${MIN_SEGMENT} |
+| 平均连续段 | ${AVG_SEGMENT} |
+
+Top 段列表（示例）：
+| 序号 | 开始时间 | 结束时间 | 时长 | 点数 |
+|---:|---|---|---:|---:|
+| 1 | ${S1_START} | ${S1_END} | ${S1_DUR} | ${S1_N} |
+
+---
+
+## 3. 重复时间点与去重
+| 项目 | 值 |
+|---|---:|
+| 重复时间点行数 | ${N_DUP_ROWS} |
+| 重复占比 | ${DUP_RATE} |
+| 去重策略 | ${DEDUP_POLICY} |
+
+---
+
+## 4. 关键通道齐全性（仅稳态判据所需通道）
+| 通道 | 非空率 | 最大连续缺失 | 备注 |
+|---|---:|---:|---|
+| ${TAG_1} | ${TAG_1_RATE} | ${TAG_1_MAX_GAP} | - |
+
+结论（是否满足进入稳态分析）：
+- [ ] 满足
+- [ ] 不满足（需要回到 `workflows/01-data-source-inventory-and-lineage.md` / `workflows/02-data-alignment-and-tag-semantics.md` 修正母表/通道语义）

package/presets/clearai/template/skills/data-qa-analysis/templates/steady_state_rules.yaml.tpl

@@ -0,0 +1,41 @@
+# 稳态规则模板 (Steady State / In-observation Rules)
+# 输出物：可复现的“有效稳态（In-observation）”判据（阈值需结合数据分布校准）
+
+meta:
+  system_name: "${SYSTEM_NAME}"
+  time_col: "${TIME_COL}"
+  sampling_minutes: ${SAMPLING_MINUTES}
+  continuous_gap_minutes: ${CONTINUOUS_GAP_MINUTES}
+
+in_observation:
+  # 有效判据（强制，建议以输入通量/负荷为主）
+  running_conditions:
+    - id: "RUN001"
+      expression: "${LOAD_TAG} > ${LOAD_MIN}"
+      reason: "In-observation: input flux/load above minimum threshold"
+    - id: "RUN002"
+      expression: "${AUX_TAG} > ${AUX_MIN}"
+      reason: "Optional supporting evidence (auxiliary resource consumption / operating condition)"
+  combine: "AND" # AND / OR（建议：以输入通量为主；辅助证据可 OR 或不启用）
+
+transition_exclusion:
+  enabled: true
+  window_minutes: ${TRANSITION_WINDOW_MINUTES}
+  # 在 in_observation 状态切换点附近剔除过渡段（避免刚启动/刚停止瞬态）
+  nan_policy: "${NAN_POLICY}" # off / abnormal / skip
+
+optional_deep_steady_state:
+  enabled: false
+  # 可选：仅当业务需要“深稳态/波动小”时启用（例如用于机理建模/回归）
+  window_minutes: ${DEEP_STEADY_WINDOW_MINUTES}
+  criteria:
+    - id: "DSS001"
+      type: "std_over_mean"
+      field: "${KEY_TEMP_TAG}"
+      max_cv: ${TEMP_MAX_CV}
+      reason: "Optional: key temperature variability filter"
+    - id: "DSS002"
+      type: "std_over_mean"
+      field: "${KEY_PRESS_TAG}"
+      max_cv: ${PRESS_MAX_CV}
+      reason: "Optional: key pressure variability filter"

package/presets/clearai/template/skills/data-qa-analysis/templates/subsystem_registry.md.tpl

@@ -0,0 +1,101 @@
+# 子系统登记表 (Subsystem Registry)
+
+> 目的：把“一个大系统如何拆分为多个子系统（按输入/负荷）”与“代价资源规格的消耗方覆盖检查”固化为可审计口径。
+> 本文件一旦确认，将作为后续 `workflow04`（单位代价/外推/波动）的唯一边界与口径约束。
+
+## 0. 基本信息
+
+- **系统/观测段名称**：${SYSTEM_NAME}
+- **登记日期**：${DATE}
+- **负责人**：${OWNER}
+- **稳态数据输入**：`products/extracted/steady_state_table.csv`
+- **口径来源**：`products/extracted/unit_inventory.md`、`products/extracted/tag_map.csv`、`products/extracted/entity_map_enriched.json`
+
+---
+
+## 1. 代价资源口径（Primary Cost Driver Spec，必填）
+
+- **资源类型**：${COST_MEDIUM}（power / coolant / reagent / compute / ...）
+- **资源规格/等级**：${COST_GRADE}（例如 power@kW / reagent@gradeA / compute@GPUh）
+- **消耗量 Q 定义**：${Q_DEFINITION}（单点/多点求和/换算规则）
+- **单位**：${Q_UNIT}
+- **净值规则**：${NET_RULES}（是否扣除回收/旁路/内循环等）
+
+---
+
+## 2. 子系统列表（按输入/负荷拆分，必填）
+
+| subsystem_id | subsystem_name | 输入/负荷 tags（负荷口径） | unit 清单（边界内） | 备注 |
+|-------------|----------------|----------------------------|---------------------------|------|
+| S1 | ${SUBSYSTEM_1_NAME} | ${SUBSYSTEM_1_LOAD_TAGS} | ${SUBSYSTEM_1_UNITS} | ${SUBSYSTEM_1_NOTE} |
+| S2 | ${SUBSYSTEM_2_NAME} | ${SUBSYSTEM_2_LOAD_TAGS} | ${SUBSYSTEM_2_UNITS} | ${SUBSYSTEM_2_NOTE} |
+
+> **拆分依据（必填）**：说明为何需要拆分，并写出判定证据。建议至少覆盖以下通用原则：
+> - **入口位置原则（强烈建议默认采用）**：若不同输入进入不同的“直接接收单元/入口位置”（例如分别进入不同处理单元/不同实验线路），则应拆分为不同子系统（每路输入对应一个子系统），避免把不同入口的系统硬合并造成口径错误。
+>   - 证据优先来自上游结构 skill 输出的“输入去向映射表”（Feed → DirectReceivingUnit）与 `products/extracted/entity_map_enriched.json` 的边界输入边（Boundary_Feed_* → Unit）。
+> - **互斥/分模式原则**：若多路输入在稳态数据中明显互斥（A 开时 B 基本为 0），应拆分为不同 mode/subsystem。
+> - **合并的例外条件**：只有在能证明输入在上游很快汇合并共享同一套主要代价资源/主要单元链路时，才允许合并，并必须说明为何不会导致口径缺路或重复计入。
+${SPLIT_RATIONALE}
+
+---
+
+## 3. 子系统负荷与系统总计规则（必填）
+
+### 3.1 子系统负荷定义
+
+对每个子系统写清楚：
+- **L_s(t) 公式**：${LOAD_FORMULA}
+- **多路输入合并规则**：sum / mode / other
+- **互斥/并行判断**：${MUTUAL_EXCLUSION_RULE}
+
+### 3.2 系统总计规则
+
+- **L_total(t)**：${L_TOTAL_RULE}
+- **Q_total(t)**：${Q_TOTAL_RULE}
+- **共享项分摊/不分摊**：${ALLOCATION_RULES}（若无法分摊，必须标注风险）
+
+---
+
+## 4. 资源规格“消耗方覆盖完整性检查”（必填）
+
+> 目标：确保所有“使用该资源规格”的单元都纳入 Q 统计，避免漏项（例如某些单元使用同一规格电力/试剂但未计入总量）。
+
+### 4.1 expected_consumers（理论应计入）
+
+来源：`products/extracted/unit_inventory.md` 的 `energy_interfaces`（资源接口）与/或 `products/extracted/entity_map_enriched.json` 的 resource edges。
+| unit | resource_interface | medium@grade | 证据位置 |
+|-----------|------------------|--------------|----------|
+| ${UNIT_1} | ${IFACE_1} | ${GRADE_1} | ${EVID_1} |
+
+### 4.2 metered_consumers（实际已计量并纳入 Q）
+
+来源：`products/extracted/tag_map.csv`（资源边/节点对应 tag）。
+| unit | q_tag(s) | unit | 来源/置信度 |
+|-----------|----------|------|-------------|
+| ${UNIT_1} | ${TAG_1} | ${UNIT} | ${SRC} |
+
+### 4.3 缺口与处理
+
+| unit | 缺口类型 | 影响 | 处理建议 |
+|-----------|----------|------|----------|
+| ${UNIT_X} | Unmetered / TagMissingInMotherTable / ObjectNotConfirmed | ${IMPACT} | ${ACTION} |
+
+> **结论（必填）**：覆盖是否完整？若不完整，是否允许继续计算（需在 `products/extracted/consumption_summary.md` 与后续改进空间测算中标注风险）？
+${COVERAGE_CONCLUSION}
+
+---
+
+## 5. 按子系统的资源计入规则（必填）
+
+对每个子系统说明：
+- 纳入哪些 unit 的资源消耗（与覆盖检查一致）
+- 若有共享计量表/共享设施：如何分摊到子系统（或不分摊）
+
+---
+
+## 6. 确认记录（闸门）
+
+- **确认日期**：${CONFIRM_DATE}
+- **确认人**：${CONFIRMER}
+- **结论**：[ ] 通过 / [ ] 需修改
+- **变更记录**：${CHANGELOG}

package/presets/clearai/template/skills/data-qa-analysis/templates/unified_execution_plan.md.tpl

@@ -0,0 +1,100 @@
+# 统一执行计划（Unified Plan，数据 QA & 分析版：Workflow01-05）
+
+> **强制**：本 plan 覆盖本次任务将执行的**所有 workflows（仅限本 skill）**。执行第一个 workflow 前必须先让用户确认本 plan。
+
+## 0. 基本信息
+
+- **项目/系统**：${PROJECT_NAME}
+- **边界范围（简述）**：${SCOPE_SUMMARY}
+- **计划日期**：${DATE}
+- **负责人**：${OWNER}
+
+## 1. 前置依赖（来自结构 skill 的交付物）
+
+> 本 skill 依赖“系统理解与结构提取”skill 的上游产物作为输入约束（不跨目录引用模板/清单，但必须满足这些文件已存在且可用）。
+
+- `products/extracted/unit_inventory.md`（存在性三态 + 观测单元/流转关系 + 资源接口）
+- `products/extracted/entity_map.json`（topology-only：节点=观测单元/支持设施/边界；边=物质或信号流/资源接口；含 evidence；不含通道号）
+
+## 2. 产物分区（必须）
+
+- **lab/**：过程文件/中间产物（临时表、探索性 notebook、截图等）
+- **products/**：最终交付（推荐把 workflows 声明的 `products/extracted/*` 映射为 `products/extracted/*`）
+
+> **规则**：任何 workflow 的“强制产出物”必须在 plan 中写清楚最终落点（`lab/` or `products/` + 具体文件路径）。
+
+## 3. 本次将执行的 Workflows（顺序与原因）
+
+| 顺序 | workflow | 目的 | 前置依赖 | 主要强制产出物（文件） |
+|------|----------|------|----------|------------------------|
+| 01 | `workflows/01-data-source-inventory-and-lineage.md` | ${WHY_WF01} | 结构产物 + 数据源 | `products/extracted/data_source_inventory.md`<br/>`products/extracted/data_lineage.mmd`<br/>`products/extracted/merge_contract.md`<br/>`products/extracted/mother_table_aligned.csv`<br/>`products/extracted/mother_table_registry.md` |
+| 02 | `workflows/02-data-alignment-and-tag-semantics.md` | ${WHY_WF02} | wf01 + 结构产物 | `products/extracted/data_dictionary.md`<br/>`products/extracted/cleaning_rules.yaml`<br/>`products/extracted/missing_tags.md`<br/>`products/extracted/tag_map.csv`<br/>`products/extracted/entity_map_enriched.json` |
+| 03 | `workflows/03-steady-state-identification.md` | ${WHY_WF03} | wf01/02 | `products/extracted/data_status_report.md`<br/>`products/extracted/time_gap_summary.csv`<br/>`products/extracted/continuous_segments.csv`<br/>`products/extracted/steady_state_basis.md`<br/>`products/extracted/steady_state_rules.yaml`<br/>`products/extracted/steady_state_mask.csv`<br/>`products/extracted/steady_state_segments.csv`<br/>`products/extracted/steady_state_table.csv`<br/>`products/extracted/steady_state_summary.md`<br/>`products/extracted/steady_state_validation.md` |
+| 04 | `workflows/04-consumption-analysis.md` | ${WHY_WF04} | wf03 | `products/extracted/subsystem_registry.md`<br/>`products/extracted/consumption_summary.md`<br/>`products/extracted/load_distribution.csv`<br/>`products/extracted/variability_summary.md`<br/>`products/extracted/workflow06_figures.md` |
+| 05 | `workflows/05-best-in-class-and-optimization-space.md` | ${WHY_WF05} | wf04 | `products/extracted/bic_thresholds.csv`<br/>`products/extracted/optimization_space_by_unit.csv`<br/>`products/extracted/improvement_space_summary.md` |
+
+> 上表默认“执行 01-05 全链路”。若本次不执行某些 workflow，必须在下方“产出物对照表”里明确标记为 N/A，并说明原因与风险。
+
+## 4. 产出物对照表（强制，逐条对照 workflow 的 `## 产出物`）
+
+> **硬规则**：本表必须逐条对照你将执行的每个 workflow 文件中的 `## 产出物` 清单，**逐行复制**文件名/路径，不允许“概括/省略/合并同类项”。
+> 若 workflow 的产出物有“可选”，也必须在本表明确是否产出（Yes/No）与原因。
+
+### 4.1 Workflow 01
+
+| 条目 | 来自 workflow 的产出物条目 | 本次是否产出 | 最终落点（lab/product + 路径） | 备注 |
+|------|---------------------------|--------------|------------------------------|------|
+| 01-1 | `products/extracted/data_source_inventory.md` | Yes | `products/extracted/data_source_inventory.md` |  |
+| 01-2 | `products/extracted/data_lineage.mmd` | Yes | `products/extracted/data_lineage.mmd` |  |
+| 01-3 | `products/extracted/merge_contract.md` | Yes | `products/extracted/merge_contract.md` |  |
+| 01-4 | `products/extracted/mother_table_aligned.csv` | Yes | `products/extracted/mother_table_aligned.csv` |  |
+| 01-5 | `products/extracted/mother_table_registry.md` | Yes | `products/extracted/mother_table_registry.md` | 推荐始终产出 |
+| 01-6 | （可选，但推荐）`products/extracted/header_meta.csv` | ${YES_NO} | ${PATH} |  |
+| 01-7 | （可选）`products/extracted/tag_map.csv` | ${YES_NO} | ${PATH} |  |
+
+### 4.2 Workflow 02
+
+| 条目 | 来自 workflow 的产出物条目 | 本次是否产出 | 最终落点（lab/product + 路径） | 备注 |
+|------|---------------------------|--------------|------------------------------|------|
+| 02-1 | `products/extracted/data_dictionary.md` | Yes | `products/extracted/data_dictionary.md` |  |
+| 02-2 | `products/extracted/cleaning_rules.yaml` | Yes | `products/extracted/cleaning_rules.yaml` |  |
+| 02-3 | `products/extracted/missing_tags.md` | Yes | `products/extracted/missing_tags.md` |  |
+| 02-4 | `products/extracted/tag_map.csv` | Yes | `products/extracted/tag_map.csv` |  |
+| 02-5 | `products/extracted/entity_map_enriched.json` | Yes | `products/extracted/entity_map_enriched.json` |  |
+
+### 4.3 Workflow 03
+
+| 条目 | 来自 workflow 的产出物条目 | 本次是否产出 | 最终落点（lab/product + 路径） | 备注 |
+|------|---------------------------|--------------|------------------------------|------|
+| 03-1 | `products/extracted/data_status_report.md` | Yes | `products/extracted/data_status_report.md` |  |
+| 03-2 | `products/extracted/time_gap_summary.csv` | Yes | `products/extracted/time_gap_summary.csv` |  |
+| 03-3 | `products/extracted/continuous_segments.csv` | Yes | `products/extracted/continuous_segments.csv` |  |
+| 03-4 | `products/extracted/steady_state_basis.md` | Yes | `products/extracted/steady_state_basis.md` | 必须先确认后再继续 |
+| 03-5 | `products/extracted/steady_state_rules.yaml` | Yes | `products/extracted/steady_state_rules.yaml` |  |
+| 03-6 | `products/extracted/steady_state_mask.csv` | Yes | `products/extracted/steady_state_mask.csv` |  |
+| 03-7 | `products/extracted/steady_state_segments.csv` | Yes | `products/extracted/steady_state_segments.csv` |  |
+| 03-8 | `products/extracted/steady_state_table.csv` | Yes | `products/extracted/steady_state_table.csv` | 下游唯一输入 |
+| 03-9 | `products/extracted/steady_state_summary.md` | Yes | `products/extracted/steady_state_summary.md` |  |
+| 03-10 | `products/extracted/steady_state_validation.md` | Yes | `products/extracted/steady_state_validation.md` |  |
+
+### 4.4 Workflow 04
+
+| 条目 | 来自 workflow 的产出物条目 | 本次是否产出 | 最终落点（lab/product + 路径） | 备注 |
+|------|---------------------------|--------------|------------------------------|------|
+| 04-1 | `products/extracted/subsystem_registry.md` | Yes | `products/extracted/subsystem_registry.md` |  |
+| 04-2 | `products/extracted/consumption_summary.md` | Yes | `products/extracted/consumption_summary.md` |  |
+| 04-3 | `products/extracted/load_distribution.csv` | Yes | `products/extracted/load_distribution.csv` | 按子系统长周期外推 |
+| 04-4 | `products/extracted/variability_summary.md` | Yes | `products/extracted/variability_summary.md` | 按 unit 逐一诊断 |
+| 04-5 | `products/extracted/workflow06_figures.md` | Yes | `products/extracted/workflow06_figures.md` | 图表索引 |
+
+### 4.5 Workflow 05
+
+| 条目 | 来自 workflow 的产出物条目 | 本次是否产出 | 最终落点（lab/product + 路径） | 备注 |
+|------|---------------------------|--------------|------------------------------|------|
+| 05-1 | `products/extracted/bic_thresholds.csv` | Yes | `products/extracted/bic_thresholds.csv` | 系统 P20 |
+| 05-2 | `products/extracted/optimization_space_by_unit.csv` | Yes | `products/extracted/optimization_space_by_unit.csv` | 单元改进空间 |
+| 05-3 | `products/extracted/improvement_space_summary.md` | Yes | `products/extracted/improvement_space_summary.md` | 改进空间与长周期收益 |
+
+## 5. 计划确认（用户确认后才允许执行）
+
+- [ ] 用户确认 plan（日期/确认人/备注）：${PLAN_APPROVAL}