报价单方案合理性自检

# 报价单方案合理性自检 ## 你遇到的痛点 - 报出去的价，客户一算发现「合价和单价对不上」，信任瞬间掉一半，单子黄了。 - 自己手抖把单价填成 0、数量为负、合价漏算，等到对账才发现，利润被吃光。 - 报价单只写了价格，没写质保、没写工期，验收后扯皮、无限期拖延，钱收不回来。 - 工程/外包/服务类项目动辄几十上百行清单，肉眼逐行对 合价=数量x单价 又慢又容易漏，请造价/财务审一份也不划算。 ## 这个技能能做什么 报价单方案合理性自检是一个**带真实代码的命令行程序**（非空壳），你只要把报价存成 `.csv` 跑一条指令，它就替你做四件事并产出结构化报告： 1. **合价逻辑矛盾**：逐行校验 `合价 是否等于 数量 x 单价`，差 1 元或 1% 以上即报「高」级矛盾。 2. **单价/数量异常**：单价为空/为0/为负、数量为空/为0、合价缺失，逐一标出。 3. **条款缺失**：缺「税率/含税价」列或税率整列空白 -> 税务不透明风险。 4. **风险点识别**：全文缺「质保/售后/保修」关键词 -> 缺失质保条款；全文缺「工期/交付」关键词 -> 缺失交付周期约定。 最终输出 **报价健康分（0-100）+ 自检结论（健康/基本合理/存在隐患/严重）+ 涉及项目 + 按优先级排序的优化清单**，支持 Markdown / JSON / CSV 三种格式，可直接贴进工作流或二次处理。 ## 四步出片（照做即得结果） **第一步：准备报价 CSV** ```bash # 支持 .csv；.xlsx 请先用 Excel/WPS 另存为 CSV（UTF-8） # 典型列：序号,项目,数量,单位,单价,合价,税率,备注 ``` **第二步：跑自检（核心指令）** ```bash python quote_audit.py check 报价.csv ``` 程序输出： ``` [OK] Markdown 自检报告: ./output/报价_quote_report.md [概览] 健康分 64/100 ｜ 存在隐患（建议复核关键矛盾项） ｜ 高3/中3/低0 ``` **第三步：拿到自检报告** 默认在同目录 `./output/报价_quote_report.md` 生成完整报告（四张检查表 + 优化清单）。也可： ```bash python quote_audit.py check 报价.csv --format json # 机器可读 python quote_audit.py check 报价.csv --format csv # 表格 ``` **第四步：按建议改稿** 照报告中的「优化清单（按优先级）」逐条修订：先把合价算错、单价异常的「高」项改对，再补质保与工期条款，改完再跑一次看健康分是否上升。 ## 四维度检查体系 | 维度 | 检查内容 | 典型产出 | |---|---|---| | 逻辑矛盾 | 合价 与 数量x单价 不一致 | 价格正确性 | | 数据异常 | 单价/数量为空/0/负、合价缺失 | 录入完整性 | | 条款缺失 | 税率/含税价列缺失或全空 | 税务透明 | | 风险点 | 缺失质保条款 / 缺失交付周期 | 售后与履约风险 | ## 输出报告字段 - **概览**：报价健康分 / 自检结论 / 行数 / 高·中·低风险数 / 涉及项目 - **一、逻辑矛盾**：优先级 / 项目 / 问题 / 建议 / 依据 - **二、数据异常**：同上 - **三、条款缺失**：同上 - **四、风险点**：同上 - **五、优化清单**：按 高->中->低 优先级排列 ## 适合谁用 - 外包/自由职业者：投标前自查报价，避免算错价、漏写条款被压价或赖账。 - 工程/装修/服务公司报价岗：批量审多份清单，快速定位矛盾行。 - 采购/甲方：反向核验供应商报价单的逻辑自洽性。 - 创业者/小微企业主：没有专职造价/财务时的「第一道防线」。 ## 注意事项（必读） - **规则引擎，非专业意见**：本工具基于数值校验与关键词匹配，能识别常见硬伤，但**无法判断报价高低是否合理、利润是否健康**。结论仅供改稿参考，重大报价请结合人工复核。 - **有可能误报/漏报**：如果你用了词表之外的说法（例如把「保修」写成「质量保障」），质保检查可能误报。关键词都是普通 Python 列表（`WARRANTY_WORDS` / `SCHEDULE_WORDS` 等），按自己行业增删即可。 - **健康分只用于横向比较**：健康分 = 100 - 各优先级扣分（高8/中4/低2），下限 0。**分低不等于报价不能用**，只说明「这份报价单文档有坑没填」；反之分高也不代表利润合理。 - **仅读文本/CSV**：支持 `.csv`。`.xlsx` 需先另存为 CSV（程序会明确提示并退出）。 - **隐私**：程序纯本地运行，不联网、不上传，报价单不会外泄。 ## 触发词 报价单自检、报价检查、报价核对、报价合理性、报价方案、合价校验、单价校验、数量单价、报价逻辑矛盾、漏项、缺项、质保条款、售后条款、工期、交付周期、外包报价、工程报价、服务报价、投标报价、成本核算、报价模板、报价风险、免费、开源 ## 文件清单 - `SKILL.md` — 本文件 - `examples/quote_audit.md` — 主程序完整源码（复制为 `quote_audit.py` 即可运行，纯标准库无依赖） - `examples/sample_quote.csv` — 样例问题报价单（含合价算错、单价异常、缺质保/工期，用于自测） - `examples/usage.md` — 详细使用说明、参数、评分规则、排错与规则扩展 - `examples/example_output.md` — 真实示例输出（对样例报价单实跑得到的自检报告）