gws-workflow

gws-workflow skillの概要

gws-workflowができること

gws-workflow skillは、gws CLIのためのGoogle Workspace自動化レイヤーです。生のAPIの形を先に推測しなくても、会議準備、スタンドアップ要約、メールからタスクへの変換、DriveからChatへの告知といった、複数サービスをまたぐワークフローを実行できるようにします。

どんな人にインストール向きか

すでにgwsを使っていて、その場しのぎの個別プロンプトではなく、再現性のある運用ワークフローがほしいならgws-workflowを入れる価値があります。Gmail、Calendar、Tasks、Drive、Chatを一つの成果物にまとめる必要があるエージェントには特に向いています。

何が違うのか

gws-workflow skillの最大の価値は、実行前にコマンドの見つけ方と入力の形を正しく整えるためのガイドがあることです。ワークフローの失敗は、コアタスクそのものよりも、パラメータ不足、resource-methodの組み合わせミス、schema確認の省略から起きることが多いため、この差は大きいです。

gws-workflow skillの使い方

インストールと前提セットアップ

gws-workflow install を行うときは、CLIのskillインストールフローを使い、まず共有認証レイヤーが入っていることを確認してください。このskillは ../gws-shared/SKILL.md に明示的に依存しています。もし見つからない場合は、gws generate-skills を実行して、ワークフロー呼び出しの前に認証、グローバルフラグ、セキュリティルールを使える状態にしてください。

まずコマンドを確認する

gws-workflow usage の最短ルートは、SKILL.md を読み、gws workflow --help を実行し、次に gws schema workflow.<resource>.<method> で対象メソッドを確認する流れです。--params や --json を組み立てる前に、必要なパラメータ、型、デフォルト値を把握するための最も安全な方法です。

ざっくりした目的を使えるプロンプトに落とす

「会議の準備をして」のような弱い依頼でも、resource、欲しい出力、制約を具体化するとskillが動かしやすくなります。たとえば「gws workflow calendar.events list と関連メソッドを使って、明日の1:1向けの会議ブリーフを作成してください。参加者、議題の文脈、リンク済みドキュメントを含めてください」のように書くとよいです。目的が具体的であるほど、エージェントが不適切なヘルパーコマンドを選ぶ確率は下がります。

先に読むべきファイル

まず SKILL.md を読み、タスクが同梱ワークフローのいずれかに当てはまるなら、skills/gws-workflow-* 以下のリンクされたヘルパーコマンドを追ってください。実務上は、トップレベルのガイドだけで一般化する前に、自分の仕事に最も近いヘルパーskillを読むのが正解です。

gws-workflow skillのFAQ

gws-workflowは上級者向けだけですか？

いいえ。Google Workspace APIに詳しくなくても、このskillはコマンドの見つけ方やschemaの確認方法を教えてくれるので役立ちます。特に初心者は、パラメータを独自に当てずっぽうで作るより、schema確認のステップに従うほうが成果につながります。

どんなときにgws-workflowを使うべきではありませんか？

単なる自然文の要約や、実際のWorkspace操作を伴わない単発の手作業レスポンスだけが欲しいなら使わないでください。gws コマンドを実行する必要がないタスクなら、このskillは余計なオーバーヘッドです。

一般的なプロンプトと何が違うのですか？

一般的なプロンプトは成果物を説明できますが、gws-workflow は実行可能なワークフロー探索を前提にしています。特に複数のGoogleサービスをまたぎ、正しいmethodやflagsが重要になる場面では、再現可能な gws workflow 呼び出しを作るのに向いています。

Workflow Automation用途のより広いgws-workflowにも合いますか？

はい。ただし、gws のサポート対象resourceとmethodに基づく自動化である場合に限ります。ワークフローにGoogle Workspace APIの外側にある独自の業務ロジックが必要なら、外部スクリプトやオーケストレーションが別途必要です。

gws-workflow skillをより良く使うには

ワークフローの対象を具体名で伝える

gws-workflow で最も良い結果が出るのは、サービス、resource、欲しい成果を最初に明示したときです。「カレンダー」より「明日の顧客との通話に向けたCalendar event lookup」のように言ったほうが、コマンド探索の範囲が絞れ、最初の出力がそのまま使える確率が上がります。

必要な出力形式をはっきりさせる

要約がほしいのか、タスクがほしいのか、下書きメッセージがほしいのか、それとも構造化されたコマンド呼び出しがほしいのかを伝えてください。たとえば「会議、未完了タスク、ブロッカーを含むstandup summaryを返して」と言えば、「今日の状況を分析して」よりもhelperの狙いが明確になります。

実行前にschemaを確認する

よくある失敗は、あるGoogle APIのmethodが別のAPIと同じフィールドを受け取ると思い込むことです。入力の形が少しでも不明なら、特に --params と --json については毎回 gws schema workflow.<resource>.<method> を使ってください。これで再試行を減らし、気づきにくい不一致を防げます。

ゼロから作らず、helper workflowから詰める

最初の試行が広すぎる場合は、+meeting-prep や +email-to-task のような最も近いhelper commandに切り替えて、そこから絞り込んでください。これらの経路は、workflowの意図をより直接的にコード化しているため、新しいプロンプトをゼロから考えるよりたいてい有効です。