Bidding Assistant - 招投标全流程助手

概述

此 Skill 提供从原始招标资料到正式投标文件的完整工作流：

1. 解析多份 .docx 格式的招标资料
2. 提取关键需求、必须响应项、评分重点、废标风险、企业素材
3. 生成标准格式投标文件 .docx（严格遵守招投标规范，不含自评内容）
4. 生成内部参考分析报告（可含评估内容）

核心规则（最高优先级）

投标文件禁止内容

正式投标文件中绝对禁止出现以下内容（参考 references/forbidden_content.md）：

• [禁止] "我方中标概率 XX%" / "中标概率预估"
• [禁止] "综合匹配度 XX分" / "匹配度评估"
• [禁止] 雷达图、评分卡、柱状图等自评可视化
• [禁止] "我方在此项目上具有明显优势"等自我评估表述
• [禁止] 任何以"内部评估""我方自评""预估"开头的段落

正确做法：用客观的事实和数据替代自评，例如：

• 不用"技术匹配度 93 分" -> 用"我方产品覆盖招标文件要求的全部 7 大功能模块，详见第四章功能对照表"
• 不用"中标概率 80%" -> 直接删除，不做任何替代

内部参考 vs 投标文件

• 正式投标文件 -> 只允许客观内容（功能对照、资质证书、技术方案、案例、响应偏离表）
• 内部参考分析 -> 可包含评估内容（匹配度分析、中标概率预估、风险矩阵、SWOT）
• 两者严格区分，不混淆

工作流程

阶段一：解析招标资料

用户通常会上传多份 .docx 文件（如：招标文件、公司介绍、产品资料、历史案例）。

解析方法：使用 scripts/read_docx.py 解析 .docx 文件：

python scripts/read_docx.py <文件.docx> <输出.txt>

该脚本通过 zipfile 直接读取 document.xml，不依赖 pandoc 或 python-docx。

必须输出 一份结构化解析报告（Markdown），包含以下五个部分：

| 章节 | 内容 |

|------|------|

| 一、招标文件核心信息 | 项目概况、功能需求（模块化表格）、技术架构要求、评分标准（分值和评审重点）、商务条款（交付周期/培训/响应/运维/保密/验收）、交付与服务要求 |

| 二、必须响应项清单 | 逐条列出，每项标注：类别（功能/架构/商务/交付/投标）、要求描述、来源章节 |

| 三、评分重点清单 | 优先级排序（星级）、各维度分值和关键得分点、技术评分细分项 |

| 四、废标风险项清单 | 风险类别、风险描述、风险等级（高/中/低）、应对建议 |

| 五、企业能力素材清单 | 公司基本信息、资质认证（状态标注 Y/N/待确认）、产品能力-招标要求对照 |

阶段二：生成投标方案初稿

基于阶段一的解析报告，生成一份结构化的投标方案初稿（Markdown），内容对应招标文件的评分标准。

初稿章节：

1. 项目理解与需求分析（采购人背景 + 核心需求逐条解析 + 关键成功因素对照表）
2. 技术方案（总体架构 + 核心功能技术方案逐条响应）
3. 项目实施方案（里程碑计划 + 团队配置 + 质量管理）
4. 培训与售后服务方案
5. 商务响应表
6. 业绩与案例

注意：初稿中可以包含优化标注（如"[优化标注：技术能力提升]"），但最终生成的 .docx 投标文件必须移除所有内部标注。

阶段三：生成正式投标文件 .docx

使用 scripts/generate_bidding_doc.py 作为模板，根据具体项目的数据进行定制。

标准格式（参考 references/standard_structure.md）：

1. 封面页
2. 投标函 + 投标函附录
3. 法定代表人身份证明 + 授权委托书
4. 资格证明文件清单
5. 技术方案
6. 项目实施方案
7. 培训与售后服务方案
8. 商务响应表（含报价清单）
9. 业绩与案例
10. 其他材料（保密承诺、知识产权声明、风险控制）
11. 签署页

生成注意事项：

• 使用 python-docx 库
• 表头使用深蓝色背景 (#1a3a5c) + 白色文字
• 表格隔行变色（#f8f9fb）
• 所有需要人工补充的内容标注【待填入】
• 图片、证书等标注"见附件"
• 页面之间用分页符分隔
• 再次检查：确认全文不含中标概率、匹配度评分等禁止内容

阶段四：生成内部参考文件（可选）

生成独立的内部参考分析文件（HTML 或 Markdown），可包含：

• 五维度匹配度评估（技术/商务/行业/资质/售后）
• 中标概率预估
• 风险检查报告
• 可视化图表（纯 SVG，零外部依赖）

脚本使用说明

read_docx.py

python scripts/read_docx.py <docx文件路径> [输出文件路径]

• 自动去除重复段落（docx XML 常见 5 份重复内容）
• 支持中文文本提取
• 不依赖第三方解析库

generate_bidding_doc.py

python scripts/generate_bidding_doc.py [输出路径.docx]

• 生成标准结构框架（前三章 + 签署页已有完整内容）
• 第四至九章为占位内容，需根据项目数据填充
• 可作为模板直接修改或作为生成器函数调用

常见陷阱与修复

| 问题 | 原因 | 修复 |

|------|------|------|

| pandoc/Word 解析依赖不可用 | 系统未安装 pandoc | 使用 scripts/read_docx.py，通过 zipfile 直接读 XML |

| 图表不显示 | Chart.js CDN 加载失败 | 改用纯 SVG 图表，零外部依赖 |

| AttributeError: NoneType object has no attribute 'set' | python-docx 的 run 没有 rFonts 元素 | 使用 run.element.get_or_add_rPr() 然后查找或创建 w:rFonts |

| 用户指出"投标文件为何评估中标概率" | 把内部评估内容写入了正式投标文件 | 严格遵守 references/forbidden_content.md，评估内容仅放在内部参考文件中 |

| 用户要求"投标文件标准格式" | 输出的文件不是标准招投标格式 | 参考 references/standard_structure.md 的九章结构，包含封面、目录、签署页 |

输出交付清单

完成后应交付：

| 文件 | 格式 | 说明 |

|------|------|------|

| 招投标资料解析报告 | .md | 五部分结构化分析 |

| 投标方案初稿 | .md | 含优化标注的初稿 |

| 投标文件 | .docx | 正式格式，不含自评内容 |

| 匹配度分析报告（可选） | .html | 内部参考，可含评估和可视化 |