pptx-reference-deck-analysis

PPTX リファレンスデッキ分析

リファレンスデッキを設計の証拠として検査します。このスキルはソースデッキをコピー、クローン、または変更することは一切ありません。

コントラクト

必要な抽出は、小さなタスクローカルの python-pptx スクリプトを使用してオンデマンドで実装します。新しいデッキに必要な情報のみを取得します:

• コンパクトなプロンプトコンテキスト: スライド数とサイズ、テキスト要約、図形数、スタイル、ブランドシグナル、テンプレート使用状況、レイアウトリズム。
• 完全抽出: summary、スライド、読み取り専用の layout_tree 証拠。
• フォルダー診断: デッキごとに 1 件の結果とマニフェスト。
• スタイルマスター分析: 色、フォント、サイズ分布、マスター/レイアウトの使用状況、フローパターン。
• 派生テンプレートカタログ: ゼロベースのソースインデックス、レイアウトの役割、使用可能領域、プレースホルダー、視覚構造、制約。

ルール

• ソースデッキは読み取り専用に保ち、ターゲットスライドのすべての座標を独自に作成します。
• バンドルされた OOXML ユーティリティは、高レベル抽出では公開できない生のテーマ、リレーションシップ、ノート、コメント、アニメーション、メディア、マスター、レイアウトにのみ使用します。
• 検査したパーツと解析例外を分析マニフェストに記録します。
• 明示的な許可とライセンスの証拠がない限り、抽出したコンテンツ、フォント、画像、または独自資産を生成されたデッキで使用しないでください。

OOXML パッケージ検査

バンドルされたユーティリティを使用する前に、requirements.txt から defusedxml をインストールします。

1. scripts/inspect.py <deck.pptx> を実行して、スライドの順序、テキスト、テーマトークン、リレーションシップ、ノート、コメント、アニメーション、メディアのコンパクトな JSON レポートを取得します。
2. scripts/validate_package.py <deck.pptx> --output <report.json> を実行して、不正な XML、壊れた内部リレーションシップ、コンテンツタイプの欠落、重複したレイアウトリンク、孤立したパーツを確認します。
3. 生のパッケージの証拠が必要な場合にのみ、scripts/unpack.py <deck.pptx> <output-dir> を実行します。
4. リレーションシップターゲットは .rels の所有者を基準に解決します。ファイル名からスライドの順序を推測しないでください。

安全性

• 提供されたデッキを変更したり、パッケージのパーツを新しいデッキに盲目的にコピーしたりしないでください。
• スクリプトは信頼できるワークスペースから実行してください。スクリプトはパストラバーサル、シンボリックリンク、サイズ超過のメンバー、アーカイブボムを拒否します。
• 信頼できない XML は defusedxml で解析してください。エンティティ展開、DTD ロード、ネットワークアクセスを有効にしないでください。
• テーマの色は、カラースキームに対して完全に解決されない限り、トークンとして扱ってください。

出力形状については references/reference-deck-analysis.md、ドキュメント専用パターンについては references/reference-deck-analysis-patterns.md、パッケージパーツマップについては references/ooxml-parsing.md を参照してください。