gws-meet

gws-meet skill の概要

gws-meet は、googleworkspace/cli に含まれる Google Meet 特化の skill で、gws CLI を使って Meet のスペースや会議アーティファクトを管理するためのものです。手書きで API 呼び出しを組む代わりに workflow agent で Meet 操作を自動化したいユーザーに最適で、特に会議記録、録画、文字起こし、スペース管理を重視する場合に向いています。

この gws-meet skill は、単なる「Meet についてチャットする」ための汎用プロンプトではありません。実際の API リソースに対応しており、どのリソースを使うのか、どの method が必要なのか、そしてどの識別子や filter を渡せるのか、という構造化された意図を前提にしています。そのため Workflow Automation には有用ですが、明確な会議コンテキストを与えられる場合に限って真価を発揮します。

gws-meet は何のためのものか

gws-meet は、conference records の一覧取得、特定レコードの取得、参加者や録画の操作、会議スペースの更新など、Meet データの確認や管理が必要な場面で使います。場当たり的なコンソール操作の代わりに、再現性のある gws-meet usage パターンを作りたいときにも適しています。

インストール前に確認すべきこと

導入可否を分ける最大のポイントは、環境が整っているかどうかです。gws-meet は gws バイナリに依存し、さらに ../gws-shared/SKILL.md にある共通の認証・セキュリティルールも前提にしています。ワークスペースがこれらの前提を満たせないなら、この skill は安定して動きません。

この skill が他と違う理由

gws-meet の価値は、API に沿った構造にあります。まず method を見つけ、そのうえで必要な resource action を正確に呼び出します。これにより推測は減りますが、その一方で、conference ID、meeting space、日付範囲のような対象オブジェクトをすでに把握している場合に最も向いています。

gws-meet skill の使い方

インストールして前提条件を確認する

gws-meet install では、リポジトリの skill ワークフローを使い、まず環境で gws が利用できることを確認してください。そのうえで、Meet の method を呼び出す前に ../gws-shared/SKILL.md を必ず読みます。共通ファイルには、この skill が継承する認証、グローバルフラグ、セキュリティ制約が定義されているためです。

実用的なインストール確認としては、Meet 用の CLI help を実行し、さらに実際に触る予定の resource に必要な権限がアカウントにあるかを確認するのが有効です。

まず skill のエントリポイントを開く

skill のエントリポイントは SKILL.md です。最初にこれを読み、そこに案内されている method discovery の流れに従ってください。gws-meet usage で最も重要なのは、呼び出す前に resource を確認する習慣です。

gws meet --help
gws meet <resource> --help
gws meet <resource> <method> --help

これにより、間違った resource に合わせて prompt を作り込んでしまったり、存在しない method をある前提で進めてしまったりするのを防げます。

あいまいな目的を、よい prompt に変える

gws-meet に対する強い prompt には、次の要素を入れてください。

• resource: conferenceRecords または spaces
• method: get, list, create, patch, endActiveConference
• すでに分かっている identifier または filter
• 欲しい出力形式。たとえば要約、特定の field 集、後続アクションなど

たとえば「Google Meet のデータを確認して」ではなく、「gws-meet を使って過去 7 日間の conference records を一覧表示し、開始時刻と参加者数で新しい順に上位 5 件を要約して」と依頼するほうが適切です。

先に読むべきファイルを間違えない

このリポジトリはあえて軽量に作られているため、最も情報価値の高い読み順は次の通りです。

1. SKILL.md
2. ../gws-shared/SKILL.md
3. gws meet --help の CLI help

この順番が重要なのは、skill 本体は短く、実行時のルールは共有 skill 側にあるからです。共有ファイルを飛ばすと、認証やセキュリティ関連の挙動を誤る可能性があります。

gws-meet skill の FAQ

gws-meet は管理者専用ですか？

いいえ。gws-meet は、Meet 操作を自動化したい権限のあるユーザーなら誰でも役立ちます。ただし、実際に使えるかどうかはアカウント権限と対象 API resource に依存します。Google Workspace で会議オブジェクトを読み取れない、または変更できないなら、この skill がその制限を回避することはありません。

ふつうの prompt の代わりに gws-meet を使うべきですか？

繰り返し使える tool-backed な操作を、少ない前提で行いたいなら gws-meet skill を使ってください。ふつうの prompt はブレストには向いていますが、正確な API method の選択、一貫した CLI usage、そして自動化への道筋が必要なタスクでは gws-meet のほうが適しています。

いちばん大きな制約は何ですか？

この skill は設計上かなり狭く、Meet resources に特化しています。広い意味での workspace 管理は扱いません。Calendar、Drive、Chat を同じ実行でまたぐような目的なら、gws-meet はワークフローの一部にすぎません。

gws-meet は初心者向けですか？

はい。ただし、すでに操作したい meeting object が分かっている場合に限ります。「すべての meeting で何が起きたか？」のような曖昧な問いから始めると初心者には扱いにくくなります。gws-meet は、明確な resource 名、ID、日付範囲があるときに最も力を発揮します。

gws-meet skill を改善する方法

agent に正確な Meet 対象を渡す

gws-meet の結果を最速で改善するには、具体的な対象を最初から渡すことです。conference ID、meeting space、日時の範囲、filter 条件などを明示してください。「team-sync の月曜から金曜の間で最後の conference record を見つけて」のような依頼は、「会議を調べて」よりはるかに優れています。

1 回の request で 1 つの API 型タスクに絞る

この skill は、各 request が 1 つの resource と 1 つの method にきれいに対応するときに最もよく動きます。list → inspect → update のような連続作業が必要なら、ステップごとに分けてください。そうすれば tool は次に進む前に各結果を検証できます。

出力条件を明確にする

生の CLI 出力が欲しいのか、簡潔な要約が欲しいのか、table 形式で field を抽出してほしいのかを agent に伝えてください。これで不要なやり取りを減らせますし、gws-meet も表示形式を決めることに気を取られず、実際の workflow に集中できます。

よくある失敗パターンに注意する

よくあるエラーは、前提条件の不足、resource 選択のあいまいさ、そして確認していない data に method が対応していると思い込むことです。最初の試行が失敗したら、次の prompt では正確な gws meet <resource> <method> の形、identifier、日付または所有範囲を追加して改善してください。