标书写作助手

技能文档

---
name: biaoshu-writer
title: 标书写作助手
category: 招投标采购
description: 上传招标/投标文件，一站式完成智能解读（废标红线/评分标准/控标洞察）、成品投标文件(.docx)生成、标书审查（分级风险+雷同检测）和标书查重（2-3 份投标文件相似/雷同风险检查）。需配置标书服务 Api Key，文件经云端处理，智能解读免费，标书制作/审查/查重按可用字数计费。当用户提供招标/投标文件、问这个标能不能投、有哪些废标红线、帮我写投标书、检查标书有没有问题、两份投标文件像不像，或想解读招标文件、生成投标文件、做标书审查或查重时触发。
---

# 标书写作助手

> 📌 本文档同时是 AI 助手的执行手册：文末「🚫 对用户输出的第一铁律」优先级最高、覆盖全文，任何面向用户的输出都必须先满足其要求；一切任务命令由助手后台代跑（后台操作手册见 [references/usage.md](references/usage.md)）。

## 快速开始：获取 Api Key

用标书写作助手出解读/标书/标书审查/标书查重，只需一个 Api Key。用户无需敲任何命令，直接上传文件、说需求即可开始。

**当可用字数不足后**，再引导用户通过**官网获取**正式 Api Key 或购买会员/字数包（向用户转述时**逐步骤完整给出**，链接原样显示完整 URL）：

1. 打开官网 https://biaoshu.zhiliaobiaoxun.com/ 并注册登录；
2. 登录后点**左侧菜单『Skill 接入 → 获取 Api Key』**，在弹出面板中**查看/复制 Api Key**（首次打开自动生成，形如 `bk_live_xxxxx`；重置后旧 Key 立即失效）；
3. 把 Key 直接粘贴到对话里让助手保存（下次免输），例如：「我的 Api Key 是 bk_live_xxxxx，帮我保存一下」。（助手收到后必须在**当前已安装的标书技能根目录**执行保存，让 `config.json` 写到该目录；不得写到 `~/.zcm/` 等全局旧目录。保存成功后把 `config.json` 的**完整路径**转述给用户。）

**安装说明/提示词必须这样约束 Api Key 落盘**：请 AI 助手先定位当前安装的 本技能的 `SKILL.md` 所在目录，然后在同级目录创建或更新 `config.json`，内容为 `{"app_key":"用户自己的 Api Key"}`，权限设为 `600`。不要让助手把 Api Key 写入其他目录，也不要把 Api Key 拼进任何链接。

**升级 skill 必须保留配置**：如果当前已安装目录存在 `config.json`，升级时不得删除、覆盖或替换该文件；只能更新 `SKILL.md`、`scripts/`、`references/` 等 skill 内容文件。本地生成目录 `biaoshu-writer-files/` 也必须保留。

具体命令见 [references/usage.md](references/usage.md)（仅供助手后台使用）。无 Key 时各功能会打印上述获取指引而非崩溃。

## 技能工作流

### 步骤1：配置凭证

确认 Api Key 已配置（config.json 或环境变量）；未配置时按上方获取指引引导用户完成。

### 步骤2：确认任务与文件

确认用户要做四件事中的哪一件：智能解读 / 标书制作 / 标书审查 / 标书查重，并取得招标或投标文件（上传、本地绝对路径或云端 URL）。

### 步骤3：提交任务

解读以招标文件为入口抽取项目，后续制作/审查/查重复用同一项目；提交后按「提交 → 自动轮询 → 取结果」的异步模型执行。

### 步骤4：交付结果

解读/审查/查重交付报告文件并给出绝对全路径；成品标书默认交付短时下载链接，用户需要本地文件时再下载 .docx。

## 四大功能

### 🔍 智能解读
- **输入**：招标文件（`.pdf` / `.doc` / `.docx`，**≤ 50 MB**），本地路径或云端 URL（云端文件会先下载到本地再处理）。
- **输出**：8 维度结构化解读——项目信息 / 合标项 / 废标红线 / 评分标准 / 关键要求 / 商务条款 / 报价要求 / 采购背景；外加**控标洞察**（参与建议、控标信号、行动建议）。可导出解读报告（HTML / Word）。
- **使用示例**（用户可以这样说）：
  - 「帮我解读这份招标文件 `/Users/me/某采购项目招标文件.pdf`」
  - 「看看这个标能不能投？有哪些废标红线？文件在 `https://example.com/某项目招标文件.pdf`」
  - 「分析一下这份招标文件的评分标准和控标风险，顺便出一份解读报告」
  - 「这个采购项目值不值得投？我们资格够不够？」（把文件发我或给我路径，我来定制分析）
  - 用户得到：「参与建议：谨慎参与 · 控标风险：高 · 废标红线 30 条 · 技术主观分占 45%」等解读要点 + 报告绝对全路径（形如 `/Users/you/biaoshu-writer-files/某采购项目招标文件_智能解读.html`）（后续制作/审查自动复用该项目，无需重传）。

![智能解读报告示例](https://cdn-huokezu.bailian-ai.com/smart_bidding/skill/report-interpret.png)

### 📝 标书制作
- **输入**：已解读项目 + 分包选择（无分包时自动跳过选包）+ 用户确认的目标页数；页数上限必须以抽包结果里的 `max_total_pages` 为准。
- **输出**：成品投标文件 `.docx`——按招标文件名自动命名，自动完成选包、抽需求、生成大纲、生成正文、抽取制式模板并导出，含目录、章节与「待填项」定位书签。（此步按生成内容消耗可用字数。）
- **使用示例**（用户可以这样说）：
  - 「就用刚才解读的项目，帮我生成投标文件」
  - 「选 01 包，生成一份 80 页左右的标书，存到桌面」
  - 「这个项目出标书，包和页数你先列出来让我确认」
  - 「时间紧，先给我出个标书框架，页数用系统建议，但开始前先问我」
  - 用户得到：解读完成后，助手必须先抽取分包；如存在多个分包，展示分包清单并让用户选择；如无分包/单项目，不再询问包选择，直接进入页数确认。页数确认时展示「系统建议页数 / 最大页数 / 预计消耗字数」，并明确说明预计消耗仅供参考，实际消耗以平台最终结算为准；用户确认前不得提交生成任务。若用户输入页数超过 `max_total_pages`，必须拒绝提交；页数确认后直接继续提交生成任务，不做字数不足示警。确认后生成过程中必须持续播报阶段、百分比、已用时间和当前章节，平台暂未返回细节时也要每 5 秒转述运行中心跳。若生成中途因 `insufficient_balance` / `insufficient_points` 停止，必须明确说明平台不会自动续跑；如果后端已导出半成品，先交付半成品下载链接，并提示充值或购买字数包后可用 `continue-generate` 继续生成正文。最后交付短时下载链接或本地成品路径；下载链接有效期以平台返回的 `expires_in` 为准，失效后只能重新获取新链接。制式表格/范本会尽量自动抽取或生成，无法确认的信息保留为待填项。（此步按生成内容消耗可用字数，生成耗时可能超过 10 分钟；章节级进度取决于后端 `progress` 是否持续写入。）

### ✅ 标书审查
- **输入**：招标文件（已解读）+ **一份或多份**投标文件（`.doc` / `.docx` / `.pdf`，**支持多选，最多 100 份**；**单份 ≤ 1024 MB**，**总大小不超过 2GB**）。
- **审查选项**：支持标记暗标、电子投标；可填写敏感单位名称用于检索；可按需关闭语义审查，仅保留规则类检查。
- **输出**：分级风险问题清单（高风险 / 待复核 / 提示，每条带招标依据、投标证据、修改建议）+ 一句话结论 + 检查范围 + 语义审查状态/部分结果提示 + 多文件雷同检测 + 人工核查清单。可导出审查报告。（此步按平台规则消耗可用字数。）
- **使用示例**（用户可以这样说，招标文件需已解读）：
  - 「审查一下这份投标文件 `/Users/me/某项目_投标文件.docx` 有没有废标风险」
  - 「把 `A公司投标.docx` 和 `B公司投标.docx` 一起查一遍，看看有没有雷同和风险」
  - 「这是暗标，帮我查格式和红线问题，出一份合规报告」
  - 「投之前帮我把把关，别废标」（把投标文件发我或给我路径即可）
  - 用户得到：「高风险 0 · 待复核 39 · 提示 25」+ 一句话结论、检查范围、语义审查是否完整、整改建议 + 报告绝对全路径（形如 `/Users/you/biaoshu-writer-files/某采购项目招标文件_合规审查.html`）（多份文件时含雷同检测结果；部分结果不得说成完整审查）。

![合规审查报告示例](https://cdn-huokezu.bailian-ai.com/smart_bidding/skill/report-compliance.png)

> 报告采用 editorial 版式（侧栏目录、风险统计、卡片化问题与证据），HTML 可离线打开、可打印。

### 🔁 标书查重
- **入口判断**：用户说「查重 / 雷同 / 相似 / 两份像不像 / 会不会被判雷同 / 围标风险线索」时，才进入标书查重；不要误走标书审查。查重只比较**不同投标文件之间**的相似/雷同风险。
- **输入**：必须先收齐 `2-3` 份合法持有的**投标文件**（`.doc` / `.docx` / `.pdf`，本地路径或云端 URL；云端文件会先下载到本地再处理）。招标文件不是投标文件，不能凑数；如用户提供招标文件，只能作为可选的 `1` 份公共表述基线（≤ 50 MB）。投标文件单份 ≤ 1024 MB，总大小不超过 2GB。
- **发起前确认**：未收齐至少 2 份投标文件前，不得发起查重；收齐后还必须先确认用户合法持有并有权处理全部上传文件。查重结果仅供提交前内部自查，不构成围标、串标或违法违规的法律认定。
- **输出**：按文件对展示文本相似、图片相似、文档元数据、主体线索、招标原文共同表述等风险线索，包含风险率、证据片段和修改建议。当前 skill 输出完整 JSON 结果，可在标书服务平台查看历史报告。（此步按平台规则消耗可用字数。）
- **使用示例**（用户可以这样说）：
  - 「帮我查一下这两份投标文件有没有雷同风险：`/Users/me/A公司投标.docx` 和 `/Users/me/B公司投标.docx`」
  - 「这三份响应文件做一下相似检查，招标文件是 `/Users/me/招标文件.pdf`」
  - 「投之前帮我看两份标书像不像，会不会有围标风险线索」
  - 用户得到：如果投标文件不足 2 份，先提示「还需要至少 2 份投标文件才能查重」；如果已收齐，先请用户确认合法持有和处理权限，再发起查重。完成后展示文件对风险率、相似片段、图片/元数据/主体线索风险提示和修改建议。

智能解读、标书生成、标书审查、标书查重的结果均可同步在标书服务平台查看：<https://biaoshu.zhiliaobiaoxun.com/>

> 标书服务平台是面向投标场景的**投标全流程工作台**。网页工作台之外，也支持通过**开放 API 与 Skill 接入**完成解读、抽包、生成、标书审查与标书查重。
>
> **字数计费说明**：智能解读免费，可用字数为 0 也能发起；标书制作、标书审查、标书查重通过开放 API / Skill 按平台规则消耗可用字数。标书生成的预计消耗仅供页数确认参考，实际消耗以平台最终结算为准；生成前不做余额不足示警，也不做余额拦截。抽包、任务查询、结果获取、知识库查询等辅助查询不作为独立成果单独计费。

## 🪶 轻咨询也接得住 & 顺势衔接下一步

- **只给片段、问通用问题也接得住**：用户只粘了一段招标公告/采购需求，或问「投标要注意什么 / 暗标有什么要求 / 技术方案怎么写 / 常见废标原因有哪些 / 控标怎么识别」时，先给一段通用要点应答，**再按第一铁律说清「怎么给完整文件」**（上传文件，或给本地绝对路径 / 云端可下载 URL，并举个路径示例），引导补上文件后做定制解读/审查。
- **一步做完，顺势提示下一步**（用户不接就不再追）：解读完 → 问「要不要接着基于它生成投标文件？」；标书生成完 → 问「要不要再做一遍标书审查、排查废标风险？」；标书审查完 → 问「要不要按整改清单改完后复审一次？」；用户提供多份不同主体投标文件时 → 可提示「要不要单独做标书查重，看雷同/相似风险线索？」。

## 🚫 对用户输出的第一铁律（优先级最高，覆盖本文档其余所有内容）

- 本 skill 的一切命令（`python3 …`、`zcm.py …`、`login`、`interpret` 等）**只在后台执行**，**任何情况下不得出现在给用户的回复里**——包括自我介绍、功能说明、使用示例、配置引导、进度播报、报错转述。
- 用户只需要做三件事：**提供文件、说需求、粘贴 Api Key**。命令全部由你（助手）代跑。
- 用户问「怎么用 / 给我些示例」时，**只展示上方各功能「使用示例」里的场景话术**（用户怎么说 → 得到什么），并告诉他「把文件给我、直接说需求即可」。[references/usage.md](references/usage.md) 里的命令是你的后台操作手册，**不是可以展示给用户的内容**。
- **安装成功后的介绍、或用户问「这个 skill 能干什么 / 怎么拿 Api Key」时，输出必须包含两块，缺一不可**：
  ① **怎么获取 Api Key**——「快速开始：获取 Api Key」的拿 Key 路径，**尤其官网获取第 3 步的粘贴示例话术**（「我的 Api Key 是 bk_live_xxxxx，帮我保存一下」）必须原样出现；
  ② **有什么功能**——「四大功能」小节，**尤其各功能「使用示例」的场景话术和「用户得到」**必须完整出现。
  两块都**优先原文照抄**，不要改写成摘要；示例是强制项，任何精简都不得省略示例。
- **让用户提供文件时，必须说清「怎么给」**：无论是要招标文件还是投标文件，都不能只说「发给我」。要明确告诉用户两种方式任选——**① 直接上传文件；② 给出文件路径**（本地绝对路径，形如 `/Users/你的用户名/Downloads/某采购项目招标文件.pdf`，或云端可下载 URL；若给 URL，本 skill 会先下载到本地再处理），并**举一个具体路径示例**。别让用户猜格式。
- **产物交付必须清楚**：解读报告 / 合规报告 / 查重报告每次产出后，把**每个文件的完整绝对路径**（形如 `/Users/you/biaoshu-writer-files/某项目_智能解读.html`）逐行告诉用户；成品标书默认交付**短时下载链接**（脚本会打印链接、文件名、大小、有效期），用户明确要本地文件时再用 `result <job_id> -o <路径>.docx` 下载并告知绝对路径。标书查重未请求报告时只总结 JSON 核心结论，不编造本地报告路径。
- **凭证保护**：不得在回复中复述、展示或转发 Api Key，也不得把 Api Key 拼入任何给用户打开的 URL。充值/自助操作只给官网普通地址，不要把 Api Key 拼进任何 URL。

## 进一步

凭 **Api Key** 调用标书服务开放 API，无需登录网页即可闭环完成投标全流程。所有任务走「**提交 → 自动轮询 → 取结果**」统一异步模型，以 Api Key 所属用户身份执行（复用其知识库与可用字数账户）。底层由零依赖 Python 客户端封装鉴权、轮询与友好错误码（具体命令见 [references/usage.md](references/usage.md)）。

- **执行任务前先读** [references/usage.md](references/usage.md)：各步参数、命名规则、计费与凭证规则、报告/边界情形、断点续查、幂等、错误处理。
- **输出铁律**（除非用户明确说不要）：运行脚本时进度照常显示、不重定向吞掉；解读/标书/合规结果文件的**绝对全路径**必须打印给用户。详见 usage.md 顶部「⚠️ 输出约定」。
- **接口契约**（开放 API 端点、错误码、解读/合规/查重返回字段）→ 见 [references/api.md](references/api.md)。

使用说明

# 标书写作助手

上传招标/投标文件，一站式完成智能解读（废标红线/评分标准/控标洞察）、成品投标文件生成、标书审查（分级风险+雷同检测）和标书查重。

## 使用

需先配置标书服务的 Api Key（官网 https://biaoshu.zhiliaobiaoxun.com/ 注册后，在「Skill 接入 → 获取 Api Key」获取）。然后直接描述需求，例如：

```text
解读一下这份招标文件，有哪些废标红线
基于这个项目帮我生成投标文件
检查这几份投标文件有没有雷同风险
```

## 工作原理

通过标书服务开放 API 以「提交 → 自动轮询 → 取结果」的异步模型完成云端处理：解读抽取项目信息与评分要点，制作按分包与页数生成 .docx 成品，审查与查重输出分级风险报告。智能解读免费，制作/审查/查重按可用字数计费。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。