k2f-invoice

K2F Invoice — AI 原生美学设计

目的

指导 Agent 在排版前规划发票：确保交易双方信息和参考信息在法律及运营层面完整无缺，理清行项目与税额的核算关系，并通过视觉层级突出应付金额、到期时间和付款方式——不得擅自编造用户未提供的银行信息、税号或金额。

基于 K2F 构建

此技能将发票生成 .K2F 包。按照 k2f 技能的说明进行创作：解压或初始化工作区、编辑语义树、运行 pack/verify，然后导出。K2F 让 Agent 专注于含义（交易双方、行项目角色、总额、付款区块），而非像素坐标；引擎会将布局、排版和主题编译为 PDF 及其他格式中的一致输出。

开始构建前，请安装核心技能：npx skills add suzheng/k2f --skill k2f。

适用场景

• 根据报价单、工时表、合同或粘贴的行项目开具新发票。
• 重做杂乱或通用的 AI 发票，使金额、参考信息和付款详情保持一致。
• 创建形式发票或定金发票，其到期日和金额语义与标准账单不同。

工作流

步骤 1. 生成 content_and_design.md

语义内容与美学意图的统一蓝图。使用带标签的区块，供 k2f 技能之后映射到各个区域。

子步骤

1. 锁定发票类型和司法管辖区 — 标准账单、形式发票、定金/部分付款发票或贷项调整单。注明币种、区域设置（日期和数字格式），以及税费是含税还是未税。省略该类型不需要的部分（例如，不收款的形式发票可跳过“应付金额”重点区块）。

2. 交易双方与身份信息区块 — 销售方：法定名称、地址、联系方式、Logo 意图，以及仅限用户已提供的税号/VAT ID。买方：账单抬头名称和地址；可选的收货方地址或收件人信息。切勿编造注册编号或银行信息。

3. 参考元数据 — 发票编号、开具日期、到期日（或明确注明“收到即付 / Net N”）。用户提供时，添加 PO、项目、合同或客户参考信息。整份文档使用一种币种代码；排版前标记缺失的到期日。

4. 行项目架构 — 优先使用表格，而非文字段落。每行包含：明确的描述、数量、单位、单价和行金额。仅当用户提供的数据已按此分类时，才对可选部分进行分组（如服务与费用、里程碑）。折扣应作为明确的负数行，或注明百分比并关联至小计规则——绝不可隐藏在描述文字中。

5. 总额计算说明（在文档中写明计算过程） — 小计 → 逐项列出税费/折扣及其税率标签 → 总额 → 可选的已付金额/余额。注明舍入规则（逐行还是按发票总额），并核对行金额之和、计税基数和总额；结果必须符合所述规则，误差不超过一分钱。如果输入相互冲突，请标记 NEEDS USER CONFIRMATION，不要猜测。

6. 付款与合规页脚 — 用通俗语言说明付款条款；仅列出用户指定的付款方式（电汇、ACH、银行卡链接、支票）。银行/钱包信息须逐字采用用户提供的内容；如果有托管 URL，则添加付款链接行动号召。仅在用户提供时添加逾期费用或汇款说明。除非用户提供文本，否则法律声明应尽量简短。

7. 设计意图 — 为引擎说明文档语气、层级、密度和配色：

   • 语气：沉稳、可信的 B2B 风格；收款单据中不添加营销废话。
   • 层级：在页眉中让文档标题和发票编号一目了然；在总额/付款区域中最突出显示应付金额和到期日；行项目表格次之；页脚再次之。
   • 密度：表格行距宽松；金额列右对齐；所有金额均使用等宽数字；备注区块不超过一个，且内容简短。
   • 配色：以克制的中性色为主，仅用一种强调色突出总额/到期信息；符合 WCAG AA；预留 Logo 空间，不添加多余装饰。

规则与限制

• 可付款性门槛：除非无需付款，否则在没有发票编号、日期、币种、核对后的总额以及用户确认的付款说明时，不得提供可直接发送的蓝图。
• 单一事实来源：行项目决定小计；税率仅适用于有文档说明的计税基础。
• 参考信息规范：PO／项目 ID 在元数据中出现一次，也可选择在行项目中注明，不要在无关段落中反复出现。
• 诚实性门槛：标明缺失的税务处理或外汇信息；未经用户输入，绝不推断法定税率。

常见失败模式

• 段落形式的行项目 → 改写为包含数量／费率／金额的表格行。
• 计税基础错误或重复计税 → 明确列出计税基础、税率和四舍五入后的税额。
• 只有笼统的“Invoice”，没有到期日或编号 → 根据用户提供的信息填写，或标记信息缺漏。
• 设计意图中应付金额埋在页面下方 → 在层级说明中突出总额／应付金额。
• 编造 IBAN、VAT 或付款链接 → 删除并替换为 TBD — user must supply。
• 一张发票中混用多种币种 → 拆分或升级处理，除非用户确认添加外汇换算行。

质量检查清单

• 交易双方和税号仅与用户提供的数据一致。
• 按照注明的舍入规则，行金额 × 数量与小计相符。
• 税费／折扣行合计与总额相符；如注明部分付款，则应付余额正确。
• 到期日和付款说明与付款条款一致。
• 设计意图明确指出应付金额、表格和付款区块需要突出显示。
• 所有数字均可追溯至用户输入或文档中的明确公式。

步骤 2：使用 content_and_design.md 和 k2f 技能生成 K2F 文件，并导出为合适的文件格式。

按照 k2f，根据蓝图创建发票，应用设计意图中的角色，完成验证，并导出可用于付款的交付文件。