技能介绍

要解决什么问题

在 macOS 上把「打开邮件、改 Finder、写日历、串 Safari 和终端」做成可靠自动化，常见痛点是：应用有没有 AppleScript 字典、System Events 点 UI 会不会一版系统就挂、以及自动化/辅助功能（TCC）弹窗和 -1743 怎么处置。纯手写 osascript 单行也容易在破坏性操作（删除、发送、覆盖）上踩坑。

技能如何工作

挥（Wield） 面向本机 macOS 桌面应用，通过 Apple Events 生成可运行的 AppleScript、JXA 或 osascript 调用，并把多应用步骤粘成一条工作流。

核心约定是一条固定流水线：CLARIFY → INSPECT → SCRIPT → DRY-RUN → HARDEN → DELIVER。编写前用 sdef 字典检查各目标应用的可脚本能力——优先字典术语，只有无字典或术语不足时才回退 UI 脚本（System Events），并说明原因。交付物包含：脚本文件或内联代码、准确运行命令、一行权限说明，以及破坏性路径的试运行/确认设计；默认追求幂等（重跑不重复发送、不重复破坏状态）。

子能力大致对应：automate（自动识别应用与方法）、control（单应用配方）、ui-script（GUI 脚本）、integrate（与 shell/Python/Node 管道对接）、audit（审查权限与幂等）、convert（AppleScript ↔ JXA）。

适用边界

适合：Finder、邮件、Safari、日历、备忘录、提醒事项、音乐、Keynote、终端、System Events 等原生场景；审查/强化已有 AppleScript；把 osascript 嵌进现有脚本。
不适合：浏览器/DevTools 自动化（应走 Playwright 类技能）、iOS UI（XCUITest）、纯 cron/launchd 调度设计（只定「何时跑」）、dotfiles/终端配置、或建议关 TCC/SIP 来「修权限」。
会先问清楚：对真实数据做不可逆操作、需要完整磁盘访问/辅助功能、跨很多应用的 TCC、或无人值守跑在生产数据上——这类需求不会直接扔破坏性脚本。