スライド教材執筆 Skill
技術研修用スライド教材の作成基準を定義します。
スライド作成の情報源
スライド作成のする上での情報源はテキスト教材（各研修コースのtextフォルダ）の内容から作成します。
スライドのファイル名から、同じ章番号ののテキスト教材の内容を確認し、その内容に合わせてスライドを作成します。
（スライドのファイル名がslides/chapter-02.mdならtext/chapter-02.mdの内容を基にスライドを作成します。）
参照ルール
以下のルールファイルも参照してください：
- •@rules/common/writing-style.md - 文章作成の基本方針
基本構造
Frontmatter設定（必須）
各章ごとに独立したMarkdownファイルとし、frontmatterでメタデータを設定：
yaml
--- marp: true title: [その章のタイトル] draft: false ---
スライド構成要素（必須順序）
- •Frontmatter
- •章タイトルのh1見出し
- •スライド区切り線「
---」 - •学習項目毎のスライド内容
- •まとめ
markdown
--- marp: true title: [その章のタイトル] --- # Git概要 --- ## この章で学ぶこと - 本章では次の内容を学習します。 - [学習項目1] - [学習項目2] - [学習項目3] - [学習項目...] --- ## [学習項目1のタイトル] - [学習項目1を完結にまとめた1文] - [学習項目1をよりわかりやすくするための箇条書き文章] - [学習項目1をよりわかりやすくするための箇条書き文章] --- ## [学習項目2のタイトル] - [学習項目1を完結にまとめた1文] - [学習項目1をよりわかりやすくするための箇条書き文章] - [学習項目1をよりわかりやすくするための箇条書き文章] --- ## この章のまとめ - [学習内容をまとめた箇条書き文章] - [学習内容をまとめた箇条書き文章] - [学習内容をまとめた箇条書き文章] ---
スライドデザイン原則
レイアウト
- •1スライド1トピックの原則
- •箇条書きを基本とした簡潔な構成
- •階層構造（メイン・サブポイント）の活用
文章スタイル
- •体言止めまたは簡潔な文
- •キーワードを太字で強調
- •専門用語は初回に説明を付与
視覚的要素
- •図表・画像を積極的に活用
- •
形式で挿入 - •概念図はdrawio.svg形式を推奨
具体例
markdown
--- marp: true title: Spring Boot概要 --- # Spring Boot概要 --- ## 本章について - 本章では次の内容を学習します。 - Spring Bootとはどんなものかを理解する - Spring Frameworkとはどのようなものかを理解する - Spring BootとSpring Frameworkの違いについて理解する - Spring Bootプロジェクトの作成方法について理解する --- ## Spring Bootとは - Spring Boot（スプリングブート）は、オープンソースのJavaフレームワークです。 - JavaのWebアプリケーションフレームワークであるSpring Frameworkを使用して作成されたアプリケーションを、少ない設定で、短期間で実行できることを目的に設計・開発されました。  --- ## Spring Bootの特徴 - Spring Bootの主な特徴 - スタンドアロンSpringアプリケーションの作成 - SpringApplicationクラスのrun()メソッドを呼び出すだけでSpringアプリケーションを起動可能 - Webサーバーコンテナの組み込み - Tomcat、Jetty、UndertowなどのWebサーバーコンテナを組み込み - 自動設定 - アプリケーションの設定を自動的に行うため、開発者が設定を行う必要なし - スターター依存関係 - 必要な依存関係を提供するスターター依存関係を提供 --- ## Spring Frameworkとは - Spring Framework（スプリングフレームワーク）は、Javaプラットフォーム向けのオープンソースアプリケーションフレームワークです。 - Javaプラットフォームのアプリケーション開発を簡素化するための機能を提供します。 **Spring Frameworkの機能** 機能|説明 ---|--- コア機能|DI（依存性注入）やAOP（アスペクト指向プログラミング）などのコア機能をベースにして、Webアプリケーションの機能を提供 Spring MVC|WebアプリケーションにおけるMVC（Model-View-Controller）モデルを提供 Spring Data|データベース接続を行うための機能を提供 Spring Security|認証や認可、脆弱性対策などのセキュリティ機能を提供 --- ## この章のまとめ - この章では次のことについて学びました。 - Spring Bootは迅速でかつ高品質なJavaのアプリケーションを作成するためのフレームワーク - Spring BootはSpring Frameworkをベースにしている - Spring Bootのプロジェクト作成方法
スライド設計原則
情報量の調整
- •1スライドあたり3-7項目を目安
- •重要ポイントに絞った内容
- •詳細は補足資料やハンズオンで補完
視認性
- •十分な文字サイズ
- •適切な色彩対比
- •シンプルで読みやすいレイアウト
講義進行への配慮
- •適切なペース配分
- •質問・議論の余地を含む構成
- •ハンズオンとの連携を考慮
ファイル命名規則
- •
chapter-XX.md形式（XXは章番号の2桁） - •出力先:
dist/slides/chapter-XX.md