用途
gws-docs 是 wadewarren/gws-claude-plugin 插件中用于操作 Google Docs 的技能，定位为「读取和写入文档」。它把 Google Docs API 的资源与方法通过命令行暴露出来，方便在脚本或智能体工作流中对文档进行读取和修改。
前置条件
使用前需要先阅读 ../gws-shared/SKILL.md，其中包含认证方式、全局参数以及安全规则。如果该文件不存在，可运行以下命令生成：
gws generate-skills
调用形式
gws docs <resource> <method> [flags]
辅助命令
+write：向文档追加文本。
API 资源
文档相关的方法包括：
- batchUpdate：对文档应用一个或多个更新。每个请求在应用前都会被校验；如果任一请求无效，则整个请求将失败且不会应用任何内容。部分请求会返回回复，以提供关于其应用方式的信息；其他请求无需返回信息，各自返回空回复。回复的顺序与请求顺序一致。
- create：使用请求中给定的标题创建一个空白文档。请求中的其他字段（包括提供的任何内容）会被忽略。返回创建出的文档。
- get：获取指定文档的最新版本。
使用方式
在调用任何 API 方法前，建议先查看该方法：
浏览资源与方法
gws docs --help
查看某方法所需的参数、类型和默认值
gws schema docs.<resource>.<method>
根据 gws schema 的输出构建 --params 和 --json 标志。
适用场景
适用于需要通过命令行或自动化流程读取 Google 文档内容、创建新文档、向文档追加文本或对文档进行批量更新的场景。
限制
- 使用前必须完成 gws-shared 中描述的认证与安全配置，否则无法正常调用。
- 本资料未提供具体的收费、价格、平台支持范围或性能效果信息。
- 本资料未提供更详细的示例、参数取值说明或错误处理说明。