跳到主要内容
哒哒星球DADA PLANET

Skill · 已公开版本

gws-sheets · 按明确区域读写表格并保护既有内容

确定表格、工作表和单元格范围后整理数据,区分追加值、批量结构修改和实际回读。

先看看示例

作者提供的示例,实际效果取决于你的输入和使用工具。

输入

编辑材料:工作表“流水”第1行表头A日期、B项目、C金额、D累计;第4行A:C已确认空白,D4已有累计公式。本次写入2026-09-30、交通、28,仅允许A4:C4。

输出

编辑示例 · 未运行

单元格待写入值
流水!A42026-09-30
流水!B4交通
流水!C428

目标范围为流水!A4:C4,金额保持数值28。D4现有公式不在本次范围;不插行、不改表头。提交前还需确认日期解析方式,写入后回读A4:C4与D4检查保留情况。当前仅为写入核对稿。

方法说明

确定表格、工作表和单元格范围后整理数据,区分追加值、批量结构修改和实际回读。

具体任务

准备一段明确区域的数据写入:对照现有表头列出目标单元格和值,保留范围外公式与人工内容。

核对一批表格修改:逐项审查请求与返回顺序,按实际区域回读确认内容。

必需材料

spreadsheetId、工作表名与目标范围

现有表头/相关单元格内容及本次待写入数据

可选材料

公式列、人工维护列和格式约束

是否允许实际写入以及值解析方式

使用门槛

拥有目标表格权限,能区分原始值、公式、显示格式及结构修改。

这个 Skill 额外提供的方法

把目标区域与应保留内容写清楚,再从实际单元格回读验收,防止文件存在却数据未落到正确工作表。

编辑示例(未运行)

追加三列交易信息并保留公式列

任务:准备已确定空白行的值写入核对表

输入:
编辑材料:工作表“流水”第1行表头A日期、B项目、C金额、D累计;第4行A:C已确认空白,D4已有累计公式。本次写入2026-09-30、交通、28,仅允许A4:C4。

结果片段:
| 单元格 | 待写入值 |
|---|---|
| 流水!A4 | 2026-09-30 |
| 流水!B4 | 交通 |
| 流水!C4 | 28 |

目标范围为`流水!A4:C4`,金额保持数值28。D4现有公式不在本次范围;不插行、不改表头。提交前还需确认日期解析方式,写入后回读A4:C4与D4检查保留情况。当前仅为写入核对稿。

表格行与数据均为编辑构造,未修改真实Spreadsheet,未计算累计结果。

首次任务

请使用已安装的 gws-sheets Skill。
任务:准备一段明确区域的数据写入。
对照现有表头列出目标单元格和值,保留范围外公式与人工内容。

必需材料:
- spreadsheetId、工作表名与目标范围:[填写或粘贴我的实际材料]
- 现有表头/相关单元格内容及本次待写入数据:[填写或粘贴我的实际材料]

可选材料:
- 公式列、人工维护列和格式约束:[有则补充;缺失时不要假定存在]
- 是否允许实际写入以及值解析方式:[有则补充;缺失时不要假定存在]

处理边界:不读取网格数据时get可能只返回结构信息,不能据此判断单元格为空。;batchUpdate会先校验全部请求,一项无效可使整批失败;空reply不直接等于该项失败。。先指出影响任务的材料缺口;没有实际执行的操作和测试不要写成已完成。

请按以下标准交付可审阅结果:
1. 工作表与范围明确,输入字段逐一对应表头。
2. 范围外公式、人工内容与结构保持约定状态。
3. 实际回读结果与提交数据一致,批量回执按请求顺序解释。

验收方法

工作表与范围明确,输入字段逐一对应表头。

范围外公式、人工内容与结构保持约定状态。

实际回读结果与提交数据一致,批量回执按请求顺序解释。

依赖与准备

需要gws、完整gws-sheets和gws-shared;+read与+append分别依赖兄弟辅助Skill。账号须有表格读/写权限;values与batchUpdate的具体请求、值解析选项先通过gws schema确认。

使用边界

不读取网格数据时get可能只返回结构信息,不能据此判断单元格为空。

batchUpdate会先校验全部请求,一项无效可使整批失败;空reply不直接等于该项失败。

追加或覆盖范围需明确,不能把公式列和人工维护列纳入未经要求的写入。

本站示例由编辑撰写,未运行上游 Skill,不代表平台已完成工具兼容认证。

排错

get结果没有看到单元格内容:检查fields或includeGridData参数,结构读取不等于值读取。

批量请求全被拒绝:先按schema定位无效请求,修正后再提交完整获准批次。

固定来源

https://github.com/googleworkspace/cli/blob/a3768d0e82ad83cca2da97724e46bea4ff0e6dbd/skills/gws-sheets/SKILL.md

许可

Apache-2.0。许可原文:https://github.com/googleworkspace/cli/blob/a3768d0e82ad83cca2da97724e46bea4ff0e6dbd/LICENSE

仓库热度

googleworkspace/cli 仓库 31,208 Stars(2026-09-30 核验);这是父仓库指标,不是单个 Skill 的评分。