macOS自动化AI技能包

macOS自动化 AI代理 辅助功能API Claude Code 窗口管理

MacPilot 技能包

MacPilot 的 AI 代理技能 —— 一个通过辅助功能 API 实现 macOS 自动化的 CLI 工具。

这些技能教会 AI 编程代理（Claude Code、Cursor、Codex 等）如何使用 MacPilot 来自动化 macOS 任务：点击按钮、输入文本、管理窗口、处理文件对话框、截图等。

安装

npx skills add adhikjoshi/macpilot-skills

使用 skills CLI 将技能安装到你选择的代理中。

可用技能

技能	描述
macpilot-automation	核心 macOS 自动化 —— 鼠标、键盘、应用、菜单、剪贴板（含历史记录与搜索）、通知、Shell、系统控制
macpilot-ui-inspector	通过辅助功能 API 检查并与 UI 元素交互 —— 查找、点击、读取和修改控件
macpilot-dialog-handler	处理原生文件对话框（打开、保存、打印）—— 导航文件夹、选择文件、关闭弹窗、等待并点击主按钮
macpilot-screenshot-ocr	截取屏幕截图、OCR 点击（在屏幕上查找并点击文字）、支持暂停/恢复的屏幕录制
macpilot-window-manager	管理窗口 —— 列出、移动、调整大小、贴靠、全屏、多桌面空间、保存/恢复布局

前置条件

已安装 MacPilot —— 从源码构建或从 releases 下载
辅助功能权限 —— 在「系统设置 > 隐私与安全性 > 辅助功能」中授权 MacPilot.app
屏幕录制权限（用于截图/OCR 技能）—— 在「系统设置 > 隐私与安全性 > 屏幕录制」中授权

快速开始

# 将 MacPilot 技能安装到 Claude Code
npx skills add adhikjoshi/macpilot-skills

# 现在可以让 Claude Code 自动化 macOS 操作：
# "打开 Safari 并导航到 example.com"
# "截取 Finder 窗口的截图"
# "将 VS Code 贴靠到左半边，Terminal 贴靠到右半边"
# "将此文件保存到桌面"

手动安装

如果不想使用 npx skills，可以将任意 SKILL.md 文件复制到代理的技能目录：

# Claude Code（项目范围）
mkdir -p .claude/skills/macpilot-automation
cp skills/macpilot-automation/SKILL.md .claude/skills/macpilot-automation/

# Claude Code（全局范围）
mkdir -p ~/.claude/skills/macpilot-automation
cp skills/macpilot-automation/SKILL.md ~/.claude/skills/macpilot-automation/

许可证

MIT

2.6 KiB Raw Blame History Unescape Escape