招标文件解析助手

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)）。

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

- **文件外发**：用户提供的招标/投标文件会**上传至招采猫服务器**（`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，帮我保存一下」。（助手收到后代跑 `login` 保存并提醒下面这条注意事项，别把命令抛给用户，见 usage.md。）

> 🔒 注意：粘贴到对话里的 Key 会留在会话记录中。介意的用户可以不经对话、自行在终端运行 `python3 scripts/zcm.py login --app-key <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%」等解读要点 + 报告全路径《某采购项目招标文件_智能解读.html》（后续制作/审查自动复用该项目，无需重传）。

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

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