AppleScript

首次使用时，请按照 setup.md 配置激活和安全偏好。设置审查为只读。任何本地文件创建或修改都需要用户明确确认。

何时使用 当用户需要在 macOS 上使用 AppleScript 自动化应用控制、数据提取或脚本化 UI 操作时。Agent 负责脚本设计、安全执行、输出解析和故障排除。

要求 macOS 上可用 osascript。目标应用程序安装并可脚本化。执行破坏性操作前需要用户明确确认。

架构 内存存储在 ~/applescript/ 中。请参阅 memory-template.md 以了解结构。 ~/applescript/ ├── memory.md # 偏好、安全默认值和最后工作模式 ├── snippets.md # 可重用脚本片段 ├── failures.md # 错误签名和已知解决方案 └── app-notes.md # 每个应用程序字典和行为注释

快速参考 仅当当前请求需要更深入的细节时，使用以下文件。 主题 文件 设置行为和入门 setup.md 内存结构 memory-template.md 应用程序字典工作流 app-dictionary-workflow.md 脚本设计模式 script-patterns.md 破坏性操作防护栏 safety-checklist.md 调试和恢复步骤 troubleshooting.md

数据存储 所有本地技能数据存储在 ~/applescript/ 中。在创建或更改本地文件之前，解释写入操作并询问确认。

核心规则

• 选择操作范围

在编写任何脚本之前，分类请求为只读、可逆写或破坏性写。如果范围不明确，在执行之前询问一个消除歧义的问题。

• 发现应用程序词汇

在自动化之前，使用 app-dictionary-workflow.md 中的字典检查工作流。不要猜测应用程序类、属性或命令。

• 确定性地转义动态输入

永远不要将原始用户文本连接到 AppleScript 命令字符串中。对于每个变量，使用 script-patterns.md 中的安全引用模式。

• 保持脚本有界限和可观察

更喜欢具有明确目标和明确输出值的短脚本。返回简洁的结构化输出，以便快速验证结果。

• 写入前读取，写入后验证

对于更新和创建，运行预读以确认目标身份。写入后运行读回检查并报告最终状态。

• 对破坏性操作要求两步确认

在删除、批量编辑或不可逆转的应用程序操作之前，应用 safety-checklist.md。如果缺少确认，停止并明确询问。

• 失败时大声报告并提供可行的恢复

发生错误时，捕获确切的失败命令和错误文本。使用 troubleshooting.md 提供下一步解决方案，而不是通用重试。

常见陷阱 猜测应用程序字典项 -> 脚本编译但在运行时失败。 在用户值中注入未转义的引号 -> 语法错误或错误的命令目标。 在重复项名称上写入而不进行预读 -> 错误的对象被修改。 在启动应用程序后过早运行 UI 自动化 -> 閃斷性失败。 将所有错误视为权限问题 -> 没有进展地重复失败。

安全性和隐私 存储在本地的数据：AppleScript 片段、运行时注释和故障排除内存在 ~/applescript/ 中。 仅为请求的任务所需的命令输出。 默认情况下不会离开您的机器的数据：无。 此技能专注于本地 macOS 自动化。 此技能不执行以下操作： 读取无关的身份验证值。 将自动化数据发送到第三方 API。 在没有明确确认的情况下执行破坏性应用程序操作。

相关技能 如果用户确认，可以使用 clawhub install 安装：macos - macOS 命令和系统操作模式。 automate - 通用自动化工作流设计和可靠性策略。 bash - Shell 脚本帮助器，用于包装和测试命令。 notes - 知识捕获和结构化注释工作流。 files - 具有明确边界的安全文件读写工作流。

反馈 如果有用：clawhub star applescript 保持更新：clawhub sync