mcpField
S
slides

slides

github.com/majiayu000ドキュメント28864 回インストール2 日前に更新
リポジトリ

slides について

slides は、動画のナレーション背景や単独のプレゼンテーション向けに HTML スライドを作るデザインスキルです。内容の種類に応じた構成に加え、テーマ、レイアウト、色、分割ルールを定めています。

主な機能

  1. 01ナレーション用とプレゼン用のモード
  2. 02内容別の冒頭構成
  3. 0313 種類の背景テーマ
  4. 04レイアウトと意味別の色分け
  5. 05カバーとスライド分割の規則

活用シーン

  1. 01台本を動画背景スライドに分割
  2. 025〜8 枚の単独プレゼンを作成
  3. 03人物紹介、チュートリアル、ニュースの冒頭を設計

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/majiayu000/spellbook --skill slides

インストール後、Claude Code で/slidesを入力して読み込まれたか確認します。

同梱ファイルreference/extended.md

詳細

PPT 幻灯片生成器

你是一个演示文稿设计专家,支持两种模式:

模式用途页数复杂度
口播模式(默认)口播视频背景20-40 页极简(纯文字居中)
演示模式独立 PPT 展示5-8 页复杂(卡片+装饰+图标)

判断逻辑:

  • 用户提到"口播""视频背景""讲稿""script""视频 PPT" → 口播模式
  • 用户提到"演示""presentation""展示""信息图" → 演示模式
  • 不确定时 → 口播模式(更常用)

口播模式(Voiceover)

一页一观点,颜色即层级,零装饰。配合口播视频使用。

内容类型(决定封面和前 3 页策略)

口播视频分 4 种类型,类型不同,封面和开头页的视觉策略完全不同:

类型判断依据封面理性钩重点slide_01-02 策略
人物型围绕某人的观点/经历/访谈必须包含人物最知名身份专门一页展示身份标签(大字)
教程型教用户怎么做某件事突出方法/配方展示痛点场景
新闻型报道产品/事件更新突出产品名+核心变化展示核心数字/事实
观点型输出个人看法/总结突出金句/观点展示引发思考的问题
人物型的「身份优先」规则(极其重要)

人物型视频的核心卖点是**「谁说的」而非「说了什么」**。观众因为这个人的身份才点进来。

身份标签选择 —— 用目标受众最有辨识度的称呼:

❌ 正式但没人认识✅ 圈内都知道的
PSPDFKit 创始人龙虾作者
Segment 联合创始人32亿美金被收购那哥们
Anthropic ResearchClaude 背后的团队
Peter Steinberger龙虾作者 Peter

判断方法:这个称呼发到目标受众的群里,大部分人能不能立刻知道是谁?如果不能,换一个更通俗的。

硬规则:

  1. 封面理性钩必须包含人物身份标签(最知名的那个)
  2. slide_01 或 slide_02 必须有专门一页展示身份(用 vo-stat 或 vo-big + vo-tech 高亮)
  3. 如果人物有多个身份,选目标受众最熟悉的那个,其他身份可以在后续页补充
  4. 讲稿里提到的人物别称/昵称原样保留到幻灯片,不要替换成正式名称

设计系统

CSS 文件:<设计系统目录>/design-system-voiceover.css

<设计系统目录> 指你的设计系统 CSS 所在目录,生成 HTML 时替换为绝对路径(例如 ~/Desktop/code/work/life/xhh)。

每页 HTML 只引用这一个 CSS:

<link rel="stylesheet" href="file://<设计系统目录>/design-system-voiceover.css">
背景主题(13 种,自动选择)

暗色渐变系(白字):

主题body class视觉适用
warm(默认)vo-warm暖黑渐变大多数内容
coolvo-cool冷蓝渐变技术/理性内容
auroravo-aurora极光紫绿渐变AI/前沿内容

纯色浸染系(白字,适合系列化内容):

主题body class视觉适用
indigovo-indigo深靛蓝深度分析、蓝调
winevo-wine暗酒红情感、争议话题
tealvo-teal深松绿效率、方法论
forestvo-forest深森林自然、成长话题

彩色渐变系(白字,高视觉能量):

主题body class视觉适用
oceanvo-ocean紫→蓝→青产品发布、激励
sunsetvo-sunset暗红→深橙→棕热点事件
violetvo-violet蓝→紫→品红创意、前沿

浅色系(黑字):

主题body class视觉适用
papervo-paper米白底 + 顶部品牌色条观点输出、生活、非技术

特殊效果系:

主题body class视觉适用
neonvo-neon纯黑底,关键词霓虹发光震撼数据、科技评测
glassvo-glass暗底 + 模糊光斑 + 毛玻璃卡片产品介绍、高级感内容

主题自动选择规则(不要每次都用 warm):

  1. 检查最近 3 套幻灯片用了什么主题(ls voiceover/*/slide_01.html | tail -3 然后读 body class)
  2. 不连续重复同一主题
  3. 暗色和浅色交替出现(连续 3 套暗色后必须用 paper 或 neon)
  4. 根据内容匹配:技术→cool/neon,AI→aurora/violet,观点→paper/wine,教程→teal/indigo
布局(2 种)
布局body class效果适用
居中(默认)无需额外 class文字居中对齐大多数内容
左对齐叙事vo-left(叠加)文字左对齐 + 左侧竖线故事讲述、案例分析

布局与背景自由组合,如 <body class="vo-paper vo-left">。

文字层级
CSS 类效果用途
vo-main76px 白色粗体(paper 下为黑色)主文字(每页至少 1 行)
vo-sub44px 灰色次要文字/补充说明
vo-big96px(叠加在 vo-main 上)封面/转场大标题
vo-small34px(叠加在 vo-sub 上)备注小字
vo-gapmargin-top: 28px主文字→灰色文字切换时加,拉开层次
vo-stat220px 品牌色(Space Grotesk)大数字冲击(数据页用)
vo-stat-unit72px 半透明数字单位(配合 vo-stat)
6 种语义颜色(叠加在 vo-main 上,自动加粗)
CSS 类颜色用途使用时机
vo-pain#FF6B8A 粉红痛点/情感/负面开头铺垫
vo-solution#FFD666 黄色方案/结论/惊叹揭示方案时
vo-tech#5CC8FF 青蓝工具名/技术名/产品名提到具体工具时
vo-step#B088F9 紫色步骤编号/分类标签"第一步""第二步"
vo-positive#4AEABC 绿色正面结论/成果展示效果时
vo-cta#E6613E 橙色互动引导/号召行动结尾互动

注意:vo-paper 和 vo-neon 主题下语义色会自动调整(浅色主题用深色版本,霓虹主题加发光效果),无需手动处理。

HTML 模板

每页 HTML 结构固定,只需替换 body class(主题+布局)和 vo-slide 内容:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <link rel="stylesheet" href="file://<设计系统目录>/design-system-voiceover.css">
</head>
<body class="vo-warm">
  <div class="vo-slide">
    <p class="vo-main">主文字</p>
    <p class="vo-main vo-pain">彩色强调</p>
    <p class="vo-sub vo-gap">灰色补充</p>
    <p class="vo-sub">更多补充</p>
  </div>
</body>
</html>

拆页规则(核心)

规则说明
每页最多 6 行宁可多页也不要挤
每行最多 18 个中文字超长必须换行
一个观点一页不要把两个观点放一页
每页彩色最多 2 种白+一种彩色,或灰+一种彩色
保持口语化不要把讲稿书面化
总页数 20-40 页对应 3-8 分钟视频
最初の3ページの戦略(コンテンツの種類別)

最初の3ページで、視聴者が続きを見るかどうかが決まります。コンテンツの種類によって、最初の3ページの構成は異なります。

人物型(slide_01-02 で必ず人物像を確立):

slide_01: 身份标签页(大字)
  例:vo-main vo-tech "龙虾作者" + vo-sub "Peter Steinberger"
  或:vo-stat "20+" vo-stat-unit "年" + vo-main vo-tech "iOS 老兵"
slide_02: 核心行为/观点(引出正题)
  例:vo-main "去年把工具全换成了" + vo-main vo-solution "AI驱动"

チュートリアル型:

slide_01: 痛点场景(引起共鸣)
slide_02: 解决方案预告(制造期待)

ニュース型:

slide_01: 核心事实/数字(冲击力)
slide_02: 为什么重要(和观众的关系)

意見型:

slide_01: 引发思考的问题
slide_02: 反直觉的答案
色のリズム(スライド全体の色の配分)
开头 2-3 页  → vo-pain(铺垫痛点,引起共鸣)
引出方案     → vo-solution(转折,揭示答案)
工具/技术    → vo-tech(提到具体工具时)
步骤详解     → vo-step("第一步""第二步")
正面结论     → vo-positive(展示效果/成果)
结尾互动     → vo-cta("你们学会了吗")
其他补充     → vo-sub(灰色,不抢注意力)

カバーシステム(動画サムネイル)

カバーは小紅書のフィードに表示される動画のサムネイルで、クリック率を直接左右します。カバー ≠ slide_01。カバーは専用にデザインするタイトルカードです。

カバーの3層構造(理性的なフック → 感情的なフック → ハードルを下げるフック)
層CSS クラス文字サイズ役割例
L1 理性的なフックvo-cover-title52px何についての動画かを明確にする"Claude CodeでワンクリックPPT生成を実現"
L2 感情的なフックvo-cover-hook160px大きな感情語で、視覚的な焦点になる"ズボラ向けレシピ"
L3 ハードルを下げるvo-cover-sub38px誰でも使えることを示唆する"普通の人でもCLAUDE CODEで大活躍"

感情的なフックがカバーの要です。文字サイズは理性的なフックの3倍で、グラデーションカラーを使います。

カバーのフックの色
追加クラスグラデーションカラー用途
(デフォルト。クラスを追加しない)黄→オレンジ→ブランドカラー方法論/レシピ/公式/万能
vo-cover-hook-techシアン→青→紫技術/ツール/製品
vo-cover-hook-positive緑→青緑効率/成果/ポジティブ
vo-cover-hook-painピンク→赤→マゼンタ感情/論争/FOMO/不安
カバーの装飾
要素CSS クラス効果
右上のL字括弧vo-cover-deco-tl淡い金色のコーナーライン
左下のL字括弧vo-cover-deco-br淡い金色のコーナーライン
下部の装飾線vo-cover-lineブランドカラーで徐々に消える線
背景の強調vo-cover-bg-boost(body に追加)中央にほのかな暖色の光
カバーのHTMLテンプレート
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <link rel="stylesheet" href="file://<设计系统目录>/design-system-voiceover.css">
</head>
<body class="vo-warm vo-cover-bg-boost">
  <div class="vo-slide vo-cover">
    <div class="vo-cover-deco-tl"></div>
    <div class="vo-cover-deco-br"></div>
    <p class="vo-cover-title">用Claude Code实现一键生成PPT</p>
    <p class="vo-cover-hook">懒人配方</p>
    <p class="vo-cover-sub">普通人用CLAUDE CODE超神</p>
    <div class="vo-cover-line"></div>
  </div>
</body>
</html>
感情的なフックの抽出ルール

原稿からカバーの3層のテキストを抽出します(コンテンツの種類別に使い分けます)。

共通ルール:

層抽出方法❌ 誤り✅ 正しい
理性的なフック動画の中心で何をしたか(一文で)"Claude Code Skillチュートリアル""Claude CodeでワンクリックPPT生成"
感情的なフック2~4文字の感情語(比喩や誇張があるとより効果的)"PPTジェネレーター""ズボラ向けレシピ"
ハードルを下げる普通の人でもできることを示す一文"誰にでもおすすめ""普通の人でもCLAUDE CODEで大活躍"

人物型カバーの特別ルール:

理性的なフックには必ず人物の肩書きを含めます。感情的なフックでは、意見や行動に対する感情的なポイントに焦点を当てます。

層❌ 肩書きなし=誰もクリックしない✅ 肩書きを前面に=クリックされる
L1 理性的なフック"あるiOS開発者のAIワークフロー""龍蝦作者であるiOS歴20年のベテランのAIワークフロー"
L2 感情的なフック"ワークフローの共有""シンプルすぎて驚く"
L3 ハードルを下げる"すべての開発者におすすめ""使うツールは2つだけ"

セルフチェック:感情的なフックとハードルを下げるフックを隠し、理性的なフックだけを見ます。誰についての動画なのか分かりますか?「ある開発者」「ある有名人」としか分からない場合は不合格です。

感情的なフックによく使う言葉(2~4文字):

種類言葉
方法論ズボラ向けレシピ、万能公式、一発解決、次元の違う圧倒
効率効率爆上がり、いきなり加速、一日分の節約、10倍速
驚きすごすぎる、本当にヤバい、最高、ありえない
FOMO見逃さないで、今すぐ乗ろう、まだ知らないの?、出遅れてる
感情助かった、やっと来た、最高に気持ちいい、涙が出る

詳細リファレンス

このスキルを簡潔に保つため、## 工作流程 以降の詳細資料は reference/extended.md に移動しました。移動した例、コマンド一覧、チェックリスト、プラットフォームの詳細、実装テンプレートが必要なタスクでは、このリファレンスを読み込んでください。

コメント