关于 k2f-conference-handout
供 Agent 将会议演讲整理为面向参会者的讲义蓝图，涵盖内容结构与设计意图，再交由 K2F 制作。
主要功能
- 01演讲转讲义内容蓝图
- 02四层参会者阅读结构
- 03现场演示的静态替代方案
- 04编辑与设计质量检查
适用场景
- 01为会议演讲制作纸质讲义
- 02将演讲浓缩为参会者参考资料
- 03为现场演示编写静态替代内容
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/k2f-conference-handout确认已加载。
详细介绍
K2F 会议讲义 — AI 原生美学设计
目的
教会 Agent 编写 content_and_design.md，供参会者参考：讲座中有哪些内容值得保留、如何分层编排以便在纸面或 PDF 上阅读，以及如何表达设计意图（语气、层级、密度）——而不是如何构建或导出 K2F 包。
基于 K2F 构建
此技能会将会议讲义制作为 .K2F 包。按照 k2f 技能进行创作：解包或初始化工作区、编辑语义树、打包/验证并导出。K2F 让 Agent 专注于含义（章节、要点、图示），而不是像素坐标；引擎会编译布局、排版和主题，确保 PDF 及其他格式的输出一致。
开始构建前，请安装核心技能：npx skills add suzheng/k2f --skill k2f。
适用场景
- 讲座大纲拟定或获批后；幻灯片制作前后均可。
- 用户想要制作供参会者留存的材料，而不是征稿提案、完整幻灯片导出或演讲者备注。
- 用于工作坊、聚会或会议场次的印刷品或 PDF 分发。
工作流
第 1 步：生成 content_and_design.md
一份将语义内容与美学意图配对的蓝图。使用带标签的内容块，方便 k2f 技能之后将其映射到页面。
子步骤
-
锁定场次信息 — 活动、场次标题、时长、受众的工作职责与具体情境（不要只写“开发者”）、中立于供应商或由供应商主办的语气，以及是否允许出现产品名称。明确讲义必须发挥的作用：供后续查阅，而非营销。
-
梳理内容主线 — 按演讲顺序列出内容，并标注预计时长（两个层级）。将每个环节标记为保留、压缩或删除。讲义应呼应演讲的脉络，而不是幻灯片数量。
-
参会者阅读层级 — 将内容分为四层：
- 浏览（10 秒）：标题、演讲者、活动/日期，可选的 QR 码或 URL。
- 扫读（1 分钟）：2–4 条以动词开头的要点，数量与场次时长相适应（闪电演讲：一个想法、一条要点；标准场次：一个问题、两到三个行动）。
- 阅读（5–10 分钟）：与内容主线对应的精简章节，包括引子、图示、表格，以及现场无法充分理解的代码。
- 稍后查阅：链接、代码仓库、阅读材料、前置要求、联系方式——简明扼要，且内容须来自用户。
-
静态呈现递进环节 — 对于现场演讲中通过逐步揭示或演示呈现的内容，在设计文档中指定其静态呈现方式（编号步骤、前后对比图、截图说明、最终代码状态）。绝不能留下只能通过动画才能理解的章节。
-
精简删改 — 删除以推销为先的开场、书籍级别的内容范围、以演讲者经历为中心的叙述，以及“理解/欣赏”类要点。改为面向参会者的表述和他们周一就能采取的行动。
-
设计意图 — 为引擎记录语气、层级、密度和配色（不使用 JSON）：
- 语气：面向参会者；问题 → 方法 → 成效；证据和数据须能由演讲者提供来源。
- 层级：要点和章节标题承载主线；正文提供支持；脚注和链接弱化呈现。
- 密度：比幻灯片更紧凑，比论文更宽松——多用项目符号和提示框，少用长段落；除非用户设定上限，否则控制在约 800–1,200 词。
- 配色：以沉稳、专业的基础色为主，用一种强调色突出要点和警告；确保印刷时对比度足够；代码和图示应作为全宽或行内内容突出呈现。
规则与约束
- 每份讲义只聚焦一个角度：一个问题、一条主线；多主题演讲应拆分为多份讲义。
- 要点检验：每条要点都以行动动词开头，并符合场次时长；25 分钟内提出 8 条要点不符合要求。
- 参会者视角：将“我会展示我们的历程”改写为读者能获得什么。
- 真实性把关：不得虚构基准测试结果、客户或引文；标明演讲略过的内容缺口。
- 仅用静态素材：视频、iframe 或现场演示 → 在蓝图中改用截图、步骤说明或代码仓库链接。
常见失败模式
| 问题 | 修正方法 |
|---|---|
| 幻灯片内容倾倒 | 保留主线标签；删去只有标题的幻灯片；仅展开高价值环节。 |
| 粘贴演讲者备注 | 将可选的“引导者”材料单独列出；默认文档仅面向参会者。 |
| 缺少揭示内容 | 为每个渐进式环节添加最终状态图、代码或编号列表。 |
| 变相推销 | 从问题入手；产品是背景，而不是标题。 |
| 标题缺乏辨识度 | 加入演讲中的系统、规模或张力。 |
| 大段代码 | 提供一个示例代码片段并附上链接；标注关键行。 |
| 泛泛的要点 | 使用“动词 + 对象 + 情境”（“启用跨区域复制前，先审计出口流量”）。 |
质量检查清单
- 明确说明场次安排和受众；语气与活动类型相符。
- 用 Keep/Compress/Drop 标注主线；确定一个清晰角度。
- 根据时长设置 2–4 条以动词开头的要点。
- 为每个仅限现场呈现的环节说明静态替代内容。
- 开场不以推销或演讲者为中心；至少提供一个有来源的数据或具体系统。
- 说明字数预算；在 Later 层中列出链接和先决条件。
- 设计意图涵盖语气、层级、密度和配色。
- 所有主张均可追溯至用户提供的材料。
步骤 2：使用 content_and_design.md 和 k2f 技能生成 K2F 文件，并导出为合适的文件格式。
遵循 k2f，根据蓝图创建页面，应用设计意图中指定的角色，进行验证，并导出可供参会者使用的讲义（通常导出为 PDF，以便打印或分享）。