SlidePatch は何をしますか?
このスキルにバンドルされているスクリプトを使用してください。ホストエージェントの作業ディレクトリに関係なく、これらのスクリプトのパスはこのファイルからの相対パスで解決されます。ホストはローカルコマンドの実行と画像表示をサポートしている必要があります。このスキルには DSH 固有の API やモデル API キーはありません。
新規インストールの場合は、python <skill>/scripts/slidepatch.py doctor を実行してください(グラフ移行の場合は --charts、数式変換の場合は --equations を追加)。これにより、アプリケーションを開かずに依存関係と Office の登録状況をチェックします。準備完了の結果は、ネイティブ検証の代わりにはなりません。
ネイティブ数式変換
スタンドアロンの数式テキスト、画像、または MathType/OLE 数式をネイティブ PowerPoint 数式に変換するリクエストには、inspect-equations と convert-equations を使用してください。計画、書き起こし、検証の契約については references/equations.md を参照してください。このモードでは、Windows/PowerPoint に加えて Pandoc が必要です。他のモードでは Pandoc は必要ありません。このモードはデッキのレイアウト、ページ数、および指定されていないオブジェクトを保持し、テンプレートを使用せず、既存のネイティブ数式を再変換しません。明示的にオブジェクト全体の LaTeX が指定された場合は候補が生成されます。エージェントは、画像やキャッシュされた OLE プレビューをレビューおよび書き起こしますが、OLE をアクティブ化したり、MathType バイナリを解析したりすることはありません。不明瞭なオブジェクトはそのまま残し、報告してください。現在、テンプレート移行は、数学的構造の損失を防ぐためにネイティブ数式を拒否します。変換を、結果の数式を移行するための自動サポートとして扱わないでください。
デッキ全体の移行と改ページ
プレゼンテーション全体を移行する、または改ページを許可するリクエストの場合は、migrate を使用してください。適用範囲の契約と証拠の形式については references/batch.md を参照してください。
python <skill>/scripts/slidepatch.py migrate <source.pptx> --template <template.pptx> --output <new-output.pptx> --evidence <fresh-evidence-directory>
エンジンはすべてのソーススライドを順番に処理します。カバー、目次、番号付きセクション、および通常のコンテンツページを識別し、一致するテンプレートページタイプを優先し、ネイティブのテンプレート背景、グラフィック、およびレイアウトを再利用します。目次ページは、専用の目次テンプレートがない場合、コンテンツページスタイルを使用できます。plan.json で分類とフォールバックを確認してください。これは幾何学的/タイポグラフィ的な推論であり、無制限の画像理解ではありません。
テンプレートのフォントファミリー、サイズ、太さ、色を保持します。ネイティブテキストの測定値が容量を決定します。可能な場合は、完全なグループをまとめて保持します。同じくらい短いグループ全体のページ分割の中では、テキスト量のバランスを取ります。単一のグループが大きすぎる場合は、ボディオブジェクト、段落、または文の境界で分割し、正確な文字スライスを保持します。サイズ超過グループの継続ページでは、コンテンツを上部に揃えます。タイトル、グループ見出し、フッターは明示的なコンテキストとして繰り返されます。ボディスライスはソースを正確に1回、順序通りに再構築する必要があります。ソースの数値を書き換えたり、目次を静かに番号変更したりしないでください。テンプレートのタイポグラフィを変更せずに収まらない文がある場合、操作全体が失敗します。
このモードは、通常の編集可能テキスト、サポートされているソーステキストプレースホルダー、および明確な構造を持つ埋め込み画像/ネイティブグラフをサポートします。ソースプレースホルダーの制限については references/plan.md を参照してください。メディアページについては references/media.md を参照してください。画像とそのトリミングはネイティブのまま、グラフは埋め込みワークブックを保持し、関連するキャプションはレイアウトと改ページの間、アセットとともに残ります。メディアページはコンテンツテンプレートを使用します。テキスト以外の装飾、サポートされていないプレースホルダー、グループ、アニメーション、外部リンク、および曖昧な構造はサポートされていません。いずれかのページで失敗すると、出力全体の公開が妨げられます。不完全なデッキを決して提供しないでください。生成されたすべてのページは、再度開かれ、レンダリングされ、テンプレートのフォント/背景に対してチェックされ、実際に編集および保存された別のプルーフコピーで確認されます。すべてのページ、テキスト、およびメディアのチェックに合格した後にのみ、出力が公開されます。
すべての after-N.png、特にカバー/セクションタイトル、目次ページのフォールバック、および改ページの境界を確認してください。report.json のページごとのチェックと編集可能性ページリストを読んでください。検証済みの PPTX、プレビュー、および簡潔なソースから出力へのページサマリーを提供してください。ページが分割された場合、コンテキストの繰り返しは意図的であると述べてください。オリジナルは変更されません。
同一ファイルモード(plan v1)
- 入力は既存の
.pptxです。ソースと参照は、同じデザインとレイアウト、および非表示のマスターグラフィックを持つ、そのファイル内の異なるスライドです。 - ソース:通常の図形、線、水平テキストボックス。参照:これらに加えて装飾的な画像。選択されたいずれのスライドにも、グループ、プレースホルダー、グラフ、SmartArt、アニメーション、トランジション、ハイパーリンク、または回転されたオブジェクトはありません。
- すべてのソーステキストオブジェクトは、正確に1つの参照テキストオブジェクトにマッピングされ、その逆も同様です。ソースの非テキスト図形は、置き換える装飾として明示的に識別される必要があります。オブジェクトに意味のある視覚的証拠が含まれている可能性がある場合は、 clarify(明確化)のために停止してください。
- この操作は、ソーススライドのローカルオブジェクトを参照オブジェクトのネイティブコピーに置き換え、それらを正確なソース文字列で埋めます。強調の変更を含む、参照のタイポグラフィを採用します。ソースの文字書式の保持は保証しません。
- コンテンツの要約、ページ分割、自動フォント縮小、または画像から編集可能への再構築は行いません。選択されたスライドがこれらの制限に適合しない場合は、無関係なツールでデッキを再構築する代わりに、特定の制限を説明してください。
個別テンプレートモード(plan v2)
ソーススライドと別の PPTX ファイルのテンプレートに対して apply-template を使用します。このモードは、テンプレートのサイズで 新しいスライド1枚 を生成します。ソースデッキを書き換えたり、他のテンプレートスライドを含めたりしません。ユーザーがソースデッキの他のスライドを保持する必要がある場合は、v1 を選択してください。
両方のファイルを検査します。これには、inheritance の下にリストされている継承されたレイアウト/マスターグラフィックが含まれます。実際のプレビューを表示し、スライド2が適切なテンプレートであると想定せずに、コンテンツページを選択してください。ブランディングと装飾を保持します。すべてのローカルテンプレートオブジェクトを、保持する装飾または削除するサンプルコンテンツとして明示的に分類します。ソースコンテンツの証拠として、無関係なテンプレート写真を保持しないでください。
ソーステキストオブジェクトごとに1つのプレースメントを作成します。プレースメントは、スタイル提供者としてテキストを持つ通常のテンプレート図形を指定し、ポイント単位で境界を与えます。同じ提供者が複数のプレースメントにサービスを提供できるため、ソースとテンプレートのテキスト数は異なる場合があります。エンジンは、テンプレート内のネイティブオブジェクトを複製し、そのレイアウト/マスターとテーマを保持します。テキストはソースから直接取得されます。計画には置換文字列は含まれません。フォント縮小とコンテンツの書き換えはサポートされていません。
v1 のソース制限が適用されますが、v2 では サポートされているソーステキストプレースホルダー も受け入れます。空の安全なテキストスロットは、破棄されたものとして明示的に記録されます。アクティブな継承ソーステキストは、静かに省略されるのではなく、拒否の原因となります。スタイル提供者は、回転していない水平テキスト図形である必要があり、プレースホルダー/グループではありません。テンプレートレイアウト/マスターの装飾は、継承された画像や未使用のレイアウトプレースホルダーを含め、ネイティブのまま保持されます。保持されるローカル装飾にはテキストがあってはなりません。計画はどのオブジェクトが削除されるかを記録します。自動計画はこれらの決定を提案できますが、エージェントがその意味をレビューします。
自動レイアウト(個別テンプレートに推奨)
明確なタイトルと本文テキスト(サポートされているソーステキストプレースホルダーを含む)を持つテキストのみのソースの場合は、最初に以下を実行します。
python <skill>/scripts/slidepatch.py plan-template <source.pptx> --template <template.pptx> --source-slide 1 --out <fresh-planning-directory>
これにより、手動でターゲットページ、図形 ID、または座標を指定せずに、標準の v2 plan.json が生成されます。selection.json には、推論されたソースの役割、候補テンプレートページ、幾何学ベースの装飾決定、候補レイアウト、適合測定、および拒否理由が記録されます。ステータス planned は計画が存在することを意味し、PPTX が最終検証に合格したことを意味するものではありません。
プランナーは、フォント階層と空間的近接性を使用して見出しと本文を関連付けます。図形名やテンプレートページ番号は使用しません。明確なトップタイトルが必要であり、短いフォントの下部フッターを認識し、グループ化された行/列または見出しのない段落をサポートします。行、積み重ね、2列、3列のレイアウトを検索し、元のテンプレートフォントサイズでPowerPointのネイティブテキスト範囲を使用します。テキストは折り返されます。文字列の書き換えやフォント縮小は発生しません。候補ボックスは、互いに、または保持された装飾と重なってはなりません。全ページ背景と未使用のレイアウトプレースホルダーは、障害チェックから除外されます。
selection.json を読み、source.png と選択された template-N.png を表示し、役割の関連付けとサンプル画像の削除が理にかなっていることを確認してください。自動画像分類は、画像理解ではなく、幾何学と近くのキャプションを使用します。普遍的な意味的マッチングを主張しないでください。明確な結果の場合は、生成された計画を直接 apply-template に進め、レンダリングされた出力をレビューしてください。ユーザーが座標を提供したり、リクエストですでにカバーされている日常的な選択を承認したりする必要はありません。
単一ページ計画が、曖昧な役割、不確かな装飾、サポートされていないオブジェクト、または容量超過のコンテンツを拒否した場合は、記録された理由を読んでください。改ページが許可されている場合は、migrate を使用してください。それ以外の場合は、レビュー済みの明示的な v2 プランを使用する前に、実際のオブジェクトを検査してください。コンテンツを静かに省略したり、フォントを縮小したり、許可されたページ範囲を変更したりしないでください。画像、テキスト以外の装飾、混合/不明瞭な階層、グラフ、またはグループを含むソースには、依然として明示的またはサポートされていないコンテンツワークフローが必要です。
実行
requirements.txt を Python 3.10+ の仮想環境にインストールしてください。すべてのコマンドにそのインタープリターを使用してください。デスクトップ PowerPoint がログイン中の Windows セッションで使用可能である必要があります。最初に検査します。
python <skill>/scripts/slidepatch.py inspect <source.pptx> --out <fresh-inspection-directory>
inventory.json を読み、関連する両方の slide-N.png プレビューを表示します。実際のオブジェクトと外観を使用してコンテンツの役割を一致させてください。図形 ID をその順序から推測したり、保護されたテキストをメモリから再構築したりしないでください。
同一ファイルモードの場合は、references/plan.md のスキーマを使用して JSON 計画を作成します。個別テンプレートの場合は、plan-template を優先します。自動推論が適切でない場合は、手動レビューされた v2 計画を使用します。現在のインベントリからハッシュと ID をコピーします。ユーザーの意図した範囲を保持します。明確なマッピングで明確に承認されたリクエストは続行できます。ファイルから解決できない実質的なコンテンツの曖昧さがある場合にのみ質問してください。
python <skill>/scripts/slidepatch.py apply <source.pptx> --plan <plan.json> --output <new-output.pptx> --evidence <fresh-evidence-directory>
個別テンプレートの場合は、それも検査し、次に v2 計画を使用します。
python <skill>/scripts/slidepatch.py inspect <template.pptx> --out <fresh-template-inspection>
python <skill>/scripts/slidepatch.py apply-template <source.pptx> --template <template.pptx> --plan <v2-plan.json> --output <new-output.pptx> --evidence <fresh-evidence-directory>
エンジンは編集されたデッキをステージングし、PowerPoint で再度開いてレンダリングし、正確なテキストオブジェクトと数値を比較し、ターゲット以外のスライドをチェックし、別のプルーフコピーで実際のテキスト編集と図形移動をテストします。これらのチェックに合格した後にのみ、出力を公開します。PowerPoint の Quit を呼び出したり、関連のないプレゼンテーションを閉じたりすることはありません。ネイティブのコピー/ペーストはシステムクリップボードを使用します。
テンプレートモードでは、代わりに1枚のスライドの結果、両方の元のハッシュ、すべてのローカルソース文字列、保存されたネイティブオブジェクト、および前後で同一のレンダリングされた装飾レイヤーをチェックします。既存の装飾的なにじみは許可されます。新しいコンテンツは収まる必要があります。クリップボードを使用せずにネイティブの重複を使用します。PPTX には、未使用のテンプレートレイアウト、マスター、またはメディアがまだ含まれている可能性があります。このプロトタイプは、非表示のパッケージアセットをサニタイズしません。
レビューと提供
report.json を読みます。終了ステータスとレポートの両方が成功を示している必要があります。before-<source>.png、before-<reference>.png、after-<source>.png を表示します。スタイリングが一致し、クリッピング、意図しない重なり、または誤った読み取り順序がないことを確認してください。幾何学的チェックは視覚的なレビューに代わるものではありません。
テンプレートモードの場合は、source-before.png、template-before.png、after-1.png、および template-shell.png と output-shell.png を表示します。テンプレートのビジュアル言語に対して新しい構成を確認します。テキスト文字列の一致だけでは不十分です。
新しい PPTX をプレビューとともに、チェックと範囲の簡潔なサマリーとともに提供してください。editability-proof.pptx は意図的に編集マーカーを含んでおり、証拠であり、最終的な提供物ではありません。いずれかのチェックが失敗した場合は、問題を報告してください。ステージングファイルやプルーフファイルを最終的なデッキとして決して提示しないでください。再試行時には新しいパスを選択し、失敗の証拠を利用可能にしておいてください。