gws-drive

gws-drive 技能概览

gws-drive 的作用

gws-drive 是 Google Workspace CLI 里的 Google Drive 技能。它可以帮你从命令行管理文件、文件夹、共享云端硬盘以及相关的 Drive API 流程，并提供技能层面的指导，避免你在资源名称、必填字段和权限限制上靠猜。

适合谁使用

如果你做 Backend Development、自动化或运维，需要在脚本或 agent 工作流里反复执行 Drive 操作，就适合用 gws-drive 技能。它最适合把 Drive 任务做成 CLI 驱动的流程，而不是一次性提问，尤其是上传、带元数据的操作，以及 API 查询这类场景。

安装前最重要的事

gws-drive 的核心价值不在于覆盖面，而在于可靠性：它会把 agent 引导到正确的 Drive 资源和正确的请求结构上。最大的落地阻力来自认证和共享环境配置，因为这个技能依赖更大的 gws 环境，以及 gws-shared 里的参数和安全规则说明。

如何使用 gws-drive 技能

安装并检查前置条件

先在 Google Workspace CLI 环境里安装 gws-drive 技能，然后优先确认共享前置条件：../gws-shared/SKILL.md。技能元数据也要求 gws 二进制可用，所以在开始 Drive 流程前先确认 CLI 本身能正常工作。一个实用的安装路径是先执行 gws drive --help，再把输出和技能里的资源清单对照。

先用正确的输入结构

gws-drive 的使用模式是 gws drive <resource> <method> [flags]，所以你的提示词应该明确写出目标资源、动作，以及精确的输出约束。好的输入示例是：“列出我能访问的共享云端硬盘，只返回 name 和 id，并排除垃圾箱。”差的输入示例是：“检查 Drive。”如果你是拿 gws-drive 指南来做 Backend Development，最好一开始就带上标识符、父文件夹，以及任何权限或 scope 假设。

先看这些文件

先看 SKILL.md，再检查 ../gws-shared/SKILL.md，因为它负责认证、全局 flags 和安全行为。在这个仓库切片里，没有可依赖的 helper 脚本或 support 文件夹，所以 skill 文件本身就是主要事实来源。尤其要注意 API resource 部分和 helper 命令 +upload，因为它们展示的是预期工作流，而不是让你从通用 Drive 文档里自己推断。

更容易得到好结果的工作流

采用三步走：先定义资源，再缩小 method 范围，最后只加那些会影响 API 响应的 flags。比如，想获取 Drive account info 时，要说明 about.get 调用需要 fields；而上传相关工作如果想自动补充元数据，就应该走 helper 命令。这是 gws-drive 最核心的使用纪律：请求最小且有用的结果，而不是尽量宽泛的结果。

gws-drive 技能 FAQ

gws-drive 只适合 Drive 基础操作吗？

不是。gws-drive 不仅覆盖核心 Drive resources，还包含自动化里很关键的特定 API 行为，比如 about.get 需要 fields，以及带 approver-only 限制的 access proposal 处理。也正因为如此，当你的任务依赖的是正确的 API 结构，而不只是泛泛解释 Drive 时，它比普通提示词更合适。

什么情况下不该用这个技能？

如果你只需要一个手动的一次性 Drive 小技巧，或者你还没准备好 gws CLI 和共享认证环境，就先别用 gws-drive 技能。如果任务根本不涉及 Drive 操作，它也不是好选择，因为这个技能优化的是请求构造和 CLI 执行，而不是通用 Workspace 建议。

它适合新手吗？

适合，只要你能说清楚一个具体的 Drive 目标。这个技能会通过 resource-method 模式和关键注意事项减少猜测，但新手仍然需要提供目标文件、文件夹、共享云端硬盘或权限场景。没有这些信息，agent 可能会给出过于笼统的命令，或者选到过宽的 API 调用。

它和普通提示词最大的区别是什么？

普通提示词可能只是解释 Drive 概念；gws-drive 给你的是基于真实 CLI 和 API resources 的工作流。当你需要的是确定性命令、有效的字段选择，或者不应在第一次执行就失败的权限感知操作时，这个区别非常重要。

如何改进 gws-drive 技能

给 agent 精确的 Drive 上下文

最好的结果来自一句话里同时写清资源、动作和范围。比如：“用 gws-drive 列出 abc123 文件夹里的文件，只返回 id、name、mimeType 和 modifiedTime，并且不要包含已删除项目。”这比“帮我找文档”强得多，因为它减少了搜索歧义，也避免了不必要的 API 输出。

说清会改变 API 调用的限制条件

明确说明你是否需要共享云端硬盘、特定文件夹、access proposal，或者 account-level 信息。对 gws-drive 来说，这些细节很重要，因为不同资源对应的权限和响应要求都不一样。如果你省略这些信息，第一次输出常常会因为缺少 fields、缺少 approver 权限，或者查询范围过宽而失败。

从命令结果倒推并迭代

如果第一次输出范围太大，就通过去掉可选输出、补上你关心的准确标识符来收紧请求。如果失败了，先检查是认证问题、gws-shared 里的前置条件缺失，还是 resource-method 配对不对。gws-drive 最快的指南式工作流，是先修正命令结构，再考虑是否要改任务本身。