观测/实验数据 QA 与分析 Skill (SOP)
本 Skill 是“观测/实验数据分析”的数据部分:在系统边界与观测对象结构骨架已具备的前提下,完成“数据从哪里来 → 如何对齐成母表 → 测量口径如何落到通道 → 如何筛有效稳态段 → 如何做代价/波动/最优区段/改进空间”的可复现交付。
落盘约定
- 最终交付:
products/extracted/(母表、稳态表、字典、报告等) - 过程数据:
lab/data/(合并中间表、脚本输出等,见 workflow01 血缘 Pattern) - 图表:PNG 等可视化写入
lab/diagrams/;products/extracted/workflow06_figures.md仅作图表索引(清单 + 口径 + 文件路径) - 文中若出现
extracted/逻辑别名,write 必须使用products/extracted/完整路径
1. 前置依赖(必须)
本 Skill 不负责“从资料恢复系统结构”。在执行前必须具备上游结构产物(由 process-understanding-extraction/ 生成):
products/extracted/unit_inventory.md:存在性三态 + 观测单元/流转关系清单 + 资源/环境接口(不含通道号)products/extracted/entity_map.json:单元级结构骨架(topology-only:节点=观测单元/支持设施/边界;边=物质或信号流/资源接口;含 evidence;不含通道号)
规则:本 Skill 不跨目录引用对方 templates/checklists;只把上述产物作为输入约束,具体落点由你的统一 plan 决定。
2. 核心方法论 (Core Method)
- Lineage-First(血缘优先):母表不是原始数据。必须先做数据源盘点与血缘图,明确“谁合并谁、冲突谁优先、表头行如何保留”。
- Mother-Table-Only(母表唯一输入):从本 skill 的
workflow01结束开始,下游所有分析只能基于products/extracted/mother_table_aligned.csv(稳态后则只能基于products/extracted/steady_state_table.csv)。 - Metric-of-Record(测量口径落点):资料以设备/环节编号叙述时必须在本 skill 的
workflow02将对象映射到实际测量通道(流量/温度/计数/功率等)。 - Steady-State-First(稳态优先):稳态以“有效观测(In-observation:仪器正常采集、实验正常进行)”为核心口径;先 basis 确认再生成 mask/table,且必须检查连续性与关键通道齐全性。
- System Benchmarking(系统级标杆):强耦合系统优先系统级 P20(分负荷段),再在系统最优时段集合内做单元归因,避免“单元最优拼不出系统最优”。
- Extrapolation Discipline(外推纪律):长周期外推优先用“绝对量差/逐负荷段累计”,避免比值平均陷阱。
3. 决策树 (Decision Tree)
根据用户意图选择工作流:
- “我需要盘点数据源/补齐母表血缘/合并契约” ->
workflows/01-data-source-inventory-and-lineage.md - “我要对齐时间/通道语义/测量口径并输出缺失清单” ->
workflows/02-data-alignment-and-tag-semantics.md - “我要识别有效稳态段/剔除启停与校准异常段” ->
workflows/03-steady-state-identification.md - “我要做资源代价/单位代价/长周期外推与波动诊断” ->
workflows/04-consumption-analysis.md - “我要做 Best-in-Class/P20 最优区段与改进空间” ->
workflows/05-best-in-class-and-optimization-space.md - “全面体检(数据部分)” -> 按顺序执行 01 -> 02 -> 03 -> 04 -> 05。
4. 核心指令 (Core Instructions)
5. 资源索引 (Resource Index)
- Workflows:
workflows/01-data-source-inventory-and-lineage.mdworkflows/02-data-alignment-and-tag-semantics.mdworkflows/03-steady-state-identification.mdworkflows/04-consumption-analysis.mdworkflows/05-best-in-class-and-optimization-space.md
- Templates:
templates/unified_execution_plan.md.tpltemplates/data_source_inventory_and_lineage.md.tpltemplates/data_dictionary.md.tpltemplates/cleaning_rules_draft.yaml.tpltemplates/data_status_report.md.tpltemplates/steady_state_rules.yaml.tpltemplates/subsystem_registry.md.tpltemplates/best_in_class_report.md.tpl
- Checklists:
checklists/readiness_check.md