Skill to manage and update google sheet

核心用法

Google Sheets Skill 基于官方 Node.js SDK，提供命令行方式操作 Google 表格。核心功能分为四类：

数据操作：read/write/append/clear 实现基础 CRUD，支持 JSON 数组格式读写单元格区域

格式控制：format/getFormat/borders/copyFormat/merge/unmerge 覆盖字体、颜色、对齐、边框、合并单元格等完整格式体系

布局管理：resize/autoResize/freeze 调整行列尺寸与冻结窗格

工作表管理：create/addSheet/deleteSheet/renameSheet 管理多标签结构

显著优点

• 功能完整：覆盖 Sheets API 核心能力，从简单读写到复杂格式复制均可实现
• CLI 直观：命令结构清晰，无需编写代码即可完成批量操作
• 格式灵活：支持 RGB 色彩、多种边框样式、文本格式等精细控制
• 自动化友好：适合集成到 CI/CD 或定时任务中生成报表

潜在局限

• 依赖服务账号：需 Google Cloud 项目、API 启用、JSON 密钥管理，门槛较高
• 无交互授权：仅支持服务账号模式，无法处理 OAuth 用户授权场景
• 格式 JSON 冗长：复杂格式需手写嵌套 JSON，易出错
• 无批量事务：单次命令独立执行，无原子性保证

适合人群

• 需要自动化报表生成的开发者/数据分析师
• 已有 Google Workspace 基础设施的企业团队
• 希望用脚本替代手动表格操作的技术用户

常规风险

• 凭证泄露：服务账号 JSON 密钥权限等同于文件所有者，需严格保管
• 权限扩散：共享给服务账号的表格可被任意修改，建议专用工作表隔离
• 配额限制：Google API 存在调用频次限制，高频场景需关注配额策略

核心用法

Google Sheets Skill 是基于 Node.js 的命令行工具，通过 Google 官方 googleapis SDK 与 Google Sheets API 交互。使用服务账号（Service Account）认证，支持完整的电子表格操作：

• 数据操作：读取单元格、写入数据、追加行、清除范围
• 格式化：单元格样式（颜色、字体、对齐）、边框、合并/取消合并、格式复制
• 布局调整：列宽/行高调整、自动适配、冻结行列
• 表格管理：创建表格、添加/删除/重命名工作表、获取元数据

所有命令通过 node scripts/sheets.js <command> 执行，参数包含表格 ID 和 A1 表示法的单元格范围。

显著优点

1. 官方 SDK 保障：依赖 googleapis@^140.0.0，由 Google 官方维护，API 兼容性和长期支持有保障
2. 功能完整：覆盖 Sheets API 绝大部分功能，从基础读写到复杂格式化均可实现
3. 安全传输：全程 HTTPS/TLS 1.3 加密，OAuth 2.0 服务账号认证，无凭证泄露风险
4. 灵活部署：支持环境变量、配置文件、默认路径三种凭证配置方式，适应不同部署环境
5. 无隐私风险：不收集用户隐私数据，环境变量访问仅限于凭证路径配置

潜在缺点与局限性

1. 配置门槛：需完成 Google Cloud 项目创建、API 启用、服务账号配置、表格共享等步骤，对非技术用户有一定门槛
2. 权限粒度：服务账号需要完整的表格编辑权限，无法针对单个操作进行细粒度授权
3. 无内置重试：网络波动或 API 限流时需自行处理重试逻辑
4. 输入验证有限：spreadsheetId 等参数缺乏格式校验，可能产生无效请求
5. 依赖外部服务：完全依赖 Google Sheets 服务可用性，无离线能力

适合人群

• 需要自动化处理 Google Sheets 数据的开发者和数据分析师
• 构建数据流水线、报表自动生成系统的工程师
• 熟悉 Node.js 和命令行工具的技术用户
• 有 Google Workspace 环境的企业团队

常规风险

• 403 错误：表格未与服务账号邮箱共享，需在 Google Sheets 中手动添加共享权限
• 权限扩散：服务账号凭证文件需妥善保管，泄露可能导致表格数据被篡改
• API 配额：Google Sheets API 有默认配额限制，高频操作需申请提升配额
• 数据持久性：write 和 clear 操作会直接覆盖数据，建议操作前备份重要表格