k2f-quotation

K2F 报价单 — AI 原生美学设计

目的

指导 Agent 在排版前规划商业报价单：让报价内容一目了然、价格核算无误、边界明确（包含什么／不包含什么），并通过设计意图突出价值、总价和有效期；不得编造用户未提供的费率、交付内容或法律条款。

基于 K2F 构建

此技能会将报价单生成为 .K2F 包。按照 k2f 技能进行编写：解包或初始化工作区，编辑语义树，运行打包和验证，然后导出。K2F 让 Agent 专注于含义（合作方、范围角色、选项档位、总价），而非像素坐标；引擎会将布局、排版和主题编译为一致的输出，支持 PDF 和其他格式。

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

适用场景

• 根据需求简述、RFP 摘录、沟通记录或费率表起草新报价。
• 重制通用 AI 报价单，让范围、金额和有效期成为连贯统一的报价内容。
• 展示用户已定义的基础／进阶／高级档位或可选附加项。

工作流

步骤 1：生成 content_and_design.md

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

子步骤

1. 报价类型与决策框架 — 固定价格、设上限的按工时和材料计费、按里程碑计费或分档套餐。注明币种、本地化格式、税务处理方式（含税／不含税／未知），以及报价是否具有约束力还是仅供参考。省略该类型不需要的部分（例如，粗略估价可跳过接受报价部分）。

2. 合作方与身份信息 — 卖方和客户的名称、地址、联系人及 Logo 意图。仅在用户提供时填写注册编号或税号。绝不伪造签名或授权签署人姓名。

3. 参考元数据 — 报价编号、签发日期、有效期至日期（或明确的有效期规则）。项目名称、RFP／PO 参考编号、版本（v1、v2）。整份文档仅使用一种币种；排版前标记缺少的有效期信息。

4. 报价说明（先陈述，再举证） — 用一个简短内容块说明客户将获得什么，以及定价依据（以结果为导向，不写空洞的营销话术）。随后提供依据：明细表、档位摘要或里程碑列表，而不是重复表格行的冗长描述。如果用户粘贴了客户需求，应在单独的小节中逐字保留需求原文，并在旁边对应列出你的定价响应；不要将 RFP 文本并入明细描述。

5. 明细架构 — 优先使用表格。每行包含：交付内容或 SKU 标签、数量、单位、单价、行总价。仅当用户提供的数据已按实施、许可、支持等方式区分时，才按此分组。可选附加项和替代方案应列为带标签的内容块，而非藏在脚注中。折扣应列为明确的明细，或注明计算百分比的规则。

6. 总价说明（写明计算过程） — 小计 → 标明税率的税费／手续费 → 报价总价 → 存在档位时可选的“起价”。注明舍入方式（按明细行或按整份文档）。如果输入信息冲突，应标记为 NEEDS USER CONFIRMATION，不要猜测。

7. 边界与条款 — 包含项、不包含项、假设条件、对客户输入的依赖。付款或订金里程碑应逐字采用用户提供的内容。仅在用户提供相关信息时，才列出验收步骤、变更单指引以及保修／支持条款。不得编造责任上限或 SLA 数值。

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

   • 语气：自信、精准的 B2B 风格；通过清晰表达说服，而非夸大宣传。
   • 层级：页眉显示报价标题和编号；范围标题和报价总价最突出；明细表次之；有效期和不包含项应清晰可见，无需费力查找。
   • 密度：表格节奏清晰易读；金额右对齐；使用等宽数字；主视图中的假设说明块最多一段，且应简短。
   • 配色：采用克制的中性色，在总价和主要 CTA（例如“请于……前接受报价”）上使用一种强调色；符合 WCAG AA；各档位列的视觉呈现应平行统一，便于比较。 规则与约束

• 验收门槛：报价单未经审核可直接发送前，必须包含报价编号、日期、币种、经核对的总额以及明确的有效期。
• 区分门槛：叙述内容、定价事实和法律／假设说明必须放在单独标注的章节中，避免读者将解读误认为已承诺的范围。
• 可追溯性门槛：每个数字和交付内容都必须对应用户输入或文档中列出的公式；明确标注缺失的税费或外汇信息。
• 诚信门槛：除非用户明确提出，否则不得虚构增销、交叉销售或“还涵盖……”。

常见失败模式

• 段落式定价 → 改为包含数量、单价和金额的行。
• 总额埋在文中或缺少有效期 → 将其置于元数据和设计意图中的显眼位置。
• 将 RFP 原文直接粘贴到明细项中 → 将原文需求与定价响应分开。
• 各档方案不一致或列间不可比较 → 统一各档方案的单位、期限和小计。
• 虚构费率、增值税或付款条款 → 删除；使用 TBD — user must supply。
• 没有对应交付范围的营销夸大用语 → 替换为可衡量的包含项说明。

质量检查清单

• 参与方和 ID 仅与用户提供的数据一致。
• 按照注明的舍入规则，逐项金额之和与小计和总额一致。
• 有效期和版本与叙述内容一致（无过期日期）。
• 包含项／不包含项与明细项不矛盾。
• 设计意图明确指出范围标题、总额、有效期和表格的强调重点。
• 可选档方案具有可比性；如果用户指定了首选方案，则首选方案一目了然。

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

遵循 k2f 技能，根据蓝图创建报价单，应用设计意图中的角色，进行验证，并导出可直接发送给客户的交付文件。