SuperAPI AI 工具集

docs

办公与效率

查看项目

更新于 10-16 08:42

技能介绍

用途:使用 goog docs 系列命令创建与编辑原生 Google Docs,面向专业报告、备忘录、提案、指南等文档。

必要用法:以 goog-cli 仓库中的 target/debug/goog 或 cargo run -- 为权威命令面。写前先确定文档目的、受众、内容结构与视觉层级;任何实时变更前运行 target/debug/goog auth list 记录活动账号;首次变更前运行 target/debug/goog docs --help 及相关嵌套 --help。优先使用高层 goog docs 命令而非 batch-update;支持的编辑先 dry run 再应用;结构编辑后重新 map 文档,因为索引与条目编号会变化。

命令入口:create 建空白文档,get 取原始结构与修订元数据,map 取可读内容位置/标题/表格/图片,text 用于搜索、插入、替换,style apply 设置文本与段落样式,table 插入与填充表格,image、break、footnote、header、footer、list-format、named-range 对应各自文档功能。仅当无高层命令支持时才用 batch-update,临时 JSON 请求体存于任务本地暂存区并在验证后删除。新建或大幅改写前阅读 references/quality.md,选择命令或位置选择器时阅读 references/commands.md。

编辑安全:命令支持时可用文档 ID 或完整 URL;默认使用 goog auth list 所示活动账号,用户指定时可传 --account EMAIL;不得凭浏览器顺序、记忆身份或无关文档推断账号。缺 scope 时运行一次 goog auth login 后重试。用 docs map 检查后再定位内容,优先语义选择器(如 heading:、after-heading:、before-text:、--text)而非原始索引;支持时用 --dry-run --json,多步或可能并发编辑用 --required-revision-id,修订 ID 直接取自命令输出,不得手抄或缩短;受保护写入失败后重取文档地图再重试,每次结构变更后重新获取修订并重新 map。局部编辑保持原有设计,除用户要求重设计。

完成门槛:内容完整一致、标题层级合理、表格用于真实行列对比、列表用原生格式、无占位或重复内容、样式一致可读、已在 100% 缩放逐页检查含页边与页数限制、最后写入后已重新获取实时文档、最终 URL 打开预期文档。检查浏览器只读,避免可变内容的快捷键;无已认证会话时将可视化 QA 报告为受阻,不得声称通过。返回 Google Docs URL 与结果简述,不得在文档中暴露暂存文件、请求体或 QA 备注。限制:资料未提供其他收费、平台或效果信息。