gws-keep

gws-keep skill の概要

gws-keep の役割

gws-keep は、googleworkspace/cli に含まれる Google Keep skill で、gws CLI から Keep ノートを管理するためのものです。API 呼び出しを手作業で組み立てずに、ノートの作成、一覧表示、確認、削除を行いたいエージェントやユーザーに最適です。

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

Google Keep の操作を再現性のあるワークフローで進めたいなら、gws-keep skill を使うとよいでしょう。特に、スクリプト実行やエージェント支援の環境で効果を発揮します。正しく CLI を検出できること、認証済みでアクセスできること、そして実行前にこの skill で何ができて何ができないかを把握したいユーザーに向いています。

ほかと何が違うのか

この skill は Keep についての一般的な説明ではなく、コマンド駆動で API に特化しています。中心になるのは gws keep <resource> <method> [flags] で、会話形式の要約ではなく、意図からコマンドへ確実に落とし込む経路が必要なときに gws-keep ガイドが役立ちます。

gws-keep skill の使い方

インストールして正しいコンテキストを読み込む

gws-keep をインストールするには、リポジトリの skill パスを使い、そのあとで先に前提となる shared skill を読みます:
npx skills add googleworkspace/cli --skill gws-keep

この skill は、認証、グローバルフラグ、セキュリティルールについて ../gws-shared/SKILL.md に明示的に依存しています。チェックアウトした環境にそのファイルがない場合は、gws-keep を使う前に gws generate-skills を実行してください。

まずコマンドの範囲を確認する

method を選ぶ前に、次のコマンドで利用可能な機能範囲を確認します:
gws keep --help

これは、ローカル版で使える正確なコマンド、resource 名、flags を確認する最短ルートです。リポジトリでも、まず SKILL.md、次に shared skill ファイル、そして method レベルの詳細が出る CLI ヘルプ出力、という順で確認する流れが示されています。

漠然とした依頼を実用的な prompt に変える

gws-keep をうまく使うには、prompt に resource、action、結果を明示するのが重要です。たとえば:

• 「この会議サマリーから Google Keep ノートを作成し、プロジェクト名をタイトルにしてください。」
• 「ノートを一覧表示して、Q2 リリースに関するものを特定してください。」
• 「このノートが自分の所有である場合にのみ削除してください。」

このレベルまで具体化することが重要なのは、notes が side effect の異なる複数の method を持っており、delete は取り消せないからです。

実運用上の制約を把握しておく

gws-keep で特に重要なのは、権限と resource type の境界です。削除には OWNER ロールが必要で、ノート一覧はページ分割される場合があり、添付ファイルのダウンロードは media の MIME type が利用できるときにしか動作しません。添付、ページ、削除が絡むタスクでは、こうした制約を最初に伝えることで、skill が適切な経路を選びやすくなります。

gws-keep skill の FAQ

gws-keep は Google Keep 専用ですか？

はい。gws-keep skill は、gws CLI エコシステム内の Google Keep ノート向けであり、一般的なメモアプリや任意のドキュメント編集を対象にしたものではありません。

shared gws skill も必要ですか？

通常は必要です。この skill 自体の案内では、認証、グローバルフラグ、セキュリティ動作のために ../gws-shared/SKILL.md が必須として扱われています。そのため、shared コンテキストがある状態で使うのが最も安定します。

どんな場合に gws-keep を使わないほうがいいですか？

実際の Keep API 操作は不要で、単に自然文の下書きがほしいだけなら gws-keep は使わないでください。また、delete のような操作について権限面で安全な指示を出せない場合も不向きです。CLI の method に対応しない大規模なノート移行やオフライン編集が必要な場合も、適していません。

初心者にも使いやすいですか？

はい。まず gws keep --help を見て、最初の依頼をシンプルにすれば使いやすいです。初心者は、create や list のように一度に 1 つの action を頼むほうが、複数の操作を連ねるより早く成功しやすくなります。

gws-keep skill を改善するには

ノートの意図を正確に伝える

gws-keep の結果を良くするには、そのノートが下書きなのか、タスクなのか、会議メモなのか、添付ファイルベースのノートなのかを明示してください。タイトル、本体、必要なラベルや所有権の制約も含めるとよいでしょう。入力が具体的であるほど、モデルが Keep ノートの構造を推測する必要が減ります。

例外条件をはっきり書く

よくある失敗は、削除依頼が曖昧なこと、ページ分割の扱いが示されていないこと、添付ファイルの要件が不明確なことです。「すべてのノート」が必要なら、ページをまたいだ結果をどう扱うかまで指定してください。ダウンロードが必要なら、添付ファイル名と期待する形式を指定し、gws-keep ガイドが未対応の MIME type を推測しないようにします。

安全な読み取り専用コマンドから段階的に進める

よいワークフローは、list や get から始めて対象ノートを確認し、そのあとで create や delete に進むことです。gws-keep for Office Documents やその他の内容量の多いノートでは、まず元テキストが完全かどうか、そして対象ノートのタイトルが曖昧でないかを確認してください。そうすることで意図しない編集を防ぎ、出力の信頼性も高まります。