Repurpose Deck From Reference

参照 PPTX のテンプレ体裁（レイアウト・フッター・フォント・配色・章割りの作り）だけを残し、内容を 新トピックの一次情報 で書き直す skill。

When to Use

• "この Scout 紹介資料の体裁で GitHub Copilot app 資料を作って" のような依頼
• 既存テンプレ deck を別プロダクト / 別テーマ向けに作り変える
• 一次情報（公式 docs / repo / changelog）を集めて新内容を組み立て、実機スクショで強化したい
• セクション構成も新トピックに合わせて再設計してよい

Use a different skill if:

• 翻訳・content.json 抽出ベースで作りたい（対象外）
• テンプレートからゼロから作る（対象外）
• 設計・骨子だけ作りたい（対象外）

Workflow

COPY → RESEARCH → PLAN → WIPE → BUILD → SCREENSHOTS → QA → POLISH

Phase	目的	主な落とし穴
COPY	参照 deck を新ファイル名でコピー、編集対象を固定	参照を破壊しない
RESEARCH	一次情報を web_fetch で複数 ドキュメント / repo README / changelog を取得	スニペットだけで決めない、最新版を確認
PLAN	セクション構成と各スライド要旨を SQL todos か markdown で先に固める	参照のセクション数に縛られない
WIPE	各スライドの shape を整理。layout を「白紙」に揃え、layout 由来 p:bg を除去	hidden slide の扱いに注意
BUILD	スライドごとに add_shape / add_textbox で再構築。footer ロゴ・ページ番号を付与	負数 width/height で COM open 不能になる
SCREENSHOTS	実機の UI を PrintWindow でキャプチャ、PII を mask して挿入	個人 PJ 名・リポ名・ユーザー名を必ず黒塗り
QA	全スライド PNG 化して sub-agent で批評 させる、自分で見ずに済まさない	"looks fine" の自己評価は禁止
POLISH	QA 結果を 1 ファイルにまとめて一括反映、再 QA	カードに空白多すぎ / 色 system 揺れを必ず潰す

Core Rules

• One file, not multiple drafts. 参照を直接コピーして、その 1 ファイルを iterate する。古い draft は残さない。
• Lock-first. 編集前に対象 PPTX を開いている PowerPoint を確認し、未保存の変更がないことをユーザーに確認してから閉じる（確認なしに Stop-Process で強制終了しない）。OneDrive 同期完了を待つ。
• Layout reset. 参照のコンテンツスライドは原則「白紙」レイアウトに切替＋<p:bg> 除去。これをやらないと旧テンプレの装飾が透けて見える。
• No negative dimensions. Emu(w - X) で X > w の状況を作らない。max(min_h, h - margin) でクランプ。
• COM cache bypass. 直近編集ファイルを COM で開くと古いコンテンツが返る場合あり。毎回別ファイル名にコピーしてから Open。
• Primary source over memory. 仕様・対象プラン・価格は memory に頼らず必ず一次情報を web_fetch。例: GitHub Copilot app の対象プランは公式 README で "Pro / Pro+ / Max / Business / Enterprise" と最新化されている。
• Section list = raw XML. python-pptx は PowerPoint セクションをサポートしない。presentation.xml に p14:sectionLst を直接挿入する。& は必ず & にエスケープしないと COM 開けない。
• Layout consistency before content polish. 18 枚作って 6 セクション正しく入る、ページ番号通る、フッター揃う、を先に確認してからコンテンツ詳細を直す。

Hard Gotchas

• Negative dim corruption: add_textbox(..., h=h-650000) で h が 650000 未満になると、python-pptx は保存できるが PowerPoint COM Open が失敗する。GUI からは開ける。バイセクションでスライド単位の犯人探しが必要になる。
• COM Export cache: app.Presentations.Open(SAME_PATH) を連続で叩くと、PowerPoint 内部が古い CRC を持つ場合あり、Export 画像が更新後の中身を反映しない。新しいファイル名へ copy してから Open。
• OneDrive 同期と Office lock: OneDrive 配下 PPTX の編集中、FileCoAuth が PackageNotFoundError を起こすことがある。Stop-Process -Id <FileCoAuth_PID> で解放。
• Section XML escape: <p14:section name="D. Customize & Collaborate"> は & で XML 不正。& に escape。
• Hidden slide page numbering: show="0" のスライドをスキップしてページ番号を振ると、見えないスライド以降の番号が前にずれる。hidden を含めた絶対インデックス で振る方が一貫する。

Quick Start

詳細は references/ を参照。

1. ユーザー: "この Scout deck の体裁で GitHub Copilot app 資料作って"
2. COPY: 参照を新ファイル名でコピー
3. RESEARCH: web_fetch で公式 docs / repo README / changelog を取得
4. PLAN: SQL todos で section 構成 + 各 slide 要旨を確定
5. WIPE → 白紙レイアウト + bg 削除 + footer 維持
6. BUILD: スライドごとに rebuild_deck.py で再構築
7. SCREENSHOTS: PrintWindow キャプチャ → PII mask → 挿入
8. QA: sub-agent で全 PNG 批評 → 修正
9. POLISH: 色 system 統一、約物統一、余白統一

References

• references/workflow-detail.md — 各 phase のコマンド例
• references/screenshot-mask-pattern.md — PrintWindow + Gaussian blur + 説明 overlay
• references/com-and-xml-pitfalls.md — 既知の COM / XML 罠
• references/section-xml-template.md — p14:sectionLst 挿入のひな型

Done Criteria

• 参照 deck のコピー 1 ファイルを正として iterate できている
• セクション構成が新トピックに最適化されている（参照と同じである必要なし）
• 全本文が一次情報出典付き（Source: 行をスライド下部に明記）
• 実機スクショは PII マスク済み（個人 PJ 名・リポ・ユーザー名・チャット名）
• sub-agent による視覚 QA を 1 回以上回している
• 色は 5 色程度に絞られ、未定義色（赤・マゼンタ等の浮き）が無い
• COM Open テストが通っている（負数 dim / XML escape / cache を踏んでいない）