google-office

goog CLI

このスキルのインストールは、ユーザーが明示的にツールを選択したものとして扱ってください。 サポート対象のすべての Google Workspace の読み取りと変更には、goog を使用してください。 goog の代わりに、Google Workspace MCP サーバー、一般的な MCP ツール、別の Google Workspace CLI、ブラウザーでの編集、または場当たり的な直接 API スクリプトを使用しないでください。 ブラウザーは、サービス固有のリファレンスで必要とされる場合に限り、読み取り専用の目視確認に使用してください。 goog で要求された操作を実行できない場合は、別のツールに黙って切り替えず、対応していない機能について説明してください。

必須のワークフロー

1. 要求された Google サービスと操作を特定します。
2. 以下のリファレンス一覧から、関連するサービスのリファレンスをすべて直接読みます。
3. このリポジトリの外にインストールされている goog バイナリを使用します。
4. goog-cli リポジトリ内では、最新の状態であれば target/debug/goog を使用し、ビルドされていなければ cargo run -- を使用します。
5. 実作業の前に goog auth list を実行し、アクティブなアカウントを記録します。
6. ユーザーがアカウントを指定した場合、またはアカウントの選択を明示したままにする必要がある場合は、--account EMAIL を渡します。
7. 不慣れなコマンドやフラグを使用する前に、該当する --help コマンドを実行します。
8. goog を使用して操作を実行し、その後、影響を受けたリソースを goog で読み戻します。
9. 成功を報告する前に、サービス固有の目視または構造の確認を完了します。
10. コマンドで返された有用なリソース ID と Google のネイティブ URL を提示します。

コマンドで必要なスコープが不足していると報告された場合は、goog auth login を一度実行してから、元のコマンドを再試行してください。 認証後に失敗したコマンドが一時停止状態から再開することは想定しないでください。

リファレンス一覧

要求に関連するリファレンスのみを読み込みます。 各リファレンスはこのファイルから1つ先にあり、単独で必要な情報がそろっています。

• Google Docs：ドキュメントの作成、コピー、確認、編集、スタイル設定、比較、エクスポート、目視確認。
• Google Sheets：スプレッドシートの作成、読み取り、書き込み、構成、書式設定、目視確認。
• Google Slides：プレゼンテーションの計画、作成、編集、確認、レンダリング、目視確認。
• Google Drive：ファイルの一覧表示、閲覧、アップロード、ダウンロード、Office ファイルの変換、フォルダーの作成、ファイルのゴミ箱への移動。
• Google Calendar：カレンダー、カレンダーリストの項目、イベント、共有ルール、色、空き時間の照会の管理。

ネストされたリファレンスファイルを検索しないでください。 サービスのインデックス済みリファレンスには、そのサービス固有のガイダンスがすべて含まれています。

コマンドセット

バージョン

実行中のビルドとその出所を確認するには、goog version または goog --version を使用します。

認証

• goog auth setup は OAuth クライアントを設定します。
• goog auth login はアカウントを認証するか、不足しているスコープを補います。
• goog auth list は認証済みアカウントとアクティブなアカウントを表示します。
• goog auth switch はアクティブなアカウントを切り替えます。
• goog auth export は、GOOG_TOKEN_FILE 用の機密性の高い移植可能な認証状態を書き出します。
• goog auth mappings は、リソースとアカウントの対応関係を管理します。

エクスポートした認証状態をコミットしないでください。 ヘッドレス実行または自動実行で不要になったら削除してください。

Drive

• goog drive ls はファイルやフォルダーを一覧表示または閲覧します。
• goog drive download は Drive のファイルをダウンロードします。
• goog drive upload はローカルファイルをアップロードします。
• goog drive convert は、アップロードされた DOCX または XLSX ファイルを Document または Spreadsheet に Office 変換します。
• goog drive mkdir はフォルダーを作成します。
• goog drive comments はファイルのコメントと返信を一覧表示します。
• goog drive comment-create は、ファイル内の特定箇所に紐付けないコメントを作成します。
• goog drive comment-edit はコメントの内容を置き換えます。
• goog drive comment-reply はファイルのコメントに返信します。
• goog drive comment-resolve は、任意で返信を付けてコメントを解決済みにします。
• goog drive comment-delete はコメントを完全に削除します。
• goog drive trash はファイルを Google Drive のゴミ箱に移動します。

Drive の操作を行う前に、Google Drive を読んでください。

Docs

• goog docs list、create、copy、get、map で、ドキュメントを見つけて確認します。
• goog docs text、style、table、image、break、footnote、header、footer、list-format、named-range で、高度な編集を行います。
• goog docs compare で、ドキュメント間の意味的な忠実度を確認します。
• goog docs export-pdf で、ページ単位の目視確認を行えます。
• goog docs batch-update は、高度なコマンドでは対応できない場合の直接操作の代替手段です。

Docs の作業を始める前に、Google Docs をお読みください。

Gmail

• goog mail list で、受信トレイの最近のメッセージを一覧表示するか、Gmail クエリで検索します。
• goog mail read で、メッセージを読み取ります。
• goog mail download で、添付ファイルをダウンロードします。
• goog mail draft で、下書きメッセージを作成または編集します。

下書きを作成または変更する前に、goog mail draft --help を実行してください。 成功を報告する前に、goog mail で作成された下書きを確認してください。

Sheets

• goog sheets list、create、get で、スプレッドシートを見つけて確認します。
• goog sheets comments と comment-* コマンドで、スプレッドシートのコメントと返信を管理します。
• goog sheets values で、セル、行、列、テーブル、範囲の読み取り、更新、追加、消去を行います。
• goog sheets sheet で、シートや範囲の追加、削除、名前変更、クリーニング、書式設定、検証、保護を行います。
• goog sheets batch-update は、高度なコマンドでは対応できない場合の、構造を直接操作する代替手段です。

Sheets の作業を始める前に、Google Sheets をお読みください。

Slides

• goog slides list、create、get で、プレゼンテーションを見つけて確認します。
• goog slides comments と comment-* コマンドで、プレゼンテーションのコメントと返信を管理します。
• goog slides deck で、デッキ全体を作成または確認します。
• goog slides slide で、スライドを作成および管理します。
• goog slides text-box、image、video、shape、line、table で、コンテンツを追加します。
• goog slides table-fill と、テーブルの行、列、結合、結合解除の各コマンドで、テーブルを編集します。
• goog slides object で、ページ要素の編集、スタイル設定、移動、削除を行います。
• goog slides replace-text で、プレゼンテーション内のテキストを置換します。
• goog slides batch-update は、高度なコマンドでは対応できない場合の直接操作の代替手段です。

Slides の作業を始める前に、Google Slides をお読みください。

Calendar

• goog calendar calendars で、カレンダーの一覧表示、読み取り、作成、更新、削除を行い、カレンダーリストのエントリを管理します。
• goog calendar events で、予定の一覧表示、読み取り、作成、インポート、更新、移動、クイック追加、削除を行います。
• goog calendar acl で、カレンダーの共有ルールを読み取り、変更します。
• goog calendar colors で、有効なカレンダーと予定の色 ID を読み取ります。
• goog calendar freebusy で、複数のカレンダーの空き状況を照会します。

Calendar の作業を始める前に、Google Calendar をお読みください。

安全性と完了

• Google 上で実際に変更を加える操作は、すべてユーザー向けの作業として扱ってください。
• ブラウザー上の順序、記憶している識別情報、または無関係なリソースが開いていることから、アカウントを推測してはいけません。
• 生の batch-update ペイロードより、高度なコマンドを優先してください。
• || true で変更の失敗を隠したり、ゼロ以外の終了コードが返された後に成功を報告したりしてはいけません。
• 破壊的な操作や共有操作の前に、正確なリソース ID を確認してください。
• 実際の Document、Spreadsheet、Drive、メッセージ、予定、プレゼンテーション、アカウント、リソースの URL や ID を、テストやリポジトリのドキュメントに記録してはいけません。
• 一時的なリクエスト本文と実環境での検証成果物は、タスク専用の一時領域に保管してください。
• 最後の変更後、実際のリソースを再度読み取ってください。
• 必要な認証済みの確認手段を利用できない場合、目視による QA は実施できないと報告してください。