スライド
トークの説明文をreveal.jsデッキに変換し、リポジトリのデザインシステムに対してレンダリングします。
1. デザインシステムを選択する
引数としてデザインシステム名が渡された場合はそれを使用します。それ以外の場合はdesign-systems/*/brand-guidelines.mdをglobします:
- 見つからない場合:ユーザーに最初に
/design-systemを実行するよう伝えます。 - 1つだけ見つかった場合:デザインシステムが1つしか存在しないことを警告し(名前を表示)、続行する前に確認を取ります。
- 複数見つかった場合:各
brand-guidelines.mdのdescription:フロントマターを読み、名前と説明を表示するピッカーを提供します。
2. 表示内容の説明を取得する
ユーザーが提供するもの(インラインテキスト、またはファイルへのパス)を受け入れます。内容が薄く、大まかな構造(スライド数、一貫したテーマ)を暗示できない場合は、生成前に確認の質問を1つ行います — 黙って推測せず、ただし完全な/grillingインタビューも実行しません。
3. デッキ名を選択する
この名前のデッキがslides/<deck-name>/の下に既に存在する場合、これは編集です — デッキをゼロから再生成するのではなく、既存のスライドを拡張・修正します(docs/adr/0004-slides-edits-in-place.mdを参照)。それ以外の場合は新しいデッキです。
4. デッキを生成または編集する
slides/<deck-name>/を小さなローカルなreveal.jsプロジェクト(index.html + アセット)として書き、選択したデザインシステムのtheme.cssとlayouts/をコピーせずに相対パスで参照します。スライドはデザインシステムの名前付きレイアウトで構成します — それらを迂回する一回限りのスライドマークアップを発明してはいけません。
対象外
デザインシステムのブートストラップ — これはこのスキルが消費するだけの/design-systemの仕事です。