ppt-master-skill

PPT Master スキル

ppt-master を呼び出すには、このスキルを使用します。次のような場合に適しています。

• ユーザーが ppt-master、PPT Master、またはリポジトリ macrochen/ppt-master に明示的に言及している場合
• PDF、ウェブページ、Markdown の資料を編集可能な PPT にまとめたい場合
• svg_output/、svg_final/、最終的な .pptx を生成したい場合
• ppt-master のプロジェクト構成、ツールチェーン、Strategist / Executor ワークフローを再利用したい場合

ランタイム

初回使用時は、まず次を実行します。

~/.agents/skills/ppt-master-skill/scripts/bootstrap.sh

以降は、上流ツールを優先的にラッパースクリプト経由で実行します。

~/.agents/skills/ppt-master-skill/scripts/run-python-tool.sh project_manager.py init demo --format ppt169
~/.agents/skills/ppt-master-skill/scripts/run-python-tool.sh project_manager.py import-sources projects/demo_ppt169_20260320 ./source.pdf
~/.agents/skills/ppt-master-skill/scripts/run-python-tool.sh finalize_svg.py projects/demo_ppt169_20260320
~/.agents/skills/ppt-master-skill/scripts/run-python-tool.sh svg_to_pptx.py projects/demo_ppt169_20260320 -s final

ウェブページを Markdown に変換する場合：

~/.agents/skills/ppt-master-skill/scripts/run-python-tool.sh web_to_md.py https://example.com/article
~/.agents/skills/ppt-master-skill/scripts/run-node-tool.sh web_to_md.cjs https://mp.weixin.qq.com/s/xxxx

Python に関する制約：

• このスキルのすべての Python スクリプトは、現在のスキルディレクトリ内の .venv でのみ実行してください。
• システム Python、グローバルな pip、または他のディレクトリにある仮想環境で代用しないでください。
• 環境がない場合は、まず scripts/bootstrap.sh を実行して .venv を作成・インストールしてから、作業を続けてください。

作業ルール

• 原則として、上流の vendor/ppt-master にあるツールを再利用し、同様の処理を独自に書き直さないでください。
• 初回使用時、vendor/ppt-master がない場合、または依存関係が無効な場合は、まず bootstrap.sh を実行してください。
• Python ツールの呼び出しはすべて ~/.agents/skills/ppt-master-skill/scripts/run-python-tool.sh またはこのスキル自身の .venv/bin/python 経由で実行してください。システム Python を直接呼び出してはいけません。
• PDF を入力する場合は、まず pdf_to_md.py を実行してください。結果が明らかに乱れている場合、スキャン文書の場合、または OCR に失敗した場合は、手作業での対応が必要であることを説明してください。
• URL を入力する場合、通常のウェブページにはまず web_to_md.py を使用してください。WeChat 公式アカウントの記事や 403 が発生した場合は、web_to_md.cjs に切り替えてください。
• 正式な生成の前に、まず project_manager.py init でプロジェクトを作成し、次に import-sources でソース資料をプロジェクトディレクトリに保存してください。
• ユーザーが既存の資料を提供せず、テーマだけを指定した場合は、プロジェクトを直接初期化し、プロジェクト内に 设计规范与内容大纲.md、svg_output/、notes/total.md を作成してもかまいません。
• デザイン段階では上流の規約に従い、キャンバス形式、ページ数、対象読者、スタイル、配色、アイコン、画像、レイアウトなどを確認してから、作図を開始してください。
• ページの作成後は、通常 total_md_split.py -> finalize_svg.py -> svg_to_pptx.py -s final の順に実行します。
• 「編集可能かどうか」をユーザーが気にしている場合、エクスポートされた PPTX には SVG 形式で埋め込まれており、Office 2016+ では「図形に変換」して引き続き編集できることを説明してください。
• コマンド一覧、役割分担、またはプロジェクト構成を詳しく確認する必要がある場合に限り、references/workflow.md を読み込んでください。

デフォルトのフロー

1. 入力ソースの種類（PDF、URL、Markdown、またはテーマのみ）を判定します。
2. 必要に応じて、ソースの内容を Markdown に変換します。
3. プロジェクトを初期化し、ソース資料を保存します。
4. 设计规范与内容大纲.md を作成または整備します。
5. ページごとに svg_output/*.svg を生成し、notes/total.md を補完します。
6. 後処理とエクスポートを実行し、最終的な .pptx を取得します。

便利なコマンド

~/.agents/skills/ppt-master-skill/scripts/bootstrap.sh
~/.agents/skills/ppt-master-skill/scripts/bootstrap.sh --update
~/.agents/skills/ppt-master-skill/scripts/run-python-tool.sh project_manager.py validate projects/<project>
~/.agents/skills/ppt-master-skill/scripts/run-python-tool.sh pdf_to_md.py ./report.pdf
~/.agents/skills/ppt-master-skill/scripts/run-python-tool.sh total_md_split.py projects/<project>
~/.agents/skills/ppt-master-skill/scripts/run-python-tool.sh finalize_svg.py projects/<project>
~/.agents/skills/ppt-master-skill/scripts/run-python-tool.sh svg_to_pptx.py projects/<project> -s final

必要な場合にのみ参照

• references/workflow.md：よく使うコマンド、プロジェクト構成、ツール選択の推奨事項
• vendor/ppt-master/README.md：上流の概要と機能の範囲
• vendor/ppt-master/docs/quick_reference.md：上流の役割と実行チェックリスト