Communitygithub.com

premium-pdf-design

機関投資家グレードのPDFプレゼンテーション(16:9 ダークエグゼクティブデッキ)およびレポート(レター ライトスイスアイボリー)デザインシステム。検証可能なオープンデータパイプライン、60-30-10カラーバランス、ヘアライン Tufte 元帳、Minto Pyramid アクションタイトル、300 DPI ベクターデータ可視化、安全な Inter フォント登録、フルブリードキャンバスペイント、自動 PyMuPDF ビジュアル QA 監査を強制します。

premium-pdf-design とは?

このスキルは、McKinsey、Stripe Press、WEF、The Economist にインスパイアされた、機関投資家グレードのPDFプレゼンテーションおよびレポートを生成するための包括的なデザインシステムです。16:9のダークエグゼクティブスライドデッキと、レターサイズのライトスイスアイボリーの機関レポートの2つのモードをサポートし、データの整合性と視覚的な洗練性を重視しています。主な機能には、検証可能なオープンデータパイプラインの強制(verifiable-pdf-pipeline スキルとの連携)、60-30-10のカラーハーモニー、ヘアラインとホワイトスペースによるTufteスタイルのレイアウト、各スライドやセクションに完全な主張を要求するMinto Pyramidアクションタイトル、300 DPIの透明背景ベクターチャート、安全なInterフォント登録、フルブリードキャンバスペイント、PyMuPDFを使用した自動ビジュアルQA監査が含まれます。また、WeasyPrintを使用した純粋ベクターSVGエキシビットと2023年コンサルティングフラッグシップモードも提供し、特定のプラットフォーム(Claude Codeや同様のAIエージェントツール)で動作するように設計されており、レポートのコンパイル前にデータの整合性を検証する厳格な10のアンチチートルールが組み込まれています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gke0op/verifiable-editorial-skills/tree/HEAD/skills/premium-pdf-design

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

検証可能な機関投資家グレードPDFプレゼンテーション&データ可視化システム

このスキルは、verifiable-pdf-pipeline(データ整合性)および editorial-page-layout-guidelines(グリッドジオメトリ)と連携し、McKinsey、Stripe Press、WEF、The Economist にインスパイアされた、出版グレードの 16:9 ダークエグゼクティブスライドデッキ および レターサイズのライトスイスアイボリー機関レポート を生成します。


1. コア不変条件:美しさに先立つ実質

このスキルで構築されるすべてのプレゼンテーションまたはレポートは、verifiable-pdf-pipeline/SKILL.md で定義された 10のアンチチートハードルール に従う必要があります:

  1. ゼロ手書きデータエアギャップ — data/raw/ 内の不変の生ファイルからすべての数値を解析します。
  2. 現実と不変条件コンパイラ — Pydantic ドメイン境界と会計恒等式を強制します。
  3. 反循環検証 — 独立した生ファイルの再計算 + Python AST チェックにより、ハードコードされたリテラルアサーションを禁止します。
  4. アトミックな来歴台帳 — 公開されたすべてのスカラーは data/provenance_ledger.json に1:1でマッピングされます。
  5. ネガティブケイパビリティと神聖な「N/A」 — 真の上流のヌル値は、偽のプロキシではなく、明示的に [N/A] としてレンダリングされます。
  6. コンパイルラッチ — PDF コンパイラは verify_integrity.py を呼び出し、ゼロ以外の終了コードで中止します。
  7. カテゴリと単位のガード — 比較できない範囲やテスト方法を決して混在させません。
  8. 法定証明 — 規制/関税の主張には、公式官報IDが必要です。
  9. 科学的分類学と登録簿検証 — 二名法、権威、系統学、および IUCN ステータスを、現行の GBIF/OpenTree/iNaturalist 登録簿から逐語的に調整します。
  10. レンダリング後の散文グラウンディング(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)でレンダリングします:

  1. デュアルパネル時系列+レート加速: イベントシェーディングと直接的な開始/ピークアノテーションを備えた過去の月次/日次軌跡と、10年/期間レートバーを組み合わせます。
  2. 積み上げマスバランス面+インデックス付き軌跡: 直接的な右端ターミナルラベル(ゼロの独立したフローティングレジェンドボックスは禁止!)を備えた積み上げフロー量と、Base = 100 構造分岐線を組み合わせます。
  3. デカップリング象限散布図+ダンベル圧縮: シェーディングされたターゲット象限+密集したクラスター用のリーダー矢印を備えた2D成長率対成果散布図と、ベースラインから現在までの水平ダンベルを組み合わせます。
  4. Stephen Few 水平弾丸グラフ: 3つの定性的バックグラウンドバンド+プライマリパフォーマンスバー+垂直アンバーベースライン/ターゲットティック+右揃えデルタテキスト(ax.spines["bottom"].set_bounds(...) を使用してx軸スパインをトリミング)。
  5. インメモリヘッドレス Tufte スパークライン: 46–66 pt × 13–16 pt のマイクロラインを io.BytesIO() バッファにレンダリングし、セマンティックなエメラルド/クリムゾンのターミナルドットを持つ ReportLab テーブルセル内に直接埋め込みます。
  6. 起点-終点行列ヒートマップ&リッジライン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> エキシビット を組み合わせます:

  1. ダークヒーロー / ピュアホワイトデータ ポラリティケイデンス(単調禁止):
    • カバーヒーロー: ディープミッドナイトネイビー(#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 アイスシアンセクションプログレスピル。
  2. 高コントラスト編集セリフ+幾何学サンズペアリング:
    • ディスプレイセリフ(Charter / Georgia / Baskerville Bold): カバータイトル、セクション数字、スライドアクションタイトル、巨大な 54 pt #2251FF KPI コールアウト、およびセンタードーナツ合計。
    • データサンズ(Inter / Helvetica Neue): チャートアノテーション、サブタイトル、元帳セル、フットノート、インプリケーションコピー。
  3. 4ティア McKinsey ブルークロマティックランプ(ゼロレインボークラッター):
    • #051C2C ミッドナイトネイビー(アンカー合計、ベースライン、深い収縮)→ #06319C ディープロイヤル→ #2251FF エレクトリックブルー(焦点デルタ、巨大KPI、拡大サージ)→ #00A9F4 ビビッドシアン→ #9AE6FF アイスシアン(セカンダリシェア&セクションピル)。
  4. シグネチャーベクターSVGエキシビットアーキタイプ:
    • マスバランスウォーターフォール / ブリッジチャート: アンカーバー(#051C2C)、フローティング追加(#2251FF)および削減(#00A9F4)、ダッシュステップコネクタ、上部角括弧スパンコールアウト、フローティングセリフネットデルタ。
    • スモールマルチプルウォール+グレー » インプリケーションサイドバー: グループ化された 5 + 3 インデックス付き軌跡カードと、右側の #EFEFEF サイドバーを、円形の #051C2C » シェブロンバッジ(3 pt 白いリング)でブリッジします。
    • 10×10 ラウンドスクエアワッフルユニット行列: ボトムアップで塗りつぶされた 10×10 グリッド(#E5E7EB トラック、4ティアブルーフィル)と、グレーのネガティブスペース内の中央揃えの太字数字。
    • ドーナツリング+100% 積み上げシェアシフト: 5ステップブルードーナツ(2 px 白いスライス区切り、セリフセンター合計)と、2000 vs 2024 のカラムを半透明フローリボンでリンク。
    • 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> を使用してください。
  5. フルブリード編集フォトマガジンモード(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% ディプティック with 4 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を取得し、以下を実行します:

  1. 解像度と色空間のチェック: ページラスタライズが300 DPIであることを確認し、予期しないカラープロファイルを検出します。
  2. ブリードチェック: ページエッジに近い白い境界線または予期しない背景色を特定します。
  3. テキスト抽出と確証: 認識された数値を provenance_ledger.json の期待値と照合します。
  4. レイアウト違反の検出: 重なり合う要素、ぶら下がり見出し、負の垂直フィル率をフラグ付けします。
  5. スライド/ページの一貫性: 同じタイプのすべてのスライドが一貫したマージンとフォーマットに従っていることを検証します。

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. 関連リソース

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル