用途:在首次调用 Google Drive、Docs、Sheets 或 Slides 连接器、且任务会创建或修改 Google 文件之前,提供连接器本身缺失的操作指引,避免编辑落到错误位置或产生多余文件。
主要能力:说明各连接器分工——Drive 可创建文件、上传并转换内容、重命名、按文本读取、导出(如 PDF)、搜索、移入回收站,但不能在创建后编辑文件;Docs 可读取完整结构并原地编辑或作为建议;Sheets 可读写值与公式、格式化、添加标签页和图表;Slides 可读取演示文稿并增改幻灯片、形状、文本、表格和链接图表。
使用方式:编辑前先读对应参考文件(Doc 读 references/docs.md,Sheet 读 references/sheets.md,Slides 读 references/slides.md),涉及多个应用时都要读。Docs 与 Slides 读取会返回 revisionId,下一次批量更新需作为 writeControl.requiredRevisionId 传入;被拒则重新读取并重建请求。Sheets 读取不返回 revisionId,写入前重新读取且不带 writeControl。一个逻辑步骤的请求放在一个批次中,批次按序且原子执行。每次编辑后重新读取校验结果。重命名用 Drive update_file,链接保持不变。技能附带 scripts/ 下的辅助脚本(docs_index.py、sheets_helper.py、slides_helper.py、render_export.py),可用 Python 运行,均支持 --help。
适用场景:需要创建或修改 Google 文档、表格、演示文稿,并希望保持同一文件与链接、避免位置错乱或重复文件的任务。
限制:连接器无法看到用户屏幕或当前选中内容;评论读取可能为空,建议模式可能被拒;部分请求列表在描述中被截断;上传内容随调用传输,大文件慢且易失败;图片需 Google 可访问的公开 URL;Slides 图表须先存在于 Sheet 中;Drive 搜索用 title 而非 name;Slides 编辑可能不会立即显示在已打开的演示文稿中。部分行为标注为已报告或未测试,具体以实际连接器为准。