shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsNo API key required

母表数据逻辑复核

母表数据逻辑链勾稽与五维判定（成本分析的逻辑复核层）。检验母表内部勾稽自洽、利润=收入−成本、量价差逻辑、标后超标剖析、五维判定矩阵、EVM 旁证。配置驱动·抗模板漂移：列定位与口径规则全部外置于 references/templates/*.json，新增一种企业母表模板 = 新增一个 json，无需改脚本。触发词：母表数据逻辑复核、母表逻辑勾稽、数据逻辑链、利润勾稽、量价差逻辑、标后超标剖析、五维判定、内部勾稽、EVM 旁证、母表自检、表4-2 超标、成本偏差闭合、勾稽自洽、逻辑关联判定。

personAuthor: user_c52c95d2hubcommunity
downloadDownload package

母表数据逻辑复核（mother-data-logic）

兄弟技能边界（先读，避免误用）：

  • 本技能只管母表（Excel 经济活动分析统计表）的数据逻辑链：表内合计=Σ子项、利润=收入−成本、标后超标、五维判定矩阵、EVM 旁证。不读 Word 报告文字、不做报告内部前后矛盾检查。
  • Word 报告的文字↔表格 / 前后矛盾检查，归「报告内部矛盾复核」技能（三视角专家团 + WPS 真实页码）。
  • 报告 vs 母表字段级溯源对账（每个数溯源到母表单元格）归「成本与报告复核」技能。
  • 原「母表逻辑验算复核」（母表勾稽+修正回填）已归档至 skills/archive，其功能由本技能的 check_mother_internal 覆盖。

定位：把「一份成本分析报告（报告 + 母表）做得对不对、数据逻辑关联是否成立」从规范文字落成确定性断言与判定矩阵。它检验的是逻辑层（内部是否自洽、链条是否闭合、超标是否剖因、EVM 是否预警），不检验字段级溯源（报告某个数是否等于母表某个单元格——那是「成本与报告复核」能力一的活）。

与溯源对账的边界（最高优先级，别混）：

  • 本技能 = 逻辑复核：母表内勾稽、利润=收入−成本、合计=Σ子项、标后超标率、EVM、五维判定。不逐字段比对报告值 vs 母表值。
  • 成本与报告复核·能力一 = 溯源对账：报告每个数溯源到母表单元格，分类 一致/偏差/口径/未披露。本技能的结论（如"勾稽闭合""EVM预警"）可作为溯源对账的输入/旁证，但二者不重复、不互相替代。

实战来源：2026-08-02「4月四项目复核」（重庆15号线13标 / 温霍3标 / 新疆TMSG-3标 / 青海小老）与 2026-08-04 TMSG-3 4月基线重建沉淀；母表逻辑校验器由温霍4月母表实测教训固化。

一、适用与范围

  • 输入：项目母表（经济活动分析统计表 .xlsx/.xls）；可选分析报告 .docx 补全判定维度。
  • 输出：逻辑复核结论（通过/不一致/预警/口径差/待确认）+ 判定矩阵（md+json）+ 超标剖析表。
  • 可独立运行：仅给母表即可跑维度②③④⑤（逻辑链维度①与超标剖析有据性④需报告补全，缺失标「待确认」而非臆断）。
  • 领域可扩展：默认按中交成本分析母表结构（表4-2/4-1/3-1/3-2…）落地；换其他结构化报告（环评/能耗/审计底稿）只需改 judge_logic.py 的列定位与维度规则，引擎不变。

二、核心能力（四模块）

| 模块 | 脚本 | 干什么 | 关键产出 | |---|---|---|---| | ① 母表自身数据逻辑校验 | check_mother_internal.py | 母表 workbook 内部勾稽自洽（不碰报告、不碰还原表）。12 项断言 | 不一致门禁（退出码1）；通过/口径差/待确认 | | ② 利润合理性 + 量价差逻辑复核 | verify_profit.py（本地解析库） | 推算利润=收入−实际成本；标后/实际利润率偏差；量价差闭合；材料超耗率 | 利润勾稽结论、量价差逻辑闭合 | | ③ 标后预算超标剖析 | gen_overrun_analysis.py | 表4-2 各科目「标后 vs 实际」超标额/率排名，套阈值预警 + 三维分解脚手架（列定位走 references/templates/*.json） | 超标主因排名、预警清单 | | ④ 数据逻辑关联五维判定 | judge_logic.py | 把②③④升维成五维判定矩阵（含 EVM 旁证 + --report 自动比对；变更台账列定位走模板配置） | 判定矩阵 md+json、整体结论 |

本技能自包含：verify_profit.py / xls_util.py / template_loader.py 全部内嵌于 scripts/，不依赖任何外部技能即可独立运行（满足上架分发）。新增企业母表模板只需在 references/templates/ 加一个 json，脚本零改动。

三、数据逻辑链（分析骨架，详见 references/data_logic_chain.txt）

三层推导：基础数据层(表2/3) → 量价差计算层(表5/6/8/9) → 利润汇总层(表4-2/4-1)。

  • 收入链：2-1→2-2→3-1→3-2→3-3/3-4（签约→图纸复核→能确认/力争→进度产值→变更/索赔）。先收入后成本。
  • 成本链：专项节超(表5/6/7/8/9)→表4-2(已完)→表4-1(预测)→利润终验。
  • 利润 = 收入(表3-1) − 成本(表4-1) 为勾稽终验，单独呈现。
  • ⚠ 表4-2 口径 completeness：实际成本合计(col10) = 六科目 + 期间费用 + 附加税，勾稽必须纳入，否则误判不平（某项目实测缺 136.34万恰为期间费+附加税，非错误）。
  • ⚠ 排除项逻辑：序号十五「不属于项目承担成本」已在合计中剔除，量价差闭合比对 合计偏差 vs Σ(一~十四)，绝不可把十五当不闭合差异。
  • ⚠ 单位判定（表级非逐值）：依合计行量级一次性判定 divisor，禁逐值 to_wan()（<10万 小偏差误判为万元会放大1万倍）。

四、五维逻辑关联判定框架（§十三 判定标尺）

每个维度输出中文判定词：通过✓ / 不一致✗ / 预警▲ / 口径差～ / 待确认？。禁英文 PASS/FAIL/WARN。

| 维度 | 判定内容 | 通过✓ | 不一致✗ | 预警▲ | 口径差～ | 待确认？ | |---|---|---|---|---|---|---| | 一·逻辑链完整性 | 收入链 / 成本链逐层闭合 | 链路全通 | 链路断裂/缺失环节 | — | — | 缺某表无法验 | | 二·勾稽关系 | 利润=收入−成本；成本偏差=实际−标后；合计=Σ子项 | 三项全闭 | 任一偏差>0.01万 | — | — | 母表无对应源 | | 三·口径一致性 | 标后vs实际归集、收入核减归属、碎石场扣减 | 口径统一 | 母表值错 | — | 母表无误仅口径异 | — | | 四·超标剖析有据性 | 标后超标率是否算出；超标科目是否剖到量/价/效率+责任归口 | 已剖且有据 | 报告缺剖析章节 | 只列数字未剖因 | — | 需报告才能判 | | 五·EVM旁证 | CPI/SPI/EAC、成本进度比(95%~105%) | 全绿 | — | 任一越界提示结构性风险 | — | 缺进度数据 |

整体结论映射：

  • 任一维度「不一致」→ 「分析存疑，须修正数值」。
  • 无不一致但存在「预警」→ 「逻辑关联基本成立，存在经营风险/分析缺口待说明」。
  • 全「通过/口径差」且无「待确认」→ 「数据逻辑关联成立」。
  • 存在「待确认」→ 结论附「需补充：XXX 数据/报告」。

不一致常见根因（主理人复核须追到根，勿只报"加法错"）：

  • 数据归类错误（A 概念数字错填进 B 栏目，典型：某项目表2 把表8 跨期成本/潜亏错填进度收入差）→ 反查跨表口径，升级为"数据归类错误"并指明应重写栏目。
  • 算术错误 / 数字笔误（0.01~0.1万级取整误差）/ 口径错位缺口径说明。

五、EVM 交叉验证（维度五，先于利润终验暴露结构性风险）

  • BCWP=进度产值(表3-2/表3-1)；ACWP=实际成本(表4-2 col10)；BAC=标后预算总成本(表4-1 col8)；PV=BAC×完工进度%。
  • CPI=BCWP/ACWP(≥1可控)；SPI=BCWP/PV(≥1达标)；EAC=BAC/CPI；成本进度比=累计成本/累计完工进度(95%~105%)。
  • 逻辑价值：利润=收入−成本 显示盈利、但 SPI<1 且 CPI<1 时，盈利可能来自收入确认超前（完工百分比虚增），须反向核查收入块。某项目实测：CPI=0.8491 预警严重成本超支，SPI 正常→问题纯在成本侧。

六、标后预算超标主 KPI（分析目的的总开关）

整份报告的分析目的 = 「实际 vs 标后预算 → 超标发现 → 超标原因剖析」。

  • 主 KPI：标后预算执行偏差率（超标率）=(实际−标后)/标后；总体±10%警戒、单科目±15%触发重点剖析。
  • 三维分解（每条偏差必归其一）：量差(实际量−预算量)、价差(实际价−预算价)、效率差(实际效率−定额)，对接责任归口（施工/采购/施工组织）。
  • 所有旁证指标红灯最终回到主 KPI 解释：CPI 掉到0.85、成本进度比冲到117%，只告诉你"超标在恶化、问题在成本侧"，真正交代是算清间接费/100章各超标多少、为什么。

七、工作流（推荐顺序 · 详见 references/usage_guide.txt）

完整「先干什么再干什么」分步提示词见 references/usage_guide.txt（含命令、看什么、特殊母表处理）。

精简顺序：母表 → ① 勾稽门禁 → ②/④ 五维判定拿结论 → ③ 超标剖析定位主因 →（给报告）④ 全本判定 → 交「成本与报告复核」做溯源对账。

  1. 先跑 ① 母表逻辑校验（check_mother_internal.py）：母表内部勾稽是下游一切的基础，门禁阻断「不一致」。
  2. 再跑 ④ 五维判定（judge_logic.py --master）：拿母表即可判维度②③④⑤，得逻辑关联整体结论。
  3. 补 ③ 超标剖析（gen_overrun_analysis.py --master）：定位超标主因、出预警清单（列定位走 references/templates/*.json，不写死）。
  4. 给 --report 全本判定（judge_logic.py --master --report）：补全维度①④，并自动比对报告 vs 母表强信号（变更漏报/表2归类/成本合计/标后总成本口径差）。
  5. 把逻辑复核结论（勾稽闭合、EVM预警、超标主因）作为溯源对账的输入/旁证交给「成本与报告复核·能力一」做字段级对账，二者互补不重复。

八、脚本索引与用法

scripts/
  judge_logic.py            # ④ 五维判定矩阵执行器（--master / --report / --out / --template）
  check_mother_internal.py  # ① 母表内勾稽确定性校验（门禁，退出码1）
  gen_overrun_analysis.py   # ③ 标后超标剖析出表器（--master / --out / --template / --list-templates）
  verify_profit.py          # ② 本地解析库（列头匹配/母表定位/利润抽取/量价差）
  template_loader.py        # 模板配置加载器（列定位 / 栏号角色 / 阈值 / 口径）
  xls_util.py               # 本地小依赖（.xls 自动转 xlsx）
references/
  data_logic_chain.txt       # 三层数据逻辑链路方法论（通用）
  usage_guide.txt               # 技能试用提示词：先干什么再干什么（分步命令+看什么+特殊母表）
  templates/
    default.json            # ③超标剖析：标准母表列定位模板（栏号公式行 + 关键词分组 + 数值自校验）
    dual_currency.json      # ③超标剖析：多币种/双段母表示例（证明机制可插拔）
    verify_profit_baselines.json  # ①②引擎基线：表4-2/4-1 多项目结构(g219/yilai/chengpinliao/g219b/rail) + 量价差 sheet 定位，全部外置，脚本零写死

# ① 母表内勾稽（任一不一致→退出码1）
python check_mother_internal.py "<母表.xlsx>" --out result.json --tol 100

# ④ 五维判定（仅母表）
python judge_logic.py --master "<母表.xlsx>" --out DIR
# ④ 五维判定（给报告补全维度①/④ + 自动比对）
python judge_logic.py --master "<母表.xlsx>" --report "<报告.docx>" --out DIR

# ③ 超标剖析（默认模板自动识别；特殊母表用 --template 指定）
python gen_overrun_analysis.py --master "<母表.xlsx>" --out DIR
python gen_overrun_analysis.py --list-templates        # 列出可用模板
python gen_overrun_analysis.py --master "<母表.xlsx>" --template dual_currency --out DIR

九、Python 环境

隔离 venv（与「成本与报告复核」同环境）：openpyxl / python-docx / python-pptx / olefile / xlrd==2.0.2。 C:/Users/古月/.workbuddy/binaries/python/envs/default/Scripts/python.exe 若缺：python -m venv .../envs/default 后 pip install openpyxl python-docx python-pptx olefile xlrd==2.0.2。

十、融合方案（与「成本与报告复核」技能）

关系：母表数据逻辑复核 是「成本与报告复核」之上的逻辑复核层。后者 = 能力一(溯源对账引擎) + 能力二(成本深度复核：利润复核/字段对账/审核意见) + 原内嵌的 §十二/§十三 逻辑框架。本技能把后者内嵌的「逻辑框架/判定框架/母表校验」抽出独立，形成清晰的两层：

成本与报告复核（成本分析技能 · 基础）
  ├─ 能力一：报告 vs 母表 字段级溯源对账（audit_engine / 基线字典 / 审核意见三件套）
  └─ 能力二：成本领域深度复核（利润复核 / 字段对账 / 公司审核意见格式）  ← 引用本层结论
母表数据逻辑复核（逻辑复核层 · 叠加）
  ├─ ① 母表内勾稽  check_mother_internal.py
  ├─ ② 利润/量价差逻辑  verify_profit（共享库）
  ├─ ③ 超标剖析  gen_overrun_analysis.py
  └─ ④ 五维判定  judge_logic.py（含 EVM + --report 自动比对）

融合机制（已落地）：

  1. 本技能自包含、可独立上架：verify_profit.py / xls_util.py / template_loader.py 全部内嵌于 scripts/，运行时 sys.path 加本目录即自解析，不依赖「成本与报告复核」技能即可跑通。上架分发时接收方无需安装任何前置技能。
  2. 配置驱动·抗模板漂移：表4-2 列定位（标后预算/实际成本/成本偏差）、栏号公式角色、阈值、口径排除规则全部外置于 references/templates/*.json。新增一种企业母表模板 = 新增一个 json（覆写 columns / lanhao.formula_roles / closure / thresholds），脚本零改动。这是与旧版本（脚本里写死 G219 列序）的根本区别。
  3. 边界单一：溯源对账（报告值↔母表单元格）与逻辑复核（内部勾稽/EVM/判定）职责不重叠；逻辑复核结论作为溯源对账的旁证输入。
  4. 判定词/中文规范一致：两技能共用 通过/不一致/预警/口径差/待确认 全中文判定词。

两层结构（当前实际状态）：

  • 成本与报告复核 = 基础技能：能力一(溯源对账引擎) + 能力二(成本深度复核：利润复核/字段对账/审核意见) + 已合并的原母表逻辑框架（其 report_fullscan 等会调用本层结论）。
  • 母表数据逻辑复核 = 可选叠加逻辑层：用户只要"逻辑通不通"时单独调用；做完整公司审核意见时，由 成本与报告复核 在其流程中引用本层的 judge_logic / check_mother_internal 输出。
  • 触发协同：在「成本与报告复核/SKILL.md」概述已加指向本技能的能力③入口；本技能 SKILL.md 上方已固化边界与调用顺序。

维护约定：本技能脚本与方法论文档（data_logic_chain.txt）刻意剥离项目专属硬编码，仅保留方法论与可配置基线骨架。任何"某项目特有列序/口径"都不应写进脚本，而应落入 references/templates/<项目>.json。