コンテンツ制作 · freestylefly/canghe-skills

canghe-slide-deck

コンテンツからプロフェッショナルなスライドデッキ画像を生成します。スタイル指示を含むアウトラインを作成し、個々のスライド画像を生成します。ユーザーが「スライドを作成して」「プレゼン資料を作って」「デッキを生成して」「slide deck」「PPT」と依頼した際に使用します。

L4 高権限 · 段階的認可と監査V1 コミット固定コマンド実行ネットワーク通信ファイル書き込みDual-pass Audit
Author freestyleflyGitHub freestylefly/canghe-skills ↗License MIT(仓库根 LICENSE)Commit dd0bf35595
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

段階的なパイプライン構成:コンテンツ分析 →(必須)確認 → アウトライン生成 → プロンプト生成 → 画像生成 → PPTX/PDF 結合。各段階の成果物はすべてディスクに保存され、--outline-only / --prompts-only / --images-only による中断・再開に対応します。

skills/canghe-slide-deck/SKILL.md
Input → Preferences → Analyze → [Check Existing?] → Confirm (1-2 rounds) → Outline → [Review Outline?] → Prompts → [Review Prompts?] → Images → Merge → Complete
ここでの処理内容:9ステップのチェックリストを1つのフローとして繋ぎ、ステージ間の隠蔽された状態を持たず、ディスク上のファイル(outline.md / prompts / PNG / pptx / pdf)のみで連携します。

スタイルシステム = 16のプリセット × 4つの次元(texture / mood / typography / density)の自由な組み合わせ。各プリセットは次元の値セットに対応づけられています。

skills/canghe-slide-deck/SKILL.md
| `blueprint` (Default) | grid + cool + technical + balanced | Architecture, system design |
ここでの処理内容:まずプリセット一覧(デフォルトは blueprint)を提供し、カスタムスタイル向けに組み合わせ可能な値の空間を次元定義ファイルで記述します。

コンテンツシグナルがキーワードリストにヒットした場合は自動でスタイルを選定し、マッチしない場合は blueprint にフォールバックします。

skills/canghe-slide-deck/SKILL.md
| tutorial, learn, education, guide, beginner | `sketch-notes` |
ここでの処理内容:「チュートリアル系コンテンツ → sketch-notes」のようなヒューリスティクスを表として整理し、ユーザーの選択負担を軽減します。

分量に応じた推奨ページ数:1,000語未満は5〜10枚 … 5,000語超は20〜30枚(分割を推奨)。

skills/canghe-slide-deck/SKILL.md
| > 5000 words | 20-30 (consider splitting) |
ここでの処理内容:コンテンツ長から目標ページ数を導くヒューリスティクス表であり、確認フェーズでのデフォルト推奨値として機能します。

Step 2 は厳格なゲート:スタイル、対象読者、ページ数、アウトラインレビュー、プロンプトレビューの5つの確認項目はいずれもスキップ不可です。

skills/canghe-slide-deck/SKILL.md
**Step 2 confirmation required** - do not skip (style, audience, slides, outline review, prompt review)
ここでの処理内容:Notes にて確認がスキップできない旨を再強調し、ワークフロー上の必須チェックポイントとして機能させます。

設定は EXTEND.md から読み込み、プロジェクトレベル、次いでユーザーレベル($HOME)の順で探索します。

skills/canghe-slide-deck/SKILL.md
# Check project-level first
ここでの処理内容:Bash の test -f で EXTEND.md を検出し、存在すれば読み込んで設定概要を出力、なければ初回セットアップまたはデフォルト値を適用します。

成果物のディレクトリ構造は固定:ソースファイル、outline.md、prompts/、NN-slide-*.png、pptx、pdf。

skills/canghe-slide-deck/SKILL.md
slide-deck/{topic-slug}/
ここでの処理内容:slide-deck/<topic-slug>/ 配下のファイル配置を標準化し、中断再開や共有を容易にします。

結合処理は2つのローカルスクリプトが担当:npx -y bun で merge-to-pptx.ts / merge-to-pdf.ts を呼び出します。

skills/canghe-slide-deck/SKILL.md
npx -y bun ${SKILL_DIR}/scripts/merge-to-pptx.ts <slide-deck-dir>
ここでの処理内容:画像ページを PPTX/PDF にまとめる実行可能コードはこの2つのスクリプトのみであり、純粋なローカルライブラリ呼び出しです。

画像生成はこのリポジトリ内では実装せず、エージェントが「利用可能な画像生成 skill を選択」し、同一セッション ID で順次生成させます。

skills/canghe-slide-deck/SKILL.md
1. Select available image generation skill
ここでの処理内容:skill 間での画像生成委譲。ユーザーコンテンツから組み立てられたプロンプトは、実行時に選定された画像生成サービスへ送信されます。

画像修正の規律:先にプロンプトファイルを修正してから、対象ページを指定して --regenerate を実行します。

skills/canghe-slide-deck/SKILL.md
**IMPORTANT**: When updating slides, ALWAYS update the prompt file (`prompts/NN-slide-{slug}.md`) FIRST before regenerating.
ここでの処理内容:変更の追跡可能性と再現性を担保し、生成済みビットマップ画像上への直接的な文字貼り付け修正を禁止します。

2コア機能

01コンテンツ/テーマからのスライドデッキ画像一式の生成(表紙・裏表紙を含む)
0216種類のプリセットスタイル(blueprint / chalkboard / corporate / … / watercolor)
034次元のカスタム組み合わせ(texture / mood / typography / density)
04コンテンツシグナルに基づくスタイルの自動選定
05分量に応じた推奨ページ数の提示
062往復の対話的確認(Round 1 は必須、Round 2 はカスタム次元指定時のみ)
07PPTX / PDF へのローカル結合
08指定ページの再生成および追加・削除・編集ワークフロー
09多言語出力(ユーザー設定 / コンテンツ言語に対応)

3外部依存関係

KindDependency / Endpoint
api运行时图像生成后端(由 agent 选择『可用的图像生成 skill』完成出图,用户内容/提示词由此出网)
clibun / npx -y bun(运行合并脚本)

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠(ファイルパスと抜粋)
  • scripts/: ローカルスクリプトまたはコマンドの実行: npx -y bun ${SKILL_DIR}/scripts/merge-to-pptx.ts <slide-deck-dir>(ローカルでの PPTX 結合)
  • 网络端点: 外部ネットワークアクセスの宣言: skill 本体のスクリプトはネットワーク呼び出しゼロ(2つの結合スクリプトはローカルファイル I/O とライブラリ呼び出しのみを実行)
  • 本地工作目录: ファイル読み書きおよびアーティファクト出力: slide-deck/{topic-slug}/source-{slug}.{ext} および analysis.md
監査ノート: 本 skill の中核目的は「ユーザーコンテンツをスライドデッキ画像に変換すること」であり、画像生成フェーズは実行時に選定された画像生成サービスに委託されます(Step 7「Select available image generation skill」)。すなわちユーザー素材やプロンプトが外部生成バックエンドへ送信されるため、プラットフォーム内の ai-image-generation やアップストリームの同種 baoyu-slide-deck の判定基準に準拠して「Orange」判定となります。スクリプト自体のフットプリントは極めて小さく、2つのローカル結合スクリプト(merge-to-pptx.ts / merge-to-pdf.ts)とローカルディスク書き込みのみで構成され、ネットワーク通信、認証情報取得、リバースエンジニアリング、なりすまし、セキュリティダウングレード、任意コード実行は含まれないため「Red」には引き上げられません。アップストリームの baoyu-slide-deck との差異:本フォークでは特定の生成バックエンド(Codex imagegen / Cursor GenerateImage 等の表記)を指定せずエンドポイントを実行時に決定しますが、「コンテンツが外部生成サービスへ送出される」という性質に変わりはありません。

5二重目の独立検証

  • [ok] 自身脚本无网络、无环境变量、无 spawn — skills/canghe-slide-deck/scripts/ 只有 merge-to-pdf.ts 与 merge-to-pptx.ts;bundle 风险扫描『網路請求:無命中』『憑證/環境變數』仅命中 ${SKILL_DIR} 与 $HOME 路径。
  • [ok] 出图是跨 skill 委派而非本仓实现 — Step 7『1. Select available image generation skill』;本仓无任何图像生成脚本或端点声明。档位按『把用户素材送外部生成后端』落 orange。
  • [ok] 确认门禁措辞与位置 — Notes 与 Step 2 均标注 ⚠️ REQUIRED;Notes 重复『Step 2 confirmation required - do not skip』。
  • [ok] 合并脚本行为 — 风险扫描『寫盤/產生檔案』命中 merge-to-pdf.ts 的 Bun.write 与 merge-to-pptx.ts 的 pptx.writeFile,均为本地输出。
  • [ok] 风格/维度数量与文件结构 — §1 清单列出 16 个 references/styles/*.md、5 个 references/dimensions/*.md(含 presets.md),与 SKILL.md 表格一致。
  • [ok] 未展开文件的处理 — bundle 只展开 12 个最相关文件;base-prompt.md、design-guidelines.md 等未展开,故未对其内容下结论,仅按 §1 清单列为内部资产。
  • [ok] 档位复核 — 自身脚本面绿蓝级,但核心用途将用户内容送入运行时图像生成服务 → 按站内『生成後端類』先例判 orange;无 red 触发项(无逆向/冒充/绕过/安全降级/任意代码执行)。
  • [ok] 元数据与 commit — skill.commit 与 audit.skill_commit = dd0bf355955b4c82b764740b4183c86a72ba0e0c;license=MIT(仓库根 LICENSE),installs=null。

6結論

  • 中断再開可能かつ再現性の高いワークフロー:生成ごとのプロンプトを prompts/NN-slide-*.md に保存し、指定ページは --regenerate で再生成可能。上書き前のバックアップルールも完備。
  • 充実したスタイルシステム:16プリセット + 4次元 + 自動選定キーワード表 + ページ数ヒューリスティクスを、必要に応じて読み込まれる小規模で特化したリファレンス群に集約。
  • ゲートと柔軟な出口の両立:デフォルトは必須確認(Step 2 の5項目)を課しつつ、--outline-only / --prompts-only / --images-only によるパイプラインの短縮実行にも対応。
  • 完全にローカルな結合処理:2つのスクリプトで画像を PPTX/PDF に結合。外部ネットワークや認証情報は不要で、成果物は自己完結しており即座に共有可能。
  • 最適な用途: 長文や特定テーマを統一されたスタイルで共有可能なスライド画像へ迅速に変換したいコンテンツクリエイターや、技術・ビジネスプレゼンターに最適:一貫したスタイルを求め、ローカルでのアーカイブとプロンプトの再現性を必要とし、画像生成サービスへの外部呼び出しを許容できるユースケース向け。
    不向きな用途: 素材の社外送信が禁止されている環境や厳格なデータコンプライアンスが求められる環境には不向き。編集可能なネイティブ PPT(本成果物は画像スライドのためテキスト編集不可)が必要な場合、厳密な組版や正確な文字配置が求められるフォーマルなビジネスプレゼン、および実行時に利用可能な画像生成 skill が存在しない環境には不向き。
    Install Agent-Ready
    ① Verified Mirror 2026-10-10
    Option A · Direct DownloadDownload canghe-slide-deck.tar.gz
    sha256: 5efda196172fff6e…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit dd0bf35595.