gslides-readlisted

# /gslides-read Google Slides �� `.pptx` として Drive API でダウンロードし、各スライドの本文とスピーカーノートを Markdown で取り出すスキル。実装本体は `{{ORG_REPO_PATH}}/Agent-team/tools/gslides-read/` に配置する前提（薄いラッパー）。環境に合わせてパスは読み替える。 ## 引数 | 形 | 用途 | |---|---| | `/gslides-read <file-id-or-url>` | 標準出力に Markdown を吐く | | `/gslides-read <file-id-or-url> -o <path>` | 指定先に書き出す | | `/gslides-read <file-id-or-url> --title "Deck Name"` | 見出しにタイトルを付与 | | `/gslides-read setup` | 依存インストール + ADC 確認 | 入力は生のファイル ID（`<FILE_ID>`）か Drive 共有 URL（`/presentation/d/<FILE_ID>/...`）どちらでも可。 ## 実行手順 ### setup（初回のみ） ```bash bash {{ORG_REPO_PATH}}/Agent-team/tools/gslides-read/setup.sh ``` ADC（Application Default Credentials）が無い、または `drive.readonly` スコープが付いていない場合： ```bash gcloud auth application-default login \ --scopes='https://www.googleapis.com/auth/drive.readonly' ``` ### 通常実行 ```bash {{ORG_REPO_PATH}}/Agent-team/tools/gslides-read/gslides-read.py <file-id-or-url> {{ORG_REPO_PATH}}/Agent-team/tools/gslides-read/gslides-read.py <file-id-or-url> -o out.md {{ORG_REPO_PATH}}/Agent-team/tools/gslides-read/gslides-read.py <file-id-or-url> --title "Deck Name" ``` ## ツール挙動（SPEC） 実装がまだ無い環境でも仕様として成立するよう、想定挙動を明記する。 - 入力の ID / URL から Drive ファイルを特定し、Drive API の export で `.pptx`（`application/vnd.openxmlformats-officedocument.presentationml.presentation`）としてダウンロードする。 - ダウンロードした `.pptx` を解析し、スライドごとに本文テキストとスピーカーノートを抽出する。Drive の通常 Markdown/テキストエクスポートはノートを落とすため、`.pptx` 経由でノートを確保する点が肝。 - 出力は下記フォーマットの Markdown。`--title` 指定時は先頭に H1 を付ける。`-o` 指定