发票生成器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-invoice-generator。
技能介绍
要解决什么问题
手工做发票往往意味着在 Word 或表格里反复改抬头、税号、明细行,再导出或打印成 PDF。一旦要对接系统里的订单或 CRM 数据,还要人肉复制字段,格式也不稳定。Invoice Generator 面向「已有结构化账单数据、只差一份可交付 PDF」的场景:你把符合约定 schema 的 JSON 交给技能,由脚本完成渲染与落盘,成功时在 stdout 返回生成文件的路径。
技能如何工作
技能的核心链路是 JSON → PDF。输入必须携带 SKILL 文档要求的一组字段(完整说明见 references/data-schema.md);脚本会先校验 JSON 是否合法、必填项是否齐全。校验失败会以退出码 1 结束,并把错误信息写到 stderr,便于在流水线里做失败分支。
通过校验后,使用 WeasyPrint 将内容生成 PDF。若渲染失败,退出码为 2。部署前需要配置 INVOICE_DIR(环境变量或 skills.entries.invoice-generator.env),用于确定发票输出目录及目录结构;本地还需安装 Node.js 侧依赖以运行生成脚本。
适用边界与注意点
- 本技能负责按 schema 出 PDF,不负责从邮件、扫描件或自然语言里「猜」发票内容。
- 字段含义与完整列表以
data-schema.md为准,集成方应先把业务对象映射成该 JSON,再调用生成。 - PDF 引擎依赖 WeasyPrint,字体、页眉页脚等版式细节取决于模板与运行环境,上线前应用真实数据试跑一页。
适合已具备订单/合同 JSON 导出能力、只需批量或按需产出标准 PDF 发票的团队,而不是替代全套财务 ERP。
使用场景
- SaaS 计费系统在月末把订阅账单导出为 JSON,需要为每个客户生成一份可邮件附件的 PDF 发票
- 自由职业者项目管理系统已存有工时与费率字段,结算时要按合同模板批量输出 PDF 而不手填 Word
- 内部运维脚本从数据库拉取订单行项目,写入符合 data-schema 的 JSON 后触发技能并得到 PDF 路径供对象存储上传
- CI 在发布新版本服务前用固定测试账单 JSON 跑生成流程,确认 WeasyPrint 渲染与必填字段校验仍正常
适合人员
- 独立开发者:业务侧已能导出订单 JSON,要把渲染 PDF 这一步交给 Agent 技能而非自建排版服务
- 小型工作室财务兼职:人手有限,希望用统一 JSON 模板驱动多张客户发票,减少复制税号与明细
- 集成 OpenClaw 技能栈的后端工程师:要在流水线里根据退出码 1/2 区分校验错误与 WeasyPrint 失败
- Sundial/RealQ 开源技能贡献者:需要对照 data-schema 维护发票字段并与 awesome-openclaw-skills 目录保持一致