Spreadsheet

核心用法

Spreadsheet Skill 提供跨平台的电子表格处理能力，支持 Google Sheets API、Excel (.xlsx) 及 CSV 三种主流格式。采用"Schema First"设计理念，首次访问任何表格时会自动记录列结构（名称、类型、样本值）并保存至本地项目配置，为后续操作建立智能上下文。

核心功能包括：单元格读写、公式处理、数据导入导出、本地化格式适配（数字千分位、日期格式等）以及大表分页策略。对于超过 1000 行的数据集，系统采用采样查询或分页加载机制防止内存溢出。

显著优点

1. 格式智能保留：更新单元格时不破坏现有格式，自动匹配用户地域的数字与日期显示习惯
2. 结构化记忆：通过 ~/spreadsheet/ 目录持久化存储项目模式、偏好设置和最近访问记录
3. 多平台兼容：Linux/macOS/Windows 全支持，优先 Google Sheets API，降级至本地 Excel 或 CSV
4. 风险预警机制：大表加载前确认、公式覆盖保护、7天模式漂移检测等设计减少误操作

潜在局限

• 依赖用户主动配置 Google Sheets API，无内置认证流程
• 大表性能受网络/本地 IO 限制，>10000 行建议分批处理
• 公式处理在 Excel 与 Google Sheets 间存在行为差异（如日期序列号）
• 欧洲文件编码（BOM）需手动检查，非完全自动化

适合人群

数据分析师、项目经理、财务/运营人员及任何需要自动化表格处理、跨平台数据同步或结构化信息追踪的用户。特别适合已使用 Google Workspace 或需定期生成标准化报告的场景。

常规风险

• API 速率限制：Google Sheets 默认 100 请求/100 秒，需批量操作
• 凭证管理：需用户自行保管 API 密钥，工具不存储密码
• 模式漂移：长期未访问表格（>7 天）建议重新验证列结构
• 数据完整性：公式读取时需注意 data_only 参数避免意外值丢失

核心用法

Spreadsheet 是一款专注于电子表格操作的纯文档型 Skill，通过结构化指引帮助用户高效处理 Google Sheets、Excel（.xlsx）及 CSV 文件。其架构以 ~/spreadsheet/ 目录为记忆中枢，自动维护项目级 schema 配置、用户格式偏好及历史操作记录。

关键特性：

• Schema 优先：首次访问任何表格即自动记录列定义、数据类型及样本值，后续操作直接引用，避免重复分析
• 格式智能保留：严格遵循用户 locale 设置（千分位/小数点格式）、日期格式偏好，公式写入永不覆盖除非明确授权
• 大数据策略：内置分级加载机制——<1,000行全量加载，1,000-10,000行采样+定向查询，>10,000行强制分页并预警
• 三平台兼容：Google Sheets（需 API 配置）> Excel（openpyxl）> CSV 通用回退

显著优点

1. 零代码风险：纯 Markdown 文档型实现，无可执行脚本或动态加载，从根本上杜绝代码注入、恶意调用等风险
2. 隐私设计优秀：所有用户数据严格隔离于 ~/spreadsheet/ 目录，明确承诺不存储密码、API 密钥或敏感财务数据
3. 操作可追溯：memory.md 与 projects/{name}.md 形成完整操作审计链，schema 漂移超 7 天自动触发重验证提醒
4. 防误触机制：大**据加载前强制确认、公式读取使用 data_only=False 防丢失、批量请求遵守 Google API 100/100s 限流

潜在缺点与局限性

• 纯指导性依赖：无原生执行能力，实际数据处理仍需用户本地安装 pandas、openpyxl 或配置 Google OAuth，对纯新手存在环境搭建门槛
• T3 来源等级：个人开发者维护（ivangdavila），无开源仓库关联，长期更新持续性依赖 ClawHub 平台
• 网络 API 局限：Google Sheets 集成需用户自行完成 OAuth 流程，Skill 仅提供示例代码而非封装 SDK
• 实时协作盲区：未涉及 Google Sheets 实时协作冲突处理、版本历史管理等高级场景

适合人群

• 数据分析师：需频繁迁移本地 Excel 与云端 Google Sheets 的工作流
• 办公自动化开发者：寻求结构化代码示例（pandas/openpyxl）及最佳实践参考
• 隐私敏感用户：要求数据不出本地目录、拒绝第三方服务器处理的场景
• 中小团队：需标准化电子表格 schema 管理、减少「表格结构口头约定」的协作成本

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 数据泄露 | 极低 | 无网络上传行为，用户数据仅存本地 |

| 恶意代码 | 无 | 纯文档型，无可执行组件 |

| 功能误用 | 低 | 大**据加载需确认，但用户仍需自行评估本地内存承载能力 |

| 依赖过时 | 中 | pandas/openpyxl 示例代码可能随库版本迭代需手动更新 |

| 服务中断 | 低 | Google API 调用依赖用户自有凭证，无 Skill 服务端单点故障 |