谷歌文档助手

要解决什么问题

在 Agent 或自动化流程里，经常需要按标题创建文档、按名称或内容检索已有 Doc、用 Markdown 整篇替换正文、批量查找替换占位符，或导出 PDF、从模板复制再填内容。直接对接 Google Docs API 要处理 OAuth、batchUpdate 请求体与 Drive 搜索语法，成本高。本技能通过 Rube MCP（Composio googledocs toolkit） 把常用操作封装成固定工具名，并在文档里约定先查 schema、再管连接的工作方式。

技能如何工作

前置：客户端已接入 Rube MCP（https://rube.app/mcp），且能通过 RUBE_MANAGE_CONNECTIONS 把 googledocs toolkit 连到 ACTIVE 状态；执行任何工作流前应先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。

核心能力（与 SKILL 中的 Core Workflows 对应）：

• 新建：GOOGLEDOCS_CREATE_DOCUMENT（title、text）
• 搜索：GOOGLEDOCS_SEARCH_DOCUMENTS（query 使用 Drive 搜索语法，如 name contains 'report'；可配合 max_results、modified_after）
• Markdown 全量更新：GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN（id、markdown）
• 全文替换：GOOGLEDOCS_REPLACE_ALL_TEXT（document_id、find_text、replace_text）
• 导出 PDF：GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF（file_id、filename）
• 复制文档：GOOGLEDOCS_COPY_DOCUMENT（document_id、title）

常见组合：先 SEARCH 拿到文档 ID，再 UPDATE_DOCUMENT_MARKDOWN 或 REPLACE_ALL_TEXT；模板场景用 COPY_DOCUMENT 后 REPLACE_ALL_TEXT；需要读现状时用 GOOGLEDOCS_GET_DOCUMENT_BY_ID，细粒度编辑用 GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT（需自行构造 editDocs）；定点插入用 GOOGLEDOCS_INSERT_TEXT_ACTION（insertion_index 或 append_to_end: true）。分享可与 googledrive toolkit 的 GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE 配合。工具文档见 Composio Google Docs toolkit。

适用边界与注意点

• GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN 会替换整篇内容，不是追加；只适合全文重写。
• INSERT_TEXT_ACTION 依赖精确字符位置；不确定时优先 append_to_end: true。
• UPDATE_EXISTING_DOCUMENT 面向原始 Docs API 的 batch 请求，结构需对照官方 API 文档。
• 同一文档在参数里可能叫 id、document_id 或 file_id，取值相同但字段名因工具而异。
• 未 ACTIVE 的连接会导致调用失败，应先完成 OAuth 链接中的授权流程。