投标文件生成技能

概述

本技能用于生成投标/竞价技术应答文件，涵盖从文档提取、格式分析到最终文件输出的全流程。核心原则：绝不编造任何内容，所有信息必须有来源，所有来源必须可追溯。

> 技能自进化机制：每次实战后回填 references/lessons.md（赢的招/丢的分/过时阈值）；行业专项、防错清单、废标雷区、澄清函模板、合规红线均已外置到 references/ 便于独立维护；当前版本见 frontmatter version 字段。

> 可编排 / 可集成：技能不只是聊天窗口驱动——scripts/run_pipeline.py 一条命令跑完整流水线（extract→price→generate→verify→compare→backfeed），scripts/serve.py 提供标准库 HTTP API 供你们自有系统直接调用。集成契约与退出码见 references/integration.md。

🆕 新手？先读这一页（3 步速通）

> 不想啃长文档？直接读 references/QUICKSTART.md——它把全流程压成「给文件 → 答 3 问 → 收 docx」三步，零代码、零术语。本技能绝大多数能力新手用不到，走通这三步就够了。

• 📄 PDF / .docx / .xlsx 都能直接给，PDF 不用先转格式（extract_documents.py 已原生支持 PyMuPDF 抽取）。v1.3.4 起 PDF 默认保留阅读顺序与多栏结构、章节标题写成 Markdown、表格转 Markdown；扫描件自动尝试 OCR（需本机装 Tesseract，缺失则报 E022 降级）。但仍是"文本级"还原——不保像素版面、不建章节目录树，加密件须先解密（完整说明见「工作流程」PDF 说明）。
• 🛑 拿不准就选默认：编制模式选 🟦🟩 融合型、编号体系选 enterprise、歧义处理选「发函」。
• 🔍 进阶才需要深入 references/workflow_guide.md；遇到废标 / 合规疑问查对应专项文件。

🧭 技能导航与使用路线

> 本技能文档较长。推荐节奏：先读本节导航 → 按步骤干活 → 遇细节跳对应章节，不要从头到尾硬啃。每个主流程步骤开头都有 📂 衔接 指针，直接带你跳到 references/workflow_guide.md 的对应节。

一、文档三层结构（先认清在读哪一层）

二、两条阅读路线

• 🆕 新手第一次：① 读本节 → ② 通读「核心原则」（11 条，是不可逾越的纪律）→ ③ 扫一遍「工作流程」第 1–8 步标题级建立全局感 → ④ 真干活时再按步骤查 workflow_guide.md 细节 → ⑤ 不确定「怎么调 / 用什么方式」先看下方「如何调用本技能（调用方式总览）」，常见疑问查文末「常见问题解答（FAQ）」与 references/faq.md。
• ⚡ 实战干活：每步开头的 📂 衔接 指针直接跳 workflow_guide.md 对应节；开工前先判断项目类型，命中下表则提前读专项文档再开工。

三、专项文档调用速查表

> ⚠️ 调用方式不一致提醒：只有「造价咨询」是独立专项技能，需 Skill 加载；其余 5 个直接 Read references/ 文件即可，不要误以为也要 Skill 调用。所有专项都只补充该品类的评分结构 / 价格公式 / 反面红名单，主流程仍按本技能走。完整调用步骤与对比见下方「如何调用本技能（调用方式总览）」C 节。

四、主流程 ↔ workflow_guide 衔接总览

五、自进化闭环在哪跑

• 复盘数据池：references/lessons.md（赢的招 / 丢的分 / 过时阈值）。
• 标后回灌：scripts/post_bid_backfill.py（向导 / 自动 / 手动三模式）→ scripts/backfeed_lessons.py 写结构化块。
• 策略推荐：scripts/recommend_strategy.py（攒够 10+ 条后按项目类型推荐编制模式 + 报价区间）。
• 知识库反哺：references/kb_backfeed_readme.md + scripts/kb_backfeed.py（每月把 IMA 法规 / 案例反哺进 references/）。
• 复盘提示词（任务级成败记忆）：详见文末「复盘提示词」节——每次实质性任务后向 references/retrospective_log.md 追加结构化复盘（含可选 IMA 向量化），下次任务启动自动检索相关历史带入上下文。这是覆盖「技能维护 / 审计 / 上传 / 模拟」等一切任务的最通用一层。
• 防退化：改完脚本跑 scripts/smoke_test.py，全绿才算收工。

投标作战五步法（总纲）

> 先读这一节再干活。下面五步是"读标→定策→编制→合规→定稿"的业务决策框架，统领「工作流程」第 1–8 步。每一步的具体操作、脚本、模板都在 references/bid_methodology.md 和 references/workflow_guide.md，本节约等于"作战地图"。

五步速记：读透 → 算清 → 写准 → 堵漏 → 交叉。详细动作清单、常见陷阱（含"价格公式必须原文禁假设""实质性要求一票否决无差不多"等红线）与每步指向的 workflow_guide.md 章节、脚本，见 references/bid_methodology.md。

如何调用本技能（调用方式总览）

> 很多用户卡在「这技能到底怎么调」——尤其是造价咨询类。本节约等于一份「调用说明书」，照着选即可。

三种调用方式，按你的情况选：

A. 对话直接调用（最常用，零代码）

直接在对话里说，例如：

• "根据 D:/标书/XX竞价文件.docx 生成技术应答文件"
• "参考这份格式，应答 XX 项目，采购清单在 XX.xlsx"

我会：提取文档 → 选编制模式 → 梳理需求/歧义 → 生成 .docx → 跑全文核查 → 给修复清单。过程中只问你几个关键决策（模式 / 编号体系 / 歧义处理），照实回答即可。

B. 脚本直驱（技术 / 集成）

一条命令跑完整流水线（extract → price → generate → verify → compare → backfeed）：

python scripts/run_pipeline.py --tender-dir <含竞价文件与 bid_data 的目录> --output-dir <输出目录> --mode hybrid --precheck

或标准库 HTTP API（零依赖，供你自有系统调用，契约见 references/integration.md）：

python scripts/serve.py --port 8080

C. 造价咨询类——必须先用 Skill 加载专项技能（关键！）

> ⚠️ 这是 6 类项目里唯一需要「先加载另一个技能」的类型，最容易踩坑，单独说清。

为什么特殊：造价咨询评标采用 E 型复合价格公式（基准价偏离法 + 最低价基准法混合），价格评审本质是"逆向工程"任务，需要专门的评估模型与高分应答范式。它本身是一个独立专项技能「造价咨询投标评估与高分范式」，不在本技能内。

正确调用顺序（4 步）：

1. 用 Skill 工具加载「造价咨询投标评估与高分范式」；
2. 读 references/cost_consulting.md 拿造价编标范式（价格评审 / 商务技术 50 分应答 / 红名单）；
3. 回到本技能主流程（第 1~8 步）生成应答文件；
4. 价格模拟用 price_simulation.py --price-rule composite --preset cost_consulting（系数须以招标文件「评标办法前附表 3」原文覆盖，严禁套用通用对称公式）。

对比其他 5 类（直接 Read references 文件，无需 Skill 加载）：

> 🔑 记忆口诀：只有「造价」要 Skill，其余五个 Read 就行。所有专项都只补充该品类的评分 / 价格 / 红名单，主流程始终按本技能走。

零代码使用路径（技术小白友好）

> 你不需要会 Python、不需要自己敲命令。本技能的全部脚本都由我（AI 代理）在后台替你运行。你的角色只有三步：

1. 给文件：把竞价文件（.docx / .pdf）、采购清单（.xlsx）、报价清单发给我，或告诉我磁盘路径（读本地文件前我会先请求授权）。
2. 做选择：我会问你 3 个关键决策——① 编制模式（不确定就选 🟦🟩 融合型）② 标题编号体系（不确定就选 enterprise 阿拉伯级联）③ 歧义条款怎么处理（发函 / 维持 / 补充）。照实回答即可。
3. 收成果：我交付正式 .docx（含响应表 / 6 章方案 / 承诺函 / 附录）+ 全文核查报告 + 需你补材料的清单。

常见顾虑解答：

• "我环境没装 Python / 依赖？" → 我用技能内置托管 Python（已含 python-docx / openpyxl）跑，你无感知。
• "脚本报错了怎么办？" → 生成前我会先跑 diagnose.py 预检拦截 90% 问题；真报错有 E0xx 错误码对照表，我直接告诉你怎么修。
• "我想自己复核？" → 我会额外导出 proposal.md / compliance_matrix.csv / checklist.md 供你在手机 / Word 里快速看，docx 才是正式交付物。
• "想进阶自己跑脚本？" → 才需要看下方「脚本清单」与 references/integration.md，普通使用完全不必。

> 💡 一句话：你只管"喂文件、做选择题、收 docx"；代码的事交给我。

数据驱动的模式与报价策略推荐（自进化第⑤步）

> 自进化闭环最后一环：lessons 积累的结构化复盘 → 自动推荐「编制模式 + 报价偏离区间」，不再每次都问用户。

何时用：拿到新标、确定编制模式与报价策略前，先跑一次：

python scripts/recommend_strategy.py --project-type 工程施工
# 或看数据池现状：python scripts/recommend_strategy.py --summary
# 或机器消费：python scripts/recommend_strategy.py --project-type IT集成 --json

逻辑：解析 lessons.md 中所有位于「复盘」标题下的 # structured YAML 块（文档示例块自动排除），按 project_type 聚合——推荐中标样本采用最多的 mode、取中标样本 price_dev_pct 的 min/max/mean/median 作为报价区间、输出高频赢点与丢分标签。数据不足（该类型 <3 条）时不强行推荐，回落到专项文档通用策略 + 人工决策。置信度随样本量升（≥10 高 / ≥5 中 / <5 低）。

闭环位置：①实战投标 → ②投标表现评估 → ③backfeed_lessons.py 回灌结构化块 → ④lessons 数据池 → ⑤本脚本出推荐。攒够 10+ 条后推荐才有统计意义，此前作人工复核参考。

投标后回灌·一键入口（降低每次操作成本）

> 把「一次真实投标的结果」最低成本写进 lessons.md 结构化块，让数据池持续长大。封装 backfeed_lessons.py，支持三种用法：

# ① 自动模式：已有 _merged.json（或投标人根目录），再补几个经验字段
python scripts/post_bid_backfill.py --merged-json _merged.json \
  --project-type 保安 --mode complete --self-name 我方 \
  --win-points "业绩三件套齐;本地化响应"

# ② 向导模式：交互式逐个问，自动拼参回灌（最适合随手记）
python scripts/post_bid_backfill.py --wizard

# ③ 纯手动：直接传项目类型 + 中标结果（无需 merged）
python scripts/post_bid_backfill.py --project-type IT集成 --result 中标 \
  --price-dev -1.5 --win-points "等保响应满分;信创目录内"

行为：
- 自动模式优先用 _merged.json / 投标人根目录；向导与纯手动模式会构造最小 _merged.json 喂给 backfeed_lessons.py，复用其解析（我方排名自动判定中标/候选/未中标，ref 按类型自动映射）。
- 回灌成功后自动跑 recommend_strategy.py --summary 显示数据池增长，并提示下一步推荐命令。
- 纪律：只填真实结果，不知道的字段留空、绝不编造；result 必须真实（中/候选/未中标/未知），不要「觉得应该中」就填中标。

触发条件

当用户提出以下类型请求时使用本技能：
- "根据XX竞价文件生成技术应答文件"
- "帮我写投标文件的技术部分"
- "参考XX文件格式，应答XX竞价文件"
- "生成技术方案书/技术响应文件"

核心原则（必须严格遵守）

1. 绝不编造原则

• 所有内容必须有来源：设备品牌/型号来自采购清单，公司资质来自参考文件，技术参数来自产品说明书或竞价文件
• 无法验证的信息用"详见附件"替代：同类项目业绩、证书编号、项目经理资质等，如果无法从提供的文件中获取真实信息，一律填写"详见附件：XXX证明材料"
• 严禁虚构项目名称、合同金额、证书编号

2. 信息来源分级

3. 响应表填写规范

• 项目需求书响应表中，每行只能填写一列：满足需求的填"完全响应"，优于需求的填"优于响应"并写明具体优于内容
• 不能两列都填，也不能两列都空
• 判断标准：需求本身明确要求的参数不算优于（如100M带宽是需求而非优于），超出需求的才算优于

4. 歧义标注原则

• 在梳理竞价文件需求时，必须主动识别并标注有歧义的条款
• 歧义内容包括：表述模糊的技术指标、前后矛盾的条款、缺失的验收标准、边界不清的范围描述
• 歧义标注格式：⚠️【歧义标注】原文：... 问题：... 建议澄清方向：...
• 发现歧义后，必须向用户汇报歧义清单，由用户决定处理方式，不得自行猜测或编造解释

5. 信息来源标注原则

• 输出的投标文件中，每个关键信息点必须标注其来源
• 标注格式在正文中为脚注或括号说明，同时生成独立的《信息来源对照表》
• 来源标注分类：
• 【来源：竞价文件 第X章 第Y条】 — 技术需求、评分标准等
• 【来源：采购清单 xxx.xlsx 行N】 — 设备品牌、型号、数量
• 【来源：参考文件 xxx.docx】 — 公司资质、服务体系描述
• 【来源：竞投人提供】 — 用户另行提供的真实信息（业绩、证书等）
• 【来源：行业通用标准】 — 技术参数来自公开标准（需注明标准编号）
• 【来源：待确认】 — 无法确定来源的内容，标记后请用户确认
• 标注信息源的同时不得暴露涉密或敏感的内部路径

6. 差异化优势识别原则

• 在梳理评分标准后，必须对每个评分项进行差异化潜力评估
• 差异化优势评分项是指：不同投标人之间容易拉开差距的评分项，在这些项上投入优化资源能获得更高回报
• 识别标准：
• 高分值 + 主观评分 → 高差异化潜力（投入产出比最高）
• 有明确优于空间（技术参数可超出需求） → 中高差异化潜力
• 有/无判定但收集难度大（如特定资质证书） → 中差异化潜力
• 低分值 + 纯客观判定 → 低差异化潜力（仅需满足即可）
• 差异化分析结果必须标注在评分标准分析报告中，指导后续应答优先级

7. 价格竞争力原则

• 不做最便宜，也不做最贵：除非用户有明确的价格策略（如"低价抢标"），默认建议中间偏低价位
• 报价必须有依据：价格建议基于报价清单实际数据，不得凭空建议数字
• 模拟测试至少3个场景：不同竞争态势下（竞争对手数量、报价策略）的报价效果
• 输出"合理报价区间"而非单一价格：给出下限（保本线）、建议价、上限（最高可接受价）

8. 投标文件编制三模式原则（基于竞品对标逆向工程）

背景：通过对比分析多个同标段中标/落标投标人的实际编制方式，归纳出三种典型编制模式。生成新投标文件时，应在满足竞价文件要求的前提下，有意识地选择或融合一种编制模式作为总体设计思路，并相应调整文件结构、美化规范、核查口径。

模式选择决策矩阵：

选择模式后的强制调整：

• 选🟦精炼务实型 → 第5步采用单PDF集成输出、文件不拆分、第7.2步美化更精细、避免文件超大导致加载慢
• 选🟨结构创新型 → 第5步输出两个PDF/章节（Main+Attachments），必须满足以下5项操作要求（缺一不可）：
  1. Main文档首页必须有显眼提示：红框或加粗文字提醒"本投标文件由【正文方案】和【资质附件】两部分组成，请同时查阅"
  2. Main文档正文引用附件编号：写"详见附件3：同类项目业绩"而非"见附件"
  3. Attachments文档有统一目录页：按"附件1、附件2..."编号列出所有附件及其页码
  4. 两份文档均完整：各自包含独立的附录A/B/C/D（信息来源表、歧义说明、差异化分析、资料清单）
  5. 交付时口头+书面提醒评审方：双PDF的告示在递交函中再次强调
  6. 第7.5步核查时两套都要检查、交付时提醒用户"评审需同时查看两份"
• 选🟩规范完整型 → 文件命名必须带版本号、每类材料独立盖章版PDF、第7.5步增加"命名一致性"和"盖章版完整性"检查

反面教训（来自实际投标对比）：

• 资质单薄的投标人不应选🟩完整型——硬堆材料会被评委看穿
• 评委数量多/评审时间紧的项目慎选🟩完整型——大文件加大评审负担
• 主观分占主导的标应选🟨结构创新型或🟦精炼务实型，把篇幅留给方案正文

9. 证据链厚度原则（基于头部投标人A中标实践提炼）

核心理念：每一份业绩/资质证据不是孤立的，必须形成可闭环追溯的证据链。单个合同只是"说法"，合同+发票+验真截图才是"铁证"。

三件套证明模式：

证据链闭环标准：

每个业绩必须满足：
├── 合同扫描件 ✓
├── 对应发票 ✓（至少1张，金额对应合同额）
├── 验真截图 ✓（国家税务总局发票查验平台截图 或 甲方盖章验收单）
└── 三者关键信息可互验（合同编号↔发票备注↔验真编号）

证据链厚度的三个层次：

表扬信/感谢函的情感背书（锦上添花）：
- 每封表扬信标注：出具方（甲方全称）、出具时间、对应项目名称、核心评价语
- 表扬信不与合同混排——作为独立附件分类，形成"硬证据（合同+发票）+ 软背书（表扬信）"双层结构
- 如评分标准含"客户满意度"项，表扬信数量≥5封时显著加分

反面警示：
- 仅有合同无发票 → 评委默认"可能为框架协议，未实际执行"
- 仅有发票无合同 → 评委默认"可能非本投标人业绩"
- 合同金额与发票金额不一致 → 评委默认"业绩水分大，按低值计"

10. 评审翻阅友好原则（基于投标人庚+头部投标人A对标提炼）

核心理念：投标文件的第一读者是评标专家，不是你自己。编制时必须以评委最短时间获取最大有效信息为设计目标。评委平均翻阅一份投标文件的时间不超过15分钟——你的文件结构决定了这15分钟能传达多少信息。

评审友好六项铁律：

评审友好与编制模式的映射：

评审翻阅最差实践（必须避免）：
- 文件＞200MB，评委端打开卡顿30秒以上 → 第一印象极差
- 目录页码全错（页码偏移≥3页） → 专业度归零
- 响应表/自查表缺失页码引用 → 评委无法验证，默认"不可信"
- 第1章直接堆企业介绍（评委最不想看的） → 黄金15秒被浪费

11. 内容厚度与写作质量规则（吸收「技术标文档自动生成工具」量化方法）

核心理念：评委按"分值密度"判断投入是否到位——分值高的项，篇幅与图表必须成正比。靠"页数注水"不如"按分定量"。

内容厚度量化指引：
- 字数目标公式（源自交通工程标书实战）：目标字数 = 评分分值 × (总页数 ÷ 总分) × 780，合格区间 目标×0.75 ~ 目标×1.25；低于下限打回重写，高于上限剔除注水。
- 图表配比：每个章节尽量含 ≥1 张表格/图；纯文字墙（无表无图）在评分博弈中易被压档。
- 🔥重点项加权：差异化分析报告中的 ★★★ 高潜力项，字数 ≥ 普通章节 1.5 倍。

写作硬规则（防 AI 腔 / 防结构乱）：
- 每小节（三级标题）正文 ≥ 3 个独立段落，禁止单一超长段落。
- 禁用第一人称销售腔："我方/我们" → 改用"本方案/项目组/将"。
- 章节正文写完即结束，禁止写"本章小结/本章总结"等总结段（易触发一级标题结构错乱）。
- 章节序号统一用中文数字（一、二、三…），禁止混用"第3章 vs 第三章"。
- 技术标中禁止出现金额/预算描述（价格另在商务/价格文件）。

12. 评分标准反向设计与分治写作原则（IMA 知识库编写技巧提炼）

核心理念：投标文件不是"把公司能力写进去"，而是"按评委打分路径把分拿到"。本原则整合 IMA 招投标知识库中多篇高价值文章的编写技巧（详见 references/bid_writing_techniques.md），是「核心原则 #9 证据链 / #10 评审翻阅友好 / #11 内容厚度」的操作化总纲。

① 评分标准反向设计三大法则（编制前先吃透评分表）：
- 法则 1 目录按打分项搭建：技术标目录（暗标除外）直接对应评分因素，标题可嵌分值（如第三章 总体技术方案（20分）），让评委 30 秒定位打分项。
- 法则 2 篇幅权重 = 分值权重：某评分项占 40 分 → 约占 40% 篇幅；★★★ 高潜力项篇幅 ≥ 普通章 1.5 倍，低分客观项不注水。
- 法则 3 硬性门槛独立成页：资质/业绩/响应时间等"有/无即生死"项，独立成页 + 标注"符合招标第 X 条" + 截图编号可查（与自查表生死线清单联动）。

② 客观分 vs 主观分 写作分治（关键战术，原差异化分析未显式展开）：
- 客观分（证书/业绩数量/资质/响应时间，有/无即判定，所有评委须打相同分）→ 写法=清单化罗列 + 证书截图直接呈现 + 编号可查 + 独立成页；准确、不废话、张冠李戴不得分。
- 主观分（方案/性能/服务，需横向对比排序，评委可不一致）→ 写法=对比表（我司 vs 行业常规）+ 量化数据 + 开头对标最高档 + 增值内容；只喊口号无数据即被压档。
- 第 3 步须对每项标注 类型=客观/主观，第 6 步按此分治优化。

③ 响应三要素框架（每个评分项自查闭环）：评分要点 → 证明材料 → 表述方式 任一缺失即有丢分风险；与合规矩阵四级状态（✅/△/⚠️/❌）联动，△/⚠️ 往往源于"证明材料"或"表述方式"不到位。

④ 评分标准合规红线（读表时必检）：政府采购项目评分标准不得设区间分、分值须与量化指标一一对应、客观分须零自由裁量；若发现此类，提示用户（可依法质疑），我方应答时把客观项做到"满分档铁证"。详见 references/bid_writing_techniques.md 第六节。

🛡️ 健壮性与故障排查（网络异常 / 输入异常 / 错误码）

本技能对「中途失败」做了两层防护：代理检索层（联网） 与 脚本执行层（输入输出）。
任何异常都会输出「错误码 + 处理建议」，不再抛出难以定位的原始堆栈。
遇到报错先看错误码（E0xx），对照下方速查表即可定位，无需读源码。

🔌 网络异常重试 / 回退协议（代理检索层）

> 关键认知：脚本本身不联网。联网检索（IMA 知识库 mcp__ima-mcp__search_knowledge）由 AI 代理在编制/反哺时执行。
> 网络不稳定或连接器未连接时，按以下协议降级，绝不因单条/单库检索失败而中断整条编制链路。

1. 连接器状态前置检查：执行检索前先确认 ima-mcp 连接器为 connected。
   - 若 disconnected（当前环境常为此状态）：不要反复重试，直接进入「回退路径」，并告知用户：
   ⚠️ 知识库连接器未连接，本次基于技能内置 references/ + 公开经验作答；法规细节请以招标文件原文为准，置信度：中。
2. 重试策略（仅当连接器已连接但偶发超时/失败）：指数退避，最多 3 次 —— 间隔 1s → 2s → 4s，单次超时建议 30s；3 次仍失败即判定为「该库本次不可用」，跳到回退路径，不阻塞其他库。
3. 回退路径（按优先级）：
   - ① 使用技能本地 references/ 中已沉淀的法规摘要与雷区清单（与知识库同源，已定期反哺）；
   - ② 用 WebSearch 兜底检索公开法规/判例；
   - ③ 标注 【来源待补 / 待用户核实】，严禁编造具体法条编号、判例号、分值。
4. 部分结果处理：多库/多关键词检索中，单个失败项跳过并记入日志，其余正常并入；最终输出标注「哪些点未经知识库核验」。
5. 反哺（kb_backfeed）降级：检索失败时不写反哺；--check-freshness 提示过期即提醒用户择机重连后补反哺，不影响日常编制。

🔁 脚本编排层自动重试（run_pipeline / serve）

> 上方协议是「AI 代理跑 IMA 检索」时的重试约定；本小节是脚本执行层自己的代码级重试——
> run_pipeline.py（一键编排）与 serve.py（HTTP API）在调用各子脚本时，对瞬态失败自动指数退避重试，
> 无需人工重跑，避免一次性环境抖动把整条流水线打断。

重试触发（仅限瞬态，值得重试）：
- 子进程超时（subprocess.TimeoutExpired，通常是网络/IO 抖动）；
- 子进程退出码 40 / 41（E040 联网检索层瞬态失败 / E041 检索降级）。

绝不重试（永久故障，重试必再次失败且掩盖问题）：
- 输入错误 E010/E011/E012/E020、缺依赖 E001、输出权限 E030 等——这些必须先修输入/环境，重试无意义。

重试参数（指数退避）：
- 默认最多重试 3 次（共最多 4 次尝试）；间隔 1s → 2s → 4s，单次等待上限 8s（不会无限放大）；
- 可用 --max-retries 0 关闭重试（CI 严格模式可用），或调大以应对弱网；
- 每次重试与最终失败都会在阶段记录里标注 attempts（总尝试次数）与 retried（是否重试过），并写入 pipeline_report.md。

# 弱网/容器环境：放宽到 5 次重试
python scripts/run_pipeline.py --tender-dir <目录> --output-dir <目录> --mode hybrid --precheck --max-retries 5
# 关闭重试（CI 严格判定）
python scripts/run_pipeline.py --config pipeline.json --max-retries 0

🧪 输入预检（diagnose.py，强烈建议生成前先跑）

在跑 generate_bid_document.py 之前先运行预检，可提前拦截 90% 的中途失败
（缺依赖、Python 版本低、bid_data.json 不存在/语法坏/缺必填字段）：

# 仅检查运行环境（Python + python-docx/openpyxl 依赖）
python scripts/diagnose.py --self-test

# 检查环境 + 输入数据（含 bid_data.json 合法性/必填字段）
python scripts/diagnose.py --input <含 bid_data.json 的目录 或 .json 文件>

• 退出码 0 = 通过（或仅有 WARN，可继续）；非 0 = 存在致命问题，先修复再生成。
• 报告会列出每条问题对应的 错误码 与可直接复制的修复命令。

🛟 统一错误码速查表

脚本输出均为 ❌ 错误 [E0xx]：描述 + ↳ 处理建议：...，对照下表：

> 退出码 = 错误码末 3 位（E010→10，E099→99），便于 AI 代理/CI 判定故障类别。

⚙️ 关键脚本参数约束速查

> 参数边界总原则：凡涉及"公式 / 阈值 / 限价 / 资格条件"等数值，一律以招标文件原文为唯一依据，脚本不假设、不套通用模板；任何未确认项列入待澄清，不得擅自使用假设值。（与第3步"歧义标注"、第3.55步"价格公式确认"联动。）

🧰 依赖与环境准备

• 推荐用技能内置托管 Python（已含 python-docx、openpyxl、PyMuPDF）。
• 若用自带环境：pip install python-docx openpyxl PyMuPDF（Python ≥ 3.8）。
• PDF 提取依赖 PyMuPDF（import fitz）；若缺失运行 pip install PyMuPDF，脚本会报 E001 并给出安装提示。
• ⚠️ pip 安装走境外源常失败（代理下 pypi.org 返回 502）——务必指定国内镜像：pip install PyMuPDF -i https://mirrors.cloud.tencent.com/pypi/simple（清华/阿里镜像亦可）。技能开发机实测：默认源失败、腾讯镜像秒装成功。
• 扫描页 OCR 的完整工具链（四件套，缺一只能降级）：① PyMuPDF（PDF 渲染）、② pytesseract + Pillow（pip 装，同上加镜像）、③ tesseract 二进制（不随技能、也不能用 pip 装，Windows 用 UB-Mannheim 安装包并勾选加入 PATH）、④ 语言包 chi_sim（中文必需）。缺 ③ 时 OCR 不可用，但不会丢内容——扫描页会被标出并汇总到「扫描页清单」，可改用外部 OCR 定向补录。
• 所有脚本均通过 common.py（scripts/common.py）统一错误处理；请勿删除或改名该文件，否则脚本将无法给出友好错误。

工作流程

第1步：提取所有文档内容

📂 衔接（操作细节）：文档提取的依赖安装、.doc/.docx/.xlsx 解析代码与异常处理见 references/workflow_guide.md §1。

使用 scripts/extract_documents.py 提取所有 .doc/.docx/.xlsx 文件的文本和表格内容：

# 提取所有文档内容到extracted目录
python scripts/extract_documents.py --input-dir <目录> --output-dir <输出目录>

注意：
- .doc 文件无法用 python-docx 直接读取，需用其他方式处理（如 LibreOffice 转换或 antiword）
- .docx 文件用 python-docx 提取段落和表格
- .pdf 文件原生支持提取（v1.3.3 新增，无需先转格式；v1.3.4 增强排版保留；v1.3.5 扫描件改为逐页混合识别）：把 .pdf 放入 --input-dir，extract_documents.py 用 PyMuPDF 直接抽取，输出 <名>_pdf.txt。它是"读成带结构的文本"，不是"像素级还原版面"——能做什么、做不到什么，一次说清：
- ✅ 能做的（v1.3.4 排版 / v1.3.5 扫描件）：
1. 文字 + 阅读顺序保留：默认 --layout blocks 用 get_text("blocks") 按（y 行带, x）排序，多栏排版左栏先于右栏、页眉页脚页码混排明显改善；并用字号探测把章节标题写成 Markdown 标题（## / ###），比纯线性平铺更贴近原结构。
2. 表格输出为 Markdown：find_tables() 识别的表格输出带表头分隔行的 Markdown 表，便于下游引用。
3. 扫描件逐页混合识别（v1.3.5 重写）：逐页判定是否需要 OCR（该页文字量低于阈值 且 图片覆盖面积占比高于阈值），因此「文字章节 + 扫描附件」混合 PDF 既不会整份误判、也不会丢页——这正是旧版「整份文档一个布尔」最常出错的场景。判定需 OCR 的页会自动调用 Tesseract：缺语言包自动降级到可用子集、单页失败不影响其他页、超大页自动降 dpi 防内存溢出。
4. 扫描页待补清单（杜绝静默丢文字）：OCR 不可用/失败的页不再留白——页内标注「本页为扫描图片页，未取到文字：原因」，并在输出文件末尾汇总「扫描页清单（精确到页码）」，据此定向用外部 OCR / 人工补录。确无扫描页时不追加清单，保持普通文本 PDF 输出干净。
5. 输出带「第 N 页」分页标记，可搜索、可定位原文，省去"先转 docx"的麻烦；确无扫描页时不追加清单尾巴，保持输出干净。
- 🔴 做不到 / 限制（务必知悉，避免误判）：
1. 加密 / 密码保护 PDF 不支持——会报 E_PARSE_FAIL，须先解密再给（OCR 也不会对加密件生效）。
2. OCR 不是内建、需本机装 Tesseract 工具链：脚本只调用 tesseract 二进制 + pytesseract + Pillow + 语言包（中文需 chi_sim）。这些不随技能附带；缺失时扫描件 OCR 会报 E022 并降级（auto 模式写提示后继续、on 模式明确报错），此时仍需先用外部 OCR（扫描王 / ABBYY / 微信识图）转出文字再给。
3. 版面是"文本/阅读顺序级"保留，非像素级还原：不会还原字体/颜色/精确坐标，"条款在第几页第几行"的精确定位仍拿不到；多栏复杂混排（图文绕排、跨页表格）仍可能错位。
4. 表格是"尽力而为"，非保真：复杂表 / 合并单元格 / 无边框表 / 嵌套表常识别不出；识别异常时静默跳过（不报错、表格直接缺失）；即便识别出，正文里也常重复出现表格内容，需人工去重对齐。
5. 不解析章节层级为目录树：输出是「第 N 页 + 文本（含 Markdown 标题）+ 表格」平铺，不会自动建成"第X章 / 第Y节"目录树；编号体系 / 章节结构以你提供的招标文件原文为准。
- 🛠️ 大文件 / 复杂版面的兜底做法：① 加密件先解密；② 本机有 Tesseract 时扫描件交给 --ocr auto/on，没有就先用外部 OCR；③ 关键评分表 / 资质清单优先用 .docx 或 .xlsx 给，抽取保真度最高；④ 抽取后必须人工通读校对页码与层级，不要把 _pdf.txt 当权威结构直接用。
- .xlsx 文件用 openpyxl 提取所有工作表数据

⚠️ 输入完整性预检（先于一切分析，吸收「评标表逆向工程」健壮性理念）：提取前先核对，发现关键缺失→先向用户追问补全，不盲目启动（防止把"用户没给"误判为"响应缺失"或"文件有毛病"）。

预检通过或用户明确「就按现有材料分析」后，再进入第2步。

第2步：分析参考文件格式

📂 衔接（操作细节）：参考文件的响应表/承诺函/自查表结构分析方法见 references/workflow_guide.md §5、§9。

从参考文件中提取以下格式信息：
- 章节结构：标题层级、编号方式
- 表格格式：列定义、表头样式、数据行格式
- 表述方式：承诺用语、技术描述风格
- 附加内容：承诺函、自查表、响应表等

第2.5步：格式与编号体系适配（新增，吸收格式排版类技能优势）

📂 衔接（操作细节）：编号体系四级映射、封面【正本】/【副本】标记、页脚 X/100 样式、格式合规联网核对见本步骤与 references/workflow_guide.md §9。

> 招/投标文件的"格式"往往决定第一印象，甚至直接触发废标（目录页码错误、编号体系不符、签字盖章页缺失）。本技能原以"第X章"固定结构出稿，对政府采购/事业单位/工程施工等强制套用特定编号体系的项目适配不足。本步吸收「投标文件编制专家/助手」的编号体系能力与评标否决判例库，在生成前先锁定格式规范。

执行流程：

分析参考文件格式（第2步）
        ↓
判定项目格式族（政府/工程/通用企业）  ← 看招标文件封面与"投标文件组成"章节
        ↓
选定编号体系 + 封面标记 + 页脚样式
        ↓
向用户汇报格式方案，征得确认
        ↓
第5步生成时按此方案渲染

四套编号体系（按项目类型选择）：

> 选择规则：招标文件封面/目录已用"一、""第一章"等 → 必须对齐对应体系（政府用体系三、工程用体系四）；未明确的通用企业项目 → 体系一。

封面与页脚格式规范（互补原第7.2步）：

• 封面正本/副本标记：竞争性项目需提交"正本+副本"时，封面右上角标注 【正本】 / 【副本】（如招标文件要求）；仅一份则按原封面结构。
• 页脚样式双选项：
• 默认：第 X 页 / 共 Y 页（居中，9号字）
• 备选 X / 100 样式：首页不显示，自第2页起编，适用于招标文件明示"页码格式 X/总页"的项目（吸收格式技能规范）
• 目录：展示至前三级标题，TOC 域自动生成；条目页码须与实际章节对齐（原第7步已覆盖，本步仅固化样式约定）。

格式合规联网核对（可选增强，吸收「投标文件编制助手」IMA 知识库联动思路）：

> 编号/字体/页面样式等"软格式"要求，仅凭模型记忆易错；真实招标范本与"因格式被废标"的判例可反向约束生成。遇到以下情形时，可联动 IMA 知识库检索验证（不默认每次检索，避免无谓开销）：

• 检索到具体规范/范本时，仍以用户提供的招标文件与官方最新范本为准；本技能生成的是内容+格式骨架，实质性内容由用户据招标文件与行业规范填充。
• 知识库内容亦可能更新；引用具体条款/范本序号时建议二次核实，不得臆造来源。
• 连接器未连接时按原「网络异常重试/回退协议」降级，标注置信度。

第3步：梳理竞价文件需求（含歧义识别）

📂 衔接（操作细节）：评分项客观/主观区分、歧义六类识别与报告模板见 references/workflow_guide.md §2、§7。

从竞价文件中提取：
- 技术需求：逐条列出所有技术参数要求
- 评分标准：评分因素、分值、评分细则
- 区分客观项和主观项（须逐项标注 类型=客观/主观，供第 6 步写作分治使用，详见核心原则 #12 ②）：
- 客观项：有/无即可判定（如证书、业绩数量、资质等级、响应时间）→ 写法走"清单+证据"路线
- 主观项：需横向对比排序（如技术方案、系统性能参数）→ 写法走"对比表+量化+对标最高档"路线
- 评分标准合规红线初检（读表即检，详见 references/bid_writing_techniques.md 第六节）：若属政府采购项目，发现评分标准设区间分（如"好得 2-3 分"）、分值无对应量化指标、或限定供应商所有制/所在地/注册资本等，立即标红提示用户（差别待遇/歧视待遇，可依法质疑）；我方应答时把客观项做到"满分档铁证"，不给评委模糊裁量口子。
- 商务条款：付款方式、工期要求、质保要求等

合规矩阵（响应矩阵）对齐（吸收「招投标标书自动生成」优势，新增）：

> 将「服务评价自查表 + 项目需求书响应表」统一视为一份合规矩阵（响应矩阵）：逐条拆解竞价文件评分项/需求条款，确保每项得分点都有对应响应，并显式标注响应状态与证据/风险，便于评委与用户一眼看到"是否全覆盖、哪里有缺口"。

在每个评分项/需求条款的响应中采用四级状态标记（与原"完全响应/优于响应"列并存，用于矩阵总览）：

矩阵每行额外记录：证据/引用（指向附件或章节）、风险备注（偏离/承诺过度/证据不足）。该矩阵可在第8步同步导出为 CSV 供用户快速复核（见第8步交付 47）。

歧义识别（必须执行）：逐条审查需求条款，识别以下类型的歧义：

歧义报告格式：将识别出的所有歧义汇总为表格，格式如下：

歧义处理流程：

> ⚠️ 法定时限（刚性，误期不受理）：对招标文件有异议，应在投标截止 10 日前提出（《招标投标法实施条例》第22条）；政府采购项目应在获取文件之日起 7 个工作日内提出（财政部87号令第53条）。质疑须在知道/应知其权益受损之日起 7 个工作日内提出，对答复不满可于 15 个工作日内向财政部门投诉。详见 references/clarification_letter.md。澄清答复前，不得对歧义条款做确定性承诺。

1. 识别歧义 → 输出歧义报告
2. 向用户汇报歧义清单
3. 用户决定：① 维持原样（投标中不做特别解释） ② 提出澄清请求（发函询标） ③ 自行补充说明
4. 按用户决定在应答文件中处理

第3.5步：差异化优势评分项分析（新增）

📂 衔接（操作细节）：差异化五维模型、潜力判定矩阵、报告完整示例见 references/workflow_guide.md §3。

完成需求梳理后，必须对每个评分项进行差异化潜力评估，输出《差异化优势分析报告》。

分析维度：

差异化潜力判定矩阵：

差异化分析报告输出格式：

========== 差异化优势分析报告 ==========

项目：XXX项目
分析时间：2026-XX-XX

-------------------------------------------------------------
评分项         | 分值 | 类型 | 可差异化空间 | 差异化潜力 | 应对策略
-------------------------------------------------------------
总体技术方案    | 20分 | 主观 | 大          | ★★★ 高     | 🔥重点优化
系统性能参数    | 15分 | 主观 | 大          | ★★★ 高     | 🔥重点优化
售后服务响应    | 10分 | 主观 | 中          | ★★☆ 中高   | 针对性优化
技术培训方案    | 10分 | 主观 | 大          | ★★☆ 中高   | 针对性优化
同类项目业绩    | 9分  | 客观 | 大          | ★★ 中      | 准备材料
认证证书       | 5分  | 客观 | 中          | ★★ 中      | 收集证书
工期响应       | 3分  | 客观 | 小          | ★ 低       | 满足即可
-------------------------------------------------------------

🔥 重点优化项（优先投入资源）：总体技术方案、系统性能参数
📋 材料准备项（需用户配合）：同类项目业绩、认证证书
✅ 满足即可项（不丢分即可）：工期响应
============================================================

响应三要素映射（每个评分项必做，详见核心原则 #12 ③ + references/bid_writing_techniques.md 第三节）：对 ★★★/★★☆ 高潜力项，在报告中追加三要素自检，任一缺失即标记 △/⚠️：
- 评分要点：用一句话说清该项得分条件（如"同类业绩≥3 个且单项≥500 万得满分"）
- 证明材料：证书/合同/截图/数据是否齐全、编号可查、与要点对应（对接第 5.5 步证据链）
- 表述方式：客观项→清单化+截图；主观项→对比表+量化+对标最高档

差异化分析必须向用户汇报，用户确认优先级后，按优先级分配应答优化资源。

第3.55步：选择编制模式（新增，必须执行）

📂 衔接（操作细节）：编制模式决策树、资料清单分级标准与输出格式见 references/workflow_guide.md §3.7、§4。

目的：在差异化分析完成后、资料清单编制前，必须先确定本次投标的编制模式，后续所有步骤（资料清单、文档生成、美化、核查）都按选定模式执行。

执行流程：

差异化分析结果（评分项优先级）
        ↓
询问用户 / 推断模式（精炼务实/结构创新/规范完整/融合）
        ↓
向用户汇报模式选择及理由，征得确认
        ↓
按选定模式调整后续步骤

模式选择决策树：

问：投标人核心优势在哪？
├─ 技术方案输出能力（强）→ 🟦 精炼务实型
├─ 资质材料丰富度（高） → 🟩 规范完整型
├─ 介于两者之间         → 🟨 结构创新型
└─ 不确定 / 想稳        → 🟦🟩 融合型（推荐默认）

输出《编制模式选择说明》：

模式与资料清单的映射：

根据差异化分析结果和竞价文件要求，编制《投标人需提供资料清单》。
清单编制依据：
- 竞价文件中明确要求的附件（业绩合同、证书复印件、人员资质等）
- 差异化分析中识别出的"材料准备项"（可加分的证明材料）
- 商务条款要求提供的资格证明（营业执照、纳税证明等）
- 技术方案中引用的产品资料（彩页、检测报告、授权函等）

资料清单分级：

资料清单输出格式：

========== 投标人需提供资料清单 ==========

项目：XXX项目
编制时间：2026-XX-XX

一、资格性审查材料（🔴 必须提供，缺一废标）
-------------------------------------------------------------
序号 | 资料名称 | 要求 | 是否已备 | 备注
1    | 营业执照副本复印件 | 加盖公章 | □ 待提供 |
2    | 法定代表人授权委托书 | 原件 | □ 待提供 |
...

二、技术评分材料（🟡 建议提供，影响评分）
-------------------------------------------------------------
序号 | 资料名称 | 关联评分项 | 分值 | 是否已备 | 备注
1    | 同类型项目合同复印件 | 同类项目业绩 | 9分 | □ 待提供 | 至少5个
2    | ISO9001证书复印件 | 认证证书 | 2分 | □ 待提供 |
...

三、方案支撑材料（🟢 建议提供，增强可信度）
-------------------------------------------------------------
序号 | 资料名称 | 用途 | 是否已备 | 备注
1    | 锐捷AP产品彩页 | 技术参数证明 | □ 待提供 |
2    | 厂家授权函 | 供货渠道证明 | □ 待提供 |
...

四、竞投人基本信息收集表
-------------------------------------------------------------
项目 | 需填写内容 | 是否已填
公司全称 | ___________ | □
投标联系人 | ___________ | □
联系电话 | ___________ | □
...
============================================================

资料清单的用途：
- 投标启动时交给投标人填报，逐项收集材料
- 避免投标截止前才发现遗漏关键材料
- 差异化高分值项对应的材料优先催收

第4步：匹配采购清单数据

📂 衔接（操作细节）：采购清单设备品牌/型号映射示例见 references/workflow_guide.md §10。

如果用户授权使用本地磁盘文件，从采购清单中提取：
- 设备品牌型号：直接使用清单中的品牌型号
- 技术参数：基于清单中的规格描述展开
- 数量和价格：用于方案设计参考和价格模拟

如果用户未授权，则对品牌型号填写"待确认"，请用户提供。

第4.5步：价格模拟测试与投标价格建议（新增）

📂 衔接（操作细节）：价格三步法、composite 复合公式 E 型、输出报告示例见 references/workflow_guide.md §6。

当用户提供了报价清单数据时，必须执行价格模拟测试，为投标人提供科学的价格决策支持。

前置条件：
- 已提取报价清单中的成本/预算数据
- 已了解竞价文件中的价格分计算规则（如有）
- 用户已告知大致竞争对手数量（如不确定，按常见场景模拟3-5个对手）

价格模拟三步法：

步骤A：成本基线分析

从报价清单中提取数据，建立成本基线：

步骤B：多场景价格模拟

使用 scripts/price_simulation.py 或手动计算，模拟以下至少3个场景：

价格分计算公式（基于常见政府采购竞价规则，如竞价文件有特殊规则以文件为准）：

# 常见规则：基准价法（最接近基准价者得分最高）
def calculate_price_score(my_price, all_prices, perfect_score=30):
    """
    my_price: 我方模拟报价
    all_prices: 所有投标人报价（含我方模拟价和对手模拟价）
    perfect_score: 价格分满分
    """
    avg_price = sum(all_prices) / len(all_prices)  # 基准价
    deviation = abs(my_price - avg_price) / avg_price

    if deviation <= 0.05:
        return perfect_score  # 偏离5%以内满分
    elif deviation <= 0.10:
        return perfect_score * 0.95  # 偏离10%以内扣5%
    elif deviation <= 0.20:
        return perfect_score * 0.85  # 偏离20%以内扣15%
    else:
        return perfect_score * 0.70  # 偏离超20%扣30%

步骤C：综合建议

输出《价格模拟测试报告》，格式如下：

========== 价格模拟测试报告 ==========

项目：XXX项目
模拟时间：2026-XX-XX
模拟对手数：4个

一、成本基线
-------------------------------------------------------------
项目               | 金额（元）
设备采购成本        | ¥XXX,XXX
施工安装成本        | ¥XX,XXX
管理费及利润        | ¥XX,XXX
税金               | ¥XX,XXX
综合成本基线        | ¥XXX,XXX（保本线）

二、场景模拟结果
-------------------------------------------------------------
场景     | 报价（元）| 预估价格分 | 所需技术分 | 可行性
场景1保守 | ¥XXX,XXX | 28 / 30   | 中偏高     | ✅ 推荐
场景2激进 | ¥XXX,XXX | 29 / 30   | 高         | ⚠️ 需技术分支撑
场景3高价 | ¥XXX,XXX | 22 / 30   | 极高       | ❌ 不推荐

三、合理报价区间建议
-------------------------------------------------------------
下限（保本线）：  ¥XXX,XXX 元
建议报价区间：    ¥XXX,XXX ~ ¥XXX,XXX 元
上限（最高可报）：¥XXX,XXX 元

四、风险提示
-------------------------------------------------------------
1. 如对手数超过5家，建议采用场景2激进策略
2. 如技术方案有明显优势，可适当提高报价至建议区间上限
3. 如技术方案无明显优势，报价应贴近建议区间下限
4. 最终价格建议需结合最新市场行情和用户利润预期调整
============================================================

重要警告：
- 价格模拟结果仅供参考，最终报价由投标人（用户）自行决定
- 不得在没有报价清单数据的情况下进行模拟（无法建立成本基线）
- 对手报价数据为假设值，可能与实际完全不符
- 如竞价文件采用不同价格分规则，优先遵守文件规定

第5步：生成技术应答文件（含信息来源标注）

📂 衔接（操作细节）：响应表填写规范、【来源】标注格式、信息来源对照表生成见 references/workflow_guide.md §5、§8。

⚠️ 生成前必须确认已选定编制模式（参见第3.55步），不同模式的文件结构如下：

5.0 各模式的标准文件结构

🟦 精炼务实型（单PDF结构）：

├── 封面（项目名称+竞投人+日期，紧凑单页）
├── 目录（含页码）
├── 服务评价自查表
├── 项目需求书响应表
├── 商务和合同响应表
├── 第1章 项目的理解及需求分析
├── 第2章 项目总体方案设计
├── 第3章 项目组织实施方案及售后服务
├── 第4章 项目整体测试验收计划和方案
├── 第5章 项目培训方案
├── 第6章 竞投人综合实力证明（详见附件）
├── 施工工期承诺函
├── 售后服务承诺函
├── 附录A 信息来源对照表
├── 附录B 竞价文件歧义说明表
├── 附录C 差异化优势分析报告
└── 附录D 投标人资料清单

🟨 结构创新型（双PDF结构：Main + Attachments）：

Main文档（正文方案）：
├── 封面
├── 目录
├── 服务评价自查表
├── 项目需求书响应表
├── 商务和合同响应表
├── 第1章～第5章（与🟦相同）
├── 承诺函

Attachments文档（资质附件）——必须独立输出：
├── 附件1：营业执照/资质证书
├── 附件2：体系认证证书
├── 附件3：同类项目业绩
├── 附件4：项目经理/技术人员资质
├── 附件5：设备检测报告
├── 附件6：厂家授权函
├── 附件7：奖项/专利/软著
├── 附件8：其他证明材料

两份文档均包含：
├── 附录A 信息来源对照表
├── 附录B 歧义说明表
└── 附录C/D 差异化分析与资料清单

**🟨结构创新型——Main文档首页评审提示模板（必须包含）**：

┌─────────────────────────────────────────────────┐
│ │
│ ⚠ 重要提示：本投标文件由两部分组成 │
│ │
│ 【第一部分：正文方案】本文件 │
│ 含：技术方案、响应表、承诺函、服务方案 │
│ │
│ 【第二部分：资质附件】另见独立PDF │
│ 含：附件1营业执照 · 附件2业绩证明 · 附件3证书 │
│ 附件4人员资质 · 附件5专利 · 附件6厂家授权 │
│ │
│ 请评审专家同时查阅两份文件。谢谢！ │
│ │
└─────────────────────────────────────────────────┘

**🟨结构创新型——Attachments文档目录页模板（必须包含）**：

┌─────────────────────────────────────────────────┐
│ 资质附件索引 │
│ │
│ 附件编号 附件名称 起止页码 备注 │
│ ──────── ────────────────── ──────── ──── │
│ 附件1 营业执照/资质证书 第1-5页 必备 │
│ 附件2 体系认证证书 第6-12页 加分 │
│ 附件3 同类项目业绩证据链 第13-45页 核心 │
│ 附件4 项目经理/人员资质 第46-55页 加分 │
│ 附件5 设备检测报告 第56-65页 必备 │
│ 附件6 厂家授权函 第66-70页 必备 │
│ 附件7 奖项/专利/软著 第71-80页 加分 │
│ 附件8 其他证明材料 第81-85页 补充 │
│ │
│ ★ 附件3（同类业绩）为本次投标重点证明项， │
│ 含N个项目证据链，每项含合同+发票+验真截图 │
│ │
└─────────────────────────────────────────────────┘

**🟩 规范完整型（多版本+独立盖章版）**：

├── 商务投标文件_v3.0.pdf ← 命名带版本号
│ └── 含全部资质证书、合同、奖项
├── 技术投标文件_v3.0.pdf
│ └── 含完整技术方案、参数表、培训方案
├── 价格投标文件_v3.0.pdf
│ └── 含分项报价表、投标一览表
├── 盖章版_分项报价表.pdf ← 独立盖章扫描版
├── 盖章版_投标一览表.pdf ← 独立盖章扫描版
└── 盖章版_法定代表人授权书.pdf

**🟦🟩 融合型（推荐默认）**：

├── 商务投标文件.pdf（单PDF，文件名规范不带版本号也可）
├── 技术投标文件.pdf
├── 价格投标文件.pdf
├── 盖章版_分项报价表.pdf ← 关键盖章版独立
├── 盖章版_投标一览表.pdf ← 关键盖章版独立
├── 主要资质证书_盖章版.pdf ← 重要证书独立盖章版
└── 法定代表人授权书_盖章版.pdf

**模式选择对应不同的脚本参数**（如果有生成脚本）：

```bash
# 🟦 精炼务实型
python generate_bid_document.py --mode concise --input ... --output ...

# 🟨 结构创新型（产物：Main_正文方案.docx + Attachments_资质附件.docx，写入 --output 目录）
python generate_bid_document.py --mode structured --output <输出目录> --input ...

# 🟩 规范完整型
python generate_bid_document.py --mode complete --version 3.0 --sealed-separately --input ...

# 🟦🟩 融合型（默认）
python generate_bid_document.py --mode hybrid --sealed-separately --input ...

# 指定标题编号体系（默认 enterprise 阿拉伯级联；另可选 symbol/government/engineering）
python generate_bid_document.py --mode complete --numbering engineering --input ...

使用 scripts/generate_bid_document.py 生成 .docx 文件，结构如下：

标准文件结构：
1. 封面（项目名称、竞投人、日期）
2. 目录（含页码）
3. 服务评价自查表（对标评分标准，含对应章节和页码，含来源标注）
4. 项目需求书响应表（每行只填一列，含来源标注）
5. 商务和合同响应表（每行只填一列，含来源标注）
6. 第1章 项目的理解及需求分析
7. 第2章 项目总体方案设计（含各子系统详细方案）
8. 第3章 项目组织实施方案及售后服务
9. 第4章 项目整体测试验收计划和方案
10. 第5章 项目培训方案
11. 第6章 竞投人综合实力证明（详见附件）
12. 施工工期承诺函
13. 售后服务承诺函
14. 附录A：信息来源对照表
15. 附录B：竞价文件歧义说明表（如有歧义）
16. 附录C：差异化优势分析报告（新增）
17. 附录D：投标人资料清单（新增）

📌 响应表即"偏离表"：本技能的「项目需求书响应表 / 商务和合同响应表」在投标术语中等同于技术偏离表 / 商务偏离表。每行除"完全响应 / 优于响应"两态外，还存在第三态：
- 无偏离（=完全响应）：满足招标要求，填"完全响应"并标来源。
- 正偏离（=优于响应）：超过招标要求，填"优于响应"并附可溯源证据（无证据不得标"优于"，否则被认定虚假应标）。
- 负偏离：未满足某条要求——原则上禁止出现（负偏离常触发废标或大幅扣分）；如确无法满足，必须提前在歧义说明表（附录B）中明示并向采购人书面澄清，不得隐瞒。

信息来源标注规则：

在正文中以下位置添加来源标注：
- 设备技术参数后 → 【来源：采购清单 xxx】
- 引用竞价文件条款时 → 【来源：竞价文件 第X章 第Y条】
- 公司资质描述 → 【来源：参考文件 xxx.docx】
- 行业标准引用 → 【来源：GB/T XXXX】
- 用户另行提供的信息 → 【来源：竞投人提供】
- 无法确定来源 → 【来源：待确认，请竞投人核实】

信息来源对照表（附录A）格式：

歧义说明表（附录B）格式：

差异化优势分析报告（附录C）格式：

投标人资料清单（附录D）格式：

注意：
- 来源标注在正文中使用小号灰色字体（宋体 7.5pt 灰色），不喧宾夺主
- 红色识别规则（便于肉眼核查）：来源标注中的括号脚注/说明（如「（以招标文件最新版为准）」）一律用红色字（RGB 0x8B0000）；正文中凡以「详见附件」占位的无法验证信息（如「详见附件：同类项目业绩证明」）同样用红色字；此外「详见第X页」页码占位（自查表/响应表页码列默认即此占位）一律标红，章节标题中的「（详见附件）」（如第6章标题）同样标红。以上均由 generate_bid_document.py 自动渲染，提醒投标人在提交前补齐真实材料/来源与页码。
- 如用户要求不显示来源标注，则仅在附录A中保留内部对照（但「详见附件」占位仍建议保留红色提示）
- 标注信息源时不得暴露涉密或敏感的内部路径（如 C:\Users\xxx 应简化为文件名）

第5.5步：构建证据链（基于头部投标人A中标实践，必须执行）

📂 衔接（实战案例）：证据链厚度为何能满分（头部投标人A 18 分业绩项拆解）见 references/workflow_guide.md §12.2；三件套标准见本技能第5.5步。

目的：将零散的资质文件组织为可闭环追溯的证据链，让评委从"看到一份合同"升级为"看到一套铁证"。这是头部投标人A在11家投标人中脱颖而出的核心编制技术。

前置条件：用户已按附录D《投标人资料清单》收集了材料。

5.5.1 证据链逐项构建

对资料清单中每个🟡加分项（尤其是同类业绩），按三件套标准逐项构建：

证据链条目页排版模板：

┌─────────────────────────────────────────┐
│ 业绩证据链 #1：XX银行信用卡外呼项目        │
│                                          │
│ ① 合同信息                               │
│   项目名称：XX银行信用卡外呼外包服务项目     │
│   合同金额：¥XXX万                        │
│   服务期限：20XX.XX - 20XX.XX             │
│   【详见下页合同扫描件】                   │
│                                          │
│ ② 资金流证明                             │
│   发票号码：XXXXXXXX                      │
│   发票金额：¥XXX万（与合同匹配√）           │
│   开票日期：20XX-XX-XX                    │
│   【详见下页发票扫描件】                   │
│                                          │
│ ③ 真实性验证                             │
│   验真方式：国家税务总局发票查验平台        │
│   验真结果：一致 √                        │
│   查询时间：20XX-XX-XX XX:XX              │
│   【详见下页验真截图】                     │
│                                          │
│ ④ 客户评价（如有）                        │
│   表扬单位：XX银行信用卡中心               │
│   出具时间：20XX-XX-XX                    │
│   核心评价："服务优质，各项指标超额完成"     │
│   【详见下页表扬信扫描件】                 │
└─────────────────────────────────────────┘

5.5.2 证据链条目页数量控制

5.5.3 表扬信/感谢函的独立编排

表扬信不嵌入业绩证据链内，而是独立成章（在第6章"竞投人综合实力证明"中）：

第6章 竞投人综合实力证明
├── 6.1 企业资质（营业执照、ISO证书等）
├── 6.2 同类项目业绩证据链（按三件套排版）
│   ├── 业绩证据链 #1～#N（按5.5.1排版）
│   └── 业绩汇总表（项目名称、金额、时间、证据链编号）
└── 6.3 客户评价与表扬信汇编
    ├── 表扬信汇总表（出具方、时间、对应项目、核心评价语）
    ├── 表扬信扫描件 #1～#M
    └── 感谢函扫描件（如有）

5.5.4 证据链核查速查表（生成后必须自查）

反面教训（来自实际投标对比）：
- 某投标人提供了19份合同但无一发票 → 评委印象："全是框架，没有落地"
- 某投标人验真截图无时间戳 → 评委印象："可能是往年截图，不代表现在"
- 某投标人表扬信无甲方公章 → 评委直接忽略不计

第6步：优化主观评价项（结合差异化分析）

📂 衔接（操作细节）：主观项优化策略、差异化分析→主观项优化的衔接见 references/workflow_guide.md §2.2、§3.6。

按差异化分析中的🔥重点优化项优先投入资源。写作前先判定该项为客观分还是主观分，采用不同写法（核心原则 #12 ②）：

• 客观分（证书/业绩数量/资质/响应时间等）：走"清单化罗列 + 证书截图直接呈现 + 编号可查 + 独立成页"路线，准确不废话，对接第 5.5 步证据链三件套；这类项"有即满分、无即零分"，不靠文采靠铁证。
• 主观分（方案/性能/服务，合计通常占 60-70 分）：走"对比表（我司 vs 行业常规）+ 量化数据 + 开头对标最高档 + 增值内容"路线，避免空喊口号。

优化时应遵循：
1. 🔥重点项优先：差异化潜力高的评分项，投入最多的文字篇幅和最详细的数据
2. 开头对标最高档：直接声明满足最高档评分标准
3. 增加对比表：我司方案 vs 行业常规方案，逐项对比
4. 量化数据：用具体数字支撑优势描述
5. 增值内容：补充需求未提及但实际有价值的增值功能

第7步：添加页码和目录页码

📂 衔接（操作细节）：页码、分页符规范见 references/workflow_guide.md §9.3、§9.4。

• 页脚：居中显示"第X页 / 共Y页"，9号字体
• 目录：每条目后加页码（基于分页符估算，提示用户核实）
• 服务评价自查表：每项标注"详见第X章第Y页"

第7.2步：文档美化（印象分提升，必须执行）

📂 衔接（操作细节）：字体/表格/封面/目录美化细则见 references/workflow_guide.md §9。

评委对投标文件格式及美化要求很高，印象分对评审结果至关重要。必须按以下规范美化：

封面设计规范

• 封面独占一页，项目名称+文件类型+竞投人信息布局紧凑，签字区不能单独占一页
• 签字栏（竞投人名称、法定代表人签字、日期）应与标题在同一页内，不独立成页
• 封面建议结构：顶部留1~2行空白 → 项目名称（黑体26pt，加粗，居中）→ "技术应答文件"（黑体28pt，加粗，居中，字距加宽）→ 中部分隔线 → 签字区（宋体12pt，居中或左对齐）
• 项目名称可用深蓝色（1F4E79）或深红色（8B0000）增强视觉冲击力

目录样式规范

• 目录标题（"目 录"）：黑体16pt，居中，与正文用细横线分隔
• 目录条目：宋体10.5pt，章节条目加粗，子条目正常，页码右对齐
• 使用制表符+前导符（...或·）连接章节名与页码

章节标题样式规范

表格美化规范

• 表头行：深蓝背景（1F4E79）+ 白色字体（FFFFFF），加粗
• 数据行：奇数行白色背景，偶数行浅蓝背景（DEEAF1），字体宋体10.5pt
• 合并单元格的表头：使用次级蓝（2E75B6）
• 表格整体框线：实线1pt，外框线2pt
• 关键列（如"优于响应"、"我方自查情况"）用不同底色强调

段落样式规范

• 正文：宋体12pt，行距1.5倍，段前段后各3pt
• 来源标注：宋体9pt，灰色（808080），段前0pt
• 重点文字：加粗，不改字体字号
• 禁止大量使用斜体

其他规范

• 所有承诺函保持独立分页（加分页符）
• 附录每个独立分页
• 避免单行孤立在页末（段落保持在一起设置）

按编制模式调整美化的重点

🟩 规范完整型专属要求

• 文件命名带版本号：<文件类型>_v<主版本号>.<次版本号>.<修订号>.pdf，如 商务投标文件_v3.0.2.pdf
• 所有扫描件必须为彩色扫描，300dpi以上，避免灰度模糊
• 盖章版独立：分项报价表、投标一览表、法定代表人授权书必须为独立盖章版PDF
• 资质目录索引：商务PDF首页必须包含《资质材料目录页码索引表》，方便评委快速定位

🟨 结构创新型专属要求

• Main文档与Attachments文档互引：正文提到"详见附件X"时，必须在Attachments文档有明确对应章节
• Attachments统一编号：所有附件按 附件1、附件2... 统一编号，正文引用必须用相同编号
• 交付时必须明确告知评委："本投标文件由两份PDF组成，需同时查看"，可在Main文档首页加显眼提示

第7.5步：全文核查完整性和合理性（必须执行）

📂 衔接（操作细节）：自动核查脚本 verify_document.py 用法、人工复核清单见 references/workflow_guide.md §10.5、§11。

生成文档后、交付前，必须执行全文核查，确保所有表格内容完整、逻辑合理、无空白行。使用 scripts/verify_document.py 自动检测，辅以人工复核。

7.5.1 表格完整性核查

逐个检查文档中的所有表格，重点核查以下关键表格：

7.5.2 内容逻辑合理性核查

7.5.2.1 按编制模式扩展的专项核查

🟦 精炼务实型专项：

🟨 结构创新型专项：

🟩 规范完整型专项：

🟦🟩 融合型专项：

7.5.3 核查流程

生成文档
  ↓
运行 verify_document.py 自动检测
  ↓
输出核查报告（合格/不合格项清单）
  ↓
逐项修复不合格项
  ↓
重新运行核查（直到全部合格）
  ↓
人工复核关键表格内容
  ↓
通过 → 进入第8步交付

7.5.4 核查报告格式

========== 全文核查报告 ==========
文件：XXX.docx
核查时间：2026-XX-XX
表格总数：X个

一、表格完整性
---------------------------------------------------
表格 | 名称 | 行x列 | 空白数据行 | 空白率 | 状态
0    | 项目需求书响应表 | 28x7 | 27 | 96% | ❌ 不合格
1    | 商务和合同响应表 | 9x6 | 0 | 0% | ✅ 合格
...

二、关键表格内容核查
---------------------------------------------------
服务评价自查表：❌ 缺失（仅有标题，无表格内容）
项目需求书响应表：❌ 27行空白，需从竞价文件逐条提取
商务和合同响应表：✅ 8条已填写
响应表响应列：✅ 每行只填一列

三、内容逻辑核查
---------------------------------------------------
章节交叉引用：✅ 通过
设备型号一致性：✅ 通过
来源标注完整性：⚠️ 3处缺失
承诺函完整性：✅ 通过
目录完整性：✅ 通过

四、修复建议
---------------------------------------------------
1. 【紧急】项目需求书响应表27行空白，需从竞价文件第三章逐条提取需求并填写响应
2. 【紧急】服务评价自查表缺失，需从竞价文件第五章评分标准逐项提取
3. 【提醒】3处来源标注缺失，需补充
==================================================

7.5.5 自动核查脚本

使用 scripts/verify_document.py 执行自动检测：

python scripts/verify_document.py --file <生成的docx文件> --bid-file <竞价文件.docx>

脚本功能：
- 检测所有表格的空白数据行比例
- 识别关键表格（响应表、自查表、附录）并检查内容完整性
- 检查响应表每行是否只填一列
- 检查目录与实际章节的对应关系
- 输出结构化核查报告

重要：自动检测通过后，仍需人工复核以下内容：
- 响应表中的"优于响应"内容是否确实优于需求
- 自查表中的评分项描述是否准确对应竞价文件
- 技术方案章节是否充分展开了🔥重点优化项

第8步：验证和交付

📂 衔接（操作细节）：交付前验证清单见 references/workflow_guide.md §11（本步已扩展 format-risk 形式瑕疵 / 多包投标 / 评分索引表（评委视角）三项新维度，详见下方检查项 41–43 与交付项 50）；提交前废标扫描见 references/bid_rejection_risks.md、防丢分见 references/prevent_checklist.md。

生成文件后，执行以下验证：

内容真实性

1. ✅ 检查是否有虚构内容（项目名称、证书编号等）
2. ✅ 检查响应表是否每行只填一列
3. ✅ 检查所有"详见附件"处是否需要用户提供真实材料

完整性核查（新增，必须通过）

4. ✅ 服务评价自查表有完整评分项数据（非空白）
5. ✅ 项目需求书响应表每行有需求原文和响应（非空白）
6. ✅ 商务和合同响应表每行有条款原文和响应（非空白）
7. ✅ 所有表格空白数据行比例<5%
8. ✅ 响应表响应列每行只填一列（完全响应或优于响应）
9. ✅ 目录条目与实际章节标题一一对应

歧义和来源

10. ✅ 检查歧义标注是否完整（是否遗漏了可识别的歧义条款）
11. ✅ 检查信息来源标注是否完整（每个关键信息点是否标注了来源）
12. ✅ 检查信息来源对照表（附录A是否覆盖了所有关键信息）

差异化分析

13. ✅ 检查差异化分析报告是否覆盖了所有评分项
14. ✅ 检查🔥重点优化项是否在应答中给予了最多篇幅
15. ✅ 检查差异化分析建议是否已向用户汇报

资料清单

16. ✅ 检查资料清单是否覆盖了所有竞价文件要求的证明材料
17. ✅ 检查🔴必须项是否有遗漏（遗漏则废标风险）
18. ✅ 检查资料清单是否已交付用户填写

价格模拟

19. ✅ 检查价格模拟是否基于实际报价清单数据（非虚构）
20. ✅ 检查是否至少模拟了3个竞争场景
21. ✅ 检查价格建议报告是否包含风险提示
22. ✅ 确认最终报价决策权归属用户

编制模式合规（新增）

23. ✅ 编制模式已选定并经用户确认
24. ✅ 文件结构与所选模式一致（如🟨必须双PDF、🟩必须带版本号和盖章版）
25. ✅ 已执行所选模式对应的专项核查（7.5.2.1）
26. ✅ 交付时已提醒用户该模式的使用注意事项

证据链合规（新增）

27. ✅ 每个🟡加分业绩至少含合同+发票+验真三件套（或合同+验收单双件套）
28. ✅ 合同金额、发票金额、验真金额可互验（偏差≤5%）
29. ✅ 验真截图含查询时间戳，不早于投标前30天
30. ✅ 表扬信含出具方全称+公章，不含公章的已剔除
31. ✅ 业绩汇总表中证据链编号与正文引用编号一致

评审友好合规（新增）

32. ✅ 第1章首段为需求理解摘要（3-5行），公司介绍在第6章
33. ✅ 服务评价自查表每行标注"详见第X章第Y页"
34. ✅ 全文搜索已删除"众所周知""根据相关规定""为了更好的"等套话
35. ✅ 单个PDF文件≤200MB（如超过已拆分并首页说明）
36. ✅ 第1章～第2章（方案核心）为正文中排版质量最高的章节

一致性校验（吸收「招投标标书自动生成」优势，新增，提交前必须执行）

> 生成后、交付前，对「自查表 / 响应表 / 正文方案」三处做跨文档一致性扫描，避免编号漂移、案例错引、商务条款打架等低级丢分项：

37. ✅ 编号一致性：目录、章节、响应矩阵的条款编号三者完全一致（无错位、无漏项）
38. ✅ 案例引用一致性：正文中引用的业绩/案例名称、金额、时间，与证据链附件及资料清单完全一致（无张冠李戴）
39. ✅ 商务条款一致性：付款方式、工期、质保等商务承诺在承诺函、商务响应表、正文中表述一致（无前后矛盾）
40. ✅ 自查表↔响应表↔正文闭环：自查表每项"详见第X章第Y页"的页码指向真实存在且内容对应（无空指/错指）

评委视角与形式瑕疵合规（新增，吸收「评标表逆向工程」）

41. ✅ （大标增配）评分索引表（评委视角）：当评分项 ≥ 15 项时，额外产出「评分索引表」——每行 评分项 | 分值 | 响应页码 | 关键证据一句话摘要 | 评委核验难度（⭐~⭐⭐⭐），让评委 5 秒定位证据、降低通读负担。
42. ✅ format-risk 形式瑕疵扫描：证据内容存在但未满足形式要件（原件/公章/法人签字/骑缝章/特定页/电子标格式）的项已逐一标红并优先补正（优先级高于普通内容缺失）。
43. ✅ 多包投标专项已执行（如适用）：投多包时各包响应表/自查表独立生成、差异项已逐包核对、无跨包共用；已产出《多包响应差异化核对清单》。

编标防错检查清单（基于实战教训，提交前必须逐项过）

> 6类20项实战防错清单（需求覆盖三对照 / 业绩证据链四查 / 评审友好三补 / 资质属地三验 / 价格策略理性化 / 加分项主动植入），提交前必须逐项过。
> 完整清单（含头部投标人A、头部投标人B等实战教训与🔧脚本核验方法）见 references/prevent_checklist.md。
> ⚠️ 脱敏纪律（与投标编制无关，但属技能共享前置）：本清单防的是「废标/丢分」；若你要把真实项目经验回填进技能（lessons.md / retrospective_log.md / 专项 md），必须先按「复盘提示词」节的 PII 复扫纪律对全技能目录脱敏——公司名/银行分行名/项目名/编号/真实号码一律 anonymize，否则技能不可对外分发。

交付

44. 输出验证报告（含全文核查报告+编标防错检查清单6类20项），列出需用户补充的材料清单
45. 输出歧义处理建议清单，供用户决策
46. 输出差异化优先级建议，指导用户资源分配
47. 输出价格模拟报告，供用户价格决策参考
48. 输出《编制模式交付说明》——明确告知用户本次投标的编制模式、文件结构、评委使用建议
49. （可选）多格式快速评审输出：为便于用户在 Word 定稿前快速复核，可同步导出① proposal.md（Markdown 版方案书）② compliance_matrix.csv（第3步合规矩阵总览，含状态/证据/风险列）③ checklist.md（第8步验证报告）；docx 仍为正式交付物，不得替代签章版。
50. （大标增配）评分索引表 + 多包清单：评分项 ≥ 15 项时附「评分索引表（评委视角）」；多包投标附《多包响应差异化核对清单》（格式见「多标段/多包投标专项」）。⚠️ 两者均由代理按模板在交付阶段手动生成（本技能无独立生成脚本）；compare_bids.py 仅做串标雷同自检，不生成多包差异清单——勿误以为脚本会自动产出。
51. ✅ 常见场景核查已逐项过（如适用）：CA签章/电子标递交、联合体连带责任、中小企业价格扣除声明、节能/环境标志加分佐证、项目经理无在建承诺、投标/履约保函替代、保证金形式——逐项核对 references/common_scenarios.md，命中项已补正。

造价咨询类项目专项（综合评估法 + 复合价格公式）

> 造价类价格分为 E型复合公式（A/B 基准价偏离法 + C/D/E 最低价基准法），编标须调用专项技能「造价咨询投标评估与高分范式」。
> 完整编标/评估要点（价格评审、商务技术50分应答、评估核验红名单）见 references/cost_consulting.md。

保安/监控值守类服务外包专项（综合评估法 + 价格70/商务技术30）

> 价格70/商务技术30，价格分占比极高且各家贴限价；案例14分为客观大项。
> 完整编标范式（评分结构、六段式方案、价格策略、反面红名单）见 references/security.md。

医疗/体检类服务采购专项（综合评估法 + 商务技术70/价格30）

> 商务技术70/价格30，胜负在商务技术实料非价格战。
> 完整编标范式（64分商务拉满、6分方案、价格策略、反面红名单）见 references/medical.md。

金融科技通用型研发项目专项（综合评估法 + 商务技术60/价格40 + 人月加权计价）

> 商务技术60/价格40，人月加权计价，价格趋同非胜负手。
> 完整编标范式（评标结构、60分要点、价格策略、反面红名单）见 references/fintech.md。

工程施工类项目专项（综合评估法为主 + 价格分常见基准价法 / 亦含经评审最低投标价法）

> 评标多为「报价+技术标(施工组织设计)+资信标(业绩/资质/项目经理/奖项)」三分离，价格分 40~60，否决风险集中在资格合规与实质性响应。
> 完整编标范式（评标结构、资信业绩拉满、技术标🔥重点、低于成本红线、反面红名单）见 references/construction.md。

IT系统集成与软件定制专项（综合评估法 + 商务技术60~70/价格30~40 + 含硬件时价格权重升高）

> 胜负在商务技术实料（方案/业绩/团队/售后），政务金融对等保与信创为硬性门槛。
> 完整编标范式（商务技术范式、技术方案🔥重点、价格分项加权、反面红名单）见 references/it_integration.md。

废标雷区总检与澄清函模板

提交前最后一关扫描 + 歧义发函闭环：

• 废标雷区总检：覆盖主体资格 / 签署密封 / 报价 / 响应性 / 时效 / 保证金 / 弄虚作假 / 其他 8 类约 50 项雷区，任一🔴项命中即停车整改（与 references/prevent_checklist.md 编标防错20项互补：前者防废标、后者防丢分）。见 references/bid_rejection_risks.md。高频真实废标案例提炼的 TOP 清单（资格过期/只盖章不签字/保证金漏交/标书雷同机器码一致/自查表复制阈值等）另见 references/bid_writing_techniques.md 第七节，提交前必逐项过。
• ⚠️ 评分标准合规红线（读表即检）：若属政府采购项目，评分标准不得设区间分、分值须与量化指标一一对应、客观分须零自由裁量；发现此类立即提示用户（可依法质疑），详见 references/bid_writing_techniques.md 第六、八节。
• ⚠️ format-risk 形式瑕疵专项核验（吸收「评标表逆向工程」）：证据内容存在但未满足招标文件要求的形式要件——如要求原件扫描却只提供复印件加盖公章、要求法人签字却只盖章、缺骑缝章/特定页/公证件——此类在评标现场极易被扣分甚至直接废标，优先级高于普通内容缺失。扫描时逐项标红并优先补正（规则见下方「多标段/多包投标专项」的 format-risk 检查项）。
• 澄清函 / 质疑函模板：编标阶段遇歧义须书面发函（法定时限内），未澄清前不得做确定性技术承诺；对采购文件 / 结果可依法质疑。见 references/clarification_letter.md。
• 合规红线（围标串标反向自检）：多标书独立编制、避免雷同被认定串标；自查表不得复制评分准则阈值；「优于响应」须可溯源。见 references/compliance_redline.md。
• 常见场景核查清单（通用·提交前必扫）：CA签章/电子标递交、联合体连带责任、中小企业价格扣除、节能/环境标志加分、项目经理无在建承诺、投标/履约保函替代、保证金形式等高频易漏项，逐项核对。见 references/common_scenarios.md。

多标段/多包投标专项（防跨包废标）

> 实战中投标人常"投多包且各包评标表有细微差异"。若用同一套标书投所有包，极易因"形式/资质/评分项不符"在某一包废标。本节约等于一份《多包响应差异化核对清单》生成指南（吸收「评标表逆向工程」优势）。

两路径：
- 路径① 单选分析：指定目标包 → 仅按该包评标表编标，不自动跨包合并（各包独立评审）。
- 路径② 多包差异比对：逐包抽取评分标准，只列各包"不完全一致"的评分项，生成《多包响应差异化核对清单》：

执行铁律：
1. 每个包独立生成响应表/自查表，包间不共用（共用=张冠李戴废标）。
2. 差异项（资质/业绩/本地化承诺/人员证书等）逐包核对，缺哪个包的证据就在哪个包补。
3. 完全一致的项不展开，避免清单过长；比对仅基于所给各包评标表，未提供的包不臆测。
4. 多包投标须分别装订/加密/递交，留意各包截止时间可能不同。

format-risk 形式瑕疵检查项（多包与单包通用，提交前必过）：

重要注意事项

1. 文件格式：.pdf 现已原生支持（PyMuPDF 抽取，v1.3.4 默认保留阅读顺序/多栏/标题/表格）；仍是文本级还原——不保像素版面、不建章节目录树，加密件须先解密，扫描件 OCR 需本机装 Tesseract（缺失报 E022 降级）；完整限制清单见「工作流程」第 1 步 PDF 说明。仅 .doc 旧格式仍需先转 .docx（或用 LibreOffice / antiword），脚本对 .doc 会提示转换
2. 中文编码：确保所有脚本使用 UTF-8 编码
3. 字体设置：中文使用宋体，标题使用黑体
4. 表格样式：表头使用浅蓝色背景（RGB 0xD9E1F2）
5. 分页符：每个主要章节前插入分页符
6. 页码估算：目录页码基于分页符位置估算，需提醒用户在Word中核实实际页码
7. 来源标注字体：正文中的来源标注使用宋体 7.5pt 灰色（RGB 0x808080），不干扰正文阅读；其中括号脚注/说明、「详见附件」占位、「详见第X页」页码占位用红色字（RGB 0x8B0000），便于一眼识别待补/待核内容（由 generate_bid_document.py 自动渲染）；章节标题中的「（详见附件）」同样标红
8. 在歧义未澄清前，不得对歧义条款做出确定性的技术承诺
9. 差异化分析必须量化：不得仅凭主观判断标注"高/中/低"，必须结合分值和评分方式计算
10. 价格模拟≠报价决策：价格模拟结果仅供参考，最终报价由投标人决定，必须附风险提示
11. 资料清单的🔴必须项必须逐条与竞价文件核对，遗漏一项可能导致废标
12. 生成文档后必须执行第7.5步全文核查，自动检测空白表格并修复，不得交付有空白表格的文档
13. 关键表格（响应表、自查表）的内容必须从竞价文件逐条提取，不得仅创建表头结构而无数据行
14. 编制模式必须先选定再生成（第3.55步），且需用户确认。不同模式对应不同文件结构、命名规范、核查口径
15. 🟦精炼务实型：文件≤50MB，避免评委加载慢；🔥重点项字数≥其他章节1.5倍
16. 🟨结构创新型：Main与Attachments必须互引、统一编号、评委提示显眼
17. 🟩规范完整型：文件命名带版本号、关键盖章版独立、扫描件≥300dpi彩色
18. 同类项目业绩必须走证据链：每个🟡加分业绩至少提供合同+发票+验真三件套，不得仅有孤立的合同扫描件
19. 验真截图须含查询时间戳：不得早于投标前30天，否则评委默认"往年截图"
20. 第1章开头必须是需求理解摘要：公司介绍一律后移至第6章——评委第一页不想看"我们成立于XX年"
21. 自查表每行必须有页码：服务评价自查表每项标注"详见第X章第Y页"，这是评委验证的第一步
22. 全文搜索删除套话：提交前搜索并删除"众所周知""根据相关规定""为了更好的服务于"等无效信息
23. 保安/监控值守类项目优先走专项范式（新增·保安专项）：价格70/商务技术30时，案例14分为客观核心拉分项，须按本技能「保安/监控值守类服务外包专项」走证据链厚装+方案六段式，且价格模拟禁用通用对称公式、须套用招标文件前附表3的非对称公式
24. 同类案例禁止复制评分阈值充数（新增·保安专项）：编标时案例必须来自真实合同+发票验真，不得把评分档位原文（100/300/500万）粘贴进业绩章冒充真实案例，否则在评估侧会被判为"零真实案例薄标"
25. 医疗/体检类项目优先走专项范式（新增·体检专项）：商务技术70/价格30时，机构实力（重点专科16+高级职称10+案例10）为客观核心拉分项，须按本技能「医疗/体检类服务采购专项」走证据链厚装+总体方案🔥重点优化；价格模拟须严格按"全部算术平均+非对称（高0.3/低0.2）"公式，禁用通用对称或去高低均值
26. 自查表"我方响应"列禁止复制评分阈值（新增·体检专项）：高级职称"600个"、床位"2000个"等评分阈值文字不得填入响应列冒充自身数据，须写"详见附件：XXX证明材料"，否则在评估侧触发"准则文本污染"误判
27. 金融科技研发/IT人力外包类项目优先走专项范式（新增·金融科技研发专项）：商务技术60/价格40、人月加权计价时，项目经验18分为客观核心拉分项（层级优先：四大行省级1.3/个>系统重要性总行0.5/个），须按本技能「金融科技通用型研发项目专项」走"一案例一档"三件套+母子公司红线排除+逐份核验签约主体；三方案18分主观🔥须量化+某银行场景绑定+引案例必附合同发票
28. 同类案例"母子公司不算"红线（新增·金融科技研发专项）：编标时仅认投标人或其下属分支机构签署的业绩，母公司/子公司业绩一律0分；人员简历中的大行案例未转投标人级合同=不计分，须逐份核验合同签约主体全称
29. 人月单价报价须走加权非对称价格公式（新增·金融科技研发专项）：评标价=高级×20%+中级×50%+初级×30%，<20家去1高1低均值作基准，高于基准每1%扣0.4、低于每1%扣0.3；禁用通用对称或去高低均值误算，报价须固定唯一且不超限价
30. 工程施工类优先走专项范式（新增·工程施工专项）：报价/资信/技术三分离时，否决风险集中在资格合规（资质、安全生产许可证、项目经理建造师+B证+近3月社保、无在建承诺），业绩须走三件套证据链且逐份核验签约主体=投标人，禁止复制评分档位金额冒充案例；报价须与招标工程量清单一致，低于成本须书面说明；技术标须含本项目专属进度计划/平面布置/方案，禁套通用模板
31. 投标前必须自查"关联冲突红线"（新增·金融科技研发实战）：提交前核对本项目的联系人姓名、手机号、邮箱、法人/负责人、注册地址不得与任何其他投标人一致**——评标委会交叉比对，一致即触发围标串标澄清甚至否决（真实案例：某金融科技项目两家投标人联系人手机号一致，触发围标串标否决）。同一集团多家子公司投同一标亦属高危，须评审前清理。详见「投标表现评估」核心原则 #8。
32. 报价明细必须做算术校核（新增·金融科技研发实战）：投标一览表/报价明细表的单价×数量之和、各分项加总必须与投标总价一致；某投标人曾因报价明细表算术错误被发澄清函并最终未通过初评。提交前用脚本对报价表做加总校验，避免低级算术废标。
33. IT集成与软件定制类优先走专项范式（新增·IT集成专项）：政务/金融项目须专章硬响应等保2.0三级、数据加密、信创国产化适配（CPU/OS/数据库/中间件清单），缺失即压档甚至废标；定制软件权属与开源组件许可证合规（避免 GPL 传染性）须专章声明；方案引案例必附合同+发票，团队驻场人员须附本单位连续社保；含硬件+软件+服务多报价项时价格须 composite 逐项加权，禁用单一基准价误算

常见错误和纠正

常见问题解答（FAQ）

> 高频疑问集中在此，更多问答（约 17 条，分造价 / 小白 / 数据 / 合规 / 脚本 5 类）见 references/faq.md。

Q1：我不会写代码，能用这个技能吗？
能。见上方「零代码使用路径」——你只需给文件、做选择题，脚本全由我后台运行，不需要你碰终端。

Q2：造价咨询为什么还要单独加载一个技能？怎么调？
因为它是 6 类里唯一采用 E 型复合价格公式、需逆向工程评估的品类，有独立专项技能。调法：先 Skill 加载「造价咨询投标评估与高分范式」→ 读 cost_consulting.md → 再走本技能主流程。其余 5 类直接 Read 对应文件即可。详见「如何调用本技能」C 节。

Q3：生成的红色字是什么？要管吗？
是"待补 / 待核"提醒（来源标注的括号脚注、「详见附件」占位、「详见第 X 页」页码占位）。提交前把「详见附件」换成真实材料、补齐页码即可——这是防编造的合规设计，不是错误。

Q4：只给竞价文件、没给采购 / 报价清单能生成吗？
能出结构，但品牌型号与价格相关项会标红待补；建议尽快补清单让数据真实、价格模拟有依据。

Q5：价格模拟的报价能直接报吗？
不能，仅供参考且必附风险提示；最终报价由你（投标人）决定，模拟须基于真实报价清单，不得凭空。

Q6：连接器（ima-mcp）没连接会影响生成吗？
不影响。脚本本身不联网；联网检索仅是可选的格式合规核对增强。连接器未连接时自动回退本地 references/ 经验，输出标注置信度「中」，法规细节以招标文件原文为准。

Q7：响应表、偏离表、自查表有什么关系？
本技能的「项目需求书响应表 / 商务和合同响应表」就是投标术语里的技术偏离表 / 商务偏离表；「服务评价自查表」是对标评分标准的自检映射。三者共同构成合规矩阵：响应/偏离表逐条响应、自查表对照评分项、附录A 列来源。每行只填一列（完全响应/优于响应），正偏离须有可溯源证据，负偏离原则上禁止。

Q8：我投多个标段/包，能用一套标书吗？
不能共用。各包评标表常有差异（资质等级/业绩/本地化承诺/人员证书等），用同一套标书投所有包极易在某一包因"形式/资质不符"废标。须按「多标段/多包投标专项」逐包独立生成响应表/自查表、做差异比对、产出《多包响应差异化核对清单》。

Q9：什么是 format-risk 形式瑕疵？为什么比内容缺失还急？
证据内容有，但没满足招标要求的形式要件——如要求原件扫描却只给复印件盖章、要求法人签字却只盖章、缺骑缝章/特定页。这类在评标现场极易被扣分甚至直接废标，优先级高于普通内容缺失，提交前必须逐一标红优先补正。

Q10：技术标要写多少字才够？
按分值定量：目标字数 = 评分分值 × (总页数 ÷ 总分) × 780，合格区间 目标×0.75~1.25；低于下限打回补写，高于上限剔除注水。🔥★★★高潜力项字数 ≥ 普通章节 1.5 倍；每小节 ≥ 3 段、配图表，禁"我方/我们"、禁"本章小结"、禁金额描述。

Q11：PDF 直接丢进来就能精确解析版面 / 表格结构吗？
不能做到像素级还原，但 v1.3.4 已大幅增强、v1.3.5 重写了扫描件识别，先说清能力边界：
- ✅ 已能做到：默认 --layout blocks 按阅读顺序抽取，多栏排版左栏先于右栏、章节标题探测为 Markdown（##/###）、表格输出为 Markdown 表——比纯线性平铺更贴近原结构；--ocr auto（默认）逐页判定是否需 OCR 并调用 Tesseract 扫出文字，混合型 PDF（部分页有文字层、部分页是扫描图）不会整份误判也不会丢页。
- ✅ 不再静默丢文字（v1.3.5）：OCR 不可用/失败的页不再留白——页内标注原因，输出末尾汇总「扫描页清单（精确到页码）」，据此定向补录，杜绝资质页悄悄变空白。
- 🛠️ 旧版两个缺陷已修：① 旧版对整份 PDF 只给一个"是否扫描件"布尔，混合 PDF 必然错判；② --ocr off 路径有未定义变量导致崩溃报 NameError。
- 🛠️ 实践建议：关键评分表 / 资质清单优先用 .docx 或 .xlsx 给；给 PDF 时加密件先解密、扫描件确保本机有 Tesseract（tesseract+pytesseract+Pillow+chi_sim，均不随技能附带）；超大 PDF 可加 --scan-max-pages 20 提速。抽取后务必人工通读校对页码与层级，别把 _pdf.txt 当权威结构直接用。
- 🔴 仍做不到：① 像素级版面还原（字体/颜色/精确坐标不保留，"第几页第几行"定位拿不到）；② 章节目录树（不自动建成"第X章/第Y节"）；③ 表格零丢失（复杂表/合并单元格/无边框表常识别不出，识别失败静默跳过）；④ OCR 不是内建——需本机装 tesseract+pytesseract+Pillow+chi_sim 语言包，缺失时报 E022 降级；⑤ 加密 PDF 仍须先解密。

Q12：哪些情况本技能不适用？
涉及国家秘密/机密的投标（须脱密后由专人处理）、需正式涉外法律审核的合同、以及纯销售类（房地产/零售）非投标项目。其余均可走主流程或对应专项。

参考文件

• references/faq.md：常见问题解答集中区（5 类约 17 条 Q&A），遇疑问先查这里。
• references/workflow_guide.md：主流程每一步的操作手册（代码、脚本用法、模板、示例）。它不是独立文档，而是本技能「工作流程」的详细展开——按上文「🧭 技能导航与使用路线 → 四、主流程 ↔ workflow_guide 衔接总览」的映射跳读对应 §，不要孤立通读。
• references/bid_methodology.md（NEW）：投标作战五步法（方法论总纲）。把"深度解读→策略→编制→合规→交叉定稿"固化为统领全部主流程步骤的业务决策框架，每步含目标/关键动作/交付物/常见陷阱，并映射到 workflow_guide.md 章节与脚本。开工前建立全局观、提交前对照自查的总入口。
• references/bid_writing_techniques.md（NEW）：IMA 招投标知识库「投标文件编写技巧」提炼的操作手册。含评分标准反向设计三法则、客观分 vs 主观分写作分治、响应三要素框架、技术标/商务标编制要点、评分标准合规红线、高频废标雷区 TOP 清单。是「核心原则 #12」的配套详解，第 3 / 3.5 / 6 步与废标雷区总检的调用入口。
• 其余 references/*.md（6 个行业专项、废标雷区/澄清函/合规红线/编标防错 4 个核查库、lessons.md 自进化数据池）的调用时机见上方导航第三、四、五节。

脚本清单

composite 复合公式模式（造价/保安/医疗/金融科技专项，E型）：

> ⚠️ 内置预设仅 4 个：cost_consulting / security / medical / fintech。建筑（construction）、IT集成（it_integration）等无内置预设，必须改用 --formula-config 提供招标文件「评标办法前附表3」的原文公式配置；严禁套用通用对称公式（老兵翻车重灾区，见系统提示第11节）。

price_simulation.py --price-rule composite 逐项套用对应公式后加权求和，严禁用单一基准价法套全部报价项（老兵翻车重灾区，见系统提示第11节）。数据源优先级：①招标文件「评标办法前附表3」复制价格公式原文 → ②电子标 TenderData.xml 用 parse_tender_data.py 抽取投标人报价 → ③填写 bidders JSON。

# 方式A：用内置专项预设（系数须以招标文件前附表3原文覆盖！）
python price_simulation.py --price-rule composite --preset security --bidders bidders.json --runs 30

# 方式B：用自定义公式配置（最严谨，公式原文来自招标文件）
python price_simulation.py --price-rule composite --formula-config formula.json --bidders bidders.json

# 方式C：从 TenderData.xml 解析出 bidders 再模拟
python parse_tender_data.py --input TenderData.xml --bidders-only -o bidders.json
python price_simulation.py --price-rule composite --formula-config formula.json --bidders bidders.json

bidders.json 格式（我方必须排第一；weighted 项用子报价对象）：

{"bidders":[
  {"name":"我方","prices":{"price":5175}},
  {"name":"对手甲","prices":{"price":5600}},
  {"name":"我方","prices":{"weighted":{"high":25900,"mid":18000,"low":12000}}}
]}

formula.json 每项支持三种 formula：benchmark_deviation（基准价偏离法，mode=symmetric/asymmetric_add/asymmetric_deduct）、lowest_price（最低价基准法）、weighted_then_deviation（先加权再偏离，配 sub_weights）。内置 preset：cost_consulting / security / medical / fintech（其系数为 SKILL.md 历史专项示例，正式投标前必须以招标文件前附表3原文覆盖）。工程施工 / IT集成 无内置 preset（价格系数强项目相关），须用 --formula-config formula.json 以招标文件前附表3原文逐项配置 benchmark_deviation（含多报价项时逐项加权走 composite 模式），脚本不臆造系数。

verify_document.py 按编制模式核查的口径：

# 默认融合型
python verify_document.py --file output.docx

# 指定精炼务实型
python verify_document.py --file output.docx --mode concise

# 指定结构创新型
python verify_document.py --file output.docx --mode structured

# 指定规范完整型
python verify_document.py --file output.docx --mode complete

不同模式下，脚本会输出对应的专项核查段（🟦专项 / 🟨专项 / 🟩专项 / 🟦🟩专项），并在修复建议中标注问题所属模式。

第5步补充：generate_bid_document.py 的输入数据格式（bid_data.json）

generate_bid_document.py 从 --input 目录读取 bid_data.json 作为内容源。字段缺失时自动生成占位提示（红色标注），不会中断运行，便于"先跑通结构、后填实内容"。完整字段示见 scripts/bid_data.sample.json（生成器已用最小样例验证可跑）。核心字段：

调用示例：

# 🟦 精炼务实型
python generate_bid_document.py --input ./bid_input --output 技术应答文件.docx --mode concise
# 🟦🟩 融合型（默认）
python generate_bid_document.py --input ./bid_input --output 技术应答文件.docx --mode hybrid
# 🟨 结构创新型（双PDF：Main + Attachments）
python generate_bid_document.py --input ./bid_input --output ./out_structured --mode structured
# 🟩 规范完整型（多文件 + 版本号 + 独立盖章版）
python generate_bid_document.py --input ./bid_input --output ./out_complete --mode complete --version 3.0 --sealed-separately

---

## 复盘提示词（Retrospective Protocol）

> **定位**：本技能的自进化闭环已有两层——`lessons.md`（标后评估→模式/报价推荐）与 `kb_backfeed`（外部法规反哺）。本「复盘提示词」是**第三层、也是最通用的一层**：把**每一次实质性任务**的成败经验沉淀下来，下次任务自动带上相关历史，避免重复踩坑、复用有效策略。详见 `references/retrospective_log.md`（存储规范 + 已沉淀示例）。

### 一、核心指令（每次对话必须遵循）

**【任务启动 · 检索历史】**
> 加载本技能后、动手前，先判断本次任务类型（投标编制 / 价格模拟 / 合规审查 / 技能维护 / 打包上传 / 需求澄清 …），然后：
> 1. **优先语义检索**：若环境 `ima-mcp` 连接器 `connected` 且存在专用「复盘知识库」，调用 `mcp__ima-mcp__search_knowledge`（针对该库）以**当前任务描述**为查询，取 Top-K 相关复盘条目。
> 2. **兜底读文件**：无论上一步是否命中，读取 `references/retrospective_log.md`，由你（代理）按「标签 + 语义相关性」筛出与本次任务相关的历史 1–5 条。
> 3. 将相关历史的「成功经验 / 失败教训 / 改进建议」**纳入本次任务的工作上下文**（即随技能加载的上下文一并带入），并在思考时显式参考——例如「上次深度审计发现 `--rule` 改名未同步，本次改参数须全仓 grep」。

**【任务完成 · 写入复盘】**
> 每次完成一个**实质性任务**（产出文件 / 修复 / 审计结论 / 报价建议等）后，按下方格式向 `references/retrospective_log.md` **追加一条结构化复盘**（用 Edit 在文件末尾「---」之后插入新 `##` 块）：
> - 字段必须齐全：任务描述 / 执行时间 / 任务状态（✅成功 / ❌失败 / ⚠️部分成功）/ 关键步骤摘要 / 失败原因（成功填「无」）/ 改进建议 / 标签 / 置信度 / 关联文件。
> - **绝不编造**：失败原因与改进建议须基于真实发生，无法确认的结论标「待核实」。
> - **双写向量（可选）**：若 `ima-mcp` `connected`，将本条正文作为一块推送到专用「复盘知识库」（用户自建，ID 不写死以保证技能可移植），实现语义检索；连接器不可用则仅留 markdown。
> - 纯闲聊 / 单条 lookup / 简短问答**不写**复盘。
> - **脱敏与 PII 复扫纪律（强制）**：凡向技能内部写入含真实项目数据的任何内容——`lessons.md` 回填 / `references/` 专项案例 / 本 `retrospective_log.md` / `SKILL.md` 核心原则里的实战案例——**写入前须先对全技能目录做一轮 PII 复扫**：用 Grep 扫 `SKILL.md` + `references/*.md`，检查是否残留具体公司名（投标人/供应商）、银行分行名（含其英文代码）、项目名、项目编号、真实手机号/身份证号。命中一律脱敏为「某国有大行 / 某投标人 / 某酒店项目 / 某地 / 某金融科技项目」等通用词；确认**零真实实体残留**后方可视为可对外共享或上 SKILLHUB。⚠️ 教训：仅脱敏单一文件（如只清 `lessons.md`）≠ 技能全干净——核心原则、复盘日志、专项引用里的"实战案例"同样会带真实实体，必须全目录复扫。

### 二、字段与格式（机器可读）

```markdown
## [YYYY-MM-DD HH:MM] 任务一句话简述
- 任务描述：<做什么、为谁、目标>
- 执行时间：YYYY-MM-DD HH:MM
- 任务状态：✅成功 / ❌失败 / ⚠️部分成功
- 关键步骤摘要：
  1. <步骤1：动作 + 关键决策>
  2. <步骤2…>
- 失败原因（若适用）：<根因分析；成功填「无」>
- 改进建议：<可复用动作 / 须规避的坑 / 待办>
- 标签：#tag1 #tag2   （建议含：领域/场景/成败类型，便于检索）
- 置信度：高 / 中 / 低
- 关联文件：references/xxx.md 或 scripts/xxx.py 或 产出文件

三、与既有机制的边界（避免重复/冲突）

三者各管一段，复盘日志不重复写入标后评估 YAML（那是 lessons.md 的职责）。

四、向量库说明（语义检索如何实现）

• 何时真向量化：仅当运行环境 ima-mcp 连接器 connected 且用户已建专用「复盘知识库」时。技能不写死任何 KB ID（保证下载者可用）。
• 写入：任务完成后调用 mcp__ima-mcp__add_knowledge 推送本条正文块。
• 检索：任务启动调用 mcp__ima-mcp__search_knowledge 语义召回。
• 降级：无 IMA 时，读 references/retrospective_log.md + 代理按标签/语义过滤，效果等价、仅非向量。
• 复用同一连接器即可与 kb_backfeed 的外部反哺共存，互不干扰。
  ```