⛔ 最も重要なルール:下書きを表示したら、停止する
ワークフロー全体は 下書き → 人間ゲート → 調整 です。以下のすべてはこのループに従います。他のことを始める前に、次の5行を読んでください:
- 要件を1ラウンドで質問し(デフォルト値を提示)、その後、1パスで下書き全体を生成します。すべてのページを並行して作成し、自己反復は行いません。
- 概要画像と下書き
.pptxをレンダリングし、人間に提示します。 - そこでターンを終了します。 続行しないでください。自己QA、調整、同じターンでの再エクスポートを行わないでください。次のアクションは人間に委ねられます:
- "continue / 問題ない" → 最終QAパスを1回(バグのみ)→ 最終版をエクスポート → 提供
- 具体的なフィードバック → 指定されたページのみを編集 → 再度表示
- "方向性が違う / スタイル変更" → 最初から再生成
- QAチェックリスト(ステップ5)は、人間の承認後にのみ実行されます。 自分がQAを実行したり、ページを修正したり、人間が見ていない下書きを「調整」していることに気づいたら、停止してください。その下書きの唯一の役割は判断されることであり、人間が決して見ない下書きは100%無駄な作業です。
- ルール3/4をスキップすることは、このスキルで最も一般的な失敗です。人間が数分で見る短く不完全な下書きは、何時間もの非公開の自己QAを経た「完璧」なデッキよりもはるかに価値があります。
定義
HXMPPTは、Moonshot AIのPPTD形式をベースにしたプレゼンテーション作成・エクスポートスキルです。これは、OOXMLを抽象化し、各ページを自己完結型にするYAML形式の中間DSL(.pptd)を定義します。
デフォルトの出力はPPTDのみではありません。 ユーザーが明示的にオプトアウトしない限り、常に次の両方を生成します:
- 完全な編集可能なPPTDプロジェクトディレクトリ(
.pptd+pages/+media/およびその他の参照される依存関係) - 対応するローカル生成の
.pptx。デフォルトですべてのスライドにフェードスライドトランジションが適用されます。
PPTXエクスポートは、python-pptxを使用してローカルで実行されます。Node.js、ブラウザ、Kimiのパブリックエディタへのネットワークアクセスは不要です。ビジュアルQA画像は、同じPPTDソースからPillowを使用してローカルでレンダリングされます。
なぜ今ローカルのみなのか? 以前のエクスポーターは、KimiのパブリックブラウザサイドOOXMLライターを、localhost SDKブリッジを介して駆動していました。Moonshot AIはそのリバースエンジニアリングされたパスを遮断し、アップストリームリポジトリをクリアしました。現在のエクスポーターは、PPTD仕様に直接従う自己完結型のPythonレンダラーです。フォント埋め込みと要素アニメーションはローカルライターではサポートされておらず、特殊なチャートタイプは静的画像としてレンダリングされます。詳細は、このファイルの最後にある「制限事項」を参照してください。
既存のPPTXファイルは、scripts/import_pptx.pyを使用してPPTDに変換できます(ベストエフォート:テキスト/図形/画像/テーブル/コネクタはインポートされます。チャート、グループ、アニメーション、ノートは警告付きでスキップされます。詳細は「制限事項」を参照)。編集後、両方の出力が再度提供されます。
pptd形式
.pptd形式は、OOXMLの簡略化された抽象化レイヤーであり、基本的なYAML構文に従います。この抽象化は、OOXMLのコアコンテンツ(テーマ、ページレイアウト、要素の位置と定義など)を保持しながら、マスターなどの複雑なネストロジックを排除します。すべてのページは自己完結型であり、見たままが得られます。このDSLの完全な定義については、reference/pptd.mdを参照してください。
PPT制作ワークフロー
ステップ0. ローカルの前提条件を確認する
デフォルトの提供には、PPTXエクスポートとビジュアルQAプレビューが含まれており、小さなローカルPythonツールチェーンが必要です。生成する前に、以下を確認します:
- python3(3.9以降):
python3 --versionを実行します(Windowsでは、pythonが正しいコマンドの場合があります)。python3が存在せず、ユーザーが明示的にPPTDのみの出力を選択していない場合、直ちに停止し、Pythonをhttps://www.python.orgからインストールするようにユーザーに伝え、続行しないでください。PPTDのみが合意されている場合は、PPTDプロジェクトを提供し、ブロッカーを報告します(ステップ6と同じフォールバック)。 - Node.jsとagent-browserは不要です — ローカルコンバーターは純粋なPythonです。複雑なチャートタイプ(ローソク足/ウォーターフォール/ヒートマップ/ツリーマップ/サンバースト/サンキーおよび混合タイプのコンボ)は、存在する場合に追加でmatplotlibを使用します。初回使用時に自動インストールされます。
- ソフト依存関係は、
scripts/export_pptx.pyとscripts/export_images.pyによって、欠落している場合にpipを介して自動インストールされます:PyYAML、python-pptx、Pillow、および(オンデマンドで)matplotlib。インストールは、アクティブなvirtualenvが存在する場合はそれをターゲットにし、それ以外の場合はpip install --userをターゲットにします。エアギャップ/CI環境で自動インストールを無効にするには、HXMPPT_NO_INSTALL=1を設定します。その場合、エクスポーターは正確にどのパッケージが欠落しているかを報告します。 - 以下のスクリプトパスは、このSKILL.md(スキルルート)を含むディレクトリからの相対パスです。 コマンドを呼び出すときは、インストールされたスキルの絶対パスに解決します(例:
<skill-dir>/scripts/export_pptx.py)。スキルルートのinstall.shは、スキルを標準のClaude/WorkBuddyの場所にインストールします。
ステップ1. コンテキストを徹底的に読む
ユーザーがアップロードしたすべてのファイル、提供されたURL、およびpptd形式ガイドreference/pptd.mdを読んで、ユーザーの要件を完全に理解します。
ステップ2. 簡単な要件確認(1ラウンドの質問の後、進む)
コンテキストに基づいてユーザーの要件を理解します:
- リクエストの目的を特定する
- PPTを作成する:新しいプレゼンテーションを作成する(ゼロから、または既存のpptxテンプレートから)
- PPTを編集する:ユーザーがアップロードしたPPTを編集する(ローカルな変更、1ページの美化など)
- PPTを複製する:pptx以外の形式(画像、PDFなど)からpptd形式にプレゼンテーションを複製する
- デザインの方向性を決定する(自己主導/デザインシステム/テンプレート/スタイル転送 — ステップ3を参照)
- 入力タイプを決定する(トピックのみ/全文書/アウトライン)。入力が全文書またはアウトラインであり、拡張が禁止されていない場合は、関連するマテリアルで拡張することを優先します。
- ページ数を決定する(ユーザーリクエストが優先。アウトライン → それに合わせる。トピックのみ → 推奨して確認する)。
スピードルール(必須)
- 最大でも1回の質問をすること。 トピック/入力/ページ数/スタイル/対象者を1つの質問にまとめ、すべての質問にデフォルトの回答を用意し、ユーザーが一言または何も言わずに返信できるようにします。
- ユーザーが回答しない場合は、仮定を1行で述べ(例:「ビジネスコンサルタント風、約15ページで進めます」)、先に進みます。人間によるレビューゲート(ステップ4)で、誤った仮定は低コストで発見されます。
- 本当にブロックとなる問題(アクセスできないファイル/URL、矛盾するハード制約)に対してのみ中断します。下書きが存在する前に、好みに関する質問でラウンドを消費しないでください。下書きは、質問よりもはるかに優れた方法で好みを伝えます。
ステップ3. 最初の下書きを生成する(1パス — 速度優先、完璧主義は禁止)
生成する前に、まずreference/pptd.mdを読んで、pptd形式の定義と制約を理解します。
下書き優先ルール(必須)
- デッキ全体を1パスで生成します。 ストーリーラインとページ計画を事前に設計し、その後すべての
.pageファイルを並行バッチで作成します。ページを作成してから再読み込みし、自分で書き直すことはしないでください。 - 最初の下書きの唯一の役割は、人間が方向性を判断できるようにすることです — ストーリーライン、構造、情報密度、スタイル。「判断に十分な品質」が基準です。人間がデッキを見る前のピクセルパーフェクトは、バグであって美徳ではありません。
- 人間ゲートの前での自己QAループは禁止です。 エクスポーターが壊れたページを示す警告なしに解析および実行されることを確認する、1回の健全性チェックのみを実行します。ビジュアルQAチェックリストを実行したり、自己修復したり、事前にページを再生成したりしないでください。
- 下書きを安価に保ちます。 拒否された方向性にかかるコストは数分であり、数時間であってはなりません。ユーザーは下書きに基づいてモデル、スタイル、または指示を変更する可能性があります。
- 下書きを作成したら、すぐにステップ4(人間によるレビューゲート)に進みます。「簡単な」デッキであっても、これをスキップしないでください。
PPTの複製
- 画像を分析して、要素の位置、フォント、サイズなどを推定し、可能な限り1:1で複製します。
- 判読が難しい部分については、グリッド線や拡大表示などの方法を使用して理解を深めます。
- 画像内の単純なコンテンツは要素で複製します。アイコンはFont Awesomeが提供するアイコンで近似することができます。写真やアバターなど、アイコンや図形で近似できないコンテンツについては、bashやpythonなどのツールを使用して元の画像を切り抜いて分割し、結果の画像要素をプレゼンテーションに追加します。
PPTの編集
- ユーザーがアップロードしたpptxファイルを
scripts/import_pptx.pyで.pptd形式に変換します(ベストエフォートのインポート。報告された「スキップ」警告を確認します。チャート/グループ/ノートはインポートされません)。 - 変換されたページを確認します(構造と主要なビジュアルの詳細)。その後、いくつかの重要なページを個別に読みます。
- 編集するページを見つけ、意図したスコープ外の部分に影響を与えないように注意します。
pptxからpptdへの変換は完全にロスレスではありません。ユーザーが後でフォーマットエラーや文字化けなどを報告した場合は、元のpptxと比較し、比較結果を参照してpptdを修復します。
PPTの生成
PPTを生成する際は、ユーザーの[デザインの方向性]に応じて異なる制作アプローチを採用します。
自己主導デザイン
- デザインガイド
reference/slides_categories.mdを読み、ユーザーのクエリに対応するシナリオドキュメントを読みます。 - 上記に基づいてプレゼンテーションを作成します。
他の形式でのコンテンツ生成
- ユーザーが明示的にインフォグラフィック、ポスター、または高度に視覚的な1ページデザインを要求した場合は、
reference/general-poster.mdを読み、それを1ページまたは数ページの編集可能なPPTDとして実装します。ユーザーが画像のみを要求した場合でも、まずPPTDで構築し、スクリーンショットまたはレンダリングを介して画像を出力します。通常のPPTリクエストでは、この参照ファイルをロードしないでください。
デザインシステム
reference/slides_categories.mdガイドの一般制約セクションを読み、ユーザーのクエリに対応するシナリオドキュメントをデザインの基礎として読みます。- 指定されたデザインシステムをプレゼンテーションスタイルとして読みます。ユーザーが提供したデザインスキーム、または
reference/design_system/の下にある対応するプリセットを読みます。完全なカタログについてはreference/design_system/README.mdを参照してください。各プリセットは推奨ファイルにマッピングされています。一部のプリセットは2つの形式(洗練されたdesign.md「シグネチャーシステム」と元のen/*.mdソースドキュメント)で存在します。常に、フォルダのdesign.mdが存在する場合はそれを優先します。他のデザインスタイルを参照または混在させることは固く禁じられています。 - 上記を参照してプレゼンテーションを作成します。
- 自己主導デザイン中にプリセットを自動選択しないでください。プリセットが明示的に指定された場合にのみ
reference/design_system/を使用します。
テンプレートの使用
- ユーザーがアップロードしたpptxファイルを
scripts/import_pptx.pyでpptd形式に変換します(ベストエフォートのインポート。報告された「スキップ」警告を確認します)。 - 変換されたページを確認して、テンプレートのビジュアルスタイル(配色、フォントスタイル、要素の特性、レイアウト特性、コンテンツ密度など)を理解します。
- ページタイプを特定します。表紙、サマリーページ、セクション区切り(1ページのスクリーンショット、.pageファイル)などの特別なページに焦点を当て、それらのページレイアウト、コンテンツ構造、再利用可能なコンポーネント(アイコン、図形、スマートアート、再利用可能なボディレイアウトスキームなど)、および要素スタイル(例:余白/ライン/カード区切り、正方形/角丸など)を抽出します。
- テンプレートを使用してプレゼンテーションを作成します。
スタイル転送
- 参照ファイルのビジュアルスタイル(配色、フォントスタイル、要素の特性、レイアウト特性、コンテンツ密度など)、ページレイアウト、コンテンツ構造、再利用可能なコンポーネント(アイコン、図形、スマートアート、再利用可能なボディレイアウトスキームなど)、および要素スタイル(例:余白/ライン/カード区切り、正方形/角丸など)を分析します。
- ユーザーがスタイル参照URLを提供した場合、テキストコンテンツを読むだけでなく、ページの視覚効果をより多く参照して学習し、スタイルの理解に役立てます。
- 参照ファイルのスタイル特性を使用してプレゼンテーションを作成します。元のpdf/urlからのイラスト、フォント、フォントサイズ階層、要素などを再利用することを推奨します。
画像とビジュアルマテリアル
- 画像は、プレゼンテーションの視覚的なインパクトを高める効果的な方法です。表紙やセクション区切りだけでなく、ボディページでも適切な画像を使用して、ページを豊かにし、理解を助け、または意思決定を支援する必要があります。
- 画像は、具体的な主題を示し、内容を説明し、証拠を提供し、またはシーンを確立するために使用されます。ロゴ、アイコン、装飾テクスチャ、および非常に小さなサムネイルは、実質的な画像とは見なされません。
- ページに製品、人物、場所、建物、イベント、ケース、インターフェース、実験対象、または空間環境が含まれる場合は、対応する実際の画像またはスクリーンショットを優先します。実際の画像とスクリーンショットを取得できない場合は、代わりに生成された画像を使用してもかまいません。
- 画像の優先順位:ユーザーが提供した画像。公式ウェブサイト、公式レポート、および信頼できるソースからの画像。コンテンツに直接関連する検索された画像。概念表現や雰囲気のために生成された画像。
- 必要な画像を決定した後、画像の検索、生成、ダウンロードを一括で完了してから、画像を中心にページをデザインします。