Communitygithub.com

slides-genedit — アカデミックプレゼンテーション生成・編集

研究資料(論文、メモ、既存のデッキ)から学術発表用のスライドを生成、または既存のデッキをソース保存的に編集します。2つのルート: (1) 固定の聴衆、時間、スライド数の制約下で新しいデッキを生成し、各スライドの主張、証拠マッピング、スピーカーノート、PDFプレビューを提供; (2) 既存デッキをインベントリし、要求された局所変更のみ適用し、未変更スライドがバイト単位で同一であることを証明します。研究資料をスライドに変換するよう依頼された場合、または既存デッキを壊さずに修正・圧縮・聴衆変更する場合に使用します。

slides-genedit — アカデミックプレゼンテーション生成・編集 とは?

slides-geneditは、AIエージェント(Claude Code, Cursor, Codexなど)向けに設計された、学術発表用スライドの生成・編集を行うスキルです。研究資料(論文PDF、メモ、LaTeXファイル)を入力とし、聴衆、時間、スライド数の制約に基づいて、各スライドに明確な主張、検証可能な証拠(引用箇所と数字)、スピーカーノートを備えた新しいデッキを生成します。また、既存のPowerPointデッキを編集する際には、インベントリを作成し、要求された局所的な変更(テキスト置換、画像挿入、スライド追加/削除など)のみを適用し、変更されていないスライドやマスター/レイアウトが完全にそのまま保たれることを検証します。スクリプト群(parse_case.py, assemble_deck.py, inventory_deck.py, edit_deck.py, render_check.py)が決定論的な処理を担当し、AIエージェントは選択と順序付けの判断(どの結果をスライドにするか、何を削るか)に集中できます。複数のバージョン管理、証跡保存、失敗時の誠実な報告が組み込まれており、学術発表における厳密な引用と再現性の要件を満たします。このスキルは主にコマンドラインとスクリプト連携で動作し、ユーザーからのフィードバックに応じて反復的にデッキを改善できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qingyulzx/pku-efficiency3-skills/tree/HEAD/slides-genedit

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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/にあります。逸脱する前に読んでください。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

biopathway-mechanism-diagram

Build or edit publication-grade biological mechanism/pathway diagrams from research materials (PDF/text) as a challengeable mechanism statement - three-layer model (typed entities, typed directed edges with verbatim evidence, compartment layout), semantics-correct SVG source, PNG/PDF exports and a traceable, uncertainty-aware result.json. Use for tasks asking to draw, generate or edit signaling pathways, mechanism figures, crosstalk diagrams or pathway flowcharts; refuses to guess regulation direction and marks unstated information instead.

graphical-abstract-builder

Build a single-page graphical abstract (question, method, results, conclusion) from research material as a traceable, editable SVG with PNG/PDF exports. Use when asked to create or edit a graphical abstract, science summary figure, mechanism or flow diagram, or data chart from a paper, study notes or experimental records, especially when editable source files and element-to-source traceability are required.

paper-to-academic-ppt

Turn a research paper (PDF) into a structured, evidence-traceable, template-compliant academic slide deck. Two phases: agent-authored narrative spine and page-level claims (each with paper locators and verbatim quotes), then scripted template adaptation that writes content into real master/layout placeholders, embeds original paper figures, checks overflow/aspect/notes, and exports a PDF preview. Handles missing conclusions, figure-trimming, layout mismatch and over-limit slide counts with explicit rules.

relationship-schematic

Generate or edit scientific entity-relationship schematics (mechanism diagrams, pathway chains, experimental workflows, structural containment) as traceable, editable SVG with verified relation semantics. Extracts an evidence-quoted entity/relation table first, renders a layered SVG from it, reads the drawing back to verify every relation type, direction and containment, then exports 300-dpi PNG and vector PDF. Use for any "draw a mechanism/workflow/relationship figure from this paper or case material" task where scientific correctness of entities, arrow directions and hierarchy matters.

関連スキル