Google Sheets 表格命令助手 Skill 技能

技能简介

googleworkspace-gws-sheets（Google Sheets 表格命令助手） 解决的是"表格 API 命令难发现、难拼对"的问题：Google Sheets 的接口方法多、参数结构杂，直接让 Agent 写请求很容易猜错字段。这个 Skill 引导 Claude、Codex、Claude Code 通过 gws 命令行工具的标准流程操作表格——先用帮助命令发现可用资源与方法，再用 schema 命令查清参数类型和默认值，最后才拼装命令执行，从源头减少"凭感觉写参数"导致的失败。技能由 Google Workspace 官方仓库维护，Skillstore 质量评分 82 分（silver 档），riskLevel 为 safe，MIT 许可，已完成安全审计（23 条静态告警经人工复核全部为误报）。

核心能力

• 资源发现：通过 gws help 系列命令列出 Sheets 支持的资源、方法与标志位，不用翻文档猜接口。
• 参数透视：用 gws schema 查看每个方法的必填参数、类型与默认值，构建请求前先确认结构。
• 创建表格：按标题创建新的电子表格，并回读校验创建结果是否符合预期。
• 读取表格：按表格 ID 或数据过滤条件检索表格内容，支持精确范围读取。
• 批量更新：先检查 batchUpdate 的 schema 要求，再提交经过校验的多条变更，并识别原子性失败风险。
• 能力分流：读取单元格值、追加行等细粒度操作会引导到配套的 read / append 辅助技能处理。

安装配置

1. 在终端执行 npx skillstore add googleworkspace/gws-sheets 完成安装。
2. 前置条件一：机器上需要已安装 gws CLI，以及安装过程中生成的共享鉴权技能。
3. 前置条件二：需要有效的 Google Workspace 凭据，且对目标表格拥有读写权限。
4. 适用工具为 Claude、Codex、Claude Code；技能涉及外部命令与网络访问，建议在受控环境运行。

使用步骤

1. 摸清命令：让 Agent "列出 gws 的 Sheets 资源与方法，并说明下一步该查什么"。
2. 读取数据：给出表格 ID 与目标范围，请 Agent 先检查方法 schema 再生成读取命令。
3. 创建表格：指定标题，要求 Agent 准备创建命令、说明必填参数与预期返回。
4. 规划批量更新：给出表格 ID 与更新目标，让 Agent 检查 batchUpdate schema、列出全部子请求并评估原子性风险后再执行。
5. 执行后核对：写操作完成后回读表格，确认变更落地情况。

适用场景

• 日常表格维护：批量补齐字段、规范化日期与格式，减少手工点选。
• 运营数据表搭建：从零创建结构规范的业务表格并验证返回信息。
• 定期报表更新：按固定规则批量刷新数据行，先查 schema 再提交。
• 跨表核对：按 ID 或过滤条件精准读取多个表格做差异比对。
• Agent 自动化：给 Claude Code 一类 Agent 提供"先发现、再确认、后执行"的表格操作规范。

适用人群

Google Workspace 环境下的办公自动化需求方、用 Agent 做运营与数据维护的团队、需要让 AI 安全操作企业表格的 IT 管理员，以及希望减少 Sheets API 拼参数试错成本的开发者。

工作原理

技能内置一套"发现 → 透视 → 执行"的命令纪律：先用 gws help 枚举能力边界，再用 gws schema 把参数类型、必填项、默认值摆在眼前，最后才构造命令。写操作前强制确认表格标识与更新意图，范围、字段掩码、数据过滤一律取最小必要集，batchUpdate 的每个子请求都要先校验再提交。所有变更最终仍受 Google Sheets API 自身的校验与配额约束，技能本身不绕过任何权限体系。

官方链接

• 技能页面：https://skillstore.io/skills/googleworkspace-gws-sheets
• 源码仓库：https://github.com/googleworkspace/cli/tree/main/skills/gws-sheets/
• 安装命令：npx skillstore add googleworkspace/gws-sheets