喜鹊标书助手

技能文档

---
name: xique-ai
title: 喜鹊标书助手
category: 招投标采购
description: 基于 xique-bid MCP 服务完成投标文件全流程生成，覆盖招标文件解析、一页式参数配置、大纲生成与修改、正文续写、任务状态跟踪与 Word 导出。当用户需要撰写标书、生成投标文件、制作技术标、生成或修改标书大纲、导出标书文档时触发。触发词：标书、投标文件、技术标、标书大纲、暗标、标书导出。
---

# 喜鹊标书工作流

只通过 `xique-bid` MCP 工具执行标书业务。禁止直接运行 `xq-cli wizard`、`xq-cli init`、
`xq-cli outline`、`xq-cli write`、`xq-cli export` 等命令行旁路，禁止创建辅助脚本、
手动启动 MCP 服务，或把日志、进程状态当作任务完成依据。

业务开始前必须调用 `xique_runtime_status`，读取结构化字段 `cliVersion`、`cliFound` 与
`loggedIn`；不能只根据「工具可用」判断服务就绪。

## 技能工作流

### 步骤1：运行状态与登录检查

1. 调用 `xique_runtime_status`。若 `loggedIn=false`、`authType=missing` 或
   `apiKeyConfigured=false`，运行时会自动打开本机 API Key 登录页，同时提示手动命令
   `xq-cli login --api-key xq_sk_xxx`。不得询问登录方式，不得展示「方式一/方式二」、
   账号密码或浏览器授权选项，也不得要求用户回复授权。
2. 提示用户在已打开的页面填写 API Key，或在本机终端把命令中的 `xq_sk_xxx` 替换为真实
   Key 后执行；也可以先设置环境变量 `XQ_API_KEY`（PowerShell：`$env:XQ_API_KEY="xq_sk_xxx"`；
   Bash：`export XQ_API_KEY="xq_sk_xxx"`）。API Key 不要粘贴到聊天消息中。
3. API Key 在官网 `https://www.xiquebiaoshu.com/` 注册后创建。
4. 反复调用 `xique_runtime_status` 直到 `loggedIn=true`；登录完成前不要创建或上传生成任务。

### 步骤2：上传解析招标文件

1. 取得招标文件（或源文件）的本机绝对路径，调用一次 `xique_prepare_source`。它只上传并
   解析文件，不生成大纲；记录返回的 `runId`。
2. 持续调用 `xique_generation_status(runId, waitSec=60)` 查询解析进度。

### 步骤3：一页式投标配置

解析完成后状态返回 `awaiting_input/bid-config`，必须立即显式调用绑定该 `runId` 的
`xique_bid_configuration(runId)` 打开统一配置页。状态工具只报告阶段，不负责打开配置页。

配置页要求：

- 字段顺序与官网 Web 端保持一致；排版相关设置采用折叠分组。
- 如果已预解析出多标包/EPC，在最顶部显示「多标包选择」和「EPC项目编写范围」；普通文件
  不显示这两项。多标包和 EPC 只显示本次预解析任务返回的真实选项，不显示占位项，不允许
  手工填写 ID。EPC 选项只允许 `全部编写`、`只写施工`、`只写设计`、`这不是EPC项目`。
- 篇幅：`极短篇（50–100页）`、`超短篇（100–200页）`、`短篇（200–350页）`、
  `中篇（350–500页）`、`中长篇（500–800页）`、`长篇（800–1200页）`、
  `超长篇（1200–1500页）`。传给 MCP 时只传括号前的名称。
- 写作质量：`标准写作`、`专家智笔`、`旗舰智笔`。极短篇和超短篇固定使用标准写作。
- 计划模式：`快速`、`规划`，默认快速。配置消息中已提供计划模式时必须原样提交：
  `规划` 对应 `--plan-mode 1`，`快速` 对应 `--plan-mode 0`，不得把规划改成快速；只有
  配置消息没有该字段时才补默认快速。
- 正文风格：`增强图文`、`全表格式`、`丰富图文`、`基础配图`、`纯文字`。
- 表格：`无（不插入表格）`、`少量（约每4页1表）`、`丰富（约每2页1表）`；表格颜色：
  `黑色`、`蓝色`、`红色`、`绿色`、`紫色`、`青色`、`橙色`；表格样式：`纯净版`、
  `表头强化`、`斑马条纹`、`全底色白框`。
- 图片设置分组默认展开，必须展示全部选项：`我的图库`、`实拍风格图`、`PPT式插图`、
  `流程图`、`无配图`，并在同一分组提供流程图样式（`灰色`、`紫色`、`蓝色`、`绿色`、
  `橙色`、`红色`）；图片尺寸单独设置。构建配置页时必须内部调用 `xique_gallery_status`
  查询图库状态：有图片时显示 `我的图库（可用，共N张）`；无图片或查询失败时显示
  `我的图库（暂无图片，不可选）` 并保持关闭。实拍风格图同时控制 `sceneImg=1` 和
  `onlineImg=1`；PPT式插图对应 `infoImg=1`；流程图对应 `mermaidImg=1`；无配图与其他
  图片类型互斥。
- 暗标设置：`按通用方式生成`（默认）、`按暗标生成`。提交后必须真实进入大纲请求的
  `blindBidConfirm.blindGenerationMode=normal|blind`，不能只停留在界面字段。
- 导出格式设置（表格样式、表格颜色、流程图样式、导出模板、导出布局、自动编号、修改
  标记、页边距、图片尺寸）。导出模板五选一：`模板1｜章节目次（第一章→第一节→一、）`、
  `模板2｜中文层级（一、→（一）→1）`、`模板3｜全数字分级（1→1.1→1.1.1）`、
  `模板4｜章节+数字（第一章→1→1.1）`、`模板5｜自定义编号（可视化设置）`。导出布局：
  `常规`、`全表`、`精排`。自动编号默认开启，修改标记默认关闭。
- 输出路径：`默认`、`指定路径`。只有选择指定路径后才允许询问绝对路径。
- 不得展示高级样式 JSON 输入框，不得要求用户输入多标包 ID、标包类型或 EPC 类型。

配置页预选项：标准写作、快速、基础配图、丰富表格、按通用方式生成暗标、纯净版、蓝色、
仅流程图、灰色流程图、模板1、常规、自动编号开启、修改标记关闭、默认输出路径；篇幅保持
未选择。用户可修改任何预选项；只有点击提交后，卡片实际值才算用户选择。只有用户明确说
`用默认配置`、`你自己定` 或 `随便先跑一版` 时，才可补齐篇幅=短篇并采用全部预选值。

用户提交后不得再次打开配置页或允许二次选择；只在用户之后单独修改某一项时使用
`xique_select_option`。

### 步骤4：生成大纲

1. 用户提交统一配置页后，把 `structuredContent.config`（含 `sourceRunId`）传给一次
   `xique_prepare_bid`，不得再次询问或改写已选择字段。
2. 原样展示 `xique_prepare_bid` 返回的完整配置摘要，明确说明尚未开始生成。
3. 调用 `xique_outline_start(context=完整配置摘要, confirmationId=准备结果)`，展示
   `确认开始`、`返回修改`、`取消`。摘要之后的点击才是有效生成确认。
4. 用户点击确认后，只调用一次 `xique_generate_bid`。返回的 `runId` 与预解析任务相同；
   该调用复用已有 `cid/uuid`，只启动大纲生成，不得再次解析、上传或创建任务。
5. 立即调用 `xique_generation_status(runId, waitSec=60)` 并持续查询同一任务。本地轮询
   窗口到期不是失败，不得创建替代任务。
6. 规划模式的智能解读只作为后台阶段，不向用户展示 `analysis-review`，也不打开智能解读
   确认卡；持续查询同一 `runId`，不得调用其他工具推进这个内部阶段。
7. 处理阶段分支（每次只调用一次对应工具，随后用 `xique_apply_*` 提交，继续同一 `runId`，
   不得重新上传或创建任务）：
   - `awaiting_input/period-confirm`：调用 `xique_period_confirmation` 收集 `periodMode`、
     `contractPeriod`，日期已知时再收集起止日期，随后 `xique_apply_period_confirmation`。
   - `awaiting_input/bidder-role`：调用 `xique_bidder_role_selection` 展示
     「我们自己生产 / 我们采购供应」，用户选择后 `xique_apply_bidder_role_selection`。
   - 商务标任务（`originType=3`）：必须在配置页选择投标公司，展示企业资信库真实公司，
     提交 `bidderCompanyId` 与 `bidderCompanyName`；列表为空时保持必填并明确提示。
   - `awaiting_input/supplement`：按 `supplementIssue` 打开补充卡。`score_judgement` 使用
     `xique_score_supplement`（支持输入评分细则或上传评分文件），其余问题使用
     `xique_parse_supplement`。`requirement_exist` 只能输入或上传招标需求，不能跳过；
     `requirement_judgement`、`billOfQuantities_judgement`、`score_judgement` 可选择
     「不补充，直接生成」；`directory_judgement` 只输入目录要求或明确不采用。提交后调用
     `xique_apply_parse_supplement`（评分兼容别名 `xique_apply_score_supplement`）。
   - 后台返回 `scoreAndDirectory_judgement` 时改用 `xique_outline_basis_selection`
     （融合评分和参考目录 / 仅依据评分 / 仅依据参考目录）；返回
     `reference_selection_required` 时改用 `xique_reference_basis_selection`；返回
     `bidderIdentity_judgement` 时改用 `xique_bidder_role_selection`。
   - `awaiting_input/basis-selection`：调用 `xique_outline_basis_selection` 选择解析依据，
     随后 `xique_apply_outline_basis_selection`。
   - `awaiting_input/reference-selection`：调用 `xique_reference_basis_selection`，用
     「融合响应 / 仅格式要求 / 仅评分要求」三个页签展示完整候选目录树；切换页签只是预览，
     用户点击「按当前思路生成大纲」后才调用 `xique_apply_reference_basis_selection`。
   - 返回未列入上述清单的 `*_judgement=0` 时不要猜测类型或继续轮询；保留同一 `runId`，
     报告 `unsupported_intermediate_state` 并提示升级服务后恢复。

### 步骤5：大纲确认与修改

1. 状态变为 `awaiting_confirmation/outline-review` 时，完整展示 `outlineDetail.outLine`
   的每一行，包含标题、主题、重要性和 id。每个数组元素显示为独立编号块，并核对显示数量
   等于数组长度；不得只显示章节数量或摘要。
2. 调用一次 `xique_prepare_outline_continue(runId)`，把完整大纲、摘要、准确的 `runId` 和
   `confirmationId` 传给 `xique_outline_confirmation`，展示：`确认大纲并生成正文`、
   `修改大纲`、`暂不继续`。
3. 用户选择 `修改大纲` 后：
   - 询问具体修改要求，基于最新结构化大纲构造完整 `outLine` 数组。
   - 保留所有未修改章节及 id；只有用户明确要求删除时才移除现有行；新增行不带 id。
   - 调用 `xique_prepare_outline_update`，完整展示新增、修改、删除、移动、重要性变化和
     续写要求。
   - 调用 `xique_outline_update_confirmation`，展示 `确认保存修改`、`返回调整`、`取消`；
     只有点击确认后才调用 `xique_apply_outline_update`。
   - 保存后完整展示最新大纲，并明确说明：`修改已保存，但正文尚未开始，仍需确认最终大纲`。
   - 对同一个 `runId` 重新执行大纲最终确认，不得返回配置页或创建新任务。

### 步骤6：目录与正文生成

1. 快速模式：用户点击 `确认大纲并生成正文` 后，只调用一次 `xique_continue_bid`。
2. 规划模式：用户点击 `确认大纲并生成目录` 后，也只调用一次 `xique_continue_bid`；该调用
   只启动目录生成。目录完成后完整展示目录树。
3. 规划模式修改目录时，必须提交全部根节点和完整子树，保留所有已有节点 `id`，目录名称使用
   `text`；不得只提交被修改的章节。只有用户明确要求删除节点时才可传 `allowDelete=true`。
   通过 `xique_prepare_directory_update` / `xique_apply_directory_update` 修改并保存；保存
   失败时必须重新查看、重新预览并再次确认，禁止自动重复保存。保存后调用一次
   `xique_prepare_directory_continue`，再用 `xique_directory_confirmation` 展示
   `确认目录并生成正文`。用户确认后只调用一次 `xique_continue_content`。
4. 继续调用 `xique_generation_status(runId, waitSec=60)` 直到 `completed`、`failed` 或
   `blocked`。

### 步骤7：结果交付与导出

1. 只有结果同时满足 `status=completed`、`fileExists=true` 和 `savedPath` 非空时才报告
   成功。随即把 Word 文件直接展示给用户并提供绝对路径；同时告知用户如需调整编号、页边距
   或图片尺寸，可对同一 `cid` 调用 `xique_export_configuration` 重新导出，不会重新生成
   正文。
2. 后台明确返回失败或阻塞时立即报告准确原因，不得等待用户主动追问。
3. 用户说 `再跑一遍` 时，只复用最近一次由用户明确确认的配置；无法确定时重新展示配置页。
   重新准备后仍必须展示摘要并取得新的生成确认。
4. 单独导出现有任务时，先调用 `xique_export_configuration(cid)` 打开一次性导出设置页，
   展示表格样式、表格颜色、模板/布局、标题和正文编号、起始编号、页边距、横向/纵向图片
   尺寸、自动编号和修改标记；选择模板5后显示对应编号字段（标题级编号归入「标题设置」，
   正文编号归入「正文序号设置」）。用户提交后展示摘要并等待新的明确确认，确认后才能调用
   `xique_export_bid`。
5. 任务返回 `OUTLINE_BLOCKED` 或 `WRITE_BLOCKED` 时，保留并报告 `cid`，用中文解释问题，
   只询问缺失选择或具体绕过授权，然后重新展示完整配置摘要并等待确认。

## 交互原则

1. 每张阶段卡片只能提交一次。第一次提交时立即锁定，即使超时或传输结果不确定也不得恢复
   点击，应查询当前工作流状态，避免重复请求。
2. 卡片点击生成的 `【喜鹊标书配置批量选择】`、`【喜鹊标包与EPC选择】`、
   `【喜鹊标书配置选择】` 或 `【喜鹊标书确认】` 消息属于明确的用户输入。
3. 不得给枚举选项追加 `Other` 或 `其他补充`。
4. 返回 `interactionMode=mcp-app` 时立即结束当前回复并等待用户点击；禁止输出编号文本
   选项，禁止改用普通问答组件。
5. 任务保持打开时持续轮询并自动交付文件。客户端被关闭或中断后，后台任务仍可继续，但不得
   声称可以在应用关闭后主动推送通知；用户回来后使用原 `runId` 恢复查询。
6. 绝不在没有非空 `savedPath` 的情况下宣称标书生成成功。

## 参考资料

- 配置项与命令行参数映射 → [references/配置映射.md](references/配置映射.md)
- 阶段卡片交互协议 → [references/交互配置参考.md](references/交互配置参考.md)

使用说明

# 喜鹊标书助手

基于 xique-bid MCP 服务，从招标文件解析到 Word 标书导出的一站式投标文件生成工作流。

## 使用

```text
帮我根据这份招标文件生成标书：/path/to/招标文件.pdf
```

典型流程：上传解析招标文件 → 一页式配置（篇幅/风格/表格/图片/暗标/导出模板）→
生成并确认大纲 → 续写正文 → 导出 Word 标书。全程通过阶段卡片确认关键节点。

## 工作原理

技能通过 `xique-bid` MCP 工具集驱动：`xique_prepare_source` 解析招标文件，
`xique_bid_configuration` 收集一页式配置，`xique_outline_start`/`xique_generate_bid`
生成大纲，`xique_continue_bid`/`xique_continue_content` 续写正文，
`xique_export_bid` 按所选模板导出 Word。配置项与命令行参数映射见
[references/配置映射.md](references/配置映射.md)。

## 前置要求

- 已安装并登录 xique-bid MCP 服务（API Key 在官网 xiquebiaoshu.com 创建）
- 招标文件支持常见文档格式（PDF/Word 等）

如何安装此技能？

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