mcpField
P
ppt-agent-workflow

ppt-agent-workflow

github.com/mucsbrドキュメント65161 回インストール8 週間前に更新
リポジトリ

ppt-agent-workflow について

ppt-agent-workflowは、プレゼンテーションを作成するエージェント向けのスキルです。依頼の確認から調査、構成、レビュー、納品までを段階的に進め、具体的な実行方法は環境に委ねます。

主な機能

  1. 01依頼内容の確認と能力評価
  2. 02調査と根拠整理の指針
  3. 03アウトラインとページ計画
  4. 04本格作成前のレビュー段階
  5. 05制約の明示と納品前チェック

活用シーン

  1. 01不明点のあるテーマを依頼内容に整理
  2. 02調査に基づくプレゼンの構成作成
  3. 03デッキを拡張する前のアウトライン確認
  4. 04重要なプレゼンの段階的な計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mucsbr/ppt-agent-workflow-san --skill ppt-agent-workflow

インストール後、Claude Code で/ppt-agent-workflowを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
agent-integration.md
method.md
prompts.md

詳細

PPT エージェントのワークフロー

概要

PPT の作成は一度きりの生成ではなく、段階的な作業として扱います。このスキルでは、何をいつ行う必要があるかをエージェントに伝え、どのように実行するかは導入先のエージェントとその環境に委ねます。

特定の環境で明示的に必要とされている場合を除き、具体的な検索ツール、ブラウザー、MCP、レンダラー、エクスポート先を指定しないでください。

基本原則

実装方法ではなく、ワークフローを制約します。

このスキルは、エージェントが次の判断を行えるよう支援します。

  • 依頼内容がまだ不明確なとき
  • 最新情報の調査が必要なとき
  • 中間成果物をユーザーに確認してもらうため、作業を止めるとき
  • より完成度の高いドラフトに進むとき
  • 能力に制限がある場合に、誠実に応答する方法

能力の把握

本格的な作業に入る前に、現在の環境で次のことが可能かどうかを大まかに確認します。

  • 外部の情報を収集する、または少なくともユーザー提供の資料に基づいて作業する
  • メモ、アウトライン、企画ドラフトなどの構造化された成果物を作成する
  • レビュー可能な成果物を作成する
  • ファイルや成果物をユーザーに渡す

これらの確認結果は、どの段階まで実現できるかを判断する目的にのみ使用してください。このセクションを、ツール選択の方針に変えてはいけません。

対応する入力形式

以下のいずれの形式でも受け付けます。

1. トピックのみ

例:「AI 安全性チェックセンターの PPT を作って」

入力が不十分な場合は、不足している最低限の項目を確認します。

  • 対象者
  • 目的
  • ページ数の範囲
  • 希望するトーンやスタイル
  • 最新情報の調査が必要かどうか
  • 完全版を作成する前に中間成果物の確認を希望するかどうか
2. トピック+ブリーフ

対象者、目的、スタイル、ページ数、主要メッセージがすでに提示されている場合に使用します。

3. ソースに基づく依頼

ユーザーが URL、レポート、PDF、メモ、文字起こし、その他の一次資料を提示した場合に使用します。

提示された資料を主なコンテキストとして扱います。外部情報の調査は、結果を実質的に改善できる場合にのみ追加します。

4. 既存のアウトラインまたは部分的なドラフト

ユーザーがすでに構成、初期段階のスライド、またはページ案を用意しており、全面的な再生成ではなく改善を希望する場合に使用します。

対応する出力段階

ユーザーが必要とする段階で作業を止めます。

  1. research-brief

    • 事実、根拠、未解決の質問、リスク、入手可能な場合は出典への参照
  2. outline

    • デッキの構成、セクションの論理、ページタイトル、各ページの目的
  3. planning-draft

    • 意図、情報の階層、根拠の必要性、レイアウトの方向性を示すページごとの企画カード
  4. sample-artifact

    • 環境で実際に作成できる形式の、レビュー可能な中間成果物を1つ以上
  5. full-deck-plan

    • 承認済みの構成と、完全版の制作に十分な企画ガイダンス
  6. review-notes

    • 論理、根拠、情報密度、一貫性、強調に関する課題

デフォルトのワークフロー

1. ブリーフを明確にする

避けられる失敗を防ぐために必要な情報だけを集めます。

  • トピック
  • 対象者
  • 目的
  • ページ数の範囲
  • スタイルまたはトーン
  • 必須のセクション
  • 避けるべき主張や方向性
  • 迅速なラフ案を希望するか、段階的な確認を希望するか
2. 情報調査が必要か判断する

次の場合は、アウトラインを作成する前に情報を調査します。

  • トピックが時事問題、市場の状況、製品の詳細、統計、技術的な事実に左右される
  • ユーザーが明示的に、調査に裏付けられた内容を求めている
  • ユーザー提供の資料が明らかに不完全である

最新情報の調査が不要な場合は、提示されたコンテキストに基づいて進めます。

3. コンテキストを収集または整理する

導入先のエージェントが利用できる機能を使って、補足資料を収集または整理します。

外部情報を調査できない場合は、結果が提示資料の範囲に限られることを明示し、確実性を捏造するのではなく、ユーザー提供の資料に基づいて作業します。

必要であれば、この手順を実行する前に references/agent-integration.md と references/prompts.md を読んでください。

4. 調査が重要な場合は、調査ブリーフを作成する

スライド資料を作成する前に、作業で得た知識を簡潔なブリーフにまとめます。

  • 重要な事実
  • 裏付けとなる根拠
  • 対象読者に関連する背景情報
  • リスク、注意点、未解決の疑問

ブリーフは短くてもかまいませんが、その後のアウトライン作成の根拠をより確かなものにする必要があります。

5. デザインの前にアウトラインを作成する

ブリーフと背景情報が十分に整ってから、スライド資料の構成を作成します。

references/prompts.md を読み、適切な場合は「Outline Architect」プロンプトを使用します。

要件:

  • 論理的な構成を維持する
  • 主張を入手可能な根拠と一致させる
  • 読むだけでなく、説明に適したスライド資料にする
  • ユーザーが確認しやすいアウトラインにする
6. 計画段階の草案を追加する

複雑なスライド資料では、アウトラインから完成度の高いページへ直接進まないでください。

各ページについて、以下を指定した計画カードを作成します。

  • ページの要点
  • 対象読者に覚えてほしいこと
  • 必要な裏付け情報や根拠
  • 情報の階層
  • 推奨するビジュアル表現または構成

references/prompts.md を読み、適切な場合は「Planning Draft / 策划稿」プロンプトを使用します。

7. 必要に応じて、レビュー可能な中間成果物を作成する

作業を拡大する前に、ユーザーがフィードバックできるものを作成します。

形式は意図的に限定しません。たとえば、次のようなものが考えられます。

  • 調査ブリーフ
  • アウトライン
  • 計画段階の草案
  • ページのサンプル表現
  • 環境で実際に対応できる、その他のレビュー可能な中間成果物

環境やタスクに応じて別の形式が適している場合は、特定の成果物の種類を無理に選ばないでください。

8. 重要なスライド資料では、レビューのために作業を一時停止する

以下の場合は、明示的なレビュー段階を設けます。

  • 社外向けのスライド資料
  • 経営層または取締役会向けのスライド資料
  • 顧客向けまたは営業向けのスライド資料
  • 不確実性が高い事実や、変化の速い事実に基づくスライド資料
  • 複雑な技術的テーマ
9. 作業を拡大するか、仕上げる

方針が承認された後にのみ、より包括的なスライド資料の計画や、さらに充実した成果物の作成に進みます。

10. 制限事項を確認し、明示する

納品前に、以下を確認します。

  • 論理性
  • 事実の確度
  • 根拠の網羅性
  • 情報密度
  • 強調点と階層
  • セクションやページ間の一貫性

機能上の制限が結果に影響した場合は、率直に伝えます。

連携ルール

調査ルール

タスクが事実に依存する場合、エージェントは確信を持って話す前に、裏付けとなる資料を収集または検証する必要があります。

誠実性ルール

環境が理想的なワークフローに対応できない場合、エージェントは制限を伝え、実行可能な中で最も価値の高い段階まで作業を続ける必要があります。

レビュー段階のルール

複雑なタスクや重要度の高いタスクでは、完全な草案の作成に着手する前に、中間成果物を提示する必要があります。

前提を置かないルール

このスキルは、特定の調査、レンダリング、プレビュー、またはエクスポートの実装方法を前提としてはなりません。

リソース

  • references/method.md — PPT 作業を段階的に進めるための要約された手法と、その背景にある考え方
  • references/agent-integration.md — 能力の異なるエージェント向けの抽象的な連携ルール
  • references/prompts.md — 調査、アウトライン作成、計画、レビュー、および任意の形式に応じた生成に再利用できるプロンプト

コメント