slides-genedit — アカデミックPPT生成とソース保存編集
研究資料(論文、メモ、既存デッキ)を編集可能で証跡追跡可能な学術発表に変換します。また、既存のデッキを、変更を依頼されていない部分を壊さずに編集します。難しいのは選択と順序付けであり、段落をコピーすることではありません。どの結果を独自のページにすべきか、メソッドに必要な箇条書きの数、最初に来る図、ページ予算を超えたときに何を削るか。これらの判断をあなたが行います。scripts/内のスクリプトは決定論的な作業(パース、アセンブリ、検証、レンダリング)を担当します。スクリプトが存在するときにXMLを手動で組み立てないでください。
ルート振り分け(最初に決定し、決して混在させない)
/input/case.jsonとtask.mdを読みます。以下のステップ1を実行してください — parse_case.pyが証拠付きのルートヒントを出力します。タスクの文言と照合します:
- GENERATE — 入力に開始デッキがない(研究資料 + 聴衆/時間/スライド数制約 + テンプレート)。新しいデッキを構築します。
- EDIT — 開始デッキ(.pptx)が提供されており、指示が局所的な変更(修改/压缩/换受众/加页/删页/调整)を求めている。インベントリを作成し、外科的な操作を適用します。編集では、未変更のスライドはバイト単位で同一、マスター/レイアウトは未変更、テンプレートスタイル、対象外スライドのノートを保存しなければなりません。
- デッキは存在するが、指示がほとんどの内容を書き換えたり、全体のナラティブを並べ替えたりする場合、それは擬似的な生成実行です — 同じテンプレートから新しく構築し、開始デッキをバージョンN-1として保持します。ルート決定とその証拠を記録します。
予算規律:約7ツールステップが理想、64モデルリクエスト/合計900秒。ステップ1ですでに契約完了のスケルトンresult.jsonを書き込むため、その後どこでクラッシュしても検証可能な成果物が残ります。インクリメンタルに改善し、スケルトンのままにしないでください。
ステップ1 — 入力をパースし、result.jsonの基礎を書き込む(両ルート)
python scripts/parse_case.py --input /input/case.json --workdir /app/work --output-dir /app/output
出力されたルートヒントと実際のタスクテキストの両方をルート決定前に読んでください(ヒントは証拠であり、最終判断ではありません)。制約スキャン(case-parsed.json)をtask.mdと自分で検証してください — キーワードスキャンは見落としや過剰マッチングを起こします。タスクの文言が優先されます。存在するすべての入力ファイル(material*.md/pdf/tex、図)を読んでください。PDFには提供されたpdf-text-tool / pdf-render-tool / ocr-toolを使用してください。ファイル名から内容を推測しないでください。
ステップ2 — 逐語的キャプチャによる抽出(生成)
実際の資料から、研究課題、手法、結果、限界(ナラティブの背骨)を抽出します。読みながら、スライドに載る可能性のあるすべての数字と主張について逐語的な引用とその位置(セクション、表、図)をキャプチャします — これが証拠マップであり、一度収集してステップ3と7で再利用します。資料に結論/結果がない場合、reference/exception-playbook.md #1を適用します:推論には印をつけ、決して捏造しない。
ステップ3 — ページレベルのアウトライン:あなたの判断、記録(生成)
reference/schemas.mdに従って/app/work/outline.jsonを作成します。これは中核的な知的ステップです — テンプレートではなく自分で行ってください:
- 1ページ = 1主張。 タイトルはページのメッセージを述べます(「結果:同圧縮率下で形状誤差が38.2%低い」、 not 「実験結果」)。すべてのスライドには
role(problem/method/result/limitation/...)とスピーカーのnotes(トークの原稿 — ノートのないデッキは不完全です)が必要です。 - 数字は逐語的に。 資料から数字を正確にコピーします(28.4 BLEU、 ~28ではない、 41.8、 42ではない)。各数字のソースはそのスライドの
evidenceに入ります。数字のソースが見つからない場合、その数字はスライドに載せてはいけません。 - 聴衆/時間予算に合わせた選択。 約1分〜2分に1スライド。グループピア:手法の詳細が重要。レビュー委員会:進捗と計画が重要。ディフェンス:貢献と証拠が重要。結果はナラティブの力で順序付けます(良いか?→どれくらいか?→持続するか?)、論文のセクション順ではありません。
- 図: ソースがビットマップの場合、元の画像とその逐語的なキャプションを引用します。データテーブルが存在する場合のみ再描画します。画像のみの結果は独自のページに値します。二次的な図はマージするか、閉会スライドの後のバックアップページに移動します。
decisionsログ: 保持/削除/マージ/並べ替えした各項目に理由を付けます(「表2アブレーションを削除 — ページ予算6ページ、主結果優先」)。これは検証可能性の成果物でありケーススタディ資料でもあります。空の決定はバグです。
ステップ4 — デッキを組み立てる(生成)
python scripts/assemble_deck.py --outline /app/work/outline.json \
--template <template.pptx if provided> --out /app/output/deck_v1.pptx \
--workdir /app/work/scratch
assembly-report.jsonを読みます。オーバーフローリスク、レイアウトフォールバック、予算超過が報告された場合、アウトライン(デッキではない)を修正し、再実行します — デッキと決定ログは一貫性を保つ必要があります。スクリプトは以下を保証します:内容はスライドレベルのプレースホルダーに配置され(不足時はレイアウトからクローン — レイアウトプレースホルダーに書き込んでもレンダリングされません)、画像はアスペクト比を保ってクロップされ歪まず、ノートが添付されます。
ステップ2' — 開始デッキのインベントリ(編集)
python scripts/inventory_deck.py --deck <starting.pptx> --out /app/work/inventory.json
インベントリを読みます。指示が指定する正確なターゲット(スライドインデックス + プレースホルダーidx / シェイプ名)を特定します。編集ターゲットが存在しない場合、プレイブック#8を適用します:明確に失敗するか、リターゲットするか、追加する — 決して黙ってスキップしない。
ステップ3' — 外科的操作を作成(編集)
reference/schemas.md(opsスキーマ)に従って/app/work/ops.jsonを記述します。Opsは1ベースのスライドインデックスに対して順に適用されます。指示が求めるもののみをカバーします:replace_text(書き換えられた箇条書き、既存の書式は保持)、append_bullets、set_notes、insert_image(アスペクト比クロップ)、add_slide、delete_slide、move_slide、duplicate_slide。Opsによるデッキ全体の書き直しは誤用です — 代わりにルートを切り替えてください。
ステップ4' — 編集を適用し、保存を検証(編集)
python scripts/edit_deck.py --deck <starting.pptx> --ops /app/work/ops.json \
--out /app/output/deck_v2.pptx --workdir /app/work/scratch
edit-report.jsonを確認:すべてのopsがok、slides_identical_raw >= source slides − touched slides、masters_untouchedとlayouts_untouchedがtrue。未変更スライドが構造的にすら同一でない場合、編集が漏れています — プレイブック#9。再レンダリングしてから納品します。
ステップ5 — レンダリングとチェック(両ルート)
python scripts/render_check.py --pptx /app/output/deck_v1.pptx --outdir /app/output/render/
PDFプレビューが存在し、ページ数がスライド数と一致する必要があります。プレビューをオーバーフロー、フォント置換、クリップされた画像について検査します(利用可能なpdf-render-tool / office-rendererを使用)。プレビューでのフォント置換は不確実性として記録されます — レンダラーを喜ばせるためにデッキのテンプレートフォントを書き換えないでください(プレイブック#4)。レンダリングが不可能な場合、.pptxを保持し、正直に失敗を記録します(プレイブック#6)。
ステップ6 — 意図的に反復する(両ルート)
ユーザーフィードバックは、現在のデッキに対する新しい編集指示として到着します:最新バージョンに対してステップ2'(編集ルート)にループバックします。以前のバージョン(deck_v1.pptx、deck_v2.pptx、...)を保持します — 決して上書きしません。各レンダーレポートとopsログ/決定差分がバージョンレコードです。各ラウンドで回帰チェック:未変更スライドは同一のままですか?
ステップ7 — result.jsonを確定する(両ルート)
/app/output/result.json(ステップ1のスケルトン)を最終値に更新します:case.jsonからのすべてのoutput_contractフィールドを入力 — プレゼンテーションファイル、スライド数、スライドごとの証拠マッピング(位置 + 逐語的引用)、レンダープレビューパス、スピーカーノートステータス。編集実行はopsログと保存マトリックスを追加します。実際に生成できなかったフィールドはnullのままとし、理由をunansweredに記述します。status ∈ complete | partial(制限を記述)。その後停止 — .pptx、ノート、PDFプレビュー、result.jsonを納品します。
譲れない条件
- スライド上の数字/引用は逐語的にキャプチャされたソースにトレース可能。捏造された図、目視再描画、黙った丸めは禁止。
- 編集ルートはマスター/レイアウトや対象外スライドに決して触れない。保存マトリックスがそれを証明する。
- result.jsonでは、偽造成功よりも正直な失敗を常に優先。
- テンプレート、依存関係、スキーマ、例外プレイブックは
README.mdとreference/にあります。逸脱する前に読んでください。