gws-keep 是 gws-claude-plugin 提供的技能，版本为 v1，用于管理 Google Keep 笔记。它通过命令行接口 gws keep <resource> <method> [flags] 调用 Google Keep API。
用途 该技能面向需要通过命令行操作 Google Keep 笔记的场景，提供对笔记的创建、删除、获取、列表查询以及附件媒体下载等能力。
前置条件 使用前需阅读 ../gws-shared/SKILL.md，以了解认证方式、全局标志和安全规则。如果该文件缺失，可运行 gws generate-skills 来生成。
主要能力 API 资源分为 media 与 notes 两类。
media 资源： download — 获取附件。通过 REST 下载附件媒体需要 alt=media 查询参数。如果附件媒体无法以请求的 MIME 类型提供，将返回 400 bad request 错误。
notes 资源： create — 创建新笔记。 delete — 删除笔记。调用者必须对笔记拥有 OWNER 角色才能删除。删除笔记会立即移除该资源且无法撤销，所有协作者将失去对该笔记的访问权限。 get — 获取笔记。 list — 列出笔记。每次 list 调用返回一页结果，page_size 为返回条目的上限。page_size 为零时允许服务器自行选择上限。ListNotesResponse 最多包含 page_size 个条目。如果还有更多内容待列出，会提供 next_page_token 值（页面令牌为不透明值）。要获取下一页结果，将结果中的 next_page_token 复制到下一次请求的 page_token 中。 permissions — 针对 'permissions' 资源的操作。
使用方式 在调用任何 API 方法之前，先检查该方法：
浏览资源与方法
gws keep --help
查看方法的必填参数、类型和默认值
gws schema keep.<resource>.<method>
使用 gws schema 的输出构建 --params 和 --json 标志。
适用场景 适用于需要通过命令行或自动化流程管理 Google Keep 笔记的用户，例如批量创建、查询、删除笔记，或下载笔记附件。
限制 删除笔记不可撤销，且需要 OWNER 角色。附件下载需要 alt=media 查询参数，且受 MIME 类型限制，不支持的 MIME 类型会返回 400 错误。列表查询为分页返回，需通过 next_page_token 与 page_token 翻页。关于认证细节、全局标志和安全规则，需参考 ../gws-shared/SKILL.md。