AgentSkillsCN

gog-calendar

通过gog CLI查看Google Calendar的日程安排,并梳理身份验证、TTY与keyring相关问题的处理步骤。当用户提出“我想查看今天的日程”“我想用gog查看日历”“我想修复calendar events的错误”等需求时使用。

SKILL.md
--- frontmatter
name: gog-calendar
description: gog CLI で Google Calendar の予定を確認し、認証・TTY・keyring の問題を切り分ける手順。ユーザーが「今日の予定を確認したい」「gog でカレンダーを見たい」「calendar events のエラーを直したい」と依頼したときに使う。

Gog Calendar Events Check

最短チェック(今日の予定)

bash
/home/yuiseki/bin/gog --account <email> calendar events primary --today --plain --all-pages --max 50
  • 予定があるかだけ確認する場合:
bash
/home/yuiseki/bin/gog --account <email> calendar events primary --today --max 1 --plain --fail-empty
  • exit code 0: 1件以上あり
  • exit code 3: --fail-empty で0件

この環境で分かったこと(2026-02-19)

  • 実行バイナリは ./bin/gog ではなく /home/yuiseki/bin/gog
  • config path は /home/yuiseki/.config/gogcli/config.json
  • keyring backend は file
  • 非 TTY ではトークン読込が失敗することがある:
    • no TTY available for keyring file backend password prompt; set GOG_KEYRING_PASSWORD
  • 利用アカウントは yuiseki@gmail.com
  • calendar events ... --plain の出力列は ID START END SUMMARY

手順

  1. コマンド仕様を確認する。
bash
/home/yuiseki/bin/gog calendar events --help
  1. 認証状態と keyring backend を確認する。
bash
/home/yuiseki/bin/gog auth status
/home/yuiseki/bin/gog auth keyring
  1. --account を明示して予定を取得する。
bash
/home/yuiseki/bin/gog --account <email> calendar events primary --today --plain --all-pages --max 50
  1. keyring のパスフレーズ入力待ちになったら TTY で実行する。
  2. 非対話で実行する場合は GOG_KEYRING_PASSWORD を設定する。

次から活用できるノウハウ

  • 「有無だけ判定」は --max 1 --fail-empty を使う。
  • 「今日の全件取得」は --today --all-pages --max <十分な件数> を使う。
  • 自動化用途は --json --no-input を基本にする。
  • 全カレンダー横断が必要なら calendar events --all --today を使う。
  • 期間指定が必要なら --from/--to または --days/--week を使う。
  • テキスト絞り込みは --query を使う。