SuperAPI AI 工具集

wordcraft-quotation

办公与效率

查看项目

更新于 11-04 23:02

技能介绍

用途:根据用户提供的项目明细、数量和单价制作可编辑的商业报价单,逐项计算金额并核对合计,最终交付 DOCX 与 PDF。适用于新建报价文档,不用于修改既有合同,也不推断税费或业务信息。

主要能力:

  • 读取结构化 quote.json 输入,生成报价步骤计划(steps)。
  • 逐项金额为数量乘单价,合计为各项金额之和;可用 expected_total 核对用户给定总额,不一致时停止,不通过修改单价凑总额;计算不使用二进制浮点数。
  • 数量仅支持正整数;单价为最多两位小数的十进制字符串。
  • 报价编号、报价日期、报价方、客户、币种、计价口径、有效期、交付约定、明细为必填;是否含税及交付范围须用户明确提供,脚本不自动加税、折扣、币种换算或增加收费项目。
  • 明细限 1 到 40 行,单行项目说明不超过 80 字符,文本不含制表符或换行;过长命令行显式拒绝,不静默删行。

使用方式:

  • 将 SKILL_DIR 解析为当前实际加载的本技能目录,脚本和模板均在本技能内部,无需安装其他技能源。
  • 仅生成步骤计划:python3 "$SKILL_DIR/scripts/quotation.py" --input /path/to/quote.json --output /path/to/new-steps.json
  • 保存 DOCX 并导出 PDF:在上述命令基础上追加 --save /path/to/new-quote.docx --pdf /path/to/new-quote.pdf --cli /path/to/wordcraft-cli;需已有 CLI 时先查其版本与实际命令,不自动安装。--save 在同一原生 CLI 进程执行,再导出 PDF。所有输出必须不存在且互不相同,保留输入。
  • 在 MCP 共享编辑器中,使用已安装 WordCraft 插件的真实工具 schema 打开同一编辑器,确认是新建空文档;若后端提供 execute,将编译结果 steps 按顺序逐条调用 execute {"command":...,"params":...},并先查询命令目录验证命令及参数存在。不要用独立 CLI 修改文件后声称编辑器内存同步。

验收与交付:

  • DOCX 必须是原生表格,4 列,行数为明细数加表头与合计两行,非截图;跨页表头重复,每行说明与金额禁止跨页拆开;A4 正文内列宽为 250/45/75/81pt,数值列显式右对齐;重开后读取文字、表格和每行禁止拆分页属性。
  • 渲染全部页面并审阅中文缺字、溢出、被截断的项目说明、拆行和金额对齐;PDF 预览不能代替 DOCX 可编辑结构核对。
  • 交付实际存在并检查过的 DOCX、PDF,说明金额口径、待业务确认内容以及未完成的宿主或平台验证。READY_FOR_REVIEW 仅表示字段与计算检查通过,不等于报价获批或业务确认。

适用场景:新建中文或含中文的商业报价单;需要逐项金额与合计可重算的报价;需交付原生可编辑 DOCX 表格并附带 PDF 的场景。

限制与已验证范围:官方资料称已用 macOS 0.7.0 CLI 生成两项中文报价,核对 DOCX 原生 4×4 表格、精确合计 2740.80、一页渲染与中文显示;macOS 与 Windows 均以普通报价、小额精度、20 项中文长明细核对金额、禁止拆行和列宽,长明细输出两页;真实 Codex 宿主另验两项报价、三单元格改价和保存重开。其他宿主、所有用户素材及 20 项宿主内分页尚未验收。长文案及多页结果需另外检查。