用途:从 JSON 计划向 Google Doc 批量发布 N 条锚定评论,每条评论附着在文档正文的某个唯一子串上,可选 @提及协作者。适合一次性添加大量评论(如清单审计);盈亏平衡点约 5 条评论,更少时建议直接在文档中手动输入。
主要能力:通过 chrome-cdp 技能复用用户已登录的浏览器会话;支持 --list 查找文档标签页、按目标前缀或 --url 指定文档、--dry-run 仅校验计划不发布;逐项输出结果,失败项写入 <plan>.residual.json 便于重试。
使用方式:计划为 JSON 数组,每项含 anchor(文档正文子串,取首个匹配)、text(评论正文,可用 \n 换行)、mentions(可选邮箱列表,会作为 +email@… 芯片前置,Google Docs 自动解析并通知)。命令示例:${CLAUDE_PLUGIN_ROOT}/skills/gdocs-comment/gdocs-comment --list;gdocs-comment 312C822D plan.json;gdocs-comment --url https://docs.google.com/document/d//edit plan.json;gdocs-comment --dry-run plan.json。
前置条件:已安装 chrome-cdp 技能(包装器自动发现 cdp.mjs,或设置 $CDP_BIN);Chrome/Brave/Edge 开启远程调试;浏览器中打开已登录且有评论权限的 Google Doc 标签页;Node.js 22+。
限制:仅支持一次性评论,不支持回复或解决线程;锚点取首个匹配,需足够唯一;标签页必须在前台,否则退出码 75;若存在未发送的人工草稿会拒绝启动(退出码 1);依赖 Google Docs 当前 UI 结构,重大改版需重新适配;以标签页登录账号发布;运行期间勿在文档中输入或点击。退出码:0 全部成功,1 至少一项失败,2 用法/计划校验错误,75 标签页仍隐藏。