SuperAPI AI 工具集

gogcli-ops

办公与效率

查看项目

更新于 10-15 17:33

技能介绍

用途:规范 gogcli 在 Google Workspace 命令行操作中的使用流程,覆盖 Drive、Sheets、Docs、Slides,适用于检查、列出、搜索、导出、读取或更新文件等场景。

主要能力与用法:先确认工具可用(gog --version),列出账号(gog auth list),多账号时用 --account <email> 明确指定。用 python3 scripts/gog_parse_url.py "<url-or-id>" 将 URL 解析为 ID,并识别目标类型(sheet/doc/slide/file/folder/id/unknown)。随后执行最小只读命令确认访问权限:Sheets 用 gog sheets metadata <spreadsheetId>,Docs 用 gog docs info <docId>,Slides 用 gog slides info <presentationId>,Drive 文件/文件夹用 gog drive get <fileId> 或 gog drive permissions <fileId>。

常用命令:Drive 支持 gog drive ls、gog drive search "<query>"、gog drive download <fileId>;Sheets 支持 gog sheets get <spreadsheetId> <range>、gog sheets export <spreadsheetId>;Docs 支持 gog docs cat <docId>、gog docs export <docId>;Slides 支持 gog slides export <presentationId>。输出可用 --plain 获得稳定 TSV,--json 获得结构化结果,非交互流程用 --no-input 避免挂起。

限制与错误处理:写操作(update/append/clear/format/move/share/delete)必须获得用户明确确认并指定精确范围。遇到 403/404 时,应检查账号(gog auth list)、权限(gog drive permissions <fileId>)和 ID 是否正确;若访问失败,需请用户将文件共享给所选账号或提供正确账号。若解析类型为 unknown,应要求直接提供 ID 或更换 URL。更多命令可参考 ${CLAUDE_SKILL_DIR}/references/gogcli-cheatsheet.md。