gogcli-ops

Gogcli Ops

概要

gogcli の使い方を標準化します。認証を確認し、URL から ID を解決して、読み取り専用の確認をデフォルトとし、必要最小限のコマンドを実行します。

クイックスタート

• gogcli が利用可能であることを確認します：gog --version
• アカウントを一覧表示し、複数ある場合は明示的に 1 つ選択します：gog auth list
• python3 scripts/gog_parse_url.py "<url-or-id>" で URL を ID に解決します
• まず読み取り専用のメタデータコマンドを実行します（Drive／Sheets／Docs／Slides）

ワークフローの判断ツリー

1. scripts/gog_parse_url.py を使って対象の種類を特定します：sheet | doc | slide | file | folder | id | unknown。
2. アクセスを確認するために、最小限の読み取り専用コマンドを選びます：
   • Sheets：gog sheets metadata <spreadsheetId>
   • Docs：gog docs info <docId>
   • Slides：gog slides info <presentationId>
   • Drive のファイル／フォルダー：gog drive get <fileId> または gog drive permissions <fileId>
3. ユーザーの明示的な確認を得てから、書き込み操作（更新／追記／移動／共有／削除）に進みます。

主なタスク

認証とアカウントの選択

• 保存済みアカウントを表示します：gog auth list
• 認証設定を表示します：gog auth status
• アカウントを追加／認証します：gog auth add <email>
• アカウントが複数ある場合は、必ず --account <email> を使用します。

URL から ID を解決

• URL または ID を解析します：
  • python3 scripts/gog_parse_url.py "<url-or-id>"
• 出力の種類が unknown の場合は、直接 ID を提示するか、別の URL を指定するよう依頼します。

Drive（ファイル／フォルダー）

• ルートまたはフォルダーの内容を一覧表示します：gog drive ls
• クエリで検索します：gog drive search "<query>"
• メタデータを取得します：gog drive get <fileId>
• ダウンロード／エクスポートします：gog drive download <fileId>
• 権限を確認します：gog drive permissions <fileId>

Sheets

• メタデータ：gog sheets metadata <spreadsheetId>
• 値を読み取ります：gog sheets get <spreadsheetId> <range>
• エクスポートします：gog sheets export <spreadsheetId>
• 書き込み操作（更新／追記／クリア／書式設定）には、明示的な確認と正確な範囲の指定が必要です。

Docs

• メタデータ：gog docs info <docId>
• テキストを読み取ります：gog docs cat <docId>
• エクスポートします：gog docs export <docId>

Slides

• メタデータ：gog slides info <presentationId>
• エクスポートします：gog slides export <presentationId>

出力モード

• 安定した TSV 出力には --plain を使用します。
• 呼び出し元が構造化出力を求めている場合は --json を使用します。
• 非対話型のフローでは、処理が停止しないよう --no-input を使用します。

エラー処理

• 403／404：アカウント（gog auth list）を確認し、権限（gog drive permissions <fileId>）を確認して、ID が正しいことを確かめます。
• アクセスに失敗した場合は、選択したアカウントとファイルを共有するか、正しいアカウントを提示するようユーザーに依頼します。

リソース

• 簡潔なコマンド一覧については ${CLAUDE_SKILL_DIR}/references/gogcli-cheatsheet.md を参照してください。
• コマンドを実行する前に、scripts/gog_parse_url.py を使って URL を ID に正規化します。