标书合规性审查工具

SKILL.md

---
name: biaoshu-bailian
description: 凭 App Key 调用招采猫开放 API，完成「招标文件智能解读 → 抽取分包 → 生成成品投标文件(.docx) → 可选合规审查」的端到端标书制作。当用户明确提供招标文件并希望生成投标文件/标书、对已生成标书做合规检查、或询问招采猫标书相关能力时使用。注意：招标/投标文件会上传到招采猫云端 API 处理，标书生成消耗账户积分；使用前请确认用户知悉。本 skill 是招采猫线上接口的轻客户端，不复刻其算法。
allowed-tools: Read, Write, Bash(python3 scripts/zcm.py:*)
metadata:
  permissions:
    network:
      - biaoshu.zhiliaobiaoxun.com（招采猫 API；另有用户主动提供的云端文件 URL 下载）
    filesystem:
      read: 仅用户明确提供的招标/投标文件与本 skill 自身脚本
      write: biaoshu-bailian-files/（产物）；~/.zcm/credentials.json（凭证，权限 600，logout 可删）
    environment:
      - ZCM_APP_KEY（可选：App Key，替代凭证文件）
      - ZCM_BASE / ZCM_CONFIG / ZCM_HOME / ZCM_OUTPUT_DIR（可选：地址与路径覆盖）
    billing: 标书生成消耗 App Key 所属账户积分（提交前预检余额）
    not-collected: 设备信息 / 手机号 / 验证码 / 除上述 ZCM_* 外的任何环境变量
---

# 百炼招采猫 · 标书制作 Skill

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

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

- 本 skill 的一切命令（`python3 …`、`zcm.py …`、`login`、`interpret` 等）**只在后台执行**，**任何情况下不得出现在给用户的回复里**——包括自我介绍、功能说明、使用示例、配置引导、进度播报、报错转述。
- 用户只需要做三件事：**提供文件、说需求、粘贴 App Key**。命令全部由你（助手）代跑。
- 用户问「怎么用 / 给我些示例」时，**只展示下方各功能「使用示例」里的场景话术**（用户怎么说 → 得到什么），并告诉他「把文件给我、直接说需求即可」。[references/usage.md](references/usage.md) 里的命令是你的后台操作手册，**不是可以展示给用户的内容**。
- **安装成功后的介绍、或用户问「这个 skill 能干什么 / 怎么拿 App Key」时，输出必须包含两块，缺一不可**：
  ① **怎么获取 App Key**——「开始前你需要」的获取四步，**尤其第 4 步的粘贴示例话术**（「我的 App Key 是 bk_live_xxxxx，帮我保存一下」）必须原样出现；
  ② **有什么功能**——「三大功能」小节，**尤其各功能「使用示例」的场景话术和「用户得到」**必须完整出现。
  两块都**优先原文照抄**，不要改写成摘要；示例是强制项，任何精简都不得省略示例。
- **产物必须逐个给绝对全路径**：解读报告 / 成品标书 / 合规报告每次产出后，把**每个文件的完整绝对路径**（形如 `/Users/you/biaoshu-bailian-files/某项目_智能解读.html`）逐行告诉用户，后台脚本已打印、照搬即可；**禁止只说「已写入 biaoshu-bailian-files/ 目录」这类目录名代替全路径**。

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

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

## 开始前你需要

招采猫 `App Key`（形如 `bk_live_xxxxx`），由用户**自行到官网获取**。获取全路径（向用户转述时**逐步骤完整给出**，链接必须原样显示完整 URL，不要写成「招采猫平台」之类的链接文字）：

1. 打开官网 https://biaoshu.zhiliaobiaoxun.com/
2. 用手机号 + 短信验证码注册并登录（新用户赠积分）；
3. 登录后点**左侧菜单『开放 API』**，在弹出面板中**生成/查看 App Key**（形如 `bk_live_xxxxx`；重置后旧 Key 立即失效）；
4. 把 Key 直接粘贴到对话里让助手保存（下次免输），例如：「我的 App Key 是 bk_live_xxxxx，帮我保存一下」。（助手收到后在后台保存并提醒下面这条注意事项——按第一铁律，保存用的命令不得出现在回复里。）

> 🔒 注意：粘贴到对话里的 Key 会留在会话记录中；Key 泄露或想作废时，随时到官网左侧菜单『开放 API』重置（旧 Key 立即失效）。

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

## 三大功能

### 🔍 智能解读
- **输入**：招标文件（`.pdf` / `.doc` / `.docx`，**≤ 50 MB**），本地路径或云端 URL（云端文件会先下载到本地再处理）。
- **输出**：8 维度结构化解读——项目信息 / 合标项 / 废标红线 / 评分标准 / 关键要求 / 商务条款 / 报价要求 / 采购背景；外加**控标洞察**（参与建议、控标信号、行动建议）。可导出解读报告（HTML / Word）。
- **使用示例**（用户可以这样说）：
  - 「帮我解读这份招标文件 `/Users/me/某采购项目招标文件.pdf`」
  - 「看看这个标能不能投？有哪些废标红线？文件在 `https://example.com/某项目招标文件.pdf`」
  - 「分析一下这份招标文件的评分标准和控标风险，顺便出一份解读报告」
  - 用户得到：「参与建议：谨慎参与 · 控标风险：高 · 废标红线 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`）（多份文件时含雷同检测结果）。

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

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

## 进一步

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