核心用法
本 skill 专为实时控制 Microsoft Word 应用程序设计,区别于静态 .docx 文件处理。通过 macOS 原生的 osascript 调用 Word 的 AppleScript 字典,实现对活动文档、选区状态、批注、修订追踪、导出等功能的精确操控。
关键工作流包括:
- 会话管理:连接现有 Word 实例或按需启动,明确标记文档来源(用户已打开 vs. 脚本新建)
- 状态感知操作:每次写入前预读文档名称、当前选区、视图模式、修订状态;操作后验证变更并报告
- 选区锚定:优先通过文档对象(段落、章节、批注范围)定位,避免依赖易漂移的光标位置
- 审阅动作分级:将添加批注、切换视图、导出标记为可逆操作;接受/拒绝全部修订、删除批注、覆盖导出、关闭不保存等需显式确认
- 清洁退出:仅关闭脚本创建的文档,保留用户原有工作会话,失败时记录具体阻塞原因(受保护文档、模态对话框、权限缺失等)
显著优点
1. 实时交互能力:直接操作 Word 应用状态,支持修订模式、批注气泡、字段更新等 DOCX 库无法触及的功能
2. 防御性设计:强制"先读后写"模式,配合双重验证防止误操作;显式区分可逆与不可逆动作
3. 会话隔离:清晰的"附件归属"策略,避免自动化意外中断用户正在进行的写作工作
4. 故障可恢复:incidents.md 记录已知失败模式与验证恢复步骤,支持问题快速定位
潜在局限
- 平台锁定:仅支持 macOS,依赖本地 Word 安装与
osascript环境 - UI 依赖:受 Word 前端状态影响(模态对话框、受保护视图、兼容模式)可能阻塞脚本执行
- 无云能力:不涉及 Microsoft Graph 或云端文档 API,无法处理基于云的协作场景
- 学习成本:需理解 Word AppleScript 字典的对象模型(document/selection/story range/comments 等层级)
适合人群
- 需要自动化处理含修订追踪、批注的正式文档的编辑/法务/出版工作者
- 需在导出前强制更新域、目录、引用的技术文档撰写者
- 希望将 Word 集成至本地 macOS 工作流(如结合 Shortcuts、Alfred 等)的效率用户
- 不适合:仅需批量生成静态 DOCX 的开发者(应选用
word-docxskill)
常规风险
| 风险场景 | 缓解机制 |
|---------|---------|
| 选区漂移导致文本写入错误位置 | 强制对象锚定,禁止纯光标相对写入 |
| 全局接受/拒绝修订造成不可逆编辑损失 | 显式确认+范围限定双重检查 |
| 导出前未更新字段导致内容过时 | 预检查 TOC/引用状态,强制更新后导出 |
| 误关用户原有 Word 会话 | 文档归属标记,仅清理脚本创建的资源 |
| 受保护文档或模态对话框阻塞 | 失败时记录具体状态,不自动重试或绕过 |