材料审查神器·逐条有出处

概述

材料审查神器

一页说明

• 给谁用：手上有一份"要求"、要拿它去审一批材料的人——招标采购的资格审查、供应商准入预审、报销审核、外贸单证（信用证、发票、装箱单）核对、质量验收资料检查、行政审批材料预审。
• 解决什么问题：要求一多就容易漏条；证书有效期、大写金额、数量、公司全称这些细节靠人眼对，常常看漏；审完写意见时说不清"依据哪条、证据在哪一页"，对方来问也答不上；对方补件后又得从头再审一遍。
• 原来几步：通读规则自己列清单 → 逐份翻材料找对应内容 → 手算金额、比日期 → 在表格里记结论 → 另写审查意见和补正通知。
• 用了以后：给规则和材料 → 确认一次检查项和含糊条款怎么处理 → 拿到审查矩阵、补正清单和初审意见。对方补件后，把新材料放进去重跑后半段即可复审。
• 产出长什么样：
  • 审查矩阵.xlsx / .csv：每个检查项一行，写清规则原文和出处、判定（颜色区分）、证据所在文件和位置、证据原文、脚本比对结果、说明、补正要求。另有"规则覆盖""脚本比对""材料清单"三个工作表。
  • 检查项清单.csv：规则原文 → 可判定的检查项，下次审同类材料可以直接复用。
  • 缺件与补正清单.md：给被审方的补正通知草稿，列出缺什么、哪里不符合、依据哪条。
  • 审查意见.md / .docx：一页初审意见：结论、各判定数量、不符合和缺证据逐条带出处、需审核人判断的事项、无法识别的材料，末尾留审核人签字栏。

样例见 examples/：一份虚构的采购资格要求、一家虚构投标方的 9 份材料（md、docx、xlsx、图片），里面埋了真实工作中常见的问题。

判定只有五种

所有结论都只是初审意见，最终结论由审核人签字。

运行环境

• 脚本都在本技能的 scripts/ 目录，只用 Python 3 标准库，不用装任何包。命令默认在本技能根目录（有 SKILL.md 的目录）运行；由助手执行时先定位技能目录，工作目录和输出目录用用户指定的路径（含空格加引号）。macOS/Linux 上 python 通常写成 python3。Windows 下输出中文乱码时先设环境变量 PYTHONUTF8=1。
• 先跑一次自测：python scripts/rules_to_items.py --selftest、python scripts/evidence_index.py --selftest、python scripts/cross_check.py --selftest、python scripts/matrix_export.py --selftest。
• 能读的材料：.md .txt .csv .docx（正文、表格、文本框、页眉页脚）.xlsx。
• PDF：环境里装了 pypdf 就自动读文字层；没装或是扫描件，脚本会列为"读不了"。处理办法二选一：让用户另存为 docx 或复制文字；或者由能读 PDF / 看图的助手把每页文字逐字转录成 原文件名.txt，每页前加一行 === 第N页 ===，文件开头注明"转录自 原文件名"，再放进材料目录。转录件在审查意见里要注明是转录。
  • 可选增强：需要直接读取文字版 PDF 且有 uv 时，在技能根目录执行 uv venv .venv，再执行 uv pip install --python .venv -i https://mirrors.cloud.tencent.com/pypi/simple pypdf。后续命令的 python 改为 macOS/Linux 的 .venv/bin/python 或 Windows 的 .venvScriptspython.exe。没有 uv 或安装失败时继续使用上述文字版方案；不安装也能完成 docx/xlsx/md 主流程。
• 图片、扫描件、旧版 .doc/.xls：脚本读不了，按上一条处理，或者在审查意见里列为"无法识别"，不猜内容。
• 没有 Python 的环境：本技能做不到逐字回查和可靠比对，告诉用户需要能运行 Python 的环境，不要改成凭印象判定。

工作流

每步有检查点，过不了不往下走。要问用户的一次问完，问的同时先做不依赖答案的部分。下面用 工作目录 指一个专门放本次审查中间文件的新文件夹。

第 1 步：收材料，问清楚三件事

需要：

• 规则：招标文件的资格和响应条款、准入清单、报销制度、验收标准、信用证条款等，可以多份。只要相关章节，不用整本。用户粘贴的文字先原样存成 .md。
• 待审材料：放在一个文件夹里。
• 一次问清：① 被审对象是谁（公司名或单据批次）；② 规则里有没有本次不适用的部分；③ 有没有已经定好的口径（例如"近三年"从哪天算、金额是否含税、容差多少）。

检查点：规则和材料是对应的（同一个项目、同一批单据）。对不上就停下来问。

第 2 步：规则拆成条款和检查项

python scripts/rules_to_items.py 工作目录 规则文件1 [规则文件2 ...]

得到 规则条款.csv（每条一行，编号 R001…，标了"要求 / 背景"、含糊词、多份规则间的重复）和 检查项清单.csv 草稿（每条要求先对应一个检查项 C001…）。

然后改写 检查项清单.csv（直接编辑这个文件）：

• 把"检查项"改成能判定的一句话，一项只查一件事。一条规则里藏了几件事的拆成几项，"对应条款"写同一个 R 编号；几条规则其实是一件事的合并成一项，"对应条款"用分号写多个。
• "需要的证据"写清到材料里找什么（如"证书上的有效期截止日"）。"判定方式"只是提示，脚本不读，可以不改。
• 脚本按句号、分号拆句，同一条规则被拆成两条、其实说的是一件事的（如"原则上……；有轻微违规的，视情况认定"），合并成一个检查项。
• 背景条款（项目概况、交付日期、截止时间）不需要检查项，但比对时可以引用它们的原文。
• 规则分场景的检查项写法见 references/场景检查要点.md。

检查点：

• 每条"要求"条款都被至少一个检查项接住。脚本把句子当"要求"的规则偏宽，确实只是说明文字的，也建一个检查项判"不适用"并写理由，不要删条款。
• 含糊词条款（脚本已列出）不擅自定口径：用户在第 1 步给了口径的，写进判定的"口径"字段；没给的，判"需人工判断"。
• 规则之间互相冲突（两份文件对同一件事要求不同），列出来问用户以哪份为准；问不到的判"需人工判断"。

第 3 步：材料切段建索引

python scripts/evidence_index.py build 工作目录 材料文件夹

每份材料切成带位置的小段（S0001…，位置是"段3""表1 第2行""工作表名 第4行""第2页 第5行"），写进 证据索引.jsonl；材料概览.md 列出每个文件读到几段、哪些读不了。

检查点：

• 段数明显偏少的文件（几页的证书只读到一两段）要打开看看，可能大部分是图片。
• 读不了的文件一次性告诉用户：要么补文字版（按"运行环境"里的办法），要么同意在意见里列为"无法识别"后继续。用户补了就重跑本步。

第 4 步：逐项找证据

对每个检查项，用关键词搜材料，再看原段：

python scripts/evidence_index.py search 工作目录 有效期 截止 至 [--file 证书]
python scripts/evidence_index.py show 工作目录 S0014

• 每个检查项至少换两三组同义词搜（"授权/委托""有效期/截止/至""质保/保修"），确实搜不到才算缺证据。
• 证据照抄原文，只抄能证明这一条的那一小段（一个日期、一个金额、一句话），不改写、不概括。脚本会逐字回查。表格行照 show 显示的样子抄，竖线可带可不带。
• 一个检查项可以有多条证据，来自不同文件的要都列上（例如"授权书上的名称"和"营业执照上的名称"）。
• 规则要求"几份""几个月""几个项目"的，先用第 5 步的日期、金额比对逐份确认是否满足条件，再只把满足的列进"计数"，不只数个数。

第 5 步：金额、日期、数量、名称交给脚本比对

凡是判定依赖数字、日期或名称是否一致的，写进 工作目录/比对.json，不心算：

python scripts/cross_check.py 工作目录

常见的比对：证书有效期 ≥ 交付日或截止日；大写金额 = 小写金额 = 明细合计；明细逐行 数量 × 单价 求和 = 合计；报价 ≤ 限价；数量 = 需求数量；发票金额 = 合同金额；授权书 / 发票 / 装箱单上的公司全称 = 营业执照全称；业绩合同签订日 ≥ 起算日、金额 ≥ 门槛。写法见 references/比对与判定写法.md。

检查点：屏幕上"无法比对"必须是 0。脚本报"原文不在某段里"的，用 show 看原段后照抄；报"有多个数"的，把引用截短到只含一个数；只有年月没有日、两边币种不同的，问用户口径，用 {"值": ..., "说明": ...} 写明。

第 6 步：写判定，脚本校验

把每个检查项的判定写进 工作目录/判定.json（格式见 references/比对与判定写法.md），然后：

python scripts/matrix_export.py check 工作目录

脚本会挡下这些情况，逐条告诉你改哪里：有条款没被检查项接住；有检查项没判定；判"符合 / 不符合"却没有证据；引用的原文在那一段里找不到；缺证据没写补正要求；含糊条款没有用户口径却直接判了符合或不符合；脚本比对不成立却判了符合。

检查点：校验通过才往下走。不要为了通过校验去改证据原文，原文找不到说明证据有问题，回第 4 步重找；找不到就改判"缺证据"。

第 7 步：出结果，交付

python scripts/matrix_export.py export 工作目录 输出目录

交给用户：

1. 审查意见.docx（和 .md）：给审核人看、签字。
2. 审查矩阵.xlsx：逐项明细，可筛选。
3. 缺件与补正清单.md：发给被审方前请审核人确认措辞和期限。本技能不替用户发送。
4. 检查项清单.csv：下次审同类材料可复用（第 2 步直接用它，跳过改写）。
5. 对话里一段说明：共几个检查项、各判定几项、条款覆盖几/几；不符合和缺证据各挑最重要的说一句；哪些需要审核人判断、为什么；哪些材料没能识别。

复审：保留上次工作目录和输出目录的副本，再把新材料放进材料文件夹，从第 3 步重跑。规则未变时可沿用检查项清单；重建索引会重新分配 S 段号，必须逐条核对 比对.json 和 判定.json 的全部引用，按文件、位置和原文更新段号，不能直接沿用旧段号或比对结果。重跑第 5、6、7 步，复审结果另存到新输出目录。

边界

• 只做初审。结论统一写"初审意见"，最终以审核人签字为准。
• 不做法律意见：合同条款的法律风险、违约责任是否公平，不在本技能范围。
• 不审广告文案是否合规，不评价制度或流程文件本身写得好不好。
• 不联网核验资质真伪、不查企业信用、不判断证书是不是伪造的；只核"材料里写的"是否满足"规则里要求的"。需要核真伪的，在意见里提示审核人去官方渠道查。
• 不改原材料，所有产出另存到输出目录；补正通知只出草稿，不自动发送。
• 规则含糊或冲突时不替用户定口径；材料读不了时不猜内容。

参考文件

• references/比对与判定写法.md：比对.json 和 判定.json 的完整写法、取值来源、组合计算、常见比对写法
• references/场景检查要点.md：招标资格审查、供应商准入、报销审核、外贸单证、验收资料、标签文字六类场景常漏的检查项
• scripts/rules_to_items.py：规则拆条款、标含糊词和重复、出检查项草稿；--selftest
• scripts/evidence_index.py：材料切段建索引、搜索、看原段；--selftest
• scripts/cross_check.py：金额（含中文大写）、日期、数量、名称的确定性比对，引用原文逐字回查；--selftest
• scripts/matrix_export.py：校验判定，出审查矩阵、补正清单、初审意见；--selftest
• scripts/md2docx.py：Markdown 转 Word，标准库实现
• examples/：虚构的资格要求和 9 份投标材料；期望要点.md 是埋的问题和答案；工作目录/、输出/ 是按本流程实际跑出来的结果

方法来源

方法参考：千问办公 AI 生产力大赛中材料审查类案例的共性方法。本技能的结构、文字和代码均为原创。

跑示例前先还原示例文件：SkillHub 不收表格、Word、邮件文件，上架包里的示例改成了文本格式。在技能目录下执行一次 python scripts/restore_examples.py（只用标准库）即可还原。

关于路路有为

本技能由路路有为出品，属于「路路有为 · 办公 AI 技能」系列。我们专注把 AI 接进企业真实的工作流程——报价、对账、核数、评审、调研、复盘——每个技能发布前都经过脚本自测、盲测和干净环境验收。想按你们的流程、模板和数据定制，在 SkillHub 搜索「路路有为」进入团队主页联系我们。