Skip to content

Latest commit

 

History

History
247 lines (169 loc) · 17.2 KB

README_ja.md

File metadata and controls

247 lines (169 loc) · 17.2 KB

English | 日本語

Spec-Driven Presentation Maker

License: MIT-0 CI AWS Blog

SDPM 自身を紹介するデッキを Web UI が組み上げるアニメーション。レイアウトパスが表紙の枠を描き、エージェントがそれぞれの色で中身を埋め、続いて 2 枚ずつ作り、最後にグリッドで完成した 7 枚を表示

手元の資料から、AI エージェントがスライドを作ります。エージェントはまず短いスペック(誰に向けた 発表か、どんな見た目にするか、各スライドで何を言うか)を書き、それをもとに PowerPoint ファイルか ブラウザで見せる HTML プレゼンテーションを組み立てます。

インストール

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/aws-samples/sample-spec-driven-presentation-maker/main/scripts/install/dist/install.sh | bash
# Windows(PowerShell。CI での検証のみ)
irm https://raw.githubusercontent.com/aws-samples/sample-spec-driven-presentation-maker/main/scripts/install/dist/install.ps1 | iex

終わったら、AI エージェントに 「〜のスライドを作って」 と頼むか、最初に 1 度 kiro-cli login を 実行してから sdpm webui でブラウザから使います。チームで使うなら、自分の AWS アカウントに ワンクリックデプロイできます。インストーラーが聞くことと、エージェントごとの 始め方はクイックスタートにあります。

同じスペックを、どのスタイルでも

「Agree on the content first」のスライドを同梱スタイル 7 つで作ったもの: agent-spectrum、newspaper、aws-dark、neo-brutalist、bento、duotone、swiss-poster

同じ文言の同じスライドを、同梱スタイルのうち 7 つで作ったもの。配色、フォント、レイアウトはスタイルが決め、 スライドで何を言うかはスペックが決めます。

📝 コンセプトと背景は AWS ブログ Spec-Driven Presentation Maker — 伝えたいことを先に設計し、スライド構築は AI に任せる もあわせてご覧ください。


できること

先にスペック、それからスライド

スライドを作る前に、エージェントは 3 つのパートからなるスペックを書きます。

  • ブリーフ: 聞き手は誰か、何を持ち帰ってほしいか、どの資料を使うか。
  • スタイル: テンプレート、配色とフォント、スライドの見せ方。Web UI では アートディレクション として表示されます。
  • アウトライン: 1 スライド 1 行。そのスライドの主張、見せるもの、根拠の出どころ。

スライドを作る前に、それぞれを確認できます。その後はコンポーザー(スライドを作る補助エージェント)の出番です。 1 つのコンポーザーが全スライドのレイアウトを決め、複数のコンポーザーが並列で中身を作ります。エージェントは プレビューを確認し、直す点をコンポーザーに戻します。

ワークフロー: 依頼からスペック(ブリーフ、スタイル、アウトライン)を作り、コンポーザーがスライドを作成(レイアウトパスの後に並列でコンテンツ作成)、エージェントがレビュー。Web UI のコメントから修正をコンポーザーに依頼

進め方は 2 つあります。

  • すばやく作成: 質問なしで、素材から初稿を作ります。
  • 確認しながら作成: 先にエージェントとストーリーを固め、スペックを確認してからスライドを作ります。

普段の言葉で頼む

やりたいことを伝えれば、エージェントが合ったワークフローを選びます。

頼み方 動作
「〜のスライドを作って」 新しいデッキ: ブリーフ → スタイル → アウトライン → スライド → レビュー
「HTML のデッキにして」 PPTX の代わりにブラウザで見るプレゼンテーション
「この PPTX を編集して」 既存の PPTX を編集できるデッキとして取り込み
「PowerPoint で手直ししたので続きを」 PowerPoint での修正をデッキに反映(ローカルインストールのみ)
「〜みたいなスタイルを作って」 再利用できるスタイル: 配色、フォント、スライドの見せ方
「このデッキを英語に翻訳して」 別の言語のコピーを作成。元のデッキはそのまま(PPTX デッキ、ローカルインストールのみ)

素材には PDF、Word、Excel、PowerPoint、テキストファイル、画像、URL を使えます。

PowerPoint か HTML か

既定では、PowerPoint で編集できる .pptx ファイルを作ります。HTML のデッキを頼むと、 どのブラウザでもオフラインで開ける output.html の 1 ファイルになり、スピーカーノートも使えます。 HTML のスライドには操作できるグラフも入れられます。

上のアニメーションのデッキの 7 枚。表紙を大きく、残りの 6 枚をその下に並べたもの

アニメーションのデッキを .pptx にしたもの。同梱の agent-spectrum スタイルです。

サワードウのパン作りを紹介する HTML デッキのスライド 3 枚(操作できるグラフを含む)

スライドに描いてレビュー

Web UI で コメント ツールをオンにし、スライド上の気になる箇所を枠で囲んで、どう直したいかを 書きます。修正を依頼 を押すと、すべての枠をまとめて送ります。エージェントはスライドごとに コンポーザーを割り当てて修正し、コメントの 1 つずつに返答します。

Web UI でスライドに置いた 2 つのコメント枠と、チャット入力の上で送信を待つ修正依頼

スタイルとテンプレート

18 のスタイルと 2 つの白紙テンプレートを同梱しています。自分の .pptx をテンプレートとして使えるほか、 Web UI やエージェントへの依頼で AI に新しいスタイルを作らせることもできます。詳しくは カスタムテンプレート・スタイル・アセットを参照してください。

自分のテンプレートをどのデッキでも使えるようにするには、.pptx を ~/.config/sdpm/templates/ (Windows は %APPDATA%\sdpm\templates\)に置きます。エージェントのテンプレート一覧に、ファイル名で並びます。 どんな場面で使うかの説明を付けたいときは、代わりにローカルの Web UI(sdpm webui)のテンプレート画面からアップロードしてください。 ファイルは同じフォルダに保存されます。インストール先の ~/.sdpm/checkout には置かないでください。 SDPM 自身のコードで、sdpm update が管理しています。依頼に添付した .pptx は、そのデッキだけで使われます。

Web UI のスタイル画面に並ぶ組み込みスタイル


使い方を選ぶ

どんなものか 必要なもの 次に読む
いつもの AI エージェント 普段使っているエージェント(Claude Code、Kiro CLI、Cursor、VS Code、Codex、Claude Desktop)の MCP サーバーとして動きます。MCP は AI エージェントがツールを呼び出すためのプロトコルです。 macOS、Linux、Windows。git と uv はインストーラーが入れます クイックスタート
手元の Web UI ブラウザで使うチャットアプリ。スペック、スライド、コメントを並べて扱えます。ローカルで動き、AWS アカウントは不要です。 Node.js 20+ と、エージェントを動かす Kiro CLI(インストーラーが入れます) クイックスタートの後に sdpm webui
AWS 上のチームサーバー Web UI と MCP サーバーを自分の AWS アカウントにデプロイします。サインインは Amazon Cognito です。 AWS アカウント。ワンクリックデプロイならローカルのツールは不要 ワンクリックデプロイ

Web UI のデッキ画面。左にグリッド表示の 7 枚のスライド、右にチャット(修正依頼とエージェントの返答)

AWS にワンクリックデプロイ

リージョン デプロイ
東京 (ap-northeast-1) Launch Stack
バージニア北部 (us-east-1) Launch Stack
オレゴン (us-west-2) Launch Stack

パラメータとほかのデプロイ方法はデプロイガイド(英語)、月額の目安は コスト見積もり(英語)を参照してください。


クイックスタート

1 コマンドで、SDPM の最新のリリースが手元のコンピューターの ~/.sdpm に入ります。

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/aws-samples/sample-spec-driven-presentation-maker/main/scripts/install/dist/install.sh | bash
# Windows(PowerShell。CI での検証のみ)
irm https://raw.githubusercontent.com/aws-samples/sample-spec-driven-presentation-maker/main/scripts/install/dist/install.ps1 | iex

インストーラーが聞くのは 2 つです。ブラウザ用の Web UI も入れるか、見つかった AI エージェントの どれに接続するか。必要なツール(git、uv、Node.js など)が足りなければ、その前に入れるかどうかを 聞きます。終わったら次のように始めます。

使うもの 手順
いつもの AI エージェント(Claude Code、Cursor、VS Code、Codex) 「〜のスライドを作って」 と頼むだけ。別のエージェントに後から接続するには sdpm register(開いていたエージェントは再起動してください)
Kiro CLI kiro-cli chat --agent sdpm(インストーラーがこの専用エージェントを作ります)
ブラウザ 最初に 1 度 kiro-cli login を実行し、sdpm webui。インストール時に Web UI を入れなかった場合は sdpm update --with-webui で追加できます
Claude Desktop sdpm.mcpb をダウンロードしてダブルクリック(インストーラー不要)

Web UI はエージェントを Kiro CLI で動かすので、kiro-cli login で Kiro にサインインします。 GitHub、Google、AWS Builder ID、組織の IAM Identity Center のいずれかを使えます。AWS アカウントは不要で、 Kiro には無料プランがあります(Kiro の料金)。

sdpm で何が入っていて何に接続済みかを表示し、sdpm update で最新のリリースに更新(版を下げることは なく、sdpm update --channel main なら main にマージされた変更をすべて追います)、sdpm uninstall で 削除します。インストールと update のたびに、OS と用途に合ったリリースのマニフェストを 1 つダウンロードします。その回数は GitHub が数え、ほかには何も送りません。 ランチャーは ~/.local/bin に入ります(Windows では %USERPROFILE%\bin で、インストーラーが PATH に 追加します)。このディレクトリが PATH にないとインストーラーが表示したら、PATH に追加して新しい ターミナルを開いてください。 スライドのプレビューには LibreOffice と poppler が必要で、インストーラーが導入を提案します。

インストーラーのオプション、エージェントごとの接続、Web UI の使い方ははじめににあります。


ワークショップ

URL、PDF、CSV、議事録などからスライドを作るハンズオンワークショップです。製造業、金融、ヘルスケア、 IT などの業界別シナリオを収録しています。

📖 ワークショップ


ドキュメント

開発者向けと一部の運用者向けのドキュメントは英語のみです。

使う

ドキュメント 内容
はじめに インストール、AI エージェントへの接続、Web UI、HTML デッキ
カスタムテンプレート・スタイル・アセット 自分の .pptx テンプレート、スタイル、アイコン

AWS でチーム向けに運用する

ドキュメント 内容
Deploy guide ワンクリックデプロイと AWS CloudShell からのデプロイ(ローカルの CDK / Docker 不要)
Cost Estimates 月額コストの内訳と、固定費を止める方法
Security スタックが設定するものと、本番前に確認すること
使用量の計測 ユーザー別のトークン数とスライド作成数
アンインストール デプロイした AWS リソースの削除

開発・連携する

ドキュメント 内容
Developer guide checkout での開発、CDK でのデプロイ
Architecture レイヤー構成、データフロー、認証モデル、MCP ツール一覧
Connecting Agents MCP クライアントやゲートウェイからの接続
Teams & Slack Integration チャットツールからの利用
Web UI React 製 Web UI、ローカルモードとクラウドモード
Contributing 変更を送る手順

旧バージョンから更新する

ドキュメント 内容
Migration guides plugin・skill・uvx の構成や v0.4 / v0.5 からの移行
CHANGELOG リリースごとの全変更

Contributing

コントリビューションを歓迎します。セットアップと実行するチェックは CONTRIBUTING.md を参照してください。

Code of Conduct

This project has adopted the Amazon Open Source Code of Conduct.

Security

これはデモと教育のためのサンプルコードで、そのまま本番環境で使うことは想定していません。デプロイの前に、 Security(英語)をセキュリティチーム・法務チームと確認してください。 脆弱性の可能性を見つけた場合は、公開 Issue を作らず CONTRIBUTING.md の手順で報告してください。

License

This project is licensed under the MIT-0 License.