検証可能な機関投資家グレードPDFプレゼンテーション&データ可視化システム
このスキルは、verifiable-pdf-pipeline(データ整合性)および editorial-page-layout-guidelines(グリッドジオメトリ)と連携し、McKinsey、Stripe Press、WEF、The Economist にインスパイアされた、出版グレードの 16:9 ダークエグゼクティブスライドデッキ および レターサイズのライトスイスアイボリー機関レポート を生成します。
1. コア不変条件:美しさに先立つ実質
このスキルで構築されるすべてのプレゼンテーションまたはレポートは、verifiable-pdf-pipeline/SKILL.md で定義された 10のアンチチートハードルール に従う必要があります:
- ゼロ手書きデータエアギャップ —
data/raw/内の不変の生ファイルからすべての数値を解析します。 - 現実と不変条件コンパイラ — Pydantic ドメイン境界と会計恒等式を強制します。
- 反循環検証 — 独立した生ファイルの再計算 + Python AST チェックにより、ハードコードされたリテラルアサーションを禁止します。
- アトミックな来歴台帳 — 公開されたすべてのスカラーは
data/provenance_ledger.jsonに1:1でマッピングされます。 - ネガティブケイパビリティと神聖な「N/A」 — 真の上流のヌル値は、偽のプロキシではなく、明示的に
[N/A]としてレンダリングされます。 - コンパイルラッチ — PDF コンパイラは
verify_integrity.pyを呼び出し、ゼロ以外の終了コードで中止します。 - カテゴリと単位のガード — 比較できない範囲やテスト方法を決して混在させません。
- 法定証明 — 規制/関税の主張には、公式官報IDが必要です。
- 科学的分類学と登録簿検証 — 二名法、権威、系統学、および IUCN ステータスを、現行の GBIF/OpenTree/iNaturalist 登録簿から逐語的に調整します。
- レンダリング後の散文グラウンディング(
vedit prose) — 最終PDF内のすべてのレンダリングされた数字は、provenance_ledger.json、summary_metrics.json、またはbackground_citations.json内のDOI バックエントリにトレースバックします。
2. 4つの黄金デザイン法則
法則1:60-30-10 カラーハイアラーキー(ライト&ダークモード)
- ライトスイス編集モード(レターレポート):
60%キャンバス:スイスウォームアイボリー(#fcfbf9)—onPage経由で明示的にペイント。30%スキャフォールディング:ディープネイビー(#0f2b48)、スレート(#334155)、スチール(#64748b)、ヘアライン(#cbd5e1)、微妙なティント(#f1f5f9)。10%シグナルアクセント:コバルト(#0284c7)、アンバー(#d97706)、エメラルド(#059669)、シグナルクリムゾン(#dc2626— リスク/サージのみ)。
- ダークエグゼクティブモード(16:9 スライドデッキ):
60%キャンバス:ディープオブシディアン(#0b0f19)またはミッドナイトネイビー(#051c2c)— フローブルがレンダリングされる前にonFirstPage/onLaterPagesでフルブリードペイントする必要があり、デフォルトの白いPDF用紙に依存してはなりません!30%スキャフォールディング&高コントラストテキスト:微妙なトーンバンド(#111827/#0a253a)、ヘアライン(#243247)、ピュアホワイトタイトル(#ffffff)、クリアなライトボディ(>= #e2e8f0、>= 9.5–10 pt)、セカンダリキャプション(>= #cbd5e1、暗い背景では決して#64748b–#94a3b8の薄暗い散文は不可)。パラメトリックワイヤーフレームウェーブや明るいアートワークがテキストの近くにある場合は、カバータイポグラフィの後ろに常に微妙な水平方向の暗いスクリムを配置します。10%シグナルアクセント:エレクトリックコバルト(#38bdf8)、ブライトアンバー(#fbbf24)、エメラルド(#34d399)、シグナルクリムゾン(#f87171)。
法則2:ヘアラインとホワイトスペースの重力(ゼロボックスカード)
- メトリクスや散文を、重厚な長方形の
BOXストロークやINNERGRIDウェブダッシュボードボックス内に閉じ込めないでください。 - KPI やコールアウトは、ボーダーレスのトーンバンド(ダーク
#111827/ ライト#f1f5f9)でグループ化し、その上部に鮮明な1.2 ptトップアクセントヘアライン、十分な12–16 ptのカラムガター、およびブックタブスタイルの Tufte 元帳(ゼロ縦線)を配置します。
法則3:Minto Pyramid アクションタイトル
すべてのスライドまたはレポートセクションは、受動的なトピックラベルではなく、1つの完全で断定的な主張 で始まります:
- 禁止:
「世界の排出動向」 - 必須:
「OECD-5 排出量を -25.0% 削減、しかし Emerging-3 は +235.8% 急増し、パネル合計は 23.52 Gt CO2e に上昇。」
法則4:調整された垂直フィル予算+目視検査
- レターレポート(
612×792 pt): 目標垂直フィル85%–92%(最小>= 82%)。 - 16:9 デッキ(
960×540 pt): 目標垂直フィル72%–88%(最小>= 72%)。 - 自動パスを最終決定と決して見なさないでください。
audit_pdf.pyを介して 180-DPI PNG プレビューをエクスポートし、レンダリングされたすべてのページでラベルの重なり、見出し行の改行、および光学的バランスを目視検査してください。
3. 機関投資家向けデータ可視化レシピ(300 DPI、透明背景)
すべてのチャートは dpi=300、transparent=True、上下右のスパイン削除、テーマに合わせたパレット(dark vs light)でレンダリングします:
- デュアルパネル時系列+レート加速: イベントシェーディングと直接的な開始/ピークアノテーションを備えた過去の月次/日次軌跡と、10年/期間レートバーを組み合わせます。
- 積み上げマスバランス面+インデックス付き軌跡: 直接的な右端ターミナルラベル(ゼロの独立したフローティングレジェンドボックスは禁止!)を備えた積み上げフロー量と、
Base = 100構造分岐線を組み合わせます。 - デカップリング象限散布図+ダンベル圧縮: シェーディングされたターゲット象限+密集したクラスター用のリーダー矢印を備えた2D成長率対成果散布図と、ベースラインから現在までの水平ダンベルを組み合わせます。
- Stephen Few 水平弾丸グラフ: 3つの定性的バックグラウンドバンド+プライマリパフォーマンスバー+垂直アンバーベースライン/ターゲットティック+右揃えデルタテキスト(
ax.spines["bottom"].set_bounds(...)を使用してx軸スパインをトリミング)。 - インメモリヘッドレス Tufte スパークライン:
46–66 pt × 13–16 ptのマイクロラインをio.BytesIO()バッファにレンダリングし、セマンティックなエメラルド/クリムゾンのターミナルドットを持つ ReportLab テーブルセル内に直接埋め込みます。 - 起点-終点行列ヒートマップ&リッジラインKDE: コントラスト切り替えデュアルタイポグラフィを備えた順次パレット、または $P_{50}$ と $P_{90}$ をマークする重なり合う分布リッジ。
4. プロダクション ReportLab 実装パターン
4.1 フルブリードキャンバスペイント(ダーク&アイボリーテーマで重要)
すべてのページですべてのフローブルの下にキャンバス背景がペイントされるように、常に onPage コールバックを登録します:
from reportlab.lib import colors
def paint_background(canv, _doc, bg_hex="#0b0f19", accent_hex="#38bdf8", page_w=960.0, page_h=540.0):
canv.saveState()
canv.setFillColor(colors.HexColor(bg_hex))
canv.rect(0, 0, page_w, page_h, fill=1, stroke=0)
if canv.getPageNumber() == 1:
canv.setFillColor(colors.HexColor(accent_hex))
canv.rect(0, page_h - 4, page_w, 4, fill=1, stroke=0)
canv.restoreState()
4.2 安全な Inter TTF 発見とクリーンなフォールバック
Inter-SemiBold を TTF を最初に登録せずにハードコードしないでください — INTER_FONT_DIR と標準の OS フォントパスをチェックし、クリーンに Helvetica にフォールバックするヘルパーを使用します:
import os
from pathlib import Path
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
def register_editorial_fonts() -> dict[str, str]:
search = [Path(os.environ["INTER_FONT_DIR"])] if os.environ.get("INTER_FONT_DIR") else []
search += [Path.home() / "Library/Fonts", Path("/Library/Fonts"), Path("/usr/share/fonts/truetype/inter")]
files = {"regular": "Inter-Regular.ttf", "semibold": "Inter-SemiBold.ttf",
"bold": "Inter-Bold.ttf", "italic": "Inter-Italic.ttf", "bold_italic": "Inter-BoldItalic.ttf"}
found = {r: d / f for d in search if d.is_dir() for r, f in files.items() if (d / f).is_file()}
if {"regular", "bold", "italic", "bold_italic"}.issubset(found):
for role, name in [("regular", "Inter-Regular"), ("bold", "Inter-Bold"),
("italic", "Inter-Italic"), ("bold_italic", "Inter-BoldItalic")]:
pdfmetrics.registerFont(TTFont(name, str(found[role])))
semi = "Inter-Bold"
if "semibold" in found:
pdfmetrics.registerFont(TTFont("Inter-SemiBold", str(found["semibold"])))
semi = "Inter-SemiBold"
pdfmetrics.registerFontFamily("Inter-Regular", normal="Inter-Regular", bold="Inter-Bold",
italic="Inter-Italic", boldItalic="Inter-BoldItalic")
return {"regular": "Inter-Regular", "semibold": semi, "bold": "Inter-Bold",
"italic": "Inter-Italic", "bold_italic": "Inter-BoldItalic", "mono": "Courier"}
return {"regular": "Helvetica", "semibold": "Helvetica-Bold", "bold": "Helvetica-Bold",
"italic": "Helvetica-Oblique", "bold_italic": "Helvetica-BoldOblique", "mono": "Courier"}
4.3 2パスランニングヘッダーと動的ページ番号
reportlab.pdfgen.canvas.Canvas のサブクラスを使用し、showPage() でページ状態辞書を保存し、save() で "Page X of Y" または "Slide X / Y" をスタンプします(examples/reportlab_premium_template.py を参照)。
5. 2023年コンサルティングフラッグシップモード(WeasyPrint + ピュアベクターインラインSVG)
2023年のフラッグシップ機関誌(Quantum Technology Monitor、The Economic Potential of Generative AI、Global Economics Intelligence、The State of Organizations)をモデルにした基調講演グレードのデッキでは、WeasyPrint(@page { size: 960pt 540pt; margin: 0; }) と 100% ピュアベクターインライン <svg> エキシビット を組み合わせます:
- ダークヒーロー / ピュアホワイトデータ ポラリティケイデンス(単調禁止):
- カバーヒーロー: ディープミッドナイトネイビー(
#051C2C)からコバルト(#0A2E8A)へのグラデーション、42ストランドのパラメトリック双曲線ベジエワイヤーフレームウェーブ(#2251FF/#00A9F4)と右側のクリーンな編集ヒーローアートが重なります。 - エグゼクティブサマリー: フルブリード
#051C2C、1.2 ptの白い水平ルール上の鮮明な28 pt白いセリフ見出し、3つの風通しの良いサンズコラム、3つの巨大なシアン/ブルーのセリフKPI。 - 分割チャプター区切り: 上部
48%はフルブリードの輝くアートワークで、120 ptの太字白セリフ数字(1、2)が固定され、下部52%はピュアホワイトで220 pt左インデントのセリフチャプター見出しと2カラムのフレーミングコピー。 - データエキシビットスライド: ピュア
#FFFFFFキャンバス、19.5–22 ptの太字セリフアクションタイトル(下に1.1 ptの#051C2Cルール)、微妙な下部フットノート区切り、および 右下#9AE6FFアイスシアンセクションプログレスピル。
- カバーヒーロー: ディープミッドナイトネイビー(
- 高コントラスト編集セリフ+幾何学サンズペアリング:
- ディスプレイセリフ(
Charter/Georgia/BaskervilleBold): カバータイトル、セクション数字、スライドアクションタイトル、巨大な54 pt#2251FFKPI コールアウト、およびセンタードーナツ合計。 - データサンズ(
Inter/Helvetica Neue): チャートアノテーション、サブタイトル、元帳セル、フットノート、インプリケーションコピー。
- ディスプレイセリフ(
- 4ティア McKinsey ブルークロマティックランプ(ゼロレインボークラッター):
#051C2Cミッドナイトネイビー(アンカー合計、ベースライン、深い収縮)→#06319Cディープロイヤル→#2251FFエレクトリックブルー(焦点デルタ、巨大KPI、拡大サージ)→#00A9F4ビビッドシアン→#9AE6FFアイスシアン(セカンダリシェア&セクションピル)。
- シグネチャーベクターSVGエキシビットアーキタイプ:
- マスバランスウォーターフォール / ブリッジチャート: アンカーバー(
#051C2C)、フローティング追加(#2251FF)および削減(#00A9F4)、ダッシュステップコネクタ、上部角括弧スパンコールアウト、フローティングセリフネットデルタ。 - スモールマルチプルウォール+グレー
»インプリケーションサイドバー: グループ化された5 + 3インデックス付き軌跡カードと、右側の#EFEFEFサイドバーを、円形の#051C2C»シェブロンバッジ(3 pt白いリング)でブリッジします。 - 10×10 ラウンドスクエアワッフルユニット行列: ボトムアップで塗りつぶされた
10×10グリッド(#E5E7EBトラック、4ティアブルーフィル)と、グレーのネガティブスペース内の中央揃えの太字数字。 - ドーナツリング+100% 積み上げシェアシフト: 5ステップブルードーナツ(
2 px白いスライス区切り、セリフセンター合計)と、2000vs2024のカラムを半透明フローリボンでリンク。 - WeasyPrint SVG ガードレール: フレックスコンテナ内では、インライン
<svg>に常に明示的なwidth/heightをptで指定し(.slide { height: 539.5pt; break-after: page; break-inside: avoid; }を設定)、サブピクセルの空白ページや300 pxのSVG崩壊を防ぎます。WeasyPrint で<text>に SVG 2 のpaint-order="stroke"を使用しないでください(テキストフィルの上にストロークが描画されます)。代わりに、クリーンなラベルオフセットまたは明示的な背景<rect>を使用してください。
- マスバランスウォーターフォール / ブリッジチャート: アンカーバー(
- フルブリード編集フォトマガジンモード(
612 × 792 ptレターポートレート、WeasyPrint): 写真ファーストの編集マガジン(demos/felis-mundi-magazine/で実証されている Kinfolk × Cereal × Condé Nast Traveler × National Geographic スタイル)を制作する場合:- タイポグラフィ&用紙ストック: 温かみのある無塗工アーカイバルペーパー(
#FAF8F5)とディープカーボン墨インク(#161616)を、高コントラストのDidoneディスプレイセリフ(Didot/Bodoni 72)、温かみのあるブックセリフボディコピー(Charter/Baskerville、9 pt、1.5×行送り)、およびワイドトラックの大文字サンズメタデータ(Inter、6.5–7 pt、+0.18emトラッキング)と組み合わせます。ランニングフォリオとクレジットは、フルブリード写真の上で純粋な#FFFFFFにシームレスにフリップします。 - まとまりのある写真(
>= 50%エッジツーエッジブリード): すべてのプレートは、ロックされた1つの マスターフォトグラフィックフィルムアイデンティティコア(references/image_generation_recipes.md§5 を参照)の下で生成し、隣接するページ間でスプレッドアーキテクチャを変化させます(100% カバー→ 61% トップブリード→ 65% ライトバーティカルカラム→ 100% フォトエッセイ→ 76% ディプティック with4 ptホワイトプリントガター→ 68% ボトムブリード→ 77% コンタクトシートトリプティック→ 100% クロージングダスクコロフォン)。また、AI 写真を透明性をもってクレジットし、SHA-256 プレートマニフェストとともに表示します。 - WeasyPrint マガジンガードレール(経験的に検証済み):
- ドロップキャップ(
float: left): WeasyPrint 67.0 では、CSS Grid または Flexbox アイテム内にfloat: leftドロップキャップを決して配置しないでください(テキストカラムが縮小するか、ドロップキャップがずれたり衝突したりします)。分割マガジンページには、position: absoluteブロックカラム(display: block)を使用して、ドロップキャップが100%左詰めでクリーンな複数行ラップになるようにします。 - シームレスグラデーションスクリム: WeasyPrint では、明るい空や雪の上に部分的な高さの
linear-gradientオーバーレイボックスを決して配置しないでください(Cairo はボックスエッジに沿ってかすかな1 px ヘアラインシームを描画します)。すべてのスクリムオーバーレイは、そのフォトコンテナの100%のサイズにし、透明なストップ内でrgba(..., 0)にフェードアウトします。 - 回転マージナルクレジット: 垂直右端クレジットは、
top: 18pt; right: 16pt; transform-origin: 100% 0%; transform: rotate(90deg); white-space: nowrap; position: fixed;で固定します。position: absoluteでは、スプレッドでページがまたがるときにrotate()がオフセットされる場合があります。
- ドロップキャップ(
- タイポグラフィ&用紙ストック: 温かみのある無塗工アーカイバルペーパー(
6. 自動化された視覚QA監査
audit_pdf.py は最終PDFを取得し、以下を実行します:
- 解像度と色空間のチェック: ページラスタライズが300 DPIであることを確認し、予期しないカラープロファイルを検出します。
- ブリードチェック: ページエッジに近い白い境界線または予期しない背景色を特定します。
- テキスト抽出と確証: 認識された数値を
provenance_ledger.jsonの期待値と照合します。 - レイアウト違反の検出: 重なり合う要素、ぶら下がり見出し、負の垂直フィル率をフラグ付けします。
- スライド/ページの一貫性: 同じタイプのすべてのスライドが一貫したマージンとフォーマットに従っていることを検証します。
7. クイックスタート
# 1. データパイプラインの設定と検証
python verifiable-pdf-pipeline/verify_integrity.py --dir data/raw
# 2. 正しいバリエーションでPDFを生成
python examples/reportlab_premium_template.py --theme dark --format 16:9 --output deck.pdf
python examples/reportlab_premium_template.py --theme light --format letter --output report.pdf
# 3. 視覚監査の実行
python audit_pdf.py --input deck.pdf --dpi 180 --output previews/
examples/ ディレクトリの完全な例を参照し、デプロイ前に verifiable-pdf-pipeline/SKILL.md の10のハードルールがすべて満たされていることを確認してください。
8. 関連リソース
- verifiable-pdf-pipeline — データ整合性レイヤー
- editorial-page-layout-guidelines — グリッドシステムとレイアウト仕様
- references/image_generation_recipes.md — 写真生成レシピ
- examples/reportlab_premium_template.py — 完全な実装例
- demos/felis-mundi-magazine/ — 写真誌デモ