SuperAPI AI 工具集

k2f-invoice

办公与效率

查看项目

更新于 10-15 15:40

技能介绍

K2F Invoice 是一个建立在 K2F 之上的技能,目标是教智能体在排版之前先完成发票的“蓝图”:让当事双方与参考信息在法律与运营层面完整,让明细行与税务计算形成可对账的数学故事,并通过视觉层级突出应付金额、到期时间和付款方式,同时不虚构用户未提供的银行信息、税号或金额。

用途

该技能适合从报价单、工时表、合同或粘贴的明细行发出新发票;也适合重建混乱或过于通用的 AI 发票,使数学、参考号和付款细节彼此对齐。还适用于预开票或定金发票,这类发票在到期日与金额语义上与标准账单不同。

主要能力

  • 锁定发票类型与辖区:标准账单、预开票、定金/部分付款,或信用式调整;记录币种、区域(日期与数字格式),以及税是含税还是未税;省略该类型不需要的部分。
  • 整理当事方与身份信息:卖方为法定名称、地址、联系方式、logo 意图、税务/VAT ID(仅在用户提供时);买方为账单抬头与地址,可选收货方或经办人行;不虚构注册号或银行信息。
  • 参考元数据:发票号、开票日期、到期日(或明确“见票即付 / Net N”)、PO、项目、合同或客户参考(在提供时);全文档只用一个币种代码;排版前标记缺失的到期日。
  • 明细行架构:以表格优先,不用段落文字;每行包含清晰描述、数量、单位、单价、行金额;仅在用户数据本身已区分时,才按服务与费用、里程碑等分组;折扣以显式负行或与某个小计规则绑定的百分比说明呈现,不隐藏在文字里。
  • 总额故事(把数学写进文档):小计 → 每条税/折扣行附税率标签 → 总计 → 可选已付金额/应付余额;说明舍入规则(按行还是按发票级);核对行和、税基与总计必须与所述规则一致(在一分钱误差内);输入冲突时标记 NEEDS USER CONFIRMATION,而不是猜测。
  • 付款与合规页脚:用平实语言写付款条款;使用用户指定的付款方式(电汇、ACH、卡链接、支票);银行/钱包字段照抄用户提供的内容;存在托管 URL 时加入付款链接行动号召;迟付费或汇款备注仅在提供时加入;除非用户提供文本,法律样板尽量精简。
  • 设计意图:向引擎传达文档语气、层级、密度与配色——语气为沉稳可信的 B2B,催款文档不写营销话术;层级为文档标题与发票号在页眉可扫读,应付金额与到期日在总额/付款区强调最强,明细表次之,页脚再次;密度为表格行距宽松、金额列右对齐、所有金额使用表格数字,避免超过一个短备注块;配色为克制的中性色,在总额/到期处使用一个强调色,符合 WCAG AA,为 logo 留空间但不堆装饰。

使用方式

先安装核心技能:npx skills add suzheng/k2f --skill k2f。K2F 让智能体关注含义(当事方、行角色、总计、付款区块),而不是像素坐标;由引擎把布局、字体和主题编译为跨 PDF 和其他格式的一致输出。工作流分两步。

第一步:生成 content_and_design.md,作为语义内容与美学意图的单一蓝图,供 k2f 技能后续映射到区域。

第二步:使用 content_and_design.md 和 k2f 技能生成 K2F 文件,并导出为合适的文件格式。按 k2f 的说明从蓝图实例化发票、套用设计意图中的角色、校验并导出可付款交付物。

适用场景

  • 从报价单、工时表、合同或粘贴的明细行签发新发票。
  • 重建混乱或通用的 AI 发票,使数学、参考号和付款细节一致。
  • 预开票或定金发票,其到期日与金额语义不同于标准账单。
  • 需要在发出前确保金额可对账、付款信息完整、无需虚构数据的场景。

规则与限制

  • 可付款闸门:在缺少发票号、日期、币种、经对账的总额,以及(在期望付款时)用户确认的付款说明的情况下,不得产出可发送蓝图。
  • 单一事实来源:明细行驱动小计;税率只适用于文档所载税基。
  • 参考号纪律:PO/项目 ID 在元数据中出现一次,可选在明细行出现,不在随机段落中重复。
  • 诚实闸门:标记缺失的税务处理或汇率;没有用户输入时不推断法定税率。
  • 常见失败模式包括:把明细行写成段落(应改写为含数量/费率/金额的表格行);税基错误或重复计税(应重新陈述税基、税率与舍入后的税额行);通用“Invoice”缺到期日或编号(应补全或标记缺口);应付金额在设计意图中被埋到折叠下方(应在层级说明中提升总计/到期);编造 IBAN、VAT 或付款链接(应删除并替换为 TBD——须由用户提供);同一发票混用币种(应拆分或升级,除非用户确认汇率行)。

质量检查清单

  • 当事方与税号仅与用户提供的数据一致。
  • 行金额 × 数量在所述舍入规则下与小计对账。
  • 税/折扣行求和等于总计;若有部分付款,余额正确。
  • 到期日与付款说明同条款一致。
  • 设计意图为应付金额、表格和付款区块指定强调层级。
  • 所有数字可追溯到用户输入或文档中的显式公式。

收费、价格与具体支持的文件格式暂未提供。