---
name: scene-graph-ja
description: ppt-scene-graphのOutlineSpec/SlideSpec→create_from_outline→beautifyで、日本語の編集可能PPTXを作る。原典APIの制約と同版vendor修復を保持する。
license: MIT
---

## このスキルでできること

大綱からPPTXを作り、本文を変えずにテーマの色と文字書式を替え、同じ頁の前後を比べる。

- 困っている状況: 完成PPTXの色や書体を変えると、ページごとの修正が必要になる。
- 必要な入力: 頁の役割と内容を持つ大綱。既存資料を整える場合は元のPPTXと希望テーマ。
- 受け取るもの: 大綱から生成した、または指定テーマで整えた編集可能PPTX。テーマ適用前後の比較も保存する。
- 必要環境: Python・lxml/Pillow/typing_extensions/XlsxWriter / 同梱の修復済みvendor runtimeと同版MIT条件 / BIZ UDPGothic/OFLとPowerPoint等の実描画環境
- 作例で試した範囲: 同一原稿の暖色draftとprojection版を保存。元API後の旧色移行を明示し、完成6頁・draft3頁・比較3枚を確認した。本文は前後で一致。
- 制約: 元beautifyは非文字図形の色を残す。本forkは旧帯・線の色移行と重複帯除去を追加した派生。 / 章番号/章題・表紙副題の座標補正も局所変更。元工場とFONT_SIZESは保持。 / 元vendorのparts8ファイルだけ同版公式python-pptx1.0.2から補完。外部lxml等が必要。 / 元evaluateは実行済みだが粗い診断で、独立した視覚採点や満点判定ではない。

# PPT Scene Graph 日本語ガイド

原典: eluckydog/ppt-scene-graph、固定commit `646e3dc4b72a444278d320c8984d5986d7fbf4bb`。MIT ©2026 PPT Scene Graph Contributors。vendorのpython-pptxはMIT ©2013 Steve Canny、字体は個別のOFL-1.1です。

このMDだけをAIへ渡す場合も、[固定SKILL](https://github.com/eluckydog/ppt-scene-graph/blob/646e3dc4b72a444278d320c8984d5986d7fbf4bb/SKILL.md)、[実pipeline.py](https://github.com/eluckydog/ppt-scene-graph/blob/646e3dc4b72a444278d320c8984d5986d7fbf4bb/ppt_scene_graph/pipeline.py)、[DesignSystem](https://github.com/eluckydog/ppt-scene-graph/blob/646e3dc4b72a444278d320c8984d5986d7fbf4bb/ppt_scene_graph/design.py)、[原文MIT](https://github.com/eluckydog/ppt-scene-graph/blob/646e3dc4b72a444278d320c8984d5986d7fbf4bb/LICENSE)を読んでください。日本語再現は同じ配布元の **scene-graph-ja.zip**（`downloads/scene-graph-ja.zip`）から`example/input/`、`example/source/runtime/`、`example/source/fonts/`と`rebuild.py`を取得します。MD単独で修復済みsourceや実字体が付属すると仮定しません。

1. [原稿](example/input/MANUSCRIPT.md)と[大綱](example/input/outline.json)を自分の題材へ置換。元OutlineSpec/SlideSpecのcover/section/content/endingを選び、1頁の主題と少ない本文を決める。coreに概念図factoryがないため、別のアートengineを原典機能として追加しない。
2. `python example/source/rebuild.py`で元create_from_outlineを実行しdraftを保存。その同じ原稿を元beautifyへ通し、projection deckを作る。theme引数は原典の表示名検証に合わせ`load_theme('projection').name`を使う。[マッピング](example/input/theme-source-map.json)に実設定を残す。
3. 原典vendorのparts/欠落は、同版公式python-pptx1.0.2から8ファイルだけ補完済み。元原本と[補完URL/version/hash/一覧](example/source/vendor-parts-repair.json)、[個別MIT](example/source/dependencies/python-pptx-wheel-LICENSE.txt)を保持する。別engineへ切り替えない。lxml/Pillow/typing_extensions/XlsxWriterは[実行依存](example/source/dependencies/REQUIREMENTS.json)。
4. [局所diff](example/source/design-ja.patch)でDesignSystemをBIZ UDPGothicに対応し、[font diff](example/source/pipeline-ja.patch)でa:ea/a:cs/langを設定する。元palette・FONT_SIZES・factoriesを保持。章番号と章題の余白は明示したtheme_layout_adapterで補正し、公式[TTF/OFL](example/source/fonts/)を使う。pt値は原典コードの設定であり、距離に対する最適値の実証ではない。
5. PowerPoint通常exportは[case exporter](example/source/render_powerpoint.ps1)を使う。Application.Quitを呼ばず、明示した作例だけCloseする。PPTXの文字/長方形枠が編集正本、PNGは表示用。

原典のparse_slide宣言はこのcommitで未実装/exportなし。使ったとは記録しない。元beautifyは非文字図形の既存色を残すため、このforkはsource/theme_layout_adapter.pyで旧primary/accentを選択テーマへ移行し、帯の重複を除く。これは原典外の局所修正です。装飾後の型検出でcover/sectionがcontentになることがある。notesフィールドもPPTX speaker notesへは書かれない。実装と宣言を混同しない。

この自作教材は可読性改善や最適pt値の実測ではありません。修正依頼に基づき全頁をPowerPointで描画し、番号/見出しの接触、字形、旧テーマ色、本文同一性を確認します。draftと完成の同頁を並べて、どこが元API、どこが局所補正かを明記。元evaluateは粗い診断として実行して警告を残し、独立評価の点数へ流用しません。QA.jsonに実行・目視・未実施を分け、独立レビューやZIP再実行を未了のまま合格としません。

## 単体の本文から使う

この本文は `skill-forks/scene-graph-ja/SKILL.md` を元にした日本語派生です。読み手・目的・自分の原稿を添えてAIへ渡す。

原典: https://github.com/eluckydog/ppt-scene-graph/tree/646e3dc4b72a444278d320c8984d5986d7fbf4bb

本文内の `upstream/`・`references/`・制作ソースは、サイトの一式ZIP `scene-graph-ja.zip` を展開した中の参照です。単体Markdownには実装や素材を内包しません。ZIPを渡すか、固定原典から必要ファイルを取得して制作する。書体は各作例の入手元と利用条件に従い、再配布できるファイルだけを添える。

原作者: eluckydog / 原典条件: MIT。公式日本語版ではありません。原文LICENSE・NOTICEと素材・書体の条件を保持し、カタログのCC0を原典へ広げない。

- https://github.com/eluckydog/ppt-scene-graph/blob/646e3dc4b72a444278d320c8984d5986d7fbf4bb/LICENSE