Quarto Task Slides（Git コミットのスライド生成）

目的

• 指定された範囲やタスク（例: TASK-123、ブランチ名、コミット範囲）に関連するコミットを抽出し、要約・diffstat・頻出ファイルなどを自動整形。
• Quarto（reveal.js）で HTML / PDF スライドを生成して配布可能にする。

前提

• 実行環境に git, python3, quarto が入っていること。
• PDF を出す場合は TinyTeX などの LaTeX が必要（quarto install tinytex）。

入力パラメータ

• task_id（オプション）: 例 TASK-123 / feature/foo。省略時はコミットメッセージフィルタなし
• repo_dir（既定 .）
• since / until（例 since=origin/main, until=HEAD。省略時は merge-base origin/main..HEAD）
• paths（任意: src/foo,app/ など）
• grep（任意の追加フィルタ）
• include_diff（bool, 既定 false）
• maxpatchlines（既定 600）
• title（任意）
• format（html | pdf、既定 html）
• outdir（既定 slides/）

自然言語での範囲指定の解釈

ユーザーが自然言語で範囲を指定した場合、以下のように解釈してパラメータに変換する：

よくある指定パターン

1. 「mainブランチとの差分」「mainとの差分」

- --since origin/main --until HEAD

1. 「コミットXXXから現在まで」「XXXから今まで」

- --since XXX --until HEAD

1. 「コミットAからコミットBまで」

- --since A --until B

1. 「このブランチの変更」「現在のブランチの作業内容」

- --since origin/main --until HEAD（mainブランチからの差分と解釈）

1. 「最近のN件のコミット」

- --until HEAD + git log で適切な since を計算

1. タスクIDなしで範囲のみ指定された場合

- task_id を空文字列にして、範囲指定のみでコミットを収集

実行手順（Claude が行うべきこと）

1. ユーザーの指定を解釈する

- 自然言語での指定を上記パターンに従って since / until / task_id に変換 - 不明な点があれば軽く確認するが、合理的な推測ができる場合は自動補完

1. スクリプトを実行する（プロジェクト内の相対パス）

``bash bash .claude/skills/quarto-task-slides/scripts/taskslides.sh \ ${taskid:+--task "<taskid>"} \ --repo "<repodir>" \ ${since:+--since "<since>"} ${until:+--until "<until>"} \ ${paths:+--paths "<paths>"} \ ${grep:+--grep "<grep>"} \ ${title:+--title "<title>"} \ --format "<format>" \ --outdir "<outdir>" \ $( [[ "<include_diff>" == "true" ]] && echo --include-diff ) ``

1. 結果を報告する

- 成功したら、出力ファイル（<outdir>/.html or .pdf）のパスを報告 - 失敗時は、git/quarto の存在を確認し、必要ならユーザーにインストールを提案

例

タスクIDを使った従来の使い方

• 「TASK-123 を src/auth に限定、HTMLで」

``bash bash .claude/skills/quarto-task-slides/scripts/task_slides.sh \ --task TASK-123 --paths src/auth --format html ``

• 「ブランチ feature/2fa を PDF で、パッチ付き」

``bash bash .claude/skills/quarto-task-slides/scripts/task_slides.sh \ --task feature/2fa --include-diff --format pdf ``

自然言語での範囲指定（新機能）

• 「mainブランチとの差分をスライドにして」

``bash bash .claude/skills/quarto-task-slides/scripts/task_slides.sh \ --since origin/main --until HEAD --format html ``

• 「コミット abc123 から現在までの変更をPDFで」

``bash bash .claude/skills/quarto-task-slides/scripts/task_slides.sh \ --since abc123 --until HEAD --format pdf ``

• 「このブランチでの作業内容をスライドに、パッチも含めて」

``bash bash .claude/skills/quarto-task-slides/scripts/task_slides.sh \ --since origin/main --until HEAD --include-diff --format html ``

• 「src/ ディレクトリの変更だけをスライドに」

``bash bash .claude/skills/quarto-task-slides/scripts/task_slides.sh \ --since origin/main --until HEAD --paths src/ --format html ``

注意

• 変更は読み取り中心だが、slides/ に成果物（.qmd / .html / .pdf）を出力する。
• ネットワークや外部 API は不要（ローカル Git に依存）。
• セキュリティ: 不要な外部コマンド導入は避ける。必要時のみ最小限に。