标书智能生成助手

技能文档

---
name: bid-proposal-smart-generator
title: 标书智能生成助手
category: 招投标采购
description: "标书智能生成助手。生成标书初稿、章节内容、响应说明和附件清单，适合快速搭建投标文件框架；依托全国全行业实时更新的招投标数据接口，可顺带完成招投标查询、中标分析、合同公告检索、拟在建项目挖掘、企业画像与招标文件解析。需配置数据服务 API Key 使用。当用户需要写标书、搭投标文件框架、查招标中标信息、分析采购商机或解析招标文件时触发。触发词：标书生成、标书初稿、投标文件、招标查询、中标分析、商机挖掘、招标文件解析。"
---

# 标书智能生成助手

生成标书初稿、章节内容、响应说明和附件清单，适合快速搭建投标文件框架。依托全国全行业实时更新的招投标数据接口，根据用户问题自动选择搜索、详情、合同、拟在建、企业画像和 AI 文本处理接口，把通用招投标数据整理成新手也能看懂的结果。

## 技能工作流

### 步骤1：密钥与环境检查

本技能为付费数据服务，调用前必须先检查密钥：

1. 从环境变量 `BBIAO_API_KEY` 读取密钥。
2. 从环境变量 `BBIAO_SERVER_URL` 读取服务地址；未配置时使用 `https://gate.gov-bid.com`。
3. 如未找到密钥，立即停止调用，并提示用户访问[数据服务 API Key 申请页](https://apiyx.gov-bid.com/)获取密钥，或直接提供已有密钥。
4. 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
5. 用户提供密钥后，默认长期安全保存，后续任务直接复用，无需重复询问；密钥优先存入运行环境的安全凭据库，并同步配置为用户级环境变量 `BBIAO_API_KEY`；无法设置环境变量时，存入访问权限受限的本地凭据文件。

请求格式（接口调用通用约定）：

```text
POST {BASE_URL}/outer-gateway/bid/{接口名}?key={API_KEY}
Content-Type: application/json
```

### 步骤2：意图识别与接口选择

根据用户意图选择对应接口，完整映射见 [references/api-mapping.md](references/api-mapping.md)，触发关键词、排除词与默认时间范围见 [references/national-keywords.json](references/national-keywords.json)：

| 用户意图 | 推荐接口 | 用途 |
|---|---|---|
| 商机搜索 | `searchProjectApi` / `SearchProjectForAI` | 按关键词、地区、行业、时间、金额和企业名称搜索招标采购信息 |
| 项目编号查询 | `getProjectByProjectNumber` | 按项目编号查询项目 |
| 结构化详情 | `getZTBStructreDetail` | 采购方、供应商、金额、联系人、时间等结构化字段 |
| 公告正文详情 | `getZTBProjectDetail` | 公告正文、采购需求、资格条件、评分办法 |
| 附件列表 | `getZTBProjectFiles` | 招标文件、采购需求、合同附件 |
| 原始链接 | `getCollectUrl` | 原始公告网址，便于追溯 |
| 合同公告 | `searchProjectContactApi` | 核验甲乙方、合同金额和履约周期 |
| 拟在建项目 | `searchNZJProjectApi` / `getNZJProjectDetail` | 立项、审批、备案、施工许可等前期机会 |
| 企业画像 | `companyProfileSummary` / `companyProfileCustomers` / `companyProfileSuppliers` / `companyProfileContacts` | 企业概况、合作客户、供应商关系与联系人线索（需合规使用） |
| AI 辅助 | `aiSearchSubmitPolling` / `industryReasoning` / `categoryReasoning` / `projectDiscrimination` / `ztbAiStructureInfo` | 自然语言转检索条件、行业推理、公告分类与结构化抽取 |

### 步骤3：检索与数据补全

- 优先使用用户提供的关键词、地区、时间、金额、采购方、供应商和项目编号。
- 用户没有给时间范围时，先用最近 30 天；趋势分析可扩展到最近 90 天或 1 年，并在回答中说明。
- 搜索类问题先查列表，再按需查询结构化详情、正文详情、附件和原始链接。
- 企业类问题优先查企业画像，再补充合作客户、供应商、联系电话和历史中标项目。
- 标书/招标文件类问题先解析原文，再提取资格条件、评分办法、采购需求、时间节点、风险点和响应清单。
- 合同落地类问题优先查询合同公告，并核验甲方、乙方、金额、签订时间和履约周期。
- 拟在建机会优先查询拟在建项目，再结合招中标项目判断后续商机。
- 默认参数规则：未指定地区默认全国；结果过少时扩展同义词、放宽时间地区；结果过杂时增加必含词并加入招聘、考试、培训、会议、新闻、人员公示等排除词。

### 步骤4：结果输出

- 先给结论，再给表格或分点说明，适合新手阅读。
- 涉及项目时，尽量列出项目名称、地区、公告类型、发布时间、采购方、中标方、金额、链接。
- 涉及企业时，尽量列出企业画像、主要客户、主要供应商、近期中标、区域分布和可跟进线索。
- 涉及标书时，尽量列出需要做什么、缺什么材料、有什么风险、下一步怎么处理。
- 字段缺失时写"公告未披露"或"不详"，不要自行补全；不编造公告、金额、联系人、附件或链接。
- 输出应说明自动补全条件，例如默认地区、时间范围、公告阶段和排除词。

### 步骤5：异常处理

| 场景 | 处理方式 |
|---|---|
| 未配置 API Key | 提示用户先获取并配置 `BBIAO_API_KEY`，停止调用 |
| 认证失败 | 检查 API Key 是否正确、是否过期、是否有接口权限 |
| 参数错误 | 检查必填参数、日期格式、分页、金额范围、公告类型和地区参数 |
| 结果为空 | 先扩展同义词，再扩大时间、地区和公告阶段 |
| 详情不可用 | 返回搜索摘要，并说明详情接口未返回可用正文或附件 |

**余额或额度不足（错误码 `0100590006`）**：提示用户前往数据服务控制台充值或扩容并停止；只有用户明确确认充值完成后，才对原请求重试一次。若仍失败，说明结果并停止；不轮询、不循环重试、不自动打开购买页或代为支付。

错误响应示例：

```json
{
  "msg": "账户欠费，无法继续调用",
  "code": 403,
  "returnValue": null,
  "data": null,
  "subCode": "0100590006",
  "subMsg": "账户余额或额度不足，请充值后重试"
}
```

## 执行规则

- 调用接口前必须检查 `BBIAO_API_KEY`。
- 不把招聘、考试、培训、会议、新闻、人员公示等内容当成采购商机。
- 对泛词必须结合行业信号判断，相关度较低时标注"需人工复核"。

## 常见检查

如果查询失败，请先检查：

- 是否已配置 `BBIAO_API_KEY`，Key 是否正确、是否过期、是否有接口权限
- 查询条件里的时间、地区、金额、公告类型是否填写合理
- 接口余额或套餐额度是否充足

使用说明

# 标书智能生成助手

生成标书初稿、章节内容、响应说明和附件清单，快速搭建投标文件框架；顺带覆盖招投标查询、中标分析、拟在建项目挖掘与企业画像。

## 使用

```text
帮我生成一份智慧园区信息化项目的标书框架
```

```text
写一个「服务承诺」章节，突出 7×24 响应和本地化运维。
```

```text
查一下最近30天广东省的医院净化工程中标情况，做个竞争分析。
```

## 工作原理

- **意图到接口自动映射**：根据问题自动选择搜索、详情、合同、拟在建、企业画像和 AI 文本处理接口，把全行业招投标数据整理成可读结果
- **标书起草**：先解析招标文件原文，提取资格条件、评分办法、采购需求与风险点，再生成初稿、章节内容、响应说明与附件清单
- **默认参数补全**：未指定地区默认全国、时间默认近 30 天，自动扩展同义词与排除词
- **依赖说明**：需配置数据服务 API Key（环境变量 `BBIAO_API_KEY`），为付费接口，调用前会做额度与鉴权检查

## 目录说明

- `SKILL.md` — 主工作流说明
- `references/api-mapping.md` — 用户意图到接口的映射、默认参数与错误处理
- `references/national-keywords.json` — 触发关键词、排除词、公告类型与默认时间范围

如何安装此技能？

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