deck-beamer-proposal-report について
deck-beamer-proposal-reportは、Beamerで提案書や進捗・最終報告のスライドを作成するスキルです。目標、作業計画、日程、マイルストーン、リスク、予算に沿って構成し、コンパイル可能なLaTeXソースを出力します。
主な機能
- 01提案書と報告書のスライド構成
- 02スライド仕様の作成手順
- 03`pgfgantt`によるガントチャート
- 04マイルストーンとリスクの状態表
- 05コンパイル可能な`.tex`とビルドスクリプト
活用シーン
- 01研究助成の提案スライド作成
- 02目標とマイルストーンに対する進捗報告
- 03日程、リスク、予算状況の提示
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ jurgendn/ agent-skills --skill deck-beamer-proposal-reportインストール後、Claude Code で/deck-beamer-proposal-reportを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
assets/preamble.texevals/evals.jsonreferences/proposal-persuasion-craft.mdslide-spec-and-design.mdscripts/compile.sh詳細
Beamer 提案書/レポートデッキ
提案書(何を行う予定で、なぜ資金提供や承認に値するのか)とレポート(約束した内容に対して何を実施したのか)のために、コンパイル可能な Beamer ソースを生成します。これらのジャンルは、単一の貢献ではなく、作業計画を軸に構成されます。そのため、目的、作業パッケージ、タイムライン、マイルストーン、成果物、予算、リスクが必要であり、レポートには計画に対する進捗も加わります。
これはレンダリングのステップです。スライド仕様のスキーマと、形式に依存しない設計ルールは references/slide-spec-and-design.md に記載されています。まずこちらを読んでください。これは deck-beamer-academic(単一論文の成果発表)でも、deck-business-report(PPTX/Canva、経営層向け)でもありません。
2 つのジャンル、それぞれ異なる骨格
提案書デッキ
対象者:承認または資金提供の可否を判断する委員会/資金提供者/アドバイザー。意義、実現可能性、計画の信頼性を評価します。
骨格:
- 課題と意義 — なぜ重要なのか、なぜ今なのか。
- ギャップ/最先端の状況 — 何が不足しているのか、他者がまだ行っていない何に取り組むのか。
- 目的/研究上の問い — 明確で検証可能な目標を 2~4 件。
- アプローチ/方法論 — 各目的に対し、どのように取り組むのか。
- 予備的な結果 — 実現できることを示す証拠(提案のリスクを軽減します)。
- 作業計画とタイムライン — 作業パッケージをガントチャートに対応づけます。
- マイルストーンと成果物 — 具体的で、日付が明確で、検証可能なもの。
- リスクと軽減策 — 実際にあるリスクを挙げ、先を見越して検討していることを示します。
- 予算/リソース(該当する場合)— 必要なものと、その理由。
- 期待されるインパクトとまとめ — 成功によって何が可能になるのか。
レポートデッキ(進捗/マイルストーン/最終)
対象者:同じ関係者が、今度は約束した内容に対する実施状況を確認します。
骨格:
- 目的の振り返り — 何を約束したのか(スライド 1 枚)。
- 計画に対する進捗 — 目的/作業パッケージごとの状況(順調/要注意/完了)。
- これまでの主な成果 — 主張をタイトルにした証拠。
- 達成/未達のマイルストーン — 正直な状況を示す表。
- 計画からの逸脱とその理由 — 計画から変更した内容と、その正当な理由。
- リスク(更新版) — 顕在化したリスクと、新たに発生したリスク。
- 残りの作業と改訂タイムライン — 残っている作業と期限。
- 予算/リソースの状況(該当する場合)— 計画に対する支出状況。
- まとめと要望 — 次に必要な判断や支援。
ワークフロー
1. 入力を収集する
- ジャンル(提案書/進捗/中間報告/最終報告)。
- 基準となる計画:目的、作業パッケージ、当初のタイムライン、マイルストーン、成果物、予算。
- レポートの場合:各項目の現状、遅れた内容とその理由。
- 対象者と発表時間、指定されている場合は組織/資金提供者の Beamer テンプレート。
2. スライド仕様を作成する
上記の該当する骨格を土台として、スライドごとの仕様ブロック(references/slide-spec-and-design.md)を作成します。提案書デッキを説得力のあるものにするための技法(情報を並べるだけでなく、売り込む構成にする方法、砂時計型の構成、提案書向けの 3 種類の図(蝶型/ファミリーポートレート型/ビフォーアフター型)、情報密度の調整)については、references/proposal-persuasion-craft.md を参照してください(Knapen et al., 2025, arXiv:2504.01645 に基づきます)。ジャンル固有のガイダンス:
- 目的には、トピックではなく成果を示す主張型タイトルを付けます。
- タイムライン → TikZ の
pgfganttを使ったガントチャートのスライド 1 枚にまとめます。日付を並べただけのスライドにはしません。 - マイルストーン/成果物 → コンパクトな状況表(
booktabs)にまとめ、表示する行数は 6 行以下にします。収まりきらない分は予備スライドに移します。 - リスク → 上位のリスクのみを示す、2 列の「リスク → 軽減策」(または発生可能性/影響)表にします。
- 進捗(レポート) → 明確な凡例(✓ 完了/◐ 順調/✗ 要注意)を付けた状況表にします。色分けしますが、色だけに頼らないでください。
- 予算 → カテゴリー別に要約し、詳細な内訳は予備スライドに移します。
LaTeX を出力する前に、仕様を確認してください。
3. コンパイル可能な .tex を出力する
承認済みの仕様を assets/preamble.tex(学術用プリアンブルをベースに、pgfgantt、ステータスマクロ、リスク/マイルストーン用の表スタイルを追加)を使ってレンダリングします。要件:
- 自己完結型で、
pdflatex/lualatexでコンパイルできます。プレースホルダーには% TODOを明記します。 - ガントチャートは
pgfganttで作成し、マイルストーン/成果物/リスクの表にはbooktabsを使います。 - ステータスマクロ(
\done、\ontrack、\atrisk)は、記号と色の組み合わせにします(色覚多様性に配慮)。 - 発表者ノートには
\note{}を使い、長めのレビューではセクションごとのまとめに\tableofcontents[currentsection]を使います。 - 詳細な予算、マイルストーンの全リスト、手法の詳細を載せる付録の補足スライドを用意します。
4. 引き渡す
コンパイルコマンド、配置するファイル、日付/数値の編集箇所、付録に含まれる詳細スライドを伝えます。
.tex と一緒に scripts/compile.sh を含め、1ステップでビルドできるようにします(latexmk があれば使用し、なければ pdflatex を2回実行します。pgfgantt のインストールが必要です)。
./scripts/compile.sh proposal.tex # build
./scripts/compile.sh -c proposal.tex # build, then clean aux files
優れた提案/報告スライドと論文発表の違い
- 計画こそが成果物です。 曖昧なタイムラインや不明確なマイルストーンは、弱い成果よりも早く提案を失敗に導きます。すべてのマイルストーンに日付を付け、検証可能にしてください。
- ここでは新規性より実現可能性が重要です。 予備的な結果は、研究を完遂できることを示すためのものであり、それ自体が完全な貢献である必要はありません。
- 報告では遅れを正直に示す必要があります。 「リスクあり」の項目を隠すステータス表は信頼を損ないます。軽減策とともに示してください。
- 数値は検証されます。 予算、タイムライン、マイルストーンの日付は厳しく確認されます。スライド間で整合性を保ってください。
避けるべきアンチパターン
- 成功基準を備えた検証可能な目標ではなく、「X の研究」のようなトピックを目的として記述する。
- ガントチャートではなく、日付を並べた段落になっているタイムラインのスライド。
- 達成できなかったマイルストーンを隠したり、進捗と計画の比較を省略したりする報告。
- 予算や作業パッケージの詳細を、補足スライドではなくメインスライドに詰め込む。
出力
- 提案または報告の骨子に基づいて作成した、確定済みのスライド仕様(Markdown)。
- ガントチャート、ステータス表、明示されたプレースホルダーを含む、コンパイル可能な単一の
.tex(およびプリアンブル)。 - コンパイル、編集、付録に関する手順。