k2f-purchase-order

K2F 采购订单 — AI 原生美学设计

目的

教 Agent 在排版之前规划采购订单：明确无歧义的买方与供应商身份、发货和账单路由、核对一致的行项目承诺，以及清晰的视觉层级，突出订购什么、送往何处、何时交付，以及适用哪些条款——不得虚构用户未提供的 SKU、价格或授权信息。

基于 K2F 构建

此技能将采购订单生成为 .K2F 包。按照 k2f 技能进行编写：解包或初始化工作区、编辑语义树、运行打包与验证，然后导出。K2F 让 Agent 专注于含义（各方、行项目角色、总额、交付信息块），而不是像素坐标；引擎会将布局、排版和主题编译为一致的 PDF 及其他格式输出。

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

适用场景

• 根据已批准的报价、请购单、目录购物车或粘贴的行项目开具采购订单。
• 重建含糊或通用的 AI 采购订单，确保参考信息、数量和总额与采购部门将要发送的内容一致。
• 标准货物采购订单、服务采购订单，或仅包含用户定义范围的框架／按需提货采购订单。

工作流

第 1 步：生成 content_and_design.md

为语义内容和美学意图提供单一蓝图。使用带标签的信息块，以便 k2f 技能稍后将其映射到各个区域。

子步骤

1. 采购订单类型与承诺框架 — 标准货物、服务、框架／按需提货，或针对现有采购订单的变更单。注明币种、地区格式，以及价格是固定价格还是仅供估算。省略该类型不需要的部分（例如，若用户说明仅数字交付，则纯服务订单无需填写收货地址）。

2. 各方与路由信息块 — 买方（开具方）：法定名称、地址、联系人、标志使用意图。供应商：仅填写用户提供的供应商名称和地址。买方总部地址与收货地址和账单地址不同时，填写相应信息；原样保留收件人或收货码头备注。不得捏造供应商税号、DUNS 编号或买方审批人姓名。

3. 参考元数据 — 采购订单编号、开具日期、要求或预计交付日期（用户提供时，填入页眉和／或各行项目）。修订时填写关联的报价、询价单、请购单、合同或先前采购订单。整份文档使用同一种币种；排版前标记缺失的交付预期。

4. 行项目架构 — 优先使用表格，不要写成叙述段落。每行包含：行号、描述、可选的零件／SKU／型号、数量、单位、单价、金额。仅当用户数据已按此划分时，才分组显示（如硬件与安装）。变更单行项目需注明其替换或新增的内容；绝不能把无关 SKU 合并为一条含糊的行项目。

5. 总额说明（在文档中写明计算过程） — 小计 → 运费／手续费、逐项列出的税费及其税率 → 采购订单总额。注明舍入规则（按行项目或按整份文档）。若报价与请购单的总额冲突，应标记 NEEDS USER CONFIRMATION，而不是擅自选择其中一个。

6. 条款与履约页脚 — 付款条款、国际贸易术语或运输方式，原样保留用户提供的内容。填写特殊说明（是否允许分批发货、包装、开票规则、汇款地址）。仅当用户提供了角色或姓名时，才添加授权人或签名信息块。除非用户提供法律条款文本，否则应尽量减少法律套话。

7. 设计意图 — 为引擎指定语气、层级、密度和配色：

   • 语气：权威、注重实务的 B2B 风格；不含任何销售用语——这是一份具有约束力的供货请求。
   • 层级：页眉中清晰呈现“Purchase Order”、采购订单编号和供应商名称；以行项目表格为主体；在次要区域突出收货地址和采购订单总额；条款页脚作为第三级信息。
   • 密度：采用便于仓库使用的表格节奏；列顺序固定（#、项目、数量、单价、金额）；金额右对齐；使用等宽数字；主视图最多放置一个简洁的备注信息块。
   • 配色：采用克制的中性色，仅用一种强调色突出采购订单编号和总额；符合 WCAG AA；清楚区分路由地址和行项目数据。 规则与约束

• 签发门槛：若未提供 PO 编号、签发日期、币种、核对无误的总额、供应商身份，以及涉及实物商品时的收货和账单地址路由信息，则不得生成可直接发送的蓝图。
• 单一事实来源：行项目金额决定小计；费用和税费仅按已记录的基数计算。
• 引用规范：报价单／请购单／合同 ID 应出现在元数据中，也可按需出现在各行项目中，不得在正文中重复。
• 真实性门槛：标明缺失的税费、运费或授权信息；不得在未经用户输入的情况下推断目录价格或审批状态。

常见故障模式

• 段落中写着“我们需要 50 台笔记本电脑”→ 改为包含数量、单位和价格的编号行。
• 缺少收货地址，或将买方地址与收货地址混为一谈 → 明确拆分地址。
• 行项目描述中包含报价营销文案 → 替换为履约标签（SKU、规格、数量）。
• PO 总额或交付日期埋在正文中 → 在元数据和设计意图中突出显示。
• 编造零件编号、付款条款或审批人 → 删除；使用 TBD — user must supply。
• 混用币种或行号重复 → 重新编号或升级处理。

质量检查清单

• 买方、供应商以及收货／账单地址仅使用用户提供的数据。
• 按照注明的舍入规则核对行项目数量 × 单价与小计是否一致。
• 费用／税费合计与 PO 总额一致；如适用，修订 PO 应引用父 PO。
• 预期交付时间与条款以及各行项目日期（如两者均有）一致。
• 设计意图明确指出 PO 编号、供应商、表格、收货地址和总额的强调方式。
• 所有数值均可追溯至用户输入或文档中的明确公式。

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

按照 k2f 技能，根据蓝图创建采购订单，应用设计意图中指定的角色，进行验证，并导出可签发的交付文件。