Slidecraft

Slidecraft は、ソース資料を洗練された編集可能なPowerPointプレゼンテーションに変換し、すでに使用しているエージェントアプリ内で完結させます。エージェントが作業を計画・誘導し、Slidecraft はプロジェクトファイル、ビジュアルリソース、画像生成、スライド理解、PowerPoint 構築を整理します。

現在のアルファ版は、Codex、Claude Code、GitHub Copilot、その他の MCP 互換エージェントアプリを通じたローカルプロジェクトに対応しています。リリースの進捗状況は Release readiness で追跡されています。

インストール

Python 3.10 以降と現在の Node.js LTS リリースをインストールし、ガイド付きインストーラーを実行してください。

macOS および Linux

curl -fsSL https://raw.githubusercontent.com/henryhyw/slidecraft/v0.1.0-alpha.1/install.py | python3 -

Windows PowerShell

irm https://raw.githubusercontent.com/henryhyw/slidecraft/v0.1.0-alpha.1/install.py | py -3 -

インストーラーは、分離されたランタイムを作成し、日常的なプレゼンテーション機能をインストールし、編集可能な PowerPoint コンストラクターを準備し、インストールを検証し、検出されたエージェントアプリを接続します。Slidecraft が更新された場合も、安全に再実行できます。

実行前の確認オプション、選択したエージェントのセットアップ、GitHub Copilot ワークスペースのセットアップ、インストール場所、トラブルシューティングについては、Installation を参照してください。

コントリビューターは、クローンしたチェックアウトから同じガイド付きフローでインストールできます。

git clone https://github.com/henryhyw/slidecraft.git
cd slidecraft
python3 install.py --source .

インストーラーは、完了時に正確なダッシュボードコマンドを表示します。その形式は次のとおりです。

/path/to/Slidecraft/app/bin/slidecraft console

ダッシュボードには、プロジェクト、スタイル設定、共有リソースコレクション、プロバイダー設定、ランタイムの健全性が表示されます。プロジェクトフォルダーとライブラリフォルダーは、オペレーティングシステムのファイルブラウザーで直接開くことができます。

Related MCP server: PPTX MCP Server

エージェント統合

Slidecraft は、プロセス内、CLI、MCP 経由で同じ機能を公開します。

slidecraft agent-capabilities
slidecraft-mcp

エージェントアプリが会話を管理します。Slidecraft は、プロジェクトの決定、ソース、進捗状況、成果物を記録するため、新しいセッションでも同じプロジェクトから続行できます。ダッシュボードは、これらのファイルと設定を1か所に表示します。

バンドルされている Agent スキルは、integrations/skills/slidecraft/SKILL.md にあります。完全なホスト契約は、Agent integration に文書化されています。

MCP サーバーは自己記述型であり、Codex、Claude Code、GitHub Copilot Chat、その他の MCP 対応ホストでローカル STDIO ツールサーバーとして動作します。ホスト固有のセットアップ例は、Agent quickstart にあります。

新しいセッションでは、プロジェクトに名前を付け、希望する内容を説明します。エージェントは保存された進捗状況を見つけ、作業を続行するか、要求されたプレゼンテーション成果物を返します。Agent quickstart を参照してください。

シェルベースの Agent ホストは、同じ名前優先のエントリポイントを直接使用できます。

slidecraft project resolve "Market Growth"
slidecraft project show "Market Growth"

プロジェクトとリソース

プロジェクトは、ユーザーが選択したディレクトリまたは Slidecraft の管理データディレクトリに置くことができます。

project/
  slidecraft.project.json
  sources/           user material and direct-use visual assets
  deliverables/      editable presentations, previews, and reports
  .slidecraft/       durable Agent evidence and resource assignments

ビジュアルインスピレーション、標準アイコン、再利用可能な編集可能コンポーネントは、共有ローカルコレクションに格納されています。チャットまたはダッシュボードで行われた選択はプロジェクトに添付されたままで、プロジェクトを再度開いたときに利用できます。

設定は、パッケージ化されたデフォルト、ユーザー設定、オプションのプロジェクトオーバーレイ、環境変数、明示的なランタイム引数に従います。次のコマンドを使用して、解決されたすべての値とそのソースを検査します。

slidecraft config path
slidecraft config show
slidecraft config validate
slidecraft config explain

Configuration、Guidance profiles、documentation map を参照してください。

パイプライン

エージェントはプレゼンテーションワークフローを推論し、これらの再利用可能な機能を構成します。

1. マルチモーダルなソース資料とハード制約を正規化します。

2. デッキのストーリーラインとスライド固有の意味的意図を計画します。

3. ビジュアルインスピレーション、標準アイコン、再利用可能なコンポーネントを検索し、コンテキスト内で有用なリソースを選択します。

4. 情報伝達スライド用の画像生成ブリーフを組み立てて実行します。

5. Agent の視覚的推論を使用して、意味のあるレンダリングされたエンティティと関係を、信頼できるソースコンテンツにマッピングします。

6. OpenCV を使用してテキスト、図形、レイアウトを測定し、不規則な塗りつぶし領域に有用な境界詳細が追加される場合は SAM 2 を使用します。

7. 再構築ルートと洗練の意図を作成し、編集可能な PowerPoint シーンをコンパイルします。

8. Agent が特定したタイポグラフィグループ、配置、アイコンスロット、コネクタートポロジに、決定的な有界正規化を適用します。

9. 編集可能なデッキをレンダリングし、再構築レポートを保持します。

システム契約は Framework pipeline に文書化されています。コネクターの推論は Connector contract に文書化されています。洗練の制約は Normalization contract に文書化されています。

リポジトリ構成

src/slidecraft/       installable Python package and dashboard
js/                   portable PowerPoint constructor
scripts/              installed worker and platform integration scripts
config/               versioned framework and design-policy examples
src/slidecraft/guidance_profiles/ reusable communication profiles
schemas/              interchange contracts
integrations/         Agent integration packages
tests/                automated tests
tools/historical_regression/  architecture-slide regression utilities excluded from the runtime
vendor/               upstream development sources for bundled resources
workspace/            ignored local projects, caches, and generated evidence

トップレベルの AGENTS.md は、リポジトリを認識する Agent に簡潔なエントリ契約を提供します。共有フレームワークコードは、workspace/ 配下のプロジェクトやテストフィクスチャに依存しません。

ライブのプレゼンテーションプロジェクトと生成された出力は、リポジトリ開発中は workspace/ 配下に置かれ、Git から除外されます。パッケージ化されたスターターリソースは、src/slidecraft/starter_resources/ 配下にあります。

すべての新しいプロジェクトは、隠し .slidecraft/ ディレクトリ配下にパッケージ化されたデッキデザインベースラインを受け取ります。カバー、アジェンダ、セクションディバイダー、ステートメント、クロージング、付録ディバイダーは、共有の決定的レイアウトを使用します。情報伝達スライドは画像生成ルートを使用します。最終アセンブリでは、すべての計画されたスライドがデッキ順に必要であり、エクスポート前に固定デザイン、繰り返されるタイポグラフィロール、コネクターポリシー、標準アセット、キャンバス、デッキクロームをチェックします。

開発

.venv/bin/python -m pytest -q
.venv/bin/python -m ruff check src tests tools
.venv/bin/python -m build

OpenCV は、通常のテキスト、コネクター、線画の測定を処理します。segmentation エクストラをインストールして、不規則な塗りつぶしオブジェクトの SAM 2 境界検出を追加します。

ライセンス

Slidecraft は MIT License の下でリリースされています。バンドルされているサードパーティリソースは、それぞれ独自の通知を保持します。