适用场景

当用户需要将 Microsoft Word 作为实时运行的应用程序进行控制，而非仅将其视为一个 .docx 文件格式时使用本技能。
Agent 通过官方 osascript CLI 实现应用挂载、活动文档状态管理、基于选区的编辑、批注操作、修订跟踪、导出及干净退出等功能。
若主要产出为离线生成 DOCX 文件或进行结构性文件编辑，请改用 word-docx。

架构

内存数据存储于 ~/word/ 目录下。若该目录不存在，请先运行 setup.md。目录结构详见 memory-template.md。

~/word/
├── memory.md             # 环境事实、安全默认值及最近有效的控制路径
├── incidents.md          # 可复用的失败案例与已验证的恢复步骤
└── document-notes.md     # 关于可信文档、视图及导出目标的非敏感笔记

快速参考

仅加载与当前 Word 任务及风险等级相匹配的最小必要文件。

前提要求

• 本地已安装 Microsoft Word。
• 运行 macOS，且系统中可用 osascript。
• 执行破坏性文档操作前需获得显式确认。

核心规则

1. 根据文档状态选择应用控制路径

• 使用 osascript 通过 Word 应用自身的脚本字典（scripting dictionary）实现对实时 Word 文档的控制。
• 保持自动化逻辑在实时 Word 会话内执行，避免回退至仅处理 DOCX 文件的工具链。
• 当所请求的任务依赖当前活跃 Word 应用的状态时，不得切换至离线文档库。

2. 执行操作前明确识别目标文档与视图

• 确认目标是当前活动文档、某个已命名的打开文档，还是需立即打开的指定路径文档。
• 在执行与光标位置或标记状态相关的编辑前，须读取当前视图、选区及审阅模式。
• 切勿假定最前端的 Word 窗口即为预期目标文档。

3. 先读再写，随后验证最终状态

• 执行变更前，预读文档名称、当前选区、目标段落、批注数量或导出目标等关键信息。
• 完成编辑、添加/删除批注、接受/拒绝修订或导出后，重新读取受影响的状态，并报告具体变更内容。
• 若 Word 未能达到预期状态，应立即中止并诊断问题，而非叠加更多操作。

4. 将基于选区的操作视为高风险行为

• 基于选区的命令可能作用于错误的段落、故事区域（story range）、页眉/页脚或批注气泡中。
• 尽可能将操作锚定到具体的文档对象（如特定段落、表格或样式），而非仅依赖当前插入点。
• 若选区上下文存在歧义，须优先澄清。

5. 将可逆的审阅操作与破坏性清理操作分离

• 添加批注、切换视图、导出等操作通常具备可逆性。
• 接受全部修订、拒绝全部修订、删除全部批注、不保存关闭文档、覆盖式导出等操作需获得显式确认。
• 若审阅状态具有业务意义，在用户未明确要求更改前，应保留修订跟踪开关及显示设置。

6. 显式维护操作溯源信息

• 说明目标文档是原本已打开，还是仅为本次任务临时打开。
• 报告被修改的文档、当时激活的审阅模式，以及导出文件的实际写入位置。
• 保留用户自主打开但不在本次任务范围内的其他文档。

7. 干净恢复，避免残留应用会话

• 若仅为本次任务启动 Word，需明确归属关系，并仅关闭自身创建的资源。
• 若附加至已有会话，则不得关闭无关文档，亦不可在未经显式批准的情况下退出 Word。
• 发生故障时，须准确记录阻塞原因：受保护文档、模态对话框、兼容模式、修订跟踪状态不一致，或缺失必要权限等。

Word 常见陷阱

• 将实时文档当作静态 .docx 文件处理 → 导致审阅状态、批注、域字段及视图上下文逐步失配。
• 未验证选区即基于当前光标位置执行写入 → 文本可能落入错误的故事区域（story range）。
• 全局接受或拒绝修订，而实际仅需处理某一部分 → 造成不可逆的编辑内容丢失。
• 未更新域字段、参考文献或目录（TOC）即执行导出 → 输出陈旧结果并误作终稿交付。
• 自动化完成后关闭已附加的用户会话 → 中断用户正在进行的其他写作工作。
• 忽略“受保护的视图”（Protected View）或“修订跟踪”模式 → 编辑操作静默失败，或生成错误的标记历史。

安全与隐私

始终保留在本地的数据：

• 存储于 ~/word/ 中的文档路径、环境备注及可复用修复方案。
• 通过本地 Word 自动化访问的文档内容。

可能离开您设备的数据：

• 本技能本身默认不会上传任何数据。
• 文档内嵌的链接、加载项（add-ins）、宏（macros）或云备份自动保存（cloud-backed autosave）行为可能主动连接外部系统。

本技能明确不执行以下操作：

• 调用 Microsoft Graph、云文档 API 或 OAuth 流程。
• 静默禁用审阅警告。
• 在无显式确认前提下接受影响整份文档的破坏性变更。
• 绕过 Word 的保护提示（如 Protected View 提示）。

相关技能

若用户确认，可通过 clawhub install 安装以下技能：

• word-docx —— 当无需保持 Word 持续运行时，用于离线生成和编辑 DOCX 文件。
• office —— 面向更广泛的 Office 任务路由能力，覆盖文档、电子表格与演示文稿。
• applescript —— 当 Word 脚本字典（scripting dictionary）相关任务需深度脚本设计时，提供 macOS 应用自动化通用模式。

反馈

• 若本技能有用：clawhub star word
• 保持更新：clawhub sync