gws-keep

gws-keep 技能概览

gws-keep 的作用

gws-keep 是 googleworkspace/cli 里的 Google Keep 技能，用于通过 gws CLI 管理 Keep 笔记。它最适合需要创建、列出、查看或删除笔记，但又不想手工编写 API 调用的代理或用户。

适合谁安装

如果你想要一套可重复执行的 Google Keep 操作流程，尤其是在脚本化或代理辅助环境中，建议安装 gws-keep 技能。它适合那些在执行前就很在意 CLI 能否正确发现、认证访问是否正常，以及这个技能能做什么、不能做什么的用户。

它有什么不同

这个技能是命令驱动、API 绑定的，不是一个泛泛而谈的 Keep 提示词。它围绕 gws keep <resource> <method> [flags] 展开，因此当你需要的是从意图到命令的可预测路径，而不是一段对话式摘要时，gws-keep 指南会更有用。

如何使用 gws-keep 技能

安装并加载正确的上下文

安装 gws-keep 时，先使用仓库里的技能路径，再优先阅读前置的共享技能：
npx skills add googleworkspace/cli --skill gws-keep

这个技能明确依赖 ../gws-shared/SKILL.md，用于认证、全局 flags 和安全规则。如果你在本地检出中缺少这个文件，先运行 gws generate-skills，再使用 gws-keep。

先从命令发现开始

在选择具体方法之前，先用下面的命令查看可用能力范围：
gws keep --help

这是最快确认你本地版本中确切可用的命令、资源名和 flags 的方式。仓库也建议优先查看这些核心部分：先看 SKILL.md，再看共享技能文件，最后看能展示方法级细节的 CLI help 输出。

把模糊需求转成可执行提示

一个好的 gws-keep 使用提示，应该同时点明资源、动作和结果。例如：

• “根据这份会议总结创建一条 Google Keep 笔记，并用项目名作为标题。”
• “列出我的笔记，并找出所有和 Q2 发布相关的内容。”
• “只在这条笔记确实归我所有时才删除它。”

这种具体程度很重要，因为 notes 支持不同方法，而且副作用并不相同，删除操作更是不可逆的。

了解实际限制

gws-keep 最关键的边界在于权限和资源类型。删除需要 OWNER 角色，笔记列表可能会分页，而附件下载只有在媒体 MIME type 可用时才可行。如果你的任务涉及附件、分页或删除，最好一开始就把这些限制说明清楚，这样技能才能选择正确路径。

gws-keep 技能 FAQ

gws-keep 只适用于 Google Keep 吗？

是的。gws-keep 技能面向 gws CLI 生态中的 Google Keep 笔记，不是通用记事应用，也不是任意文档编辑工具。

我还需要共享的 gws 技能吗？

通常需要。技能本身的说明把 ../gws-shared/SKILL.md 视为认证、全局 flags 和安全行为所必需的上下文，所以在这个共享上下文可用时，gws-keep 的效果最好。

什么时候不该用 gws-keep？

如果你只需要一段一次性的自然语言草稿，并不打算真正执行 Keep API 操作，就不要用 gws-keep；如果你无法提供适合权限安全操作的指令，比如 delete，也不适合使用它。如果你需要的是大规模笔记迁移，或者与 CLI 方法不对应的离线编辑，gws-keep 也不是理想选择。

它适合新手吗？

适合，只要先运行 gws keep --help，并把第一次请求保持得足够简单。新手通常更容易成功的方式是一次只请求一个动作，比如先 create 或 list，再逐步串联多个操作。

如何改进 gws-keep 技能

给技能明确的笔记意图

想让 gws-keep 取得更好的结果，就要说明这条笔记是草稿、任务、会议记录，还是基于附件的笔记。把标题、正文，以及你关心的标签或所有权限制一并写清楚。输入越具体，模型就越不需要去推测 Keep 笔记结构。

把边界情况说清楚

最常见的失败模式包括：删除请求太模糊、没有说明分页预期、附件要求不明确。如果你需要“全部笔记”，要说明结果要如何跨页处理；如果你需要下载附件，要写明附件名称和预期格式，这样 gws-keep 指南就能避免对不受支持的 MIME type 进行猜测。

从安全的只读命令开始迭代

一个更稳妥的流程是先用 list 或 get 确认目标笔记，再进入 create 或 delete。对于 gws-keep for Office Documents 或其他内容量大的笔记，先确认源文本完整、目标笔记标题没有歧义。这能减少误改，也让输出更值得信赖。