googledocs-automation

googledocs-automation skill 概览

googledocs-automation 能做什么

googledocs-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP 控制 Google Docs。它可以帮助 agent 创建文档、搜索现有 Docs、更新文本、复制文件、导出内容，并管理文档工作流，而不必依赖浏览器点击操作。关键要求是：agent 必须先使用 Rube 的实时工具发现能力，因为 Google Docs 工具 schema 可能会变化。

适合的用户和任务

这个 googledocs-automation skill 最适合希望在已连接的 Google Workspace 账号内进行 AI 辅助文档操作的用户：比如把会议纪要起草到一个 Doc 中、按标题或内容查找合同、导出文档、在编辑前创建副本，或更新共享的协作文档。它尤其适合那些具有操作性、可重复，并且绑定到真实 Google Docs 文件的任务，而不只是生成一段文本。

采用前的重要要求

该 skill 依赖可用的 Rube MCP 连接以及 googledocs toolkit。使用前，你的客户端必须暴露 RUBE_SEARCH_TOOLS，并且 Google Docs 连接必须已通过 RUBE_MANAGE_CONNECTIONS 激活。如果你的环境无法运行 MCP tools、无法完成 Google Docs 认证，或者只需要离线起草文档，那么相比普通写作 prompt，这个 skill 带来的价值并不大。

如何使用 googledocs-automation skill

googledocs-automation 的安装场景

在与你的 Claude-compatible skill 设置相匹配的环境中，从 Composio skill collection 安装该 skill，例如：

npx skills add ComposioHQ/awesome-claude-skills --skill googledocs-automation

然后在客户端中将 https://rube.app/mcp 添加为 MCP server，以配置 Rube MCP。上游 skill 说明 MCP endpoint 不需要 API key，但你仍然需要授权 Google Docs toolkit connection。设置完成后，让 agent 验证 RUBE_SEARCH_TOOLS，针对 toolkit googledocs 调用 RUBE_MANAGE_CONNECTIONS，并且只有当 connection status 为 ACTIVE 时才继续。

这个 skill 需要哪些输入

为了可靠地使用 googledocs-automation，请向 agent 提供文档目标、目标文档身份、操作类型以及输出约束。一个较弱的 prompt 是：“Update my Google Doc.” 更好的 prompt 是：“Use googledocs-automation to find the Google Doc titled Q1 Partner Brief, make a copy before editing, replace the outdated pricing section with the text below, preserve the rest of the document, and report the final document link.”

创建文档时，请提供标题和初始文本。搜索文档时，请提供可能的标题关键词、内容短语、已知的所有者或共享线索，以及日期限制。编辑文档时，请明确是追加内容、替换某个 section、先创建副本，还是导出而不修改原文件。

推荐工作流

每次会话开始时，都应指示 agent 先搜索 Rube tools：“Before calling any Google Docs action, run RUBE_SEARCH_TOOLS for current Google Docs schemas.” 这一点很重要，因为该 skill 的源文件强调要进行实时 schema 发现，而不是假设参数固定不变。

一个实用的工作流是：

1. 确认 Rube MCP 可用。
2. 确认 googledocs connection 为 ACTIVE。
3. 针对当前要执行的具体 action 和 schema 搜索 tools。
4. 搜索或创建文档。
5. 执行编辑、复制、导出或更新操作。
6. 让 agent 总结变更内容，并提供返回的 document IDs 或链接。

优先阅读的仓库文件

仓库路径是 composio-skills/googledocs-automation，最需要查看的主文件是 SKILL.md。在提供的结构中没有可见的支持目录，例如 references/、scripts/、rules/ 或 resources/，因此这个 skill 比较精简。先阅读 SKILL.md，了解前置条件、设置方式以及命名的 Google Docs 工作流；最终参数细节则应以实时 RUBE_SEARCH_TOOLS 输出为准。

googledocs-automation skill 常见问题

googledocs-automation 适用于 Office Documents 吗？

“googledocs-automation for Office Documents” 这个说法可能会让人误解。该 skill 面向的是通过 Google Docs toolkit 操作 Google Docs，而不是 Microsoft Word 或本地 Office 文件。如果你的工作流会把导入的 Office 文档存储为 Google Docs，它可能会有帮助；但除非已连接的 tools 暴露了受支持的导出或转换路径，否则它并不是通用的 DOCX 自动化层。

它比普通 prompt 好在哪里？

普通 prompt 可以起草文本，但如果没有工具访问权限，它无法安全地查找、创建、复制、编辑或导出真实的 Google Docs。googledocs-automation skill 增加的是一套流程性指导：如何使用 Rube MCP、检查认证状态、发现当前 Google Docs tool schemas，并选择 create、search、update、copy 或 export 等操作。

对新手友好吗？

如果你的 AI 客户端已经支持 MCP tools，并且你能接受类似 OAuth 的连接流程，那么它对新手是友好的。如果你从未配置过 MCP，它就不那么适合入门，因为该 skill 假设 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS 已经可用。上游文件本身很短，因此设置问题更可能来自你的客户端或账号权限，而不是 skill 文本。

什么时候不该使用这个 skill？

不要把它用于纯离线写作、你无权暴露给 AI 工具的敏感文档、需要视觉检查的复杂版式编辑，或要求格式一定完整保留的工作流。如果你无法清楚识别目标文档，也应避免使用；搜索结果含糊时，除非要求在修改前确认，否则可能会编辑到错误文件。

如何改进 googledocs-automation skill

改进 googledocs-automation prompt

提升 googledocs-automation 结果最快的方法，是给出精确的操作指令。请包含文档标题、是原地编辑还是先复制、要插入的内容、要修改的 section，以及期望的最终回复。例如：“Search for Board Update April, confirm the matching document before editing, append the following risk summary under Open Risks, and return the document URL plus a bullet list of edits made.”

降低常见失败风险

主要失败模式包括：Google Docs 授权未激活、对 tool 参数使用过期假设、文档搜索结果不明确，以及误改共享文件。预防方法是要求 agent 检查 connection status，在选择 action 前调用 RUBE_SEARCH_TOOLS，当搜索不确定时展示候选匹配项，并在进行高风险修改前先创建副本。

首次输出后继续迭代

第一次运行后，要求 agent 给出一份简洁的执行报告：使用过的 tool names、目标 document identifier、已完成的修改、跳过的步骤以及任何错误。如果结果不完整，用更具体的搜索词、精确替换文本或权限约束来细化 prompt。对于高价值文档，建议采用两步流程：先搜索并制定计划，再批准执行编辑。

建议的 skill 增强方向

如果能为每种工作流提供示例 prompt、加入“编辑前先复制”的安全模式、给出处理多个搜索匹配项的指导，并补充常见 Rube MCP connection states 的排障说明，这个 skill 会更强。再增加一个将目标映射到 action 的小型决策表——create、search、copy、update、export——也能帮助 agent 减少猜测，更准确地触发对应的 Google Docs tool。