用途
K2F Conference Handout 是一个 AI 原生美学设计技能，用于教会智能体为参会者参考资料编写 content_and_design.md：从演讲中保留什么、如何分层以便在纸张或 PDF 上阅读，以及如何表达设计意图（语气、层级、密度）——而不是如何构建或导出 K2F 包。
该技能将会议讲义生成为 .K2F 包。编写时需遵循 k2f 技能：解包或初始化工作区、编辑语义树、打包/验证并导出。K2F 让智能体专注于含义（章节、要点、图表），而非像素坐标，同时引擎将布局、排版和主题编译为跨 PDF 及其他格式的一致输出。
在构建之前，请安装核心技能：npx skills add suzheng/k2f --skill k2f。
何时使用
- 在演讲已列出大纲或被录用之后；在幻灯片存在之前或之后。
- 当用户想要参会者可以保留的东西时，而不是 CFP、完整幻灯片导出或演讲者备注。
- 在工作坊、聚会或会议环节中进行打印或 PDF 分发。
工作流程
第 1 步：生成 content_and_design.md
一份将语义内容与美学意图配对的蓝图。使用带标签的块，k2f 技能稍后可将其映射到页面。
子步骤：
- 会话锁定 — 活动、会话标题、时段长度、受众任务和情境（而非“开发者”）、供应商中立与供应商主导的语气，以及是否允许出现产品名称。说明讲义必须做什么：后续参考，而非营销。
- 来源主线 — 按运行顺序列出演讲，并附分钟估算（两个层级）。将每个节拍标记为保留、压缩或删除。讲义反映的是叙事弧线，而非幻灯片数量。
- 参会者分层 — 将内容组织为四个层级：
- 一瞥（10 秒）：标题、演讲者、活动/日期、可选二维码或 URL。
- 浏览（1 分钟）：2–4 个以动词开头的要点，范围与时段长度匹配（闪电演讲：一个想法、一个要点；标准演讲：一个问题、两到三个行动）。
- 阅读（5–10 分钟）：与主线对齐的精简章节——现场无法吸收的钩子、图表、表格、代码。
- 后续：链接、仓库、阅读材料、先决条件、联系方式——简短，来源于用户。
- 渐进式节拍 — 当现场演讲使用揭示或演示时，在设计文档中指定静态等效物（编号步骤、前后对比、截图描述、最终代码状态）。绝不要留下只有在动画中才有意义的章节。
- 删减环节 — 移除推销式开场、书籍级范围、演讲者旅程框架以及“理解/欣赏”类要点。替换为参会者视角的句子和他们周一就能执行的操作。
- 设计意图 — 为引擎记录语气、层级、密度和配色（非 JSON）：
- 语气：面向参会者；问题 → 方法 → 收益；演讲者可以溯源的证据和数字。
- 层级：要点和章节标题承载故事；正文支持；脚注和链接退居其次。
- 密度：比幻灯片紧凑，比论文宽松——用项目符号和标注框而非长段落；除非用户设定限制，否则上限约 800–1,200 词。
- 配色：平静的专业基调，一个强调色用于要点和警告；打印时高对比度；代码和图表标注为全宽或行内。
规则与约束
- 每份讲义一个角度：一个问题、一条主线；多主题演讲拆分为独立讲义。
- 要点测试：每个要点以动作动词开头并适合时段；二十五分钟内八个要点不合格。
- 参会者视角：将“我将展示我们的旅程”改写为读者能获得什么。
- 诚实门槛：不编造基准、客户或引用；标记演讲跳过的空白。
- 仅静态资产：视频、iframe 或实时演示 → 蓝图中的截图、步骤或仓库链接。
常见失败模式
| 失败 | 修复 |
|---|---|
| 幻灯片倾倒 | 保留主线标签；删除仅有标题的幻灯片；仅扩展高价值节拍。 |
| 粘贴演讲者备注 | 分离可选的“引导者”材料；默认文档仅面向参会者。 |
| 缺失揭示内容 | 为每个渐进式节拍添加最终状态图、代码或编号列表。 |
| 伪装成讲义的推销 | 以问题开头；产品是背景，不是标题。 |
| 可互换的标题 | 添加演讲中的系统、规模或张力。 |
| 代码墙 | 一个示例片段加链接；注释重要行。 |
| 泛泛的要点 | 动词 + 对象 + 上下文（“在启用跨区域复制前审计出口流量”）。 |
质量检查清单
- 会话锁定和受众明确；语气与活动类型匹配。
- 主线映射了保留/压缩/删除；一个清晰角度。
- 2–4 个以动词开头的要点与时段长度匹配。
- 每个仅现场节拍都有静态替代描述。
- 没有推销式或演讲者中心的开场；至少一个可溯源数字或具体系统。
- 声明了字数预算；链接和先决条件在后续层。
- 设计意图涵盖语气、层级、密度和配色。
- 所有声明可溯源到用户提供的材料。
第 2 步：使用 content_and_design.md 和 k2f 技能生成 K2F 文件并导出为适当格式
遵循 k2f 从蓝图实例化页面，应用设计意图中的角色，验证并导出参会者就绪的讲义（通常为 PDF，用于打印或分享）。