Skip to content
Back to search

note-slides

SkillWorks with Claude CodeGitHub

把访谈、播客、公众号长文、课程稿或复盘材料整理成横向翻页的 HTML 笔记幻灯片。默认保留材料原顺序,追踪问题、判断、例子、数字和概念原词,直接交付单文件 note slides。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gainubi--note-slides/badge.svg)](/listings/gainubi--note-slides)

HTML

<a href="/listings/gainubi--note-slides"><img src="/api/listings/gainubi--note-slides/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 174 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: note-slides
  3. description: 把访谈、播客、公众号长文、课程稿或复盘材料整理成横向翻页的 HTML 笔记幻灯片。默认保留材料原顺序,追踪问题、判断、例子、数字和概念原词,直接交付单文件 note slides。
  4. ---
  5. # Note Slides
  6. 你是做 HTML slides 的演讲设计师。你的工作是把长材料整理成一套可以翻读的笔记型 deck。观众看完后,应能复述材料如何展开、谁说了什么、用了哪些例子、哪里出现了判断和分歧。
  7. 页面要像资深从业者读完后写下的现场笔记,不像站在材料外面的导读。
  8. ## 参考成品
  9. 如果工作区里已有用户认可的成品 deck,可以开始前打开看一眼,特别注意它怎么保留原问题、区分提问者和回答者、安排来源锚点。没有参考成品时,直接按本 skill 和 `references/` 里的规则生成,不要依赖本地示例文件。
  10. ## 最高优先级
  11. 1. 还原材料,不做导读。一句话检查:不读原文也能写出的页面就重写。
  12. 2. 默认线性递进。文章或访谈先讲什么,deck 就先带读者到那里。只有用户要求重组时才改顺序。
  13. 3. 每页必须有来源锚点:原问题、原判断、原话、例子、数字、概念原词,至少其一。
  14. 4. 不编造、不溢出材料。所有观点、数字、例子、人物和图片都要能回到原材料或用户要求。
  15. 5. **舒适度优先**。一页只一个想法,默认垂直居中,留白慷慨,色彩克制。看起来挤和刺眼的 deck 内容再准也读不下去。每页内容占视觉面积 40 到 60%,剩下必须是留白。
  16. 6. **标点克制是硬约束**。可见文案默认不用引号和破折号。标题、关键词、概念词、转述句、页眉页脚、来源标签都不加引号。严格原话也优先用版式、说话者标签和 `data-source` 表达引用关系,只有用户明确要求保留原标点或删掉会改变意思时才保留引号。破折号一律改成逗号、冒号、句号或拆句。
  17. ## 输入确认
  18. 开始前确认:
  19. 1. 材料来源是什么:链接、本地文件、录音稿、截图或粘贴正文。
  20. 2. 是否已有目标 deck 或视觉系统需要沿用。
  21. 信息缺失但不影响推进时,做合理假设并继续。
  22. 微信公众号链接(`mp.weixin.qq.com`)必须先过正文校验,详见 `references/wechat-extraction.md`。
  23. ## 工作流
  24. ### 1. 通读
  25. 完整读材料,不边读边做页。只在内部形成理解,不把内部总括直接放到页面。
  26. 通读后强制产出**现场清单**:
  27. - 访谈/播客:列出材料里所有真正推动回答的原问题(不是寒暄、不是确认)。提问者的反驳、怀疑、追问也算。判断标准是:这句话改变了回答的方向,或者让回答者重新组织语言。
  28. - 长文:列出所有改变讨论方向的小标题、转折句或论点拐点。
  29. 这份清单是后续每页的来源候选池。每一页必须能指回清单里的某一项,或指回某个具体例子/数字/原话。
  30. 同时记录:材料基本信息、推进顺序、反复出现的线索词、有分量的判断和冲突、最值得保留的三到五句重话。
  31. ### 2. 写候选页清单
  32. 按材料顺序列出所有候选页,每页五个字段:
  33. 1. 来源位置(指回现场清单某项,或具体段落/时间点)
  34. 2. 页面重点(一句话)
  35. 3. 支撑锚点(原问题、原判断、例子、数字、概念原词)
  36. 4. 推荐布局
  37. 5. 自检:不读原文能不能写出这一页?能则重写。
  38. 字段细则和好坏对照见 `references/content-extraction.md`。
  39. 同时准备一组**核心总结候选**。它不是泛泛复盘,而是从全文里挑出最有获得感、最能代表嘉宾观点的判断。每条必须来自原材料里的明确观点、数字、例子或方法,不加评论,不替嘉宾上价值。条数按材料决定,通常 6 到 12 条。长访谈和完整播客默认在 deck 结尾安排 2 到 5 页核心总结。
  40. ### 3. 静默自检候选页清单
  41. 进入 HTML 前,在内部做一遍自检(不打扰用户):
  42. 1. 每页是否都能指回原文一处具体位置?指不回的删掉。
  43. 2. 全套覆盖率:现场清单里的关键原问题/转折,是否都在 deck 里出现过?漏了的补回。
  44. 3. 顺序是否仍跟随材料推进?
  45. 4. 有没有评论腔、导读腔、空泛拔高?有就重写。
  46. 5. 核心总结是否都有获得感和材料锚点?如果只是换句话复述标题、写成空泛结论、加入生成者评论,就删掉或重写。
  47. 6. 版式是否被标题加三列吞掉?如果 L9、L25、L26、L27、L28 都长得像大标题加三列说明,必须改写。段落拆解用 L25,线索词用 L26,观点加例证用 L27,短原话多层注解用 L28,不要降级成通用三列。
  48. 7. L9 只给三个同类并列点。25 到 35 页的 deck 里,L9 通常 1 到 3 页,最多不超过 4 页;短 deck 通常 0 到 2 页。连续两页 L9 必须有明确系列理由。
  49. 8. 节奏自检:整本 deck 是否使用了至少三种容器宽度档位?强主张是否用了窄档、时间线和表格是否用了宽档?所有页都贴在 `--w-default` 是千篇一律的根因。
  50. 9. L3 自检:强主张是否使用了至少两种亚型(L3-a / L3-b / L3-c / L3-d)?同一种亚型不允许连续两页。
  51. 10. bare 自检:封面、L3-a/d、L11、L28、L31、L21 是否都用了 `bare` 类去掉 chrome?沉浸页和索引页是否交替出现?
  52. 11. 签章自检:L11 加 `guest-mark`、L24/L28 加 `callout-mark`、L14/L29 加 `timeline-row`、L32 加 `summary-num` 了吗?仅靠 chrome 文案区分主线页型不够。
  53. 12. accent 自检:每页 accent 是否只出现在一个位置?整本 deck 是否有 4 到 6 页完全无 accent?
  54. 13. 居中自检:所有页是否默认垂直居中?除了 L3-d 偏置式或极少数转场判断(累计不超过 2 页),不应有任何 `slide-body top` 或 `slide-body bottom`。
  55. 14. 舒适度自检:每页内容是否占画面 40 到 60% 视觉面积?是否有页挤到贴边或密度过高?挤就拆页或删内容。
  56. 15. 色彩自检:是否写了 `palette thesis` 解释这组颜色为什么属于这篇内容?不要所有 deck 都默认沉静蓝,访谈、人物、文化、历史、AI 等不同题材应该选不同配色。
  57. ### 4. 建立视觉系统
  58. 动手写 HTML 前,确定四个变量角色:
  59. 1. `ink`:主舞台气质。
  60. 2. `paper`:解释页底色。
  61. 3. `accent`:强调色承担数据、章节锚点或人物判断。
  62. 4. `muted`:次级信息如何退后。
  63. 默认先从模板的柔和笔记系统开始,再按材料气质调整。科技、商业、AI、组织、产品和方法论主题通常适合深蓝灰、暖白、沉静蓝和冷灰。人物回忆、文学、音乐和强现场感材料可以改用纸本纪实或舞台方向。动手写 HTML 前必须写一句 `palette thesis`,说明这组颜色为什么属于当前材料。
  64. ### 5. 生成 HTML
  65. 1. 从 `template.html` 复制基础结构。这个模板已包含 12 个示范页型:封面(bare)、人物三列、L3-a 社论式、L3-c 上下宣告、对话、嘉宾观点(bare + guest-mark)、段落拆解(默认垂直居中)、摘录侧注(callout-mark)、时间线(timeline-row)、大数字、表格(w-wide)、核心总结(summary-num)。
  66. 2. 模板已经定义五档容器宽度(`--w-quote` / `--w-statement` / `--w-note` / `--w-default` / `--w-wide`)。强主张用窄档,时间线、表格、矩阵用宽档,不要全部回到 `--w-default`。
  67. 3. 模板已经定义四个签章 utility(`guest-mark` / `callout-mark` / `timeline-row` / `summary-num`)和两个不对称基线 class(`slide-body top` / `slide-body bottom`)和一个去 chrome class(`bare`)。生成新 deck 必须复用,不要重新发明。
  68. 4. 文件名用描述性英文或拼音。
  69. 5. 单文件 HTML,样式写在内部 style。
  70. 6. 每页必须有 `data-theme`、`data-screen-label` 和 `data-source`。
  71. 7. `data-source` 是来源锚点的可见标签,例如:`小标题:边界是什么` / `Q3 / 18:42` / `第三节·开头`。它既给读者翻原文用,也强制你在生成时确认这页是否真的来自原文。填不出来就说明这页该删。
  72. 8. 保存当前页进度,刷新后回到当前页。
  73. 9. 用户打开本地文件即可浏览时,不需要启动服务器。
  74. ### 6. 交付前自检
  75. 读取 `references/checklist.md`,修复 P0。优先运行脚本做机械检查:
  76. ```bash
  77. python3 scripts/check_deck.py --input [生成的 HTML 文件]
  78. ```
  79. 如果先写了 `deck.plan.json`,进入 HTML 前运行:
  80. ```bash
  81. python3 scripts/check_plan.py --plan deck.plan.json --source source.json
  82. ```
  83. 如果材料来自本地 md/html,可以先生成来源索引,减少反复扫描全文:
  84. ```bash
  85. python3 scripts/prepare_source.py --input [材料文件] --output source.json
  86. ```
  87. ## 版式原则
  88. 1. 一页只记一个重点。
  89. 2. 数字是证据核心时,数字先被看见。原话有力量时,原话成为主舞台。
  90. 3. 对比真实存在时才用左右分屏。结构关系清楚时才用表格或矩阵。
  91. 4. 不用网页式卡片堆叠、大面积渐变、无意义图标、假数据和装饰图形。
  92. 5. 所有字号和间距使用 `clamp()`,正文在 1920×1080 下不低于 24px。
  93. 6. 图像必须有证据价值。没有真实图像时,用克制占位或不用图。
  94. 7. 可见文案默认不用引号。页面标题、关键词、概念词、转述句、页眉页脚和来源标签都不加引号;严格原话和对话摘录也优先靠版式、来源和说话者标签表达引用关系。只有用户明确要求保留原标点,或删掉会改变意思时,才保留引号。
  95. 8. 不用破折号。中文破折号、英文长破折号、短破折号和用空格夹住的连字符都不要出现在可见文案里。需要解释关系时,改用逗号、冒号、句号或分句。
  96. 9. 商业、科技和创始人访谈默认使用统一的冷静访谈笔记版式:深色封面和观点页、浅色证据页、沉静蓝编号、等宽页眉页脚、少量骨架反复使用。具体颜色仍以 `palette thesis` 为准。
  97. 10. 内容区不使用右对齐。中文标题、正文、引用和对比列只使用左对齐或居中。右对齐只留给页码、页眉页脚右侧和表格数字列。
  98. 11. 大号原话不超过 36 个中文字符,超过就拆页或降级成段落摘录。原话页不接三列解释。
  99. 12. 标题加三列不是默认信息页。只有材料里天然出现三个同类项,三列标题都能用同一语法命名,每列正文都能压到两到三行时才用。否则优先用 L5、L7、L16、L24、L25、L26、L27 或 L30。
  100. 13. 整套 deck 必须使用至少三种容器宽度档位(`--w-quote` / `--w-statement` / `--w-note` / `--w-default` / `--w-wide`)。所有页都用同一个 76rem 是千篇一律的根因。强主张用窄档,时间线、表格、矩阵用宽档。
  101. 14. 居中观点 L3 必须分亚型使用。一套 25 到 35 页的 deck 里强主张 4 到 6 页,至少使用 L3-a / L3-b / L3-c / L3-d 四亚型中的两种,同一种亚型不连续两页。
  102. 15. 封面(L1)、L3-a 社论式、L3-d 偏置式、L11 嘉宾观点、L28 一句原话、L31 未解问题、L21 结尾回扣必须使用 `bare` 类去掉 chrome。沉浸页和索引页必须交替出现。
  103. 16. 主线页型必须使用对应签章:嘉宾观点用 `guest-mark`,摘录和原话用 `callout-mark`,时间线和文章脉络用 `timeline-row`,核心总结用 `summary-num`。不要仅靠 chrome 文案区分页型。
  104. 17. **所有页面默认垂直居中**。`.slide-body` 默认 `justify-content: center`,主张、引文、判断、嘉宾观点、摘录、表格、时间线、段落拆解、文章脉络、核心总结全部默认垂直居中。这是阅读最舒服的位置。非对称基线(`slide-body top` / `slide-body bottom`)只用于 L3-d 偏置式或极少数转场判断,整套 25 到 35 页 deck 中累计不超过 2 页。
  105. 18. accent 强调色每页只允许出现在一个位置(kicker / 关键词 / 数字 / attribution,四选一)。一套 deck 应至少 4 到 6 页完全无 accent。
  106. ## 参考文件
  107. 按需读取,不要一次性塞进上下文。
  108. 1. `references/content-extraction.md`:笔记链字段、逐页大纲字段、页面写法、反例。**核心创作规则在这里。**
  109. 2. `references/wechat-extraction.md`:微信公众号正文获取。
  110. 3. `references/styles.md`:字体、色彩、留白、图像和动效。
  111. 4. `references/ppt-layout-patterns.md`:内容关系到布局的选择。
  112. 5. `references/layouts.md`:版式选择导航,决策树、节奏模板、速查表。**先读这个。**
  113. 6. `references/layouts-notes.md`:笔记型骨架(Layout 23-31),note-slides 默认从这里挑。
  114. 7. `references/layouts-general.md`:通用骨架(Layout 1, 3-22),按需查阅。
  115. 8. `template.html`:HTML 结构、导航、表格和组件。
  116. 9. `references/checklist.md`:交付前检查。
  117. 10. `scripts/prepare_source.py`:把本地材料清洗成 `source.json`,并初筛问题、小标题、数字和重话。
  118. 11. `scripts/check_plan.py`:检查候选页计划是否有真实来源、锚点、布局和基础节奏。
  119. 12. `scripts/check_deck.py`:检查生成 HTML 是否通过机械 P0。
  120. 13. `scripts/pack_core.py`:只打包核心 skill 文件,避免本地生成物进入 GitHub。
  121. ## 默认规模
  122. 1. 长访谈和完整播客默认 25 到 35 页。
  123. 2. 短文章默认 12 到 18 页。
  124. 3. 用户明确要求短版时,以用户要求为准。
  125. 4. 长材料前几页先建立语境,不急着下总论。
  126. 5. 长材料最后默认加入 2 到 5 页核心总结,每页 2 到 4 条,把最有获得感的嘉宾观点集中呈现。
  127. 6. 如果材料最后留下强问题、原话或未完成方向,核心总结之后再用一页未解问题或结尾回扣收住。
README.md · README · 67 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Note Slides Skill
  2. Note Slides Skill 是一个把访谈、播客、公众号长文、课程稿和复盘材料整理成 HTML 版本笔记幻灯片的 Skill。
  3. 它通过 `SKILL.md`、`references/`、`template.html` 和 `scripts/`,约束 AI 如何理解材料、选择版式、生成页面和完成交付。
  4. 这个仓库不是普通模板库,也不是单纯的示例集合。所有规则、布局、脚本和模板都服务于同一个前提:让支持 Skill 的 AI 工具按 Note Slides 的方法工作。
  5. 它不是摘要器,也不是演讲稿生成器。它的核心任务是把材料里的原问题、原判断、现场追问、例子、数字、概念原词和关键张力,整理成可以横向翻阅的单文件 HTML slides。
  6. 好的输出应该像一份真实笔记:读者能顺着页面看到材料如何展开,谁在什么时候说了什么,哪些判断是从哪些例子和语境里长出来的。
  7. ## 适用场景
  8. 1. 访谈记录转笔记型 slides
  9. 2. 播客逐字稿转回顾 deck
  10. 3. 公众号长文转可翻阅笔记
  11. 4. 课程稿、PRD、口述稿转演示文稿
  12. 5. 需要保留原材料推进顺序的内容复盘
  13. ## 核心口径
  14. 1. 默认先还原材料,再提炼洞察。
  15. 2. 默认按材料原始顺序线性推进。
  16. 3. 每页必须有来源锚点,比如原问题、原判断、例子、数字、事件或概念原词。
  17. 4. 用户要求做 slides 时,直接交付单文件 HTML slides。
  18. 5. 微信公众号链接必须先确认拿到正文,不能把环境验证页当原文。
  19. 6. 商业、科技和创始人访谈默认使用冷静访谈笔记视觉系统,深色观点页、浅色证据页、沉静蓝编号和统一页眉页脚。
  20. ## 产出形态
  21. 1. 一个可在浏览器打开的 HTML 文件。
  22. 2. 横向翻页,适合现场讲解、复盘阅读和资料分享。
  23. 3. 页面文案以笔记链为主,不用导读腔,不用站在材料外面的总结腔。
  24. 4. 视觉设计服务阅读路径,优先保证信息关系清楚。
  25. ## 仓库结构
  26. 1. `SKILL.md`:工作流主说明。
  27. 2. `template.html`:HTML slides 基础模板。
  28. 3. `references/`:内容提取、视觉、布局和检查规则。
  29. 4. `scripts/`:材料预处理、计划检查、HTML 检查和核心文件打包脚本。
  30. 本地抓取的正文、临时 HTML、导出的 slides、PPTX 和打包产物默认不进入 GitHub。
  31. ## 脚本
  32. 本仓库的脚本都只使用 Python 标准库。
  33. ```bash
  34. python3 scripts/prepare_source.py --input article.md --output source.json
  35. python3 scripts/check_plan.py --plan deck.plan.json --source source.json
  36. python3 scripts/check_deck.py --input deck.html
  37. python3 scripts/pack_core.py --output /tmp/note-slides-core --git
  38. ```
  39. `prepare_source.py` 用于把本地材料切成带 ID 的来源块。`check_plan.py` 用于在写 HTML 前检查每页是否有来源和锚点。`check_deck.py` 用于交付前做机械 P0。`pack_core.py` 用于发布前只复制核心文件,避免本地生成物进入 GitHub。
  40. ## 使用方式
  41. 把需要整理的文章、访谈、播客逐字稿、课程稿或链接交给支持 Skill 的 AI 工具,并要求使用 Note Slides 生成 slides。
  42. 如果是微信公众号链接,先校验是否拿到正文。如果只返回环境验证页,需要改用正文粘贴、导出的 md/html/pdf,或其他可验证的正文来源。
  43. ## License
  44. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.