用途:让一份 .docx 走完评审周期,同时保持 Ane 的格式完整,且每处改动都可在写回文件中核验。所有 Office 操作由 ane_package.officeops 承担,本技能只提供判断逻辑;调用签名见 references/officeops-api.md。
模式路由:read(只读,渲染文档及其批注,给出专家意见);annotate(把发现写成边注,作者默认 Ane Gasser,写入工作副本并保留备份);track(生成带修订标记的副本,供对方逐条接受或拒绝);revise(Ane 已确认的修改就地应用);annex(追加术语表与来源附录)。模式可串联:read 产出发现,annotate 写入边注,track 或 revise 应用为编辑。模式不明确时先问一句。
主要能力与用法:read 用 python scripts/review_pass.py read <path> --out review.md 渲染批注,先读全文再读批注,逐条归入同意、反驳或重构三类,并补充遗漏发现。annotate 将 [{"match": "...", "text": "..."}] 写入 comments.json 后运行 python scripts/review_pass.py annotate <path> --comments comments.json --author "Ane Gasser";锚点须为五个以上连续词且只命中一个段落,失败即整体报错并列出坏锚点,应重选而非放宽。track 用 python scripts/review_pass.py track <path> --edits edits.json --author "Ane Gasser" --out marked-up.docx,只写副本;须用 read_revisions 验证,不能用 paragraph.text。revise 用 python scripts/review_pass.py revise <path> --edits edits.json,文件须在 Word 中关闭,自动写时间戳备份;用 verify 检查品牌、页眉页脚、孤立超链接与字数。annex 的术语表须从文档本身构建,来源附录的链接须在本会话用 WebSearch 或 WebFetch 验证,无法验证的标注 ⚠️ URL unverified。
限制:不得编造事实;不得重新生成文档;验证必须在写回文件上进行;PDF 导出默认拒绝,因 ExportAsFixedFormat 在部分文档上会挂起,需由 Ane 手动从 Word 导出;驱动只能新增批注,就地改写已有批注文本暂不支持;Windows 路径须用 C:/Users/... 形式;锚点匹配区分弯引号等字符。报告采用 EDIT-PRESERVATION DELIVERY 格式,说明改了什么、未动什么及范围外观测。