用途
Deckset 技能用于从对话上下文创建 Deckset Markdown 演示文稿和演讲者备注。适用场景包括：明确的 Deckset 请求、Markdown 幻灯片组，以及对已有演示内容的编辑。
主要能力
- 刷新并检查上游参考资料（每次调用都会从该技能目录运行
uv run scripts/refresh_sources.py）。 - 从对话中提取受众、目标、时间盒（演讲时长）、形式（演示、深入探讨、状态更新、路演）、关键主张与证据，以及约束（必含要点、必需章节、指定的主题/页脚）。
- 在写幻灯片之前先构建叙事主线和幻灯片大纲（标题 + 一句话意图）。
- 起草一份完整的 Deckset Markdown 演示文稿。
- 在有助于讲解时，使用
^添加演讲者备注。 - 返回输出前运行质量门禁。
使用方式
每次调用时先刷新上游参考资料：
uv run scripts/refresh_sources.py
可选：设置 GH_TOKEN/GITHUB_TOKEN 以避免 GitHub API 速率限制。正常使用技能时不要传入 --max-age-sec，默认行为应每次检查上游。
把脚本的 JSON 输出作为刷新状态来源，捕获 docs_source、gist_source、cheatsheet_source 和 used_cache_fallback；仅在输出表明回退或参考资料不可用时，才读取 references/refresh-metadata.json 做本地诊断。references/refresh-metadata.json 是被忽略的本地缓存，用于条件请求和诊断，不要纳入暂存、提交，也不要求它保持干净。刷新脚本不得因仅时间戳/来源信息变更而重写受跟踪的参考文件，应将干净的 cache_not_modified 输出视为有效刷新。
优先使用 references/deckset-cheatsheet.md，而不是 HTML 文档缓存。
默认输出契约：默认只输出一份完整的 Deckset Markdown 演示文稿；在能改善讲解时加入演讲者备注。若未指定受众，假设为混合技术受众；若未指定时长，以约 10 分钟 / 约 10 张幻灯片为目标（不强制固定页数）。如果缺失的时长/受众会实质性改变演示文稿，只提出一个澄清问题；否则应用默认值。保持风格由提示驱动：除非被要求，不强制主题/页脚/页码/自动缩放，不强制固定页数，按内容调整规模。
Deckset 规则
- 用
---分隔幻灯片。 - 优先使用
#和##标题做幻灯片结构。 - 仅在需要保持可读性时使用
[fit]。 - 除非内容本身耦合，每张幻灯片只保留一个主要观点。
- 代码块保持简洁并标注语言。
- 仅在用户要求分步展示时使用增量构建命令。
- 全局命令（如
theme:、footer:、slidenumbers:）必须位于文件顶部，且它们之间不能有空行。 - 如果打开分栏（
[.column]），务必用[.end-columns]关闭。
质量门禁
- 保真：保留对话中的主张与层级。
- 连贯：每张幻灯片在叙事中都有明确目的。
- 语法：演示文稿能解析为有效 Markdown，且 Deckset 命令放置正确。
- 讲解：演讲者备注阐明要点，而不是重复幻灯片文字。
- 结构：每张幻灯片都有标题；每张幻灯片一个主要观点。
- 密度：保持幻灯片可快速浏览（每张不超过 6 个要点；把细节移入演讲者备注）。
- 来源：在响应摘要中披露缓存回退或参考资料不可用；不要求仅时间戳变更的参考文件改动，也不要求写入演示文稿备注。
参考资料
- 速查表（首选）：
references/deckset-cheatsheet.md - 完整文档缓存（回退）：
references/deckset-markdownDocumentation.html - Gist 示例缓存：
references/examples/*.md - 本地刷新元数据（被忽略，仅供操作缓存）：
references/refresh-metadata.json
如果 used_cache_fallback 为 true，请在响应摘要中披露。
限制
资料未提供该技能的具体收费、价格、平台或效果信息。