| name | slide-writer |
| description | 技術研修スライド教材をMarp形式で執筆。1スライド1トピック、箇条書き中心の簡潔な構成。スライド教材、プレゼンテーション作成時に使用。 |
スライド教材執筆 Skill
技術研修用スライド教材の作成基準を定義します。
スライド作成の情報源
スライド作成のする上での情報源はテキスト教材(各研修コースのtextフォルダ)の内容から作成します。
スライドのファイル名から、同じ章番号ののテキスト教材の内容を確認し、その内容に合わせてスライドを作成します。
(スライドのファイル名がslides/chapter-02.mdならtext/chapter-02.mdの内容を基にスライドを作成します。)
参照ルール
以下のルールファイルも参照してください:
- @rules/common/writing-style.md - 文章作成の基本方針
基本構造
Frontmatter設定(必須)
各章ごとに独立したMarkdownファイルとし、frontmatterでメタデータを設定:
---
marp: true
title: [その章のタイトル]
draft: false
---
スライド構成要素(必須順序)
- Frontmatter
- 章タイトルのh1見出し
- スライド区切り線「
---」 - 学習項目毎のスライド内容
- まとめ
---
marp: true
title: [その章のタイトル]
---
# Git概要
---
## この章で学ぶこと
- 本章では次の内容を学習します。
- [学習項目1]
- [学習項目2]
- [学習項目3]
- [学習項目...]
---
## [学習項目1のタイトル]
- [学習項目1を完結にまとめた1文]
- [学習項目1をよりわかりやすくするための箇条書き文章]
- [学習項目1をよりわかりやすくするための箇条書き文章]
---
## [学習項目2のタイトル]
- [学習項目1を完結にまとめた1文]
- [学習項目1をよりわかりやすくするための箇条書き文章]
- [学習項目1をよりわかりやすくするための箇条書き文章]
---
## この章のまとめ
- [学習内容をまとめた箇条書き文章]
- [学習内容をまとめた箇条書き文章]
- [学習内容をまとめた箇条書き文章]
---
スライドデザイン原則
レイアウト
- 1スライド1トピックの原則
- 箇条書きを基本とした簡潔な構成
- 階層構造(メイン・サブポイント)の活用
文章スタイル
- 体言止めまたは簡潔な文
- キーワードを太字で強調
- 専門用語は初回に説明を付与
視覚的要素
- 図表・画像を積極的に活用
形式で挿入- 概念図はdrawio.svg形式を推奨
具体例
---
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