Skip to content

feat(slides): デザインシステムに連動したスライドを作るスキル ds-slides を追加 - #23

Merged
tkc310 merged 2 commits into
mainfrom
feat/ds-slides
Oct 21, 2026
Merged

tkc310 merged 2 commits into
mainfrom
feat/ds-slides

Conversation

@tkc310

@tkc310 tkc310 commented Oct 20, 2026

Copy link
Copy Markdown
Owner

変更内容

8341-ui の semantic トークンと design-principles の原則に沿って、発表用のスライドを作れるようにしました。スライドは 1 ファイルの HTML デッキで、オフラインで開け、ブラウザの印刷で 1 枚 1 ページの PDF になります。

  • スキル ds-slides(.claude/skills/ds-slides/SKILL.md): 前提のヒアリング → 結論と見出しの骨子 → レイアウト選択 → 検査とビルド → 目視確認 → セルフチェック
  • ルール docs/rulebook/07-slides.md: 原則と WCAG をスライドに落とした S1〜S20(1 枚 1 メッセージ、箇条書き 5 項目まで、色だけで区別しない、キーボード操作、幅 768px 未満は一覧表示など)、10 種のレイアウト、要素とトークンの対応表
  • scripts/slides/(依存ゼロ)
    • build.ts: トークンを packages/tokens の Resolver で解決して CSS 変数を埋め込む(make tokens 不要、primitive は出さない)
    • check.ts: ソースの静的検査(見出しの段、箇条書きの数、style・独自クラスの禁止、alt、SVG の色の直書き、表の th、リンク文言など)と deck.css の監査(色・px・太さ・中央揃え・動きの直書き禁止、存在しないトークンの参照)
    • deck.css / deck.js: 960×540(rem)のキャンバスを拡大・縮小する発表モードと一覧モード、→ ← PageUp/Down Space Home/End(文字キー 1 つのショートカットは作らない)、切り替えのライブリージョン、全画面、印刷
    • examples/sample.html: 全レイアウトの見本
  • make slides SRC=… / make slides-check SRC=…。make check に deck.css と見本の検査を追加
  • ADR-0017、AGENTS.md・ai-agents.md・ルールブックの目次を更新

確認したこと: 見本を Chromium で描画し、発表モード 10 枚(ライト / ダーク)、幅 360 の一覧モード(横スクロールなし)、キー操作とライブリージョンの読み上げ文、はみ出し検出を確認。壊れたソースで各エラーが出ることを確認。

Storybook プレビュー

なし(コンポーネントとトークンは変更なし)

完了の定義

  • PR のタイトルが Conventional Commits の形式
  • make check と make test が通る(作業環境から npm レジストリに届かず未実行。node scripts/slides/check.ts は通過。CI で確認をお願いします)
  • changeset を追加した(公開パッケージは変更なしのため不要)
  • ライト / ダークの両方で見た目を確認した
  • キーボードで操作でき、フォーカス表示が見える
  • 新しい semantic カラーを足した場合 → 追加なし
  • 値や方針を変えた場合、docs/decisions/ に ADR を足した(0017)

改善ループ

  • docs/improvement/log.md に 1 行追記した
  • 再発防止として追加したもの: make check で deck.css の監査と見本の検査を実行

Generated by Claude Code

tkc310 and others added 2 commits October 20, 2026 13:40
8341-ui の semantic トークンと design-principles の原則で、発表用のスライド(1 ファイルの HTML デッキ)を作れるようにした。

- スキル `.claude/skills/ds-slides/`(前提のヒアリング → 構成 → レイアウト選択 → 検査とビルド → 目視確認)
- ルール `docs/rulebook/07-slides.md`(S1〜S20。原則と WCAG をスライドに落とした対応表、レイアウト、要素とトークンの対応)
- `scripts/slides/`: build.ts(トークンを Resolver で解決して埋め込む。依存ゼロ)、check.ts(ソースの検査と deck.css の監査)、deck.css / deck.js(発表・一覧モード、キーボード操作、印刷で PDF)、見本
- `make slides` / `make slides-check`。`make check` で deck.css と見本を検査
- ADR-0017、改善ログ

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Yb44feYKDNj2ukQeT2j8Ks
make check の fmt で見本(scripts/slides/examples/sample.html)が未整形として失敗していたため整形した。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Yb44feYKDNj2ukQeT2j8Ks
@tkc310
tkc310 merged commit 3c16f4f into main Oct 21, 2026
3 checks passed
@tkc310
tkc310 deleted the feat/ds-slides branch October 21, 2026 04:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant