投标全流程 Skill 体系：用 9 个 Skill 把投标这件事串成流水线（基于灵犀Claw
一、整体架构
整个投标体系由 9 个 Skill 按固定顺序编排为一条流水线（bid-pipeline），数据中枢为 WPS 多维表「投标资源库」，共享脚本 bidding_common.py 统一管控进度和文件操作。
architecture_diagram
流水线步骤：
步骤 | Skill 名称 | 产出物 | 管控点 |
Step 0 | bid-qualification（资质库数据准备） | 资质缓存数据 | 投标主体匹配、证书有效性校验、缓存24h过期自动刷新 |
Step 1 | bid-overview（标书解析与投标一览表） | 投标项目多维表记录 + project_context.json | 招标文件PDF/Word/图片多格式解析、前附表表格结构还原 |
Step 2 | bid-client-analysis（甲方招标分析报告） | 甲方分析 Word 报告 | 历史招采信息自动搜集、中标格局分析、参与建议 |
Step 3 | bid-registration（报名材料生成） | 报名材料 Word | 按招标文件第六章原文格式、自动填充资质信息 |
Step 4 | bid-framework（投标书框架生成） | 投标文件 Word | python-docx 动态生成、XML操作表格定位、资质自动匹配章节 |
Step 5 | bid-eligibility（资格审查自检） | 资格审查自检 Word 报告 | 逐项对照评分标准、颜色标注满足/不满足/待确认 |
Step 6 | bid-scoring（评分预打分） | 评分预审 Word 报告 | 客观分蓝标/主观分橙标、优先级排序优化建议 |
Step 7 | bid-learning（经验沉淀） | 投标经验库多维表记录 | 自动捕获经验教训、结构化存储、后续投标动态加载 |
Step 8 | skill-packager（打包归档） | 全套文件 ZIP | 按"项目名称_开标日期"命名规则、上传多维表附件字段 |
二、核心管控点与处理逻辑
2.1 数据中枢：投标资源库多维表
所有 Skill 共享一个多维表作为数据中枢，包含 5 张数据表：
数据表 | 用途 | 关键字段数 |
资质证书表（sheet_id=1） | 管理全部投标资质 | 10 字段（名称/编号/分类/有效期/扫描件/关联投标文件章节等） |
公司信息表（sheet_id=2） | 公司基础信息键值对 | 3 字段 |
投标主体信息表（sheet_id=3） | 多投标主体详细信息 | 30 字段（全称/信用代码/法人/开户行等） |
投标文件格式规范表（sheet_id=4） | python-docx 排版参数 | 17 条配置项（字体/字号/行距/页边距等） |
投标经验库（sheet_id=5） | 经验教训沉淀 | 11 字段（项目名称/经验类型/经验描述/适用场景等） |
2.2 项目上下文传递机制
Step 1 执行完成后生成 project_context.json，后续所有 Skill 通过 load_project_context() 加载，无需重复解析招标文件。
2.3 招标文件缓存机制
首次下载招标文件后缓存到本地目录，后续 Skill 直接读取本地文件：
.output/
.bidding_cache/
{项目名称}_{开标日期}/
招标文件.pdf
project_context.json缓存函数：
cache_bidding_file() — 首次下载后缓存
get_cached_bidding_file() — 后续 Skill 直接读取
2.4 投标书动态生成（bid-framework）
这是技术复杂度最高的环节。
动态章节结构：从招标文件第X章解析章节层次，非固定模板，根据具体招标文件确定章节结构。
排版参数控制：从多维表格式规范表（sheet_id=4）读取 N 条配置项：
参数 | 值 |
页面 | A4 |
正文字体 | 宋体 + Calibri + Times New Roman |
正文字号 | 12pt（小四） |
正文行距 | 1.5 倍 |
表格行距 | 1 倍，autofit |
一级标题 | 单独起页 |
签章区段前段后 | 1.5 行 |
页眉页脚字号 | 9pt |
关键技术细节：
表格插入：python-docx 的 add_table() 只能追加到文档末尾，在指定位置插入表格需通过 XML 方式（OxmlElement）操作文档树
章节拆分：投标书内容按每批不超过 10 章拆分执行，避免持久化环境超时
后处理修复：post_convert_fix() 清除文档属性中的个人信息（creator/lastModifiedBy/Company）
偏差表自动填充：根据已完成的投标书内容自动生成偏差说明
2.5 资格审查自检（bid-eligibility）
对照评标办法中的资格审查标准逐项自检，这是投标流程中的否决性关卡。
审查流程：
从招标文件提取"评标办法前附表"中的资格审查标准
逐项与投标资源库数据对比
审查维度 | 数据来源 | 自检方式 |
营业执照 | 资质证书表（关联章节=资格审查-基本证照） | 自动比对经营范围 |
资质等级 | 资质证书表（关联章节=资格审查-体系认证） | 自动比对等级和有效期 |
人员资格 | 资质证书表（关联章节=资格审查-人员资质） | 自动比对证书类型和有效期 |
业绩 | 需用户提供 | 标记为【待确认】 |
财务状况 | 需用户提供 | 标记为【待确认】 |
信用记录 | 需用户提供或联网查询 | 标记为【待确认】 |
颜色标识规范：
结果 | 颜色 | 含义 |
满足 | 绿色 (#28a745) | 已通过自动检查 |
不满足 | 红色 (#dc3545) | 存在废标风险 |
待确认 | 橙色 (#fd7e14) | 需人工补充确认 |
2.6 评分预打分（bid-scoring）
将评分项分为客观项和主观项两类处理：
客观评分项（蓝色标注）—— 直接计算确定分值：
价格分（按招标文件公式精确计算）
资质数量（按资源库统计）
业绩数量和金额
人员执业资格数量
软件著作权/专利数量
主观评分项（橙色标注）—— 给出预估分值 + 优化建议：
技术方案完整性、科学性、先进性
项目实施计划的合理性
质量保障措施的完善性
培训方案的针对性
优化建议优先级：
优先级 | 颜色 | 说明 |
高 | 红色背景 | 亟需改进 |
中 | 黄色背景 | 建议改进 |
低 | 绿色背景 | 锦上添花 |
2.7 流水线编排与断点续传（bid-pipeline）
执行流程：
每步执行完成后暂停，展示该步产出摘要，等待用户确认后再继续下一步。用户可指定任意步骤子集执行，系统自动计算依赖关系补跑前置步骤。
步骤依赖矩阵：
步骤 | 依赖前置 | 说明 |
Step 0 资质库 | 无 | 独立运行 |
Step 1 一览表 | 无 | 独立运行 |
Step 2 甲方分析 | Step 1 | 需甲方名称 |
Step 3 报名材料 | Step 0 + Step 1 | 需资质数据和招标信息 |
Step 4 投标书 | Step 0 + Step 1 | 需资质数据和招标信息 |
Step 5 资格审查 | Step 0 + Step 1 | 需资质数据和评标办法 |
Step 6 预评分 | Step 0 + Step 1 + Step 4 | 需资质、评标办法和投标书 |
Step 7 经验更新 | 任意已执行步骤 | 捕获前序步骤经验 |
Step 8 打包归档 | 任意已执行步骤 | 收集前序步骤产出文件 |
用户可选操作：
指令 | 行为 |
"继续" / "下一步" / "确认" | 执行下一步 |
"跳过" | 跳过当前步骤 |
"暂停" / "先到这里" | 保存进度，结束流程 |
"重新执行XX" | 重置后重新执行指定步骤 |
"查看进度" | 展示流水线进度摘要 |
"执行第X到Y步" | 选择性执行指定范围步骤 |
三、关键技术选型
技术点 | 选型 | 原因 |
文档生成 | python-docx | 直接API操作（非html2docx），排版精准可控 |
数据存储 | WPS 多维表 | 天然云同步、多Skill共享、支持附件字段 |
共享脚本 | bidding_common.py | 唯一真本，所有bid skill共用，避免重复代码 |
进度持久化 | project_context.json | 轻量级、可读性强、支持断点续传 |
文件缓存 | 本地目录结构 | 避免重复下载、多Skill复用 |
附件上传 | dbsheet API | 直接关联多维表记录 |
四、适用场景
信息化/软件销售企业：年度投标量大（20+），需要标准化流程管理
多投标主体：总公司+子公司独立投标，资质库统一管理
招标文件格式多样：PDF/Word/图片混合输入
团队协作投标：销售负责信息确认、技术负责内容填充、商务负责报价
以上 Skill 已在实际项目中跑通，流程基本稳定。每次投标遇到新问题就往经验库加一条规则，Skill 持续迭代中。
Lv.1 新人创作者