gws-sheets 是 Google Sheets 相关技能，用途是对电子表格进行读取和写入操作。它属于 gws-claude-plugin（来源 wadewarren/gws-claude-plugin），基于 Sheets API v4。
使用前提：需要先阅读 ../gws-shared/SKILL.md，了解认证方式、全局参数和安全规则。如果该文件不存在，运行 gws generate-skills 来创建它。
命令形式为：gws sheets <resource> <method> [flags]。
辅助命令：+append 用于向电子表格追加一行；+read 用于读取电子表格中的值。
API 资源与方法：
spreadsheets 资源：
- batchUpdate：对电子表格应用一个或多个更新。每个请求在应用前都会被校验；如果有任何请求无效，整个请求会失败，所有更新都不会被应用。部分请求会返回回复，回复顺序与请求一一对应。
- create：创建一个电子表格，并返回新建的电子表格。
- get：返回指定 ID 的电子表格。调用方必须提供电子表格 ID。默认不返回网格内的数据；可通过两种方式包含网格数据：在 HTTP 的 fields URL 参数中指定所需的字段掩码，或将 includeGridData URL 参数设为 true。
- getByDataFilter：返回指定 ID 的电子表格。调用方必须提供电子表格 ID。与 get 的区别在于，它允许通过 dataFilters 参数选择要返回的电子表格数据子集，可以指定多个 DataFilter。
- developerMetadata：针对 developerMetadata 资源的操作。
- sheets：针对 sheets 资源的操作。
- values：针对 values 资源的操作。
发现命令的方式：在调用任何 API 方法之前，先检查它。使用 gws sheets --help 浏览资源和方法；使用 gws schema sheets.<resource>.<method> 查看某个方法的必填参数、类型和默认值。根据 gws schema 的输出来构建 --params 和 --json 参数。
适用场景与限制：本技能适用于需要程序化读取或写入 Google Sheets 电子表格的场景，包括追加行、读取值，以及通过 API 资源执行批量更新、创建和获取表格等。使用前必须完成共享技能中说明的认证配置，否则无法调用。关于具体的认证方式、全局参数、安全规则、配额和错误处理等细节，资料中未提供，详见 ../gws-shared/SKILL.md。