学会・研究会・学内での研究発表を、対話しながら編集可能なPowerPointへ仕上げるスキルです。Codex・OpenCode・Claude Codeから、同じ公開ツールによる生成・検証経路を利用できます。
スタイル → 企画書 → アウトライン → スライド構成と図 → 完成イメージ → 編集可能なPPTX
初めて使う方は 導入 から始めてください。使い方 に研究資料を渡す依頼例があります。
1.7.4では、画像・イラストを多めに使う標準を明確にしました。本文10枚あたり合計12〜16点程度を7〜8割のページへ配置し、そのうちイラストは6〜8点程度を目安にします。減らすのは利用者から指定がある場合とし、構成・完成イメージ・最終PPTXで点数と配置を確認します。素材の要件と確認方法
1.7.3では、利用者の文体を初稿から反映する手順を追加しました。本人が自然だと選んだ参考資料と、実行中のCodex・Claude Code・OpenCodeで参照できる本人のメモリを確認します。タイトルは話題名・説明文・問いを使い分け、本文は対象と動作が分かる日本語に整えます。メモリを参照できない場合も、今回の指示と文章を基準に進めます。文体と日本語の指針
1.7.2では、写真1つ以上と本編の研究全体の概要図・アーキテクチャ図1つ以上を独立した必須条件にしました。イラストの標準量とグラフの推奨も設けました。画像等の合計と減量の扱いは1.7.4で更新しています。素材の要件と確認方法
1.7.1では、表の不正値、内部要素順、不要な定義・グラフ軸参照、ノート用テーマの共有を修正し、同じ不具合の検査と既存PPTXの限定修復を追加しました。回帰試験148件が成功し、再生成した架空作例3件・計28ページがPowerPoint 16.111で修復なしに開くことと全ページの表示を確認しました。検証範囲
1.7.0では、発表メモの口頭補足・詳細根拠・制作事項を分け、PPTXと外部メモの対応を検査します。従来のメモ入力を保ち、生成範囲内の手修正も上書きから保護します。主張の対象・分母・期間と図の役割は、必要な箇所で確認します。入力形式と検査手順
1.6.0では公開ツールによる3作例・28枚の生成、描画、全ページ確認を実施しました。OpenCodeの実クライアントでも生成・描画・機械検査まで確認しています。ただし、試験時の選択モデルは画像入力非対応で、Claude Codeは未ログインだったため、両クライアントの目視を含む完走は未検証です。実施範囲と再実行手順
従来の**中間発表型（cps-midterm）**を維持し、**短い研究発表型（cps-workshop）も選べます。研究入力、章構成、CPSの視覚仕様、ページのレイアウトを分け、研究に合う説明方法を使います。表紙は独立してタイプA（題目帯＋写真）／タイプB（背景動画）**から選びます。
企画書・アウトライン・完成イメージでは、必ず使用者のレビューを受けて停止します。現行版への了承後に次工程へ進み、修正依頼があれば修正版を再提示します。一括制作を依頼しても、この3回のレビューは省略しません。
使用者本人が特定工程の省略・直接編集を明示した場合は、その指定を優先し、対象工程と基準版を記録します。固定入力による架空作例・部品の内部試験は新しい研究発表のレビューと区別し、架空の了承を記録しません。
各工程の成果物を確認しながら進められます。「企画書だけ」「構成から再開」「既存PPTXの改訂」にも使えます。作成者の過去チャットや研究リポジトリは必要ありません。
新規の企画書・アウトライン・スライド構成・制作記録・検証記録・発表メモは、Markdown（.md）で生成します。Org用の環境は不要です。既存のOrg・TXT等の資料や手修正は保持し、使用者の指定なく変換や二重管理をしません。PPTX・画像・機械用JSON等は、それぞれの用途に合う形式を使います。
導入では前提と研究の便益をつなぎ、先行研究から今回の問いへ進めます。システムの原図を見せてから比較する、大きな問いで区切る、章内の提案をまとめるなど、聴衆の理解に必要な配置を選びます。既存資料への追加はイラストのタッチを合わせ、PPTXと発表原稿の手修正を保持します。
目次とページ番号は必須です。短時間発表でも目次を残し、表紙からデッキ末尾まで全スライドに1始まりの連番を表示します。
スライド全体に写真1つ以上を、本編に研究全体の概要図・アーキテクチャ図を1つ以上、必須とします。 全体図では主要な要素・役割・関係や流れ・対象範囲を示します。写真と全体図は同じページに置いてもよく、単独の人物イラストだけでは全体図の条件を満たしません。また、表だけでなくグラフを入れることを推奨します。 グラフは適したデータがある場合に検討し、数値や結果を創作しません。素材の要件と確認方法
写真は研究対象・背景・利用場面などを伝える撮影写真を使い、スクリーンショット・ロゴ・配置枠・生成した写実画像は写真として数えません。実機のない研究では背景や対象の写真を選べます。新規の全体図は文字・図形・接続線を編集可能なPPTX要素で作り、実施済みと計画を区別します。必要な素材が不足している場合は具体的に案内し、未充足のまま完成扱いしません。
画像・イラストは、本文の内容スライド10枚あたり合計12〜16点程度を、本文の7〜8割のページへ配置することを標準とします。写真・UIスクリーンショット・出典図版・概念イラストを含み、そのうちイラストは6〜8点程度を約半数のページへ配置します。表紙・目次・章扉・まとめ・サマリ・補足を除く本文枚数から計画し、背景・概念・利用場面・方法などの説明に使います。独立した説明単位を1点と数え、再掲・図の部品・ロゴ・QRコード・装飾・表・グラフ・箱と矢印だけの模式図は加算しません。イラストの内訳を合計へ二重加算しません。
減らすのは利用者から指定があった場合です。 指定がなければ標準量で進め、短時間・余白・生成の手間を理由に制作側だけで減らしません。構成には合計・内訳・各点の役割・掲載ページ・画像のある本文ページの割合を記録し、減量時は利用者の指示も残します。収まりが悪い場合は先に文や配置を直し、点数合わせの装飾を増やさず、画像と文字の可読性を保ちます。
「写真は残してイラストを減らす」のように対象を指定した場合は、その範囲で減らし、合計や掲載割合を戻すために別種の画像で穴埋めしません。標準量でよいかを毎回確認することや、減量のための追加承認工程は設けません。素材・制作機能が不足する場合は不足内容と未充足の点数を具体的に示し、黙って減らしたり完成扱いしたりしません。
完成イメージは、表紙からデッキ末尾まで全ページを順番に並べた1枚の一覧画像として提示します。この画像をレビューしてからPPTX制作へ進みます。
短い研究発表型には、装置の概念素材・UI・合成値を扱う10枚と、装置・UI・定量結果を使わない研究計画7枚を用意しています。題目・著者・連絡先・データは架空で、実研究へ転用しません。再生成には各 input.json と同梱素材、共通生成器を使います。
| 作例 | 説明方法 | 成果物・入力・検証 |
|---|---|---|
| 短い変化を残す記録方法 | 問い、比較表、概念画像、UI、分岐、合成チャート、計画 | PPTX · 一覧 · 入力 · 検証記録 |
| 地域アーカイブの未記録を調べる計画 | 概念の区別、質的調査の計画、同意の考え方。実測結果なし | PPTX · 一覧 · 入力 · 検証記録 |
作例の表示・内容・再生成の実施範囲は各検証記録を参照してください。PowerPoint本体の操作・動画再生は、静止レンダーやネイティブ要素の検査とは別です。再生成手順
既存の作例は固定入力による教材で、撮影写真を含まないものや配置枠だけのものがあります。写真と研究全体の概要図の必須条件や、画像・イラストの標準量を満たす完成デッキの見本としては扱いません。実際の制作では今回の素材でこの条件を満たします。
各作例の research-source.org は、固定JSONの研究内容を照合して整理した教材資料です。既存資料との互換性のため元形式で保持しており、新規ドキュメントの標準形式ではありません。OrgからJSONへの自動変換・同期や、研究資料だけから独立して構成を作った試験は実施済みとしていません。
同梱の9枚は、架空研究・合成データによるレイアウト見本です。表紙2種類と共通の本文デザインをまとめて確認できます。実際の発表では表紙をどちらか一方選びます。9枚という枚数は、発表の推奨枚数ではありません。
編集可能な見本PPTX · 発表メモ · 作例の説明と検証範囲 · 企画から図までの通し作例
作例を1枚ずつ見る（全9枚）
題目帯、所属・発表者帯、研究対象の写真を組み合わせる表紙です。見本の写真部分は配置枠です。
全画面の背景に白文字を重ねる表紙です。見本は静止レイアウトで、背景動画は同梱していません。
4章と各章の画像を対応させます。見本の画像部分は配置枠です。
上部の色帯に章番号と章名を置き、その下に案内文を添えます。
上部に話題とメッセージ、下部に主図を配置します。PPTXでは点・接続線・文字を個別に編集できます。
軸・単位・系列と短い正確な主張を示す散布図です。詳しい条件は同梱の発表メモに記録しています。PPTXには編集可能なチャートとデータを収録しています。
条件ごとの値を、単位を付けた表で比較します。PPTXでは表のセルを編集できます。
目次と同じ章名・順序で、各章の要点を振り返ります。
発表の概要、著者・所属、連絡先をまとめる最後のページです。教材の連絡先は架空例として明示しています。
実際の成果物は利用者の研究プロジェクトへ保存します。このリポジトリには、再利用するスキル・素材・ひな形と、明示した架空作例を収録しています。
ベースカラーはすべて白 #FFFFFF。同じレイアウトで、メイン色と独立したアクセント色の使い分けを比較できます。各画像は編集可能な配色見本PPTXの表示確認用レンダーです。
| 配色 | メイン | アクセント |
|---|---|---|
| アイリス | #8064A2 |
#543477 |
| kiMera | #FACADF |
#A61C60 |
| オレンジ | #F79646 |
#B45F06 |
| シチリア | #4BACC6 |
#165F73 |
| ボタニカ | #9BBB59 |
#38761D |
| ボルドー | #C0504D |
#8B2523 |
色の用途・文字色・指定方法はスタイル仕様、再生成は配色見本の説明を参照してください。
以下は初めて使うメンバー向けの手順です。スキルの取得 → ツールの導入 → 動作確認 → 自分の研究で制作の順に進めます。PPTX生成には公開パッケージを使い、Codex専用の制作ライブラリを必要としません。利用するAIサービスの契約・ログインは別途必要です。
既に使えるものは再インストールしません。所属先でNix等を使っている場合は、その管理方法でも構いません。
| ツール | 用途 | 導入方法 |
|---|---|---|
| Git | スキルの取得・更新 | 公式導入ページでOSを選ぶ |
| Node.js | 編集可能なPPTXの生成 | 公式ダウンロードから、20以上のサポート中LTSを入れる。npmも使用する |
| uv | Pythonと検査・描画用ライブラリの管理 | 公式導入手順を使う。Pythonは後の uv sync で用意できる |
uvの公式インストーラーを使う例です。
macOS・Linux：
curl -LsSf https://astral.sh/uv/install.sh | shWindows PowerShell：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"インストール後はターミナルを開き直し、次を確認します。
git --version
node --version
npm --version
uv --versionmacOS・Linuxのターミナルで実行します。既存の同名フォルダがある場合は更新についてを先に確認してください。
mkdir -p "$HOME/.agents/skills"
git clone https://github.com/cpslab/skill-create-slides.git \
"$HOME/.agents/skills/research-presentation-slides"
cd "$HOME/.agents/skills/research-presentation-slides"Windows PowerShellでは次を使います。
New-Item -ItemType Directory -Force "$HOME/.agents/skills" | Out-Null
git clone https://github.com/cpslab/skill-create-slides.git "$HOME/.agents/skills/research-presentation-slides"
Set-Location "$HOME/.agents/skills/research-presentation-slides"Gitを使わない場合はGitHubの Code → Download ZIP から取得し、フォルダ名を research-presentation-slides にして同じ場所へ置きます。SKILL.md だけでなく、assets/・references/・scripts/・依存定義とlockファイルを含むフォルダ全体が必要です。この手順は 1.7.4の内容を取得した場合を対象とします。取得した SKILL.md が旧版なら、配布担当者が指定したリリース・ブランチを確認してください。
| 利用環境 | 導入・ログイン | スキルの呼び出し |
|---|---|---|
| Codex | 公式案内に従ってCodexを用意する。上記 .agents/skills を認識する |
$research-presentation-slides |
| OpenCode | 公式導入手順で使用する版を導入し、プロバイダーへ接続する。上記 .agents/skills を認識する |
research-presentation-slides スキルを読み込んでください |
| Claude Code | 公式導入手順で導入し、claude を起動してログインする。下記のリンクを追加する |
/research-presentation-slides |
OpenCode・Claude Codeをまだ導入していない場合
OpenCodeの公式手順にあるnpm版を使う例（OpenCode 1）：
npm install -g opencode-ai
opencode起動後に /connect で利用するプロバイダーへ接続します。OpenCode 2を使う場合は V2の導入案内 を使ってください。両版は既定で同じ opencode コマンドを使用するので、既に導入してある版を確認してから選びます。
Claude Codeの公式インストーラーを使う例（macOS・Linux）：
curl -fsSL https://claude.ai/install.sh | bash
claudeWindows PowerShell：
irm https://claude.ai/install.ps1 | iex
claude初回起動時の案内に従ってログインします。Not logged in と表示された場合は、Claude Code内の /login を実行します。インストーラーや対応OSの最新条件は表の公式ページを参照してください。
OpenCodeは .agents/skills と .claude/skills の両方を探索します。Claude Codeは個人用スキルを .claude/skills から読み、スキルフォルダへのシンボリックリンクも扱えます。OpenCodeのスキル仕様・Claude Codeのスキル仕様
Claude Codeを使う人は、同じスキル本体を参照するリンクを1回だけ作ります。既存の同名スキルへ上書きしません。
macOS・Linux：
mkdir -p "$HOME/.claude/skills"
ln -s "$HOME/.agents/skills/research-presentation-slides" \
"$HOME/.claude/skills/research-presentation-slides"Windows PowerShell（同じPC内のフォルダへジャンクションを作成）：
New-Item -ItemType Directory -Force "$HOME/.claude/skills" | Out-Null
New-Item -ItemType Junction -Path "$HOME/.claude/skills/research-presentation-slides" -Target "$HOME/.agents/skills/research-presentation-slides"Claude Codeだけを使う場合は、手順2のクローン先を最初から .claude/skills/research-presentation-slides にしても構いません。その場合、以後のコマンドのスキルの場所も読み替えます。登録後に新しいセッションを開き、スキルの読込み元と版を確認してください。同名の古いコピーを複数の探索先へ残さないようにします。
スキルのフォルダで実行します。以下はmacOS・Linux・Windowsで共通です。
npm ci
uv sync --frozen --python 3.12package-lock.json に従いPptxGenJS・sharpを、uv.lock に従いPyMuPDF・Pillowを導入します。利用者が使っているni等から同等のlock付き導入を行っても構いません。node_modules/ と .venv/ は各PCで作る実行環境で、他のPCへコピーする配布物には含めません。
続いて、PPTXをPDFへ書き出す LibreOffice と、日本語表示用の Noto Sans JP を入れます。
| OS | LibreOffice | Noto Sans JP |
|---|---|---|
| macOS | 公式ダウンロードでIntel／Apple Siliconを確認して選ぶ。DMGを開き、Applicationsへ移動する | Google Fontsから取得し、展開したフォントをFont Bookでインストールする |
| Windows | 同じ公式ページでOS・CPUに合うインストーラーを選び、画面の案内に従う | ダウンロードしたフォントを右クリックしてインストールする |
| Linux | ディストリビューションのパッケージ管理でLibreOfficeのImpressを含めて導入する | ダウンロードしたフォントをユーザーのフォントフォルダ等へ入れ、利用環境のフォントキャッシュを更新する |
LibreOfficeのOS別手順は公式インストール案内も参照してください。WindowsのWSLを使う場合は、Node・Python・LibreOffice・フォントもWSL内へ揃えます。Windows側だけへ入れたアプリがLinuxのコマンドとして使えるとは仮定しません。
macOSのPowerPointを既に利用している場合は、LibreOfficeの代わりに --renderer powerpoint を指定する経路もあります。後続の doctor.py と render_portable.py の両方へ指定してください。doctorで省略するとLibreOfficeを検査します。発表先がPowerPointなら、LibreOfficeでの静止表示確認に加えて発表先アプリで開き、動画・編集・スライドショーの動作を確認します。
次はスキルのフォルダから実行します。記録は研究用フォルダへ保存し、パスは自分の保存先へ変更してください。
uv run --frozen python scripts/doctor.py --backend portable --strict \
--report /path/to/my-research/presentation/environment.jsonWindowsでも同じオプションを使えます。コマンドを1行で入力し、保存先を "C:/Users/自分の名前/Documents/my-research/presentation/environment.json" 等へ変更します。LibreOfficeを通常と異なる場所へ入れた場合は、環境変数 SOFFICE に実行ファイルの場所を設定できます。詳細な生成・描画コマンド
doctorは生成・描画の依存確認です。画像生成と画像閲覧は、選んだモデルと接続済みツールで実際に利用できるか別に確認します。 モデル名や契約名だけで利用可能と判断しません。画像生成サービスは固定せず、エージェントが利用できる機能を選びます。生成が必要な画像の用途・参照素材・寸法・品質・実物との違いを渡し、出力画像を確認します。追加サービスの契約・料金や外部送信が必要な場合は、その機能の利用条件を確認します。
画像生成や画像閲覧が利用できない場合は不足を明示し、対応モデル・ツールを用意して再開します。必要な画像を作れない状態を、完成イメージのレビュー済みや全ページ確認済みとして扱いません。
スキルのフォルダで実行します。以下はMac/Linuxの例です。SLIDE_TRIAL_DIR はスキルとは別の、新しい作業フォルダにしてください。WindowsではPowerShellの $SlideTrialDir に同じ用途のパスを設定して各コマンドを1行で実行できます。
SLIDE_TRIAL_DIR="$HOME/Documents/slide-skill-trial"
uv run --frozen node scripts/build_deck.mjs --backend portable \
--input assets/plan-reference/input.json --work-dir "$SLIDE_TRIAL_DIR" \
--output "$SLIDE_TRIAL_DIR/output/plan-v1.pptx"
uv run --frozen python scripts/render_portable.py \
--input "$SLIDE_TRIAL_DIR/output/plan-v1.pptx" \
--output-dir "$SLIDE_TRIAL_DIR/render-v1" --renderer libreoffice
uv run --frozen python scripts/check_pptx.py "$SLIDE_TRIAL_DIR/output/plan-v1.pptx" \
--expect-slides 7 --report "$SLIDE_TRIAL_DIR/structure-v1.json"
uv run --frozen python scripts/check_layout.py "$SLIDE_TRIAL_DIR/output/plan-v1.pptx" \
--profile assets/profiles/cps-workshop.json --deck-spec assets/plan-reference/input.json \
--report "$SLIDE_TRIAL_DIR/layout-v1.json"これは固定入力の内部試験で、利用者レビューや新規画像生成は行いません。既存の出力は上書きしないため、再試行では plan-v2.pptx・render-v2 など新しい名前を使います。PPTX・発表メモ・配置対応表、全ページPNG・一覧・hash付き描画記録が作成されます。PNGを1枚ずつ開いて表示を確認してください。配置検査の終了値2は要確認事項が残る状態です。個別確認と最終品質判定まで行って、初めて検証済みと記録します。
研究資料があるフォルダを利用するエージェントで開きます。OpenCodeならそのフォルダで opencode、Claude Codeなら claude を起動します。開始時のワーキングディレクトリを基点に、エージェントが直下と既存のサブディレクトリから関連する論文・研究計画・結果・素材を確認します。sources/ や assets/ を作ったり、資料を移動・改名したりする準備は不要です。特定のファイルや範囲だけを使いたい場合は、その指定を優先します。
スキルの導入先と研究資料の作業先は別です。同梱の assets/ はロゴ・ひな型・架空作例等の配布物で、利用者の入力フォルダ名を指定するものではありません。次は全クライアントで使える依頼例です。Codexでは先頭を $research-presentation-slides、Claude Codeでは /research-presentation-slides にしても構いません。
research-presentation-slides スキルを読み込んでください。
読込み元・バージョンと、PPTX生成・描画・画像生成・画像閲覧の機能を確認してください。
このワーキングディレクトリにある資料を、既存のサブディレクトリも含めて確認し、
今回の研究に関連する資料・素材を元の配置のまま入力に使ってください。
学会の10分発表を制作してください。質疑は別に5分です。
聴衆は情報工学系の学生・研究者、言語は日本語です。
発表者・所属：［氏名・所属］
掲載する連絡先：［メール・URL、または掲載しない］
保存先：presentation/my-talk/
短い研究発表型（cps-workshop）、表紙タイプA、フッター横線なし。
未実施の内容は計画として扱い、必要な枚数を提案してください。
説明に合う撮影写真と、本編の研究全体の概要図を含めてください。
画像・イラストは標準量を使い、減らす場合はこちらから指定します。
本文枚数に応じた点数・内訳・掲載ページを構成へ記録し、
適したデータがある場合はグラフも検討してください。
編集可能なPPTXと必要な発表メモを制作し、全ページを描画して確認してください。
まずスタイルと企画書を提示し、各レビューで私の確認を待ってください。
表紙タイプBにしたい場合は「表紙は表紙タイプB。背景動画は○○」と指定します。表紙が未指定なら2択で確認します。本文は表紙選択から独立しています。cps-midterm は画像付き2×2目次・4章・上部型章扉・縦4行まとめ、cps-workshop は研究に合う章数・縦目次・章扉の採否・本編末尾のサマリを選びます。装置・UI・定量結果がない研究も計画や概念に合う型で制作します。
開始時には制作の流れと、次にレビューしてほしい成果物を案内します。成果物を提示するときも、見るべき点と回答方法を伝えます。修正点を返すか、問題なければ「この案で次へ」と返してください。
分かる情報だけで始められます。エージェントが資料から入力票を整理し、次の判断に必要な不足を確認します。既存のスタイルを使う場合は、その資料も渡してください。
文体の参考資料は任意です。「このPPTXは文体だけ参考にして。見た目はCPS標準のまま」「タイトルは普通の話題名を中心に、本文は常体で」のように指定できます。今回の希望・修正を優先し、参考資料は研究内容・見た目・文体の用途を分けて使います。
参照可能な本人の文体メモリがあれば必要な関連箇所だけを確認し、使えない場合も今回の指示と文章から進めます。採用する文体は style.md に短く記録し、通常の企画書・アウトライン等のレビューで調整します。メモリの設定変更・書込みや、文体だけの追加承認工程は行いません。文体の詳しい手順
途中から再開する場合の例：
$research-presentation-slides
企画書とスタイルは確認済みです。添付した制作記録を読んで、
今日はアウトラインとスライド構成まで進めて。
後ろの工程ほど、より推論能力の高いモデルを使うことを勧めます。草案では速度、アウトライン以降は推論能力を重視し、PPTX制作・最終検証では利用可能な範囲で最も強い推論モデルを推奨します。工程の切り替わりに案内しますが、変更は任意です。画像生成は、選択したモデルと接続済みツールの実際の能力から方法を決めます。
完成イメージとPPTXの作成前には、スタイルの参考にしたいスライドを任意で提示できます。CPS LABの基本を残し、文字の組み方・配色・図の大きさなどを参考へ寄せます。参考なしでも進められます。PPTX制作前に見た目を変更する場合は、完成イメージを更新して再レビューします。
既存資料の改訂などで、特定工程を省略して直接編集するよう明示した場合は、その指定を優先します。省略したレビューと、実施した内容・表示・手修正保持の検証は分けて記録します。
各配色はベース・メイン・独立したアクセントの3色を必ず定義します。ボタニカは白／#9BBB59／#38761D。他の5配色も対応表に濃い同系色のアクセントを定義しています。
下端のメインカラーの横線は、スタイル設定時にあり／なしを選べます。線なしでもロゴとページ番号は残ります。元から線を置かない章扉・表紙タイプBはそのままです。
表紙以外の全ページには左上に小さな章タイトル、右上に短縮発表タイトルを表示します。目次・まとめ・補足・サマリでは、章タイトルの代わりにページ種別を表示します。引用箇所に [1]・[1-4] 等を付け、同じページ下部に参考文献を載せます。概要・著者・所属・表示を指定した連絡先のサマリは、中間発表型では補足後、短い研究発表型では本編末尾を既定とします。補足後の再掲や連絡先の省略は別に選べます。
公開ツール経路では、Node.js 20以上・Python 3.10以上・lock付き依存・LibreOffice・Noto Sans JPを使用します。画像を読み取れるモデルまたは確認手段と、今回必要な画像を生成・編集できる機能も準備します。スキルの配置だけでは、ツール・権限・契約・フォントは追加されません。導入方法は上の導入、能力の確認範囲は導入と実行条件を参照してください。
Codexの Presentations・@oai/artifact-tool が利用可能な環境では、従来の --backend codex も選べます。OpenCode・Claude Codeにこれらの非公開ランタイムがあるとは仮定しません。通常は --backend portable を使います。
研究内容は各メンバーの資料に基づき、根拠・論理・可読性・編集可能性を同じ完成基準で確認します。生成文章や画像の完全一致を要求するものではありません。
| 資料 | 用途 |
|---|---|
| スキル本体 | 6工程と対話・再開の手順 |
| CPSスタイル | 2つのプロファイル、色、余白、文字階層、ロゴ配置 |
| 文体と日本語 | 本人のメモリ・参考文章の参照、タイトルと本文の書き方、意味を保つ確認 |
| レイアウト選択 | 問い・写真・表・UI・結果・分岐などの用途と選び方 |
| 再生成と検査 | 入力と共通部品、環境確認、生成・検査の実行方法 |
| 1.7.1の互換性検証 | 修復なしのPowerPoint開封、限定修復、対象を絞ったOOXML検査の実施範囲 |
| 1.6.0の公開ツール検証 | 3作例28枚、クライアント別の実施範囲と未検証事項 |
| 通し作例 | 根拠から企画書、メッセージ、図へ変換する具体例 |
| 編集可能な見本PPTX | 表紙2種類、目次、章扉、模式図、定量図、表、まとめ、最終サマリの9種類 |
| 視覚作例の説明 | 比較ポイント、検証範囲、再生成方法 |
| 検証記録のひな形 | 確認結果と未検証事項の記録 |
見本の研究・データは架空です。実際の研究結果として使用しないでください。見本の表紙・目次には未提供素材の配置枠があり、表紙タイプBの実動画は同梱していません。9枚の見本PPTXは構造検査に加え、1.5.0の検証記録でPowerPoint 16.111のPDF書出しとPoppler Cairoによる全ページ個別目視を記録しています。この9枚の編集・再保存と動画再生は未検証です。7枚の計画作例では、別の試験用コピーによる文字・表の編集、保存、再オープンも記録しています。各検証は記録したファイルと操作の範囲に限り、別環境での表示や全要素の編集を保証しません。
研究の根拠は利用者の資料、編集する構成の正本は slide-structure.md とし、承認済みの版と照合したJSONを生成入力にします。MarkdownとJSONは自動同期されません。修正は構成正本・生成入力・共通部品・コードへ戻し、再生成で維持します。コマンド、依存関係、出力の対応は 再生成と検査 を参照してください。
uv run --frozen python scripts/init_presentation.py --project-dir /path/to/presentation --title '研究発表'
uv run --frozen python scripts/doctor.py --backend portable --strict --report /path/to/presentation/environment.json
uv run --frozen python scripts/check_pptx.py assets/visual-reference/cps-layout-reference.pptx --expect-slides 9init_presentation.py は workflow.md だけを初期化します。既存の workflow.md または workflow.org がある場合は上書きや二重作成をせず、終了値2で作成を止めます。その既存の制作記録をエージェントが引き継いで使います。
PPTX生成は uv run --frozen node scripts/build_deck.mjs --backend portable --input INPUT.json --work-dir WORK --output WORK/output/deck-v1.pptx を使います。最終PPTXは作業先配下の独立した出力ディレクトリへ保存し、既存PPTXへの上書きを拒否します。候補・検証記録は .build/ へ分離し、成功時は最終PPTXと同じ場所へ .layout.json と -発表メモ.md も出力します。既存の同名TXTメモを引き継ぐ場合は形式を保ち、Markdownとの二重作成を避けます。
公開ツール経路の render_portable.py はLibreOfficeまたはmacOSのPowerPointからPDFを書き出し、PyMuPDFで全ページを描画します。Codex用の render_deck.mjs は既定の artifact-tool に加え、macOSのPowerPointとPopplerを使う --renderer powerpoint、対象アプリが書き出したPDFを使う --renderer pdf に対応します。全ページPNG・一覧・hash付き描画記録を出力します。PDF経路は書出し元PPTXのhashと実際の書出しログを別途照合します。画像の一覧化だけでは個別目視を合格にしません。
公開バックエンドの共通チャート部品は棒・折れ線、直接埋め込む画像はPNG・JPEGに対応します。散布図、系列ごとのマーカー・線種、SVG等の未対応指定はエラーになります。同梱の9枚教材にある散布図まで、この公開生成器でそのまま再生成できるという意味ではありません。対応範囲を確認してください。
表紙タイプBは提供された静止ポスターを必須とし、MP4があれば自動開始・ループ・消音の設定付きで埋め込めます。埋込検査と対象アプリでの再生確認を分け、実際に操作していない再生・停止等は未検証として残します。
Pythonの検査コードは標準ライブラリを基本とします。PPTX生成・レンダーのNode依存とフォントは別途必要です。構造検査、配置検査、全ページ個別目視、意味・編集可能性・対象アプリ動作を区別します。終了値0だけで完成とせず、Q1〜Q11を個別に判定します。固定入力の開発内部試験では利用者レビューを捏造しません。
最終検証には外部メモとの照合も含めます。次の INPUT.json は実際の生成入力へ、PPTXと各レポートは同じ版のファイルへ置き換えてください。
uv run --frozen python scripts/check_memo.py WORK/output/deck-v1.pptx \
--deck-spec INPUT.json --report WORK/memo-check-v1.json
uv run --frozen python scripts/quality_gate.py WORK/output/deck-v1.pptx \
--layout-report WORK/layout-v1.json --deck-spec INPUT.json \
--memo-report WORK/memo-check-v1.json --visual-review WORK/visual-review-v1.json \
--report WORK/quality-v1.jsonメモ検査の終了値0は文字・番号等の機械照合の結果です。意味や手修正の確認事項は別途レビューし、現行のメモ・入力のhashに対応する記録を残します。品質ゲートはメモ検査結果や生成入力がなければ未検証とします。詳しくは個別目視と最終判定を参照してください。
既存PPTXで今回対象とした互換性問題がある場合は、uv run --frozen python scripts/repair_pptx_compat.py --input ORIGINAL.pptx --output NEW.pptx --report REPAIR.json で原本とは別の新規ファイルへ限定修復できます。本文・図形・ノート・画像・グラフ値を作り直す処理ではありません。修正版はメモ対応・表示・対象アプリでの開封を再確認し、旧版の検査hashは流用しません。対象と実行手順
Gitで導入し、ローカルでファイルを変更していない場合は、導入先で git pull --ff-only を実行します。独自の変更がある場合は、差分を保存してから更新内容を統合してください。更新後はスキルのフォルダで npm ci と uv sync --frozen --python 3.12 を再実行し、lockファイルに合わせて依存も更新します。新しいセッションで読込み元と版を確認し、doctorで実行環境を再確認してください。
同名の旧スキルが .codex/skills/ などにある場合は、必要な旧版を検索対象外へ保存し、使用する版を1つにします。既存ファイルを無条件で上書きしないでください。
主張を補足・限定して説明したい箇所は、スライド上の細かな注意書きを増やさず、出力PPTXと同じディレクトリの 発表資料-発表メモ.md に記録します。ページ番号・スライドIDごとに、発表時に口頭で伝える補足、適用範囲・条件・未確認事項、根拠をまとめます。必要な箇所があればメモも納品され、PPTXの修正・並べ替えに合わせて更新します。メモひな形を使えます。
メモ入力の notes は従来の文字列に加え、text（口頭補足）、evidence（詳細根拠の文字列配列）、preparation（制作事項の文字列配列）へ任意に分けられます。口頭補足と詳細根拠はPPTX内ノートと外部メモへ、制作事項は作業先の .build/ 内へ出力します。
再生成では利用者の追記を保持します。生成範囲の手修正や、旧版の生成範囲に検証用hashがない場合は自動上書きを止め、候補メモの保存先を案内します。現物と候補を照合して引き継いでください。入力と保持の仕様
まず主張や図ラベルを根拠に合う短い表現へ直します。対象・分母・単位・比較条件・実測／例示／計画など、省くと結論の理解が変わる情報は読める形で画面にも残します。詳しい方法・補足・限定はメモへ送ります。長い発表原稿・想定質問集とは別の、発表者が該当ページを話すときに参照するメモです。
現在のスキル版は 1.7.4 です。package-manifest.jsonにはスキルの配布ファイルとSHA-256、見本の検証範囲を記録しています。README・AGENTS・検査コードも一覧に含め、Git設定・キャッシュ・manifest自身はhash一覧の対象外です。配布検査は scripts/check_package.py で実行できます。
1.7.1の互換性検証は新規に再生成した別ファイルを対象とし、同梱の旧PPTX・PNGは差し替えていません。新しい検証結果を旧ファイルの合格記録へ流用しないでください。
PNG・PPTXは、メンバーが制作環境なしでも見本を確認できるよう同梱しています。合成入力は example-source.org、生成コードは build.mjs、再生成手順は視覚作例の説明にあります。フォントや制作エンジンは同梱していません。