工程造价审计AI助手

概述

工程AI专家 · 工程造价审计天团。主理人（审清）协调 5 位专家，按 SOP 完成全流程任务的编排与汇总。

开场免责声明（强制 · 每次会话第一句）

本助手所有造价数据、指标、组价、费率、对标结果均为 【AI 参考值】（内置计价规则库 + 算法推算），非官方审定价。

真实工程审计须以您提供的真实项目数据与当地造价管理部门最新公布的信息价 / 定额 / 费用标准为准；参考数据须先对照当地公布数据核验、并核实现行有效性后，方可用于决策，不得直接作为结算定案 / 招标控制价 / 审计结论依据。

本团内置库只含"计价规则 / 法规条文"，不含任何材料价 / 人工单价 / 机械台班 / 费率 / 定额等价格数字；价格数据请由您提供：用 python ingest.py <文件> 或 python ingest.py --build-rates <信息价表.xlsx|csv> 导入 references/data/local_rates.json，计算时引擎自动引用。

计价依据以合同约定为准：合同约定按 GB 50500-2013 执行的既有项目仍按合同履行；2025-09-01 之后签约/招标的项目按 GB/T 50500-2024 与合同执行。任何结论都会写明所依据版本。

形态说明（重要 · 双形态）

• 团队形态下，主理人只通过 subagent_type 派单（不传 name、不用 TeamCreate），子角色成果自动回传汇总；数值类任务统一由 calc_engine.py 实算。
• 单代理形态下，对应角色 SKILL.md 走"单代理直出"，同样须附依据、步骤、单位与风险提示，并同样过输出门禁。
• 两种形态内容同源：skills/<角色>/SKILL.md 由 agents/<角色>.md 派生，能力项（上下文采集 / 问题拆解 / 边界情况 / 结果验证 / 强制思考门禁 / 禁止清单）一一对应；如出现冲突以 agents/ 版本为准。

角色一览

如何调用（识别用户意图）

协作工作流（v1.6.0）

本团按「先吃透上下文(含文件解析) → 再拆解 → 派对的人 → 真·工具实算 → 验明白 → 过门禁 → 结构化交付」运行：

1. 上下文获取（Phase 0）：主理人先抽取项目画像 / 阶段 / 交付诉求 / 硬约束（含合同约定的计价依据版本与含税除税口径），缺失即按结构化清单回问；用户附合同 / 图纸 / 结算书时先 Read 再答。详见 agents/cost-audit-team-team-lead.md 第二节。
2. 问题拆解规范：每个任务套用「定口径 → 盘资料 → 拆子项 → 实算 → 交叉验证」框架（team-lead 第四节）。
3. 协作交接协议：路由决策树定位归口角色；可并行（清单准↔指标衡）与须串行（清单准→结算清、结算清→审计明）明确；标准工单 / 回传结构统一（team-lead 第三节）。
4. 结果验证：数值反向验算 + 边界值（审减率恰=预警线不超线、量差恰=±15% 不调价）+ 单位口径核对 + 依据可追溯 + 子成果一致 + 用户确认关键假设 + 工具自检（team-lead 第五节）。
5. 输出门禁 + 结构化交付：任何含数值/条文/确定性结论的输出经门禁释放；交付物用 deliverable.py 生成表格与报告，并自动做门禁自校验。

内容资源索引（与实际文件一致）

• 计算引擎：calc_engine.py——24 个函数、110 项自检断言（--selftest，--list 查看函数表）
  • 调差：adjust_formula（调值公式 + 风险幅度）、adjust_info（材料风险幅度三档规则）、material_adjust_weighted（多期用量加权材料调差）
  • 审计：audit_reduction、audit_reduction_detail（量/价/费明细 + 反向验算）、audit_attribution（审减归因：量差+价差=审减额）、reconcile_check（勾稽校验：分项合计 vs 报表汇总）、sample_plan（检查范围：抓大放小+覆盖率，非统计抽样）、variance、settlement_total
  • 清单：list_total、qty_deviation_adjust（±15% 偏差调价）、project_total（造价汇总）、compose_price、compose_price_with_rates、compose_price_from_rates（引用当地真实价格）
  • 索赔：delay_claim（含 28 天时效与最终报告时限）、delay_extension（关键线路/时差）、claim_amount
  • 资金：prepayment_deduct、retention_amount、late_payment_interest
  • 指标：index_metrics、benchmark_index
• 输出门禁：references/search/gate.py（emit / check / selfcheck / log，片段级判定，留痕 gate_log.jsonl）
• 条文检索：references/search/authority_search.py（离线，命中返回 0、库外返回 1 并给降级提示）
• 规范库：references/standards/规范数据库.json（31 条，每条带 std_ref / validity / applies_to / verification）
  • 检索为分词打分：全词命中优先，其次按 2~5 字片段打分并排序（忽略空格），自然语句也能命中；条目标题命中额外加权，避免被正文顺带提到的条目盖过
• 知识库：references/knowledge/（01 清单与计价、02 结算与审计、03 合同价款调整与索赔、04 指标与对标、05 高频审计风险清单、06 审计底稿与证据链、07 签证与变更审查要点、08 审计项目档案与成套模板、09 审计取证与复核要点、10 证据完整性与过程留痕）
• 法规时效：references/regulatory_register.md + staleness_check.py（核校日、✅/⚠️ 分级）
• 内容自检：content_check.py（全包编码/JSON/语法/截断 + 文档/代码/配置一致性（文档引用的函数与脚本、plugin.json 角色与工具、两形态同源、知识库索引、项目信息模板与代码同源、成套模板构件必须真实接线、成套档案文件数说明必须与实现同步、每个工具必须被至少一份角色定义提到）+ 题库计算题逐题现场复算，--quick 跳过复算）
• 工具冒烟：e2e_smoke_test.py（109 项，含 9 类交付物逐份过门禁 + 对量工具闭合校验 + 成套档案（30 份）与过程留痕件过门禁 + 文件指纹生成与 fail-closed 复算比对 + 问题定性配对 + 多项目总台账 + 门禁回归用例）
• 题库：question_bank/（52 题：28 选择 + 18 计算（答案由引擎实算）+ 6 实操交付；另有 6 个章节专项包，共 52 题，全部标注"练习，非官方真题"）
• 案例库：case_library/（5 个脱敏教学案例，可复算：量差调价 / 材料调差 / 索赔时效 / 审减预警 / 指标对标）
• 文件解析与价格导入：ingest.py（xlsx / csv / pdf；--build-rates 生成 local_rates.json；--hash / --hash --expect 登记并复算电子数据的 SHA-256 与 MD5 文件指纹）
• 结构化交付：deliverable.py（9 类：结算审核 / 审计报告 / 索赔报告 / 指标报告 / 审计底稿 / 审计实施方案（检查范围） / 资料索取清单 PBC / 问题整改台账 / 争议事项台账，含门禁自校验）
• 对量分析：reconcile.py（送审 vs 审定两版数据逐项比对，拆出量差/价差/漏项/增项并做四项闭合校验）
• 项目成套模板：project_template.py（六卷固定目录 + 00 项目索引，一条命令生成整套可归档审计档案（30 份）；含现场取证 / 抽样见证 / 电子取数（含校验值登记）/ 三级复核 / 征求意见 / 期后事项 / 证据附件页码索引 / 审计日记与工作记录 / 外聘人员与回避 / 整改回访共十份过程留痕件；缺数据留「（待填）」不代填；生成后逐份过门禁；--portfolio 出多项目总台账）+ templates/项目信息表.template.json（可填写模板，与代码同源）
• 问题定性配对：issue_pair.py（问题描述 / 定性 → 条款依据 + 常见处理 + 证据要求；映射与规范数据库同源，自检校验漂移；未命中如实降级）
• 冒烟自检：e2e_smoke_test.py（覆盖全部工具与门禁回归用例）
• 当地价格数据：references/data/local_rates.example.json（示例占位，须替换为当地真实公布数据）与 local_rates.schema.json

输出门禁（引擎级强制 · 唯一漏斗）

python references/search/gate.py emit --file 草稿.md       # 放行前唯一通道（推荐文件模式）
python references/search/gate.py selfcheck 报告.md         # 交付文件末道拦截
python references/search/gate.py log --limit 20            # 查看门禁留痕

• ERROR（无出处数字 / 金额无来源或计算式 / 模糊措辞+数字 / 编码损坏）→ 禁止输出，按 stderr 合规替代重写；
• WARN（价格未声明来源 / 缺实算证据 / 模糊措辞与数字同句）→ 可输出但须按提醒补齐；
• 判定按片段生效：同一句内须自证来源，不会因文中某处写了"例如"而放行全文；
• Windows 下不要用 echo ... | python gate.py（PowerShell 5.1 会把中文变成 ???，门禁将直接拦截并提示改用 --file）。

注意事项

• 你是专业助手，不替用户决策重大商务/法律责任；计算要标注规范依据与数据来源。
• 计算类任务写清步骤，不要只给结果；涉及价格/费率的结果须显式标注"参考值，须对照当地公布数据核验"。
• 单位口径：组价/合价结果的单位标签必须与输入一致（元、万元、元/㎡），严禁把「元」的结果标成「万元」。
• 保密与脱敏：用户提供的合同、结算书、图纸、报价属商业敏感资料，仅限本次任务使用；对外举例一律脱敏。
• 诚实性：题库与案例均为模型自编/脱敏构造，不得声称是官方真题或真实项目；示例占位数据不得用于正式结论。
• 团队形态的协同由 .codebuddy-plugin/plugin.json 驱动；单代理形态见 skills/。

<!–GATE_SOP_START–>

输出前硬门禁（引擎级强制 · 唯一输出漏斗）

你的任何对外输出（含数值 / 规范条文 / 确定性结论）只能经统一门禁 references/search/gate.py 释放，禁止绕过门禁直接输出。

# 唯一 sanctioned 输出路径；ERROR 时不输出，只给合规替代
python references/search/gate.py emit --file 草稿.md

• 退出码 0（PASS/WARN）：已放行，可正常输出；WARN 须按 stderr 提醒补来源或补实算证据。
• 退出码 1（ERROR）：已拦截，严禁输出该内容。改用 stderr 给的合规替代——先 python references/search/authority_search.py "<关键词>" 查到条文号再给数字；或补数据来源；或明确标注「以下为无规范出处的经验估算，仅供参考，不作为设计/审查依据」。
• 铁律：未查权威条款库（references/standards/规范数据库.json）就给具体数字 = 编造，一律拦截；「模糊措辞 + 数字」同样拦截；金额（元/万元/亿元）只标条文而不给数据来源或计算式，同样拦截（条文只能证明计价规则，不能证明本项目金额）。
• 库外显式降级：若 authority_search 未命中，必须在输出中标注「⚠ 超出本团权威库，以下为经验判断，建议查阅规范[编号]，仅供参考」，严禁假装权威。
• 审计留痕：引擎对每次放行/拦截追加记录到 references/search/gate_log.jsonl，可用 gate.py log 查阅。
• 指挥官在汇总子角色结果后，须对最终交付文件再跑一次 python references/search/gate.py selfcheck <文件> 做末道拦截。

<!–GATE_SOP_END–>

v1.11.0 变更要点（相对 1.10.0）——真实输入口径与追溯性

本轮不再修 bug（1.10.0 已清零），只补三类「真实作业里一定会踩」的缺口：表格口径、交付留痕、编排可消费。

1. 两行表头支持（真实送审表刚需）

送审/审定表普遍是「首行大类（合并单元格）+ 次行细目」，原来按单行读会得到一排空列名或重名列而直接失败，用户无解。reconcile.py 新增 --header-rows N（默认 1）：表头按列纵向拼装为 金额/送审、金额/审定 形式；空列名保留为「未命名列N」而不是丢弃（丢列等于悄悄少一个字段，拿它当键比对会得出"全表漏项"的假结论）；重名报错时明确提示「若源表是两行表头，请加 --header-rows 2」。

1. 交付物覆盖前自动留档上一版（追溯链不断）

同名交付物（底稿/台账/报告）被重跑覆盖原来是无痕的——事后无法证明"报告改过没有"。现在写出前若内容与旧文件不同，旧文件自动改名为 *.prev.*（同名只留一份，反复重跑不堆垃圾；内容一致不留档、不产生垃圾文件）。xlsx 改为先写内存再落盘，同时避免 openpyxl 中途失败留下半截文件。

1. --json 结构化输出（给编排和脚本用）

reconcile.py / deliverable.py 支持 --json：前者直接给出差额、匹配/漏项/增项数、是否截断、文件路径与门禁等级；后者给出 9 类交付物的路径、门禁等级与留档清单，便于主理人串流程而不必解析人读文本。

1. 旧版 .xls 给可执行出路

reconcile.py 遇 .xls/.xlsb 不再只说"仅支持 xlsx/xlsm/csv"，而是明确告知这是二进制格式、给出另存为与 pandas 批量转换命令。

1. 文档数字自洽纳入自检（防"代码改了、说明没改"）

content_check.py 新增实测比对：跑全部 9 个 --selftest 与 calc_engine.py --list，把实测函数数、各脚本断言数与 README/SKILL/使用示例/plugin.json 里的数字说法逐一核对，不一致直接报错；加 --with-e2e 连冒烟总数一起核对。数字漂移是文档最隐蔽的失效形态——用户会按旧数字核对而漏件。

1. 显示层小修：浮点残差归零（不再出现「-0.00 元」这种不专业显示）。

v1.10.0 变更要点（相对 1.9.0）——全面检查与加固

版本收敛：此前 _meta.json（1.2.2）与 plugin.json（1.9.0）双轨并行，本轮统一为 1.10.0（同时大于两者，避免本地已装 1.9.0 不触发更新）。此后以 _meta.json 为唯一版本来源。

1. 修复 7 处会导致作业中断的硬缺陷
   • deliverable.py：build_table 在缺 openpyxl 降级 CSV 时未创建输出目录→ 直接 FileNotFoundError 崩溃（9 类交付物全部产不出来）；现统一在任何分支前 makedirs；同时修正"扩展名为 .csv 却按 xlsx 写"的错配。
   • deliverable.py：台账金额 float() 裸转，遇「1,200」「1200万元」「待核」即抛异常；现统一走 _num() 安全解析（千分位/全角/货币符号/单位后缀）。
   • deliverable.py：争议台账在 报送价=0 或非数字时除零崩溃；现按「无法计算占比」如实披露。
   • calc_engine.py：_parse_kv 把全角冒号判断写反了——中文用户输入「工程量核减：60」必报"格式错误"；现兼容 ： 与 =，并补「缺名称/缺数值/数值非法」三类精确报错。
   • ingest.py：ingest_xlsx 的 sheet 名不存在时抛 KeyError 裸栈、且 read_only 工作簿句柄未关闭（批量解析会泄漏）；现给出「该文件包含哪些工作表」的可选清单并 finally: close()。
   • reconcile.py：指定的工作表不存在同样裸崩；现归纳为可读错误。
   • staleness_check.py：注册表格式一旦漂移，正则一条都匹配不上时会输出「全部在有效期内 ✅」——把解析失败伪装成合格（审计级风险）；现改为「有表格行却 0 条解析成功 = 格式漂移」，判异常退出 1，并单列未解析行。
2. 补齐静默丢数据的三处隐患（审计场景最忌讳）
   • reconcile.py / ingest.py：超过读取上限时原来静默只取前 N 行；现返回 truncated 标记 + 中文提示，对量报告正文追加「⚠ 数据完整性提示」段落并声明结论仅覆盖已读取部分。
   • reconcile.py：单元格里出现「1.5万」会被静默解析成 1.5（1 万倍量级错误）；现 fail-closed 报错，要求先在源表统一单位再用 --unit 声明。
   • ingest.py：信息价表原来固定 200 行上限（一张几百行的信息价表会被悄悄截断），现统一走 --max_rows（默认 5000）。
3. 门禁自相矛盾修复（逻辑缺陷）

gate.py 的合规替代方案里写着「可标注『以下为无规范出处的经验估算，仅供参考』」，但 HARD_FUZZY 是全文扫描、不认降级语境——照门禁自己给的建议改稿，仍然会被门禁拦住。现改为逐处判断模糊措辞所在行，命中降级声明则降为 WARN（fuzzy_declared）放行，并提示责任人确认。

1. 每个脚本都有了可独立验证的 --selftest（原来 9 个脚本里 4 个没有）

新增 deliverable.py / reconcile.py / ingest.py / staleness_check.py / issue_pair.py / project_template.py / authority_search.py 的 --selftest，以及 gate.py 新增 selftest 模式（11 条规则用例，同时测"该拦的拦住"与"该放的放行"）。合计自检断言：引擎 110 项、交付 12 项、对量 20 项、解析 10 项、时效 6 项、定性配对 8 项、门禁规则 11 项、检索 7 项、成套档案 6 项。

1. 参数校验与错误返回规范化
   • 比例类参数（--warn_line / --threshold_rate / --coverage_target / --retention_rate / --tax_rate 等）统一校验 0~1，传 3 会明确提示「10% 要写成 0.1」而不是算成 300%。
   • --top / --limit / --max-rows / --days 非正或过大一律拒绝；--func 未知返回 2（参数错误）而非 1。
   • calc_engine.py / reconcile.py 补 except Exception 兜底：任何未预期异常都输出可读 JSON 结论 + 退出码 2，不再裸抛栈。
   • 无参调用一律「打印用法 + 非 0 退出」，绝不进入交互等待（AI 自动调度场景必须如此）；reconcile.py 的 --left/--right 由 required=True 改为软校验，以便 --selftest 可独立运行。
   • issue_pair.py：--selftest 不再被当成查询关键词；未知参数明确拒绝；--json 模式下不再把类别清单混进 stdout 破坏机器解析；条文检索子进程加 60s 超时。
2. 稳定性与可维护性
   • gate.py：留痕文件 gate_log.jsonl 超过 5MB 自动轮转为 .1（原来无上限，长期使用会拖慢 log 查询）。
   • content_check.py：修掉 plugin.json 缺失时 plug 未定义导致的 NameError；题库 18 题复算的子进程加 120s 超时。
   • reconcile.py：逐项金额改为缓存预计算（排序与输出复用同一结果），并让金额解析错误带上具体匹配键；TopN 大额差异改为按绝对差额排序（原按有符号降序，负向大额差异会被排到末尾）。
   • e2e_smoke_test.py：所有子进程加 300s 超时（超时计失败而非挂死整轮），并新增「无参调用不得挂死」「历史缺陷回归」两组用例。
3. 自检口径同步：e2e_smoke_test.py 由 83 项扩到 109 项（新增 9 个 --selftest、5 项无参行为、5 项历史缺陷回归；v1.11.0 再加两行表头、--json 与覆盖留档回归）；引擎断言由 99 项扩到 110 项（新增全角冒号、等号兼容、缺值拦截、数值列表解析与量级单位拦截）。content_check.py 全量（含题库 18 题逐题复算）与 --quick 均通过。

v1.9.0 变更要点（相对 1.8.0）

1. 证据完整性补强（整套档案由 26 份扩到 30 份），新增四件：
   • 04_审计底稿与证据/证据附件页码索引.md：把「报告金额 → 底稿索引 → 附件页码」三步打通；页码自「附件起始页码」按页数连续累加，某一项未填页数即其后页码一律留「（待填）」，须装订后手工补填（不跳页累加、不猜数）；

报告第七节「附件目录」随之自动编号（附件编号 + 对应底稿索引 + 起止页码 + 合计项数与页数）。

• 04_审计底稿与证据/审计日记与工作记录.md：审计日记按日留痕（日期 / 参与人 / 工作内容 / 挂接底稿索引 / 发现问题 / 处理与下一步 / 耗时），另设重要工作记录（会议 / 询问 / 踏勘 / 电话）；结论在底稿、过程在日记，两者须互相印证。
• 01_审前调查与立项/外聘人员与回避记录.md：外聘人员登记（聘请依据 / 承担工作 / 报酬来源 / 保密与独立性承诺）+ 回避情形逐人排查（亲属任职 / 曾任职或提供咨询 / 经济利益往来 / 曾参与本项目编审）。
• 05_问题与争议/整改回访记录.md：回访核实与销号证据（金额类 / 制度类 / 程序类三类凭证）；回访结论须与问题台账「状态」栏一致，不一致以回访核实结果为准并更正台账。

1. 电子数据校验值登记：电子数据取数说明.md 增加「导出时间 / 校验值（SHA-256 / MD5）/ 校验方式 / 校验人」列，并写明登记三件套（导出时间 + 记录数 + 校验值）与「取数时算一次、此后每次使用前重算比对」纪律；

ingest.py 新增 --hash（算 SHA-256 与 MD5）与 --hash --expect（复算比对，不一致退出码 1，失败闭合）。

1. 新增知识库 10_证据完整性与过程留痕.md：三步可查、文件指纹、审计日记、回避与外聘、整改回访与销号、留痕自检 8 条。
2. 自检扩容：e2e_smoke_test.py 增至 83 项（新增新件逐份过门禁、文件指纹生成与 fail-closed 复算比对）；

content_check.py 新增三项一致性校验——「成套模板构件必须真实接线」「成套档案文件数说明必须与实现同步（30 份）」「每个工具必须被至少一份角色定义提到」；项目信息模板扩至 58 个字段。

1. 角色定义与制度文件同步（本轮补齐的老账）：agents/audit-auditor.md（审计明）、agents/audit-settlement.md（结算清）、agents/cost-audit-team-team-lead.md（主理人）补入 v1.6–v1.9 的审计作业过程与留痕能力（成套档案 / 页码索引 / 校验值登记 / 审计日记 / 回避与外聘 / 整改回访 / 问题定性配对 / 对量 / 多项目总台账），审计明新增 3 条本岗禁止（编造页码、把校验值当数据真实的证明、以说明代替销号证据）；references/交付自校验清单.md 红线扩到 15 条、证据项扩到 8 项并补交付前命令；references/执行制度总纲.md 禁止项扩到 16 条并补 2 条条件禁止；references/knowledge/06 补页码索引 / 日记 / 校验值 / 回访销号交叉引用。单代理形态 skills/<角色>/SKILL.md 由 agents/ 重新派生，两形态逐字同源（自检强制）。

v1.8.0 变更要点（相对 1.7.0）

1. 过程留痕六件套（按审计实务补强）：整套档案由 20 份扩到 26 份，新增——

① 04_审计底稿与证据/现场取证记录单.md（两人以上取证、见证签认、编号归档、补记须注明）；② 04_审计底稿与证据/抽样见证记录.md（抽样方法与样本量、见证人签认、结果不符须扩大样本；再次声明非统计抽样）；③ 04_审计底稿与证据/电子数据取数说明.md（数据源 / 取数方式 / 记录数与金额合计完整性校验 / 只读保存）；④ 04_审计底稿与证据/三级复核意见记录表.md（审计员自校 → 主审复核 → 负责人签发，复核意见须具体到索引号 / 金额 / 依据 / 证据并闭环）；⑤ 06_报告与归档/征求意见与沟通记录.md（反馈意见逐条答复：采纳 / 部分采纳 / 不采纳 + 理由，不得以「已沟通」代替书面记录）；⑥ 06_报告与归档/期后事项与追溯调整记录.md（基准日后至签发前的事项：调整 / 披露 / 不处理三选一，写明理由）。

1. 新增问题定性与依据配对 issue_pair.py：问题描述或定性 → 规范数据库条款（标准号 + 条款 + 效力 + 适用条件 + 要点）+ 常见处理 + 证据要求；映射文件 references/data/问题定性与依据映射.json（18 类定性、110 个关键词、35 处条款引用）与规范数据库同源，自检校验漂移；未命中退出码 1 并转向 authority_search.py，绝不编造条款。问题整改台账同步新增「建议依据（须核实）」列，逐条自动配对。
2. 新增多项目总台账 project_template.py --portfolio <目录>：扫描目录下所有 项目信息.json，汇总为总台账（xlsx + md）——项目 / 阶段 / 送审与审定 / 审减额与审减率 / 问题数与未销号数 / 争议数；缺项留「（待填）」，合计只累计有值的行。
3. 实施方案补强：第三节新增重要性水平与确定口径（工程审计常用「金额阈值 + 覆盖率」，财政 / 内审另有规定从其规定）。
4. 新增知识库 09_审计取证与复核要点.md：取证三原则、证据形式与强度、抽样见证、电子数据完整性校验、三级复核、征求意见逐条答复、期后事项、复核最常挑出的 10 个缺陷。
5. 自检扩容：e2e_smoke_test.py 扩到 71 项（新增档案逐份过门禁、问题定性配对命中与库外降级、多项目总台账）；content_check.py 新增两项校验——问题定性与依据映射必须与规范数据库同源、包内工具脚本必须全部登记在 plugin.json。

v1.7.0 变更要点（相对 1.6.0）

1. 新增审计项目成套模板 project_template.py：把「审计实施方案」接到真实项目档案上——一条命令生成六卷固定目录 + 00 项目索引的整套档案（20 份文件，含表格）：

① 01_审前调查与立项（审前调查表 / 独立性声明与保密承诺 / 审计组分工与联系方式）；② 02_审计实施方案（共十四节：编制依据·目标·范围与内容·方法与程序·检查范围与抽查方案·进度·分工与三级复核·质量控制·配合事项·交付物清单·计价依据版本·重点风险领域与应对措施·方案调整与报批·编制/复核/批准签署栏）+ 检查范围与抽样方案表；③ 03_资料索取与交接（资料索取清单 PBC / 资料交接签收单）；④ 04_审计底稿与证据（底稿目录与索引规则 / 审计底稿 / 证据清单与证据链台账）；⑤ 05_问题与争议（问题整改台账 / 争议事项台账）；⑥ 06_报告与归档（审计报告征求意见稿骨架 / 卷内目录与归档说明）。

1. 缺数据一律留「（待填）」，绝不代填；补全后重跑同一条命令即可整体刷新；生成的每份 Markdown 逐份过输出门禁，未放行的文件会被列出并返回非 0 退出码。
2. 检查范围不凭空给：实施方案第五节的必查/抽中/未覆盖由引擎 sample_plan 实算，并写明「非统计抽样」的口径免责；未提供检查范围明细时，如实说明尚未生成及生成规则。
3. 新增知识库 08_审计项目档案与成套模板.md：六卷结构、索引规则（W-/I-/D-）、「（待填）」纪律、归档与保密要求。
4. 可填写模板 templates/项目信息表.template.json：与代码中的 TEMPLATE 同源，content_check.py 会自动校验两者一致（模板漂移即报错）。
5. 自检扩容：e2e_smoke_test.py 扩到 54 项（新增成套档案生成 + 三份档案文件过门禁 + 模板字段完整性）；content_check.py 新增「模板同源」校验；解包验证脚本新增成套档案用例。

v1.6.0 变更要点（相对 1.5.0）

1. 补齐审计作业过程能力（本轮主线）：原版本只到"算得准"，缺"作业过程怎么落地"。新增 4 个引擎函数——audit_attribution（审减归因：把审减额精确拆成工程量核减 + 单价核减，量差+价差 ≡ 审减额，可反向验算）、reconcile_check（勾稽校验：分项合计 vs 报表汇总，差额超允差即判定不一致，禁止以"四舍五入/尾差"解释）、sample_plan（检查范围方案：大额必查 + 覆盖率控制，明确非统计抽样）、material_adjust_weighted（多期用量加权材料调差）。
2. 新增对量工具 reconcile.py：送审 / 审定两版明细（xlsx / xlsm / csv）按项目编码逐项比对，自动拆出量差 / 价差 / 漏项 / 增项并做四项闭合校验（差值 ≡ 总差额），输出差异明细 xlsx + 分析报告 md，自带门禁自检。
3. 交付物由 4 类扩到 9 类：新增审计底稿（索引 + 检查程序 + 证据 + 依据 + 金额 + 结论 + 编制/复核签署，清单表逐行自带「证据与数据来源」列）、审计实施方案（检查范围，调用引擎 sample_plan）、资料索取清单 PBC、问题整改台账（含销号状态）、争议事项台账；python deliverable.py 一键产出 9 类并逐份过门禁。
4. 知识库补 2 篇作业向内容：06_审计底稿与证据链.md（底稿九要素、证据分级与证据链四点闭合、三级复核、必做勾稽与归因两道验算、审计范围限制披露、台账销号闭环）、07_签证与变更审查要点.md（变更/签证/索赔边界、变更审查五步、签证有效性要件清单、高频虚报手法对照表、索赔三关）。
5. 角色与门禁自检同步：审计明 / 结算清 / 索赔通 的职责、工具与交付物清单同步本轮新增能力；单代理 skills/<角色>/SKILL.md 由 agents/ 重新派生；e2e_smoke_test.py 扩到 42 项（9 类交付物逐份过门禁 + 对量闭合校验）；content_check.py 新增文档/代码/配置一致性检查（文档里写的 --func 与脚本必须真实存在、plugin.json 角色与工具必须存在、单代理 SKILL 与 agents 定义逐字同源、知识库索引收录全部文件、章节编号连续）——该检查上线即抓出 2 处文档引用不存在函数的漂移（文档把引擎函数名写成了 qty_deviation，实为 qty_deviation_adjust）。
6. 修掉一处交付物门禁误伤：审计底稿清单表原先同一行「条文 + 金额」被判为"金额只标条文、无来源"，现改为每行显式标注「数据来源 + 证据」，并新增 _flat() 压平单元格内句读，避免整行被拆段导致误判。

v1.5.0 变更要点（相对 1.2.1 / 内部 1.4.1）

1. 门禁重写：修复"整篇豁免"漏洞（原来只要文中出现"例如"就放行全部数字）、修复日期误判（2026年9月被视为编造数字）、修复管道中文乱码导致门禁失效、修复模糊词一刀切；改为片段级判定 + 编码损坏拦截 + 文件模式 + log 留痕查询。新增金额可溯源规则：金额（元/万元/亿元）只标规范条文、不给数据来源或计算式的，一律拦截——条文只能证明计价"规则"，不能证明"本项目的金额"；并修复"合同约定/合约"中的"约"被误判为模糊措辞（原会误杀"约定时效 28 天"这类正常表述）。
2. 计算引擎修复与扩展：修正材料风险幅度三档规则（原实现只有单一情形，投标价高于基准价时会算错）、修正调值公式风险幅度语义（改为"超出部分据实调整"）、修正组价单位标签（原来把"元"标成"万元"）、修复 CLI 魔法值导致参数无法覆盖；修正逾期付款利息「约定利率被擅自替换为 LPR」的错误口径（改为有约定从约定、仅在提示中警示）；新增工程量偏差 ±15% 调价、造价汇总、预付款扣回、质保金、逾期利息、按当地真实价格组价、索赔时差扣减与最终报告时限。
3. 规范库与法规时效：规范库由 13 条扩到 31 条并加 applies_to/validity（新增不平衡报价识别、措施费结算调整、甲供材计价与扣除）；检索由整词匹配升级为分词打分（原实现问「材料风险幅度」会误报库外）；更正逾期付款利息「约定利率不得低于同期 LPR」的错误表述；修正"禁止套用 2013 版"的错误硬规则，改为合同约定优先；更正审计法修正年份与增值税法施行日期等待核验项并统一标注 ⚠️。
4. 两形态同源：单代理 SKILL 由 agent 定义派生，消除重复段落与能力缺失。
5. 资源真实性：案例库由占位符改为 5 个可复算的教学案例；题库重编为 52 题（计算题答案由引擎实算生成）；删除"avatars/""10+ 真实案例""106 题"等与实际不符的表述。
6. 新增纪律：保密与脱敏、诚实性（禁止虚构案例来源）、示例数据禁用规则、单位口径铁律。
7. 新增自检与实证：新增 content_check.py（全包完整性 + 题库 18 道计算题逐题现场复算）；deliverable.py 由只演示 1 类交付物改为 4 类全部演示并逐份过门禁（该改动当场暴露并修复了门禁的两处缺陷）；题库计算题答案全部按现场实算重写，确保与引擎输出逐字一致。