gwslisted
Install: claude install-skill iamtatsuki05/dotfiles
# Google Workspace CLI (gws)
## Overview
`gws` コマンドを使って Google Calendar・Drive・Gmail・Tasks などの Google Workspace サービスをターミナルから操作するスキル。
## 前提条件:認証状態の確認
作業前に必ず認証状態を確認する。
```bash
gws auth status
```
未認証またはトークン切れの場合:
```bash
gws auth login # ブラウザが開いて OAuth2 認証
```
## 安全弁
- 書き込み系操作(予定作成、メール送信・返信、Drive upload、共有・削除、Tasks 変更)は、対象アカウント、宛先/参加者、日時、本文、ファイル名、実行コマンドを提示してからユーザー承認を取る。
- `--dry-run` がある操作は先に dry-run を実行し、確認結果を提示してから本実行する。
- 「今日」「明日」「来週」などの相対日付は、現在日付とタイムゾーンを踏まえて絶対日付に直して確認する。
- メール本文・カレンダー詳細・Drive ファイル名には個人情報が含まれるため、最終報告では必要な範囲だけ要約し、秘密情報や長い本文を不用意に再掲しない。
---
## Calendar
### 予定の確認(+agenda)
```bash
# 直近の予定(デフォルト)
gws calendar +agenda
# 今日の予定
gws calendar +agenda --today
# 明日の予定
gws calendar +agenda --tomorrow
# 今週の予定(表形式)
gws calendar +agenda --week --format table
# N日分
gws calendar +agenda --days 7
# 特定カレンダーのみ
gws calendar +agenda --today --calendar 'Work'
# タイムゾーン指定
gws calendar +agenda --week --timezone Asia/Tokyo
```
### 予定の作成(+insert)
```bash
# 基本
gws calendar +insert \
--summary 'ミーティング' \
--start '2026-04-14T10:00:00+09:00' \
--end '2026-04-14T11:00:00+09:00'
# 場所・説明・参加者付き
gws calendar +insert \
--summary 'レビュー' \
--start '2026-04-14T14:00:00+09:00' \
--end '2026-04-14T15:00:00+09:00' \
--location '会議室A' \
--description '週次レビュー' \
--attendee alice@example.com \
--attendee bob@example.com
# Google Meet リンク付き
gws calendar +insert \
--summary 'オンライン打ち合わせ' \
--start '2026-04-15T09:00:00+09:00' \
--end '2026-04-15T09:30:00+09:00'