k2f-one-pager

K2F 单页文档——AI 原生美学设计

目的

教会 Agent 为单页决策与叙事文档编写 content_and_design.md：单页应包含哪些内容、如何分层信息以便高管快速浏览，以及美学意图（语气、层级、信息密度）——而非 K2F 打包或导出。

基于 K2F 构建

此技能将单页文档生成为 .K2F 包。编写时请遵循 k2f 技能：解包或初始化工作区、编辑语义树、打包/验证并导出。K2F 让 Agent 专注于含义（章节、论点、证据形式、CTA），而非坐标；引擎会将布局、排版和主题编译为可导出的成品。

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

适用场景

• 适用于单页产品或功能简介、项目提案、解决方案/公司概览、合作摘要或版本摘要。
• 在详细设计、工程团队交接或发布沟通前达成共识。
• 一份便于浏览的材料——不适用于演示文稿、传单、海报、完整的 PRD 或多页报告。

**不适用：**深入的技术设计、研究演示文稿，或以日期/场地和一个醒目 CTA 为核心的活动宣传（k2f-flyer）。

工作流

第 1 步：生成 content_and_design.md

为单个画布的各个带标签区块编写语义内容和设计意图蓝图。

子步骤

1. 锁定单页文档 — 明确唯一目标（审批、发布摘要、方案推介）。确定受众、渠道（打印版 PDF、电子邮件、Wiki）和体裁——选择一种原型；不要混合不兼容的结构。

2. 原型与区块顺序 — 固定的纵向排列，并使用标题：

   • 决策 / 产品：主张 → 问题（痛点 + 当下为何重要）→ 解决方案（是什么，而非 UI）→ 用户 → 指标（基线 + 目标）→ 范围内 / 范围外 → 约束 → 未决问题 → 可选的负责人 / 下一步。
   • 发布 / 更新日志：版本、日期、摘要 → 新增 → 修复 → 重大变更 → 已知问题 → 升级说明 → 仅在有真实目的地时添加 CTA。
   • 方案 / 公司：受众 → 一句话报价 → 三项差异化优势 → 证明材料 → 可选定价 → 一个下一步。
   • 计划提案：问题 → 方法 → 影响 → 资源 / 时间线 → 请求 → 风险。

3. 浏览层级 — 一眼浏览：标题、主张、核心指标或版本。快速浏览：2–4 个项目符号区块。细节：来源和细则——从属于主张。

4. 内容层级 — 主张（页面核心信息）、证据（数字、引言、列表）、边界（范围、约束、明确写出“无”）。第二页内容 → 删除或作为附录链接。

5. 诚实原则 — 不得编造指标、日期、客户或重大变更。缺少输入 → None、No … provided 或 TBD；版本 / 日期未知 → 使用带标签的 —。

6. 精简审阅 — 删除长篇论述、功能目录、API、重复指标。将模糊目标改为可衡量结果或 TBD。仅保留一个主要 CTA；其他内容放在联系信息中。

7. 设计意图（不指定坐标）：

   • 语气：决策内容以证据为主；发布内容客观；仅在有证明材料时采用自信的方案语气——使用一组形容词。
   • 层级：主张最大；区块标签保持一致；核心指标 / 版本作为视觉锚点；边界内容最小。
   • 密度：约 250–450 个词，除非用户另有要求；优先使用项目符号而非段落；每个区块最多约 5 个项目；仅范围内 / 范围外使用简短的并排栏。
   • 节奏：交替使用项目符号和一种视觉元素（指标行、Logo 带、时间线标签）——避免整页堆满项目符号。
   • 对比度：浅色底色，在主张 / 指标 / CTA 上使用强调色；品牌颜色需易于阅读。

规则与约束

• 一页，一个主张——将组合在一起的不同角度拆分为单独的单页文档。
• 更新日志：必须包含每个标准区块；没有内容时 → 明确写出 None 风格的文案。
• 能力以结果为导向，而非屏幕规格。
• 指标：必须有基线 + 目标，或 TBD——不得用于装饰。
• 清晰列出范围内 / 范围外；适用时注明 MVP 与后续计划。
• 仅在有真实目的地时添加 CTA——不得使用占位符。

常见失败模式

失败情况	修正方法
粘贴演示文稿 / PRD	收敛到一种原型；每个项目符号表达一个想法；将详细内容放入范围外部分。
产品简报采用传单语气	先写问题 + 指标，再写口号。
跳过发布区块	添加带标签的区块，并使用 None 风格的文案。
问题描述模糊	写明痛点 + 信号，或标注 TBD。
范围蔓延	设置边界层级 + 范围外列表。
两个主张	每页只设一个目标。
编造证明材料	使用占位说明或 NEEDS USER INPUT。

质量检查清单

• 锁定目标、受众、体裁和渠道。
• 按原型顺序排列；主张位于一眼浏览层。
• 设置主张 / 证据 / 边界；注明字数预算。
• 所有主张均可追溯或已标注；范围 / 更新日志区块完整。
• 设计意图：语气、层级、密度、节奏、对比度。
• 只有一个主要下一步；不使用虚假的 CTA。

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

遵循 k2f，根据蓝图构建单页，应用设计角色、进行验证并导出（通常为 PDF）。