招标文件解读-比地招标网

概述

招标文件解读 SKILL

定位与边界

本 skill 处在招投标工作流的中间层，做解读而非解析：

一句话：parser 告诉你"标书写了什么"，本 skill 告诉你"这意味什么、怎么投、哪里会死"，rejection-audit 在你写完标书后兜底。

触发条件

• 关键词：解读招标文件、帮我看看这份标书、这标能不能投、标书坑在哪、标书风险点、标书白话版
• 上传/提供招标文件（PDF/DOCX/TXT）或其解析报告
• 提供招标文件文本内容

输入约定（重要）

本 skill 不重复做 PDF 字段抽取。获取标书内容按优先级：

1. 用户提供 parser 的 Markdown 报告路径 → 直接读取（含页码标注，最推荐）
2. 用户提供原始 PDF/DOCX/TXT → 用 @pdf / @docx skill 或 Markdown Converter 提取纯文本（页码可为空）
3. 用户直接粘贴文本 → 直接使用

工作流程

步骤 1：获取标书内容

按"输入约定"拿到标书文本（或 parser 报告全文）。本 skill 的解读与渲染只需要纯文本，PDF/DOCX 抽取不是硬依赖——没有 bidding-document-parser 也能完整运行，只是少了页码标注。

• 最稳妥（零外部依赖）：直接把标书内容粘贴进对话，或上传 PDF/DOCX 让 WorkBuddy 用 @pdf / @docx 直接读取（页码字段留空即可）。
• 带页码（可选，需 bidding-document-parser）：若本机已装该 skill，可用它的抽取脚本生成带页码文本（页码能回填到解读条目）。路径用 $HOME 保持可移植：

  PYBIN="$(command -v python3 || true)"
  SCRIPT="$HOME/.workbuddy/skills/bidding-document-parser/scripts/extract_pdf_with_pages.py"
  if [ -f "$SCRIPT" ] && [ -n "$PYBIN" ]; then
    "$PYBIN" "$SCRIPT" "<标书.pdf>" "标书原文_带页码.txt"
  else
    echo "未安装 bidding-document-parser（可选）：请直接粘贴标书文本，或上传 PDF 让 WorkBuddy 读取"
  fi

该脚本依赖 pdfplumber；缺它不影响本 skill 运行，只是少页码。

• 用户已给 parser 报告 / 粘贴文本：直接读取使用。
• 若实在无法抽取：提示用户直接粘贴文本。

步骤 2：七层解读（核心）

1. 读取 references/interpretation_prompt.md，将标书文本插入模板的 [在此插入标书文本] 位置。
2. 按七层框架（白话翻译 / 废标红线 / 资格自检 / 评分策略 / 隐性陷阱 / 时间轴 / 澄清问题）产出解读，并严格按文末 JSON Schema 输出 interpretation.json。
3. JSON 字段不全时填空数组/空字符串，不要省略章节。

步骤 3：生成交互式 HTML 报告

使用纯标准库脚本将 JSON 渲染为带可勾选清单的交互式 HTML（废标红线清单、资格自检表、待办清单均带勾选框 + 进度条）。

cd "[skill目录]/tender-doc-interpreter"
python3 scripts/build_report.py "interpretation.json" "招标文件解读报告_[项目名]_[YYYYMMDD].html"

• 输入：interpretation.json（步骤 2 产出）
• 输出：招标文件解读报告_[项目名]_[YYYYMMDD].html（保存到当前工作空间根目录）
• 无第三方依赖，离线可用

可选：若需要 Markdown 版，将 JSON 同步整理为 招标文件解读报告_[项目名]_[YYYYMMDD].md。

步骤 4：交付

用 present_files 打开 HTML 预览。向用户说明：废标红线清单与待办清单可在浏览器里逐项勾选，进度条实时统计，打印即交付。

工具与依赖

报告视觉风格（重要）

渲染出的 HTML 严格对齐比地「预测投标人」报告设计系统，确保品牌统一：

• 比地 logo 内联 SVG（蓝色 #3083EB / 橙色 #FA5401）置于品牌头，离线可用、不依赖外部图片文件。
• 设计变量与组件：浅蓝基调（--bg:#f6f8fb、蓝 #1f5fbf、红 #c93434、琥珀 #b8841c、绿 #1f8a4c）、品牌头、粘性目录、Hero 项目卡、章节卡片、.tw 表格、KPI 卡、verdict 卡、时间轴、页脚声明。
• 结论前置：报告顶部"核心结论（先看这 4 个数）"KPI 卡（决策建议 / 高危废标红线 / 硬性资格待确认 / 高优待办），先于细节。
• 同时保留用户要求的可勾选清单：废标红线（勾选"已落实"）、资格自检（状态下拉）、待办（勾选"已完成"），均带进度条 + localStorage 本地保存 + 打印导出。
• 报价策略测算器（内嵌交互组件）：在第四层评分策略下，依据 price_model 结构化字段（价格权重/算法/扣分率/最高限价），提供"输入基准价与拟报价→实时算偏离率与价格得分、扫描报价区间标出满分点、给出稳健推荐价"的小工具，把"解读"转化为"能下单"。支持中间价法/低价优先法/基准价法。

注意事项

1. 页码：若输入来自 parser 报告，解读条目尽量带 Pxx 页码；纯文本无页码时该字段留空。
2. 资格自检的局限：本公司资质需用户补充（或引用 bid-knowledge-base / 公司档案）。输出"资格符合性自检表"时，self_check 列默认留"待确认"，由用户勾选真实情况，skill 不替用户伪造"已满足"。
3. 不替用户决策硬下结论：决策段给出建议档位 + 理由 + 关键风险，但最终投否由用户定。
4. 大文件：标书超长可分段解读后合并到同一 JSON。
5. 歧义条款：理解有歧义时，归入"澄清问题清单"而非武断下结论。
6. 风格红线（沿用比地报告规范）：正文禁用内部术语（如 BID-/接口/token/API 等），缺失字段写"—"、脚注"以正式招标文件为准"，页脚含演示数据/免责声明。