镖行AI投标文件生成助手

SKILL.md

---
name: biaoshu-writer-service
description: 侧重把成稿改到能打。对照招标文件要求，它对已生成或已有的技术标、商务标逐段润色精修，补齐待填项，排查废标红线并完成合规审查，输出更稳的 .docx。凡涉及撰写标书、精修投标文件、成稿把关，都通过 App Key 调用本 SKILL。
allowed-tools: Read, Write, Bash(python3 scripts/zcm.py:*)
metadata:
  permissions:
    network:
      - biaoshu.zhiliaobiaoxun.com（招采猫 API，唯一外联目标）
    filesystem:
      read: 仅用户明确提供的招标/投标文件与本 skill 自身脚本
      write: biaoshu-bailian-files/（产物）；~/.zcm/config.json（凭证，权限 600，logout 可删）
    environment:
      - ZCM_APP_KEY（可选：App Key，替代凭证文件）
      - ZCM_BASE / ZCM_CONFIG / ZCM_HOME / ZCM_OUTPUT_DIR（可选：地址与路径覆盖）
    billing: 标书生成消耗 App Key 所属账户积分（提交前预检余额）
    not-collected: 设备信息 / 手机号 / 验证码 / 除上述 ZCM_* 外的任何环境变量
---

# 招采猫 AI 标书助手

把招标文件交给 AI，三步拿到能投的标：

- 🔍 **智能解读**——8 维度拆解招标文件：废标红线、评分标准、关键要求，外加控标洞察（参与建议 / 控标信号 / 行动建议）
- 📝 **标书制作**——直接产出成品投标文件 `.docx`：目录、章节、「待填项」定位书签齐全，可指定页数
- ✅ **合规审查**——高风险 / 待复核 / 提示分级风险清单，每条带招标依据与修改建议，支持多文件雷同检测

![智能解读报告示例](https://raw.githubusercontent.com/chichihaixiaojian666/biaoshu-skill/main/report-interpret.png)

新用户注册即送积分，装好就能试；解读 / 制作 / 审查全程在对话里完成，无需学任何命令。

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

## 三大功能

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

### 📝 标书制作
- **输入**：已解读项目 + 选定分包（多包时）；可指定目标页数。
- **输出**：成品投标文件 `.docx`——按招标文件名自动命名，含目录、章节与「待填项」定位书签。（此步消耗积分。）
- **使用示例**（用户可以这样说）：
  - 「就用刚才解读的项目，帮我生成投标文件」
  - 「选 01 包，生成一份 80 页左右的标书，存到桌面」
  - 「这个项目直接出标书，页数按系统建议来」
  - 用户得到：多包项目会先看到分包清单供挑选，然后拿到成品绝对全路径（形如 `/Users/you/biaoshu-bailian-files/某采购项目招标文件_投标文件.docx`），可直接编辑填充。（此步消耗积分，生成耗时可能超过 10 分钟，期间实时播报进度。）

### ✅ 合规审查
- **输入**：招标文件（已解读）+ **一份或多份**投标文件（`.doc` / `.docx`，每份 **≤ 1024 MB**）。
- **输出**：分级风险问题清单（高风险 / 待复核 / 提示，每条带招标依据、投标证据、修改建议）+ 多文件雷同检测 + 人工核查清单。可导出合规报告。
- **使用示例**（用户可以这样说，招标文件需已解读）：
  - 「审查一下这份投标文件 `/Users/me/某项目_投标文件.docx` 有没有废标风险」
  - 「把 `A公司投标.docx` 和 `B公司投标.docx` 一起查一遍，看看有没有雷同和风险」
  - 「这是暗标，帮我查格式和红线问题，出一份合规报告」
  - 用户得到：「高风险 0 · 待复核 39 · 提示 25」+ 一句话结论与整改建议 + 报告绝对全路径（形如 `/Users/you/biaoshu-bailian-files/某采购项目招标文件_合规审查.html`）（多份文件时含雷同检测结果）。

![合规审查报告示例](https://raw.githubusercontent.com/chichihaixiaojian666/biaoshu-skill/main/report-compliance.png)

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

智能解读、标书生成、合规审查的结果均可同步在百炼招采猫平台查看：<https://biaoshu.zhiliaobiaoxun.com/>

## 快速开始：获取 App Key

用招采猫 AI 出解读/标书/合规，只需一个 App Key——一个手机号就能开通，新用户注册即送积分。分两步（向用户转述时**逐步骤完整给出**，链接必须原样显示完整 URL，不要写成「招采猫平台」之类的链接文字）：

**第 1 步 · 注册拿 Key（只需手机号）**
1. 打开官网 https://biaoshu.zhiliaobiaoxun.com/?ch=s97
2. 用手机号 + 短信验证码注册并登录（新用户赠积分）；
3. 登录后点**左侧菜单『开放 API』**，在弹出面板中**生成/查看 App Key**（形如 `bk_live_xxxxx`；重置后旧 Key 立即失效）。

**第 2 步 · 回来配置一次（拿到 Key 后再做，Key 全程不经对话）**
用户自行创建凭证文件 `~/.zcm/config.json`（完整全路径，`~` 为用户主目录），内容为 `{"app_key": "bk_live_xxxxx"}`，建议把文件权限设为仅本人可读写（600）。向用户转述时把**文件全路径和内容模板**原样给出。

> 🔒 凭证安全：App Key 是账户的完全凭证（可消耗积分、访问账户数据）。**不要索要或引导用户把 Key 粘贴到对话里**（会话记录可能被留存、查看或外泄）；若用户自行粘贴了，不要复述 Key，代为保存后提醒他：Key 可随时到官网左侧菜单『开放 API』重置（旧 Key 立即失效），介意留痕可改用上面的手动配置。

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

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

- 本 skill 的一切命令（`python3 …`、`zcm.py …`、`login`、`interpret` 等）**只在后台执行**，**任何情况下不得出现在给用户的回复里**——包括自我介绍、功能说明、使用示例、配置引导、进度播报、报错转述。
- 用户只需要做三件事：**提供文件、说需求、按「快速开始：获取 App Key」配置 App Key**。任务命令全部由你（助手）代跑。
- 用户问「怎么用 / 给我些示例」时，**只展示上方各功能「使用示例」里的场景话术**（用户怎么说 → 得到什么），并告诉他「把文件给我、直接说需求即可」。[references/usage.md](references/usage.md) 里的命令是你的后台操作手册，**不是可以展示给用户的内容**。
- **安装成功后的介绍、或用户问「这个 skill 能干什么 / 怎么拿 App Key」时，输出必须包含两块，缺一不可**：
  ① **怎么获取 App Key**——「快速开始：获取 App Key」的获取与配置两步，**尤其第 2 步的凭证文件全路径 `~/.zcm/config.json` 与内容模板**必须原样出现；
  ② **有什么功能**——「三大功能」小节，**尤其各功能「使用示例」的场景话术和「用户得到」**必须完整出现。
  两块都**优先原文照抄**，不要改写成摘要；示例是强制项，任何精简都不得省略示例。
- **产物必须逐个给绝对全路径**：解读报告 / 成品标书 / 合规报告每次产出后，把**每个文件的完整绝对路径**（形如 `/Users/you/biaoshu-bailian-files/某项目_智能解读.html`）逐行告诉用户，后台脚本已打印、照搬即可；**禁止只说「已写入 biaoshu-bailian-files/ 目录」这类目录名代替全路径**。
- **凭证不进对话**：不得索要或引导用户在对话中提供 App Key，不得在回复中输出 App Key，也不得转发任何**携带 Key 的链接**（如平台 402 返回的 `?bind_key=` 充值/绑定链接——会经会话记录、截图、链接预览泄露）；涉及充值/账户操作只给不含参数的官网普通链接。

## ⚠️ 权限与数据说明（首次使用前告知用户）

- **文件外发**：用户提供的招标/投标文件会**上传至招采猫服务器**（`biaoshu.zhiliaobiaoxun.com`）处理。此类文件常含商业、报价与个人信息，上传前须确认用户知悉并同意。
- **网络访问**：仅访问上述招采猫域名（API 调用），无其他外联；不抓取任何云端链接。
- **本地读写**：读取用户指定的文件；产物（标书/报告）写入 `biaoshu-bailian-files/`；凭证存 `~/.zcm/config.json`（权限 600，skill 目录之外）。
- **数据留存**：上传的文件与产出结果以 App Key 所属账户身份**留存在招采猫服务器**——任务结果与成品 .docx 约 7 天后过期，历史数据可登录官网查看管理。
- **计费**：标书生成消耗 App Key 所属账户的积分，提交前脚本会预检余额。
- **环境变量**：仅读取上方 frontmatter 声明的 `ZCM_*` 可选配置项，不读取其他任何环境变量。
- **不采集**：本 skill 不采集设备信息、不代注册账号、不收集手机号/验证码。

## 进一步

凭 **App Key** 调用招采猫开放 API，完成投标全流程。所有任务走「**提交 → 自动轮询 → 取结果**」统一异步模型，以 App Key 所属用户身份执行（复用其知识库与积分钱包）。底层由零依赖 Python 客户端封装鉴权、轮询与友好错误码（具体命令见 [references/usage.md](references/usage.md)）。

- **执行任务前先读** [references/usage.md](references/usage.md)：各步参数、命名规则、计费与凭证规则、报告/边界情形、断点续查、幂等、错误处理。
- **输出铁律**（除非用户明确说不要）：运行脚本时进度照常显示、不重定向吞掉；解读/标书/合规结果文件的**绝对全路径**必须打印给用户。详见 usage.md 顶部「⚠️ 输出约定」。
- **链接铁律**：凡向用户展示招采猫平台地址（注册、查看结果、充值、绑定等），一律**原样输出完整 URL**（如 https://biaoshu.zhiliaobiaoxun.com/ ），不要用「招采猫平台」「官网」这类超链接文字代替或省略。
- **接口契约**（8 端点、错误码、解读/合规返回字段附录 A·B）→ 见 [references/api.md](references/api.md)。