Skill Recorder

录一次自己的操作，然后把它变成 AI agent 可以重复执行的 Skill。

Skill Recorder 会捕捉你屏幕上的真实工作过程：点击、应用和窗口切换、访问的页面，以及（如果你愿意）你的语音旁白。然后它使用 GitHub Copilot CLI 把你实际做的事情重构为清晰的意图加上有序步骤列表。从这一步起，只需一次操作就能把单次运行变成 agent 可以复用的东西：

• Skill：一个 agent 按需运行的 SKILL.md 流程，或者
• Automation：同样的流程，按时间表或触发器执行。

两者都优先使用 agent 的原生工具（如 gh CLI 或 web_fetch），而非重放 UI 点击，并且能从你的单个示例泛化，所以录制自己提交一个表单就能教会 agent 提交所有表单。

工作原理

1. 🔴 录制。 点击录制（或从任何地方按 ⌘⇧R / Ctrl+Shift+R），然后只管做你的任务。Skill Recorder 会在后台本地捕捉你的屏幕和活动。
2. 🎛️ 控制。 录制过程中，一个始终置顶的悬浮条显示捕捉和麦克风状态。随时静音、取消静音或切换麦克风，然后结束，如果录制不顺利也可以丢弃（会要求确认）。
3. 🧠 分析。 点击分析，GitHub Copilot 会重构出一个总体意图和有序步骤列表。审阅并编辑，直到内容准确。
4. ✨ 创建。 从已确认的分析结果中，生成可复用的 Skill 和/或定时执行的 Automation。

开始使用

Skill Recorder 以源码发布形式提供：一条命令即可下载固定版本的 Node.js 运行时，在你的机器上构建精确的发布 commit，并添加一个可以随时重新启动的 Skill Recorder (Source) 应用。不会全局安装任何东西。你需要拥有 Copilot access 的 GitHub 账号；Copilot CLI 会随应用一起提供。

macOS 是主要目标平台。Windows 11（x64 和 ARM64）也受支持（详见 WINDOWS-VALIDATION.md）。

安装

打开 latest release，复制适合你平台的命令。每个发布都固定一个确切的 commit，所以实际命令类似于下面的模式，其中 <40-character-release-commit> 会被填充。

macOS / Ubuntu

commit="<40-character-release-commit>"; curl -fsSL "https://raw.githubusercontent.com/microsoft/skill-recorder/$commit/install.sh" | SKILL_RECORDER_COMMIT="$commit" bash

该 commit 同时固定下载的脚本和要构建的源码。如果希望终端关闭后应用继续运行，在管道符后添加 SKILL_RECORDER_DETACHED=1：

commit="<40-character-release-commit>"; curl -fsSL "https://raw.githubusercontent.com/microsoft/skill-recorder/$commit/install.sh" | SKILL_RECORDER_COMMIT="$commit" SKILL_RECORDER_DETACHED=1 bash

在 macOS 上，这会将 Skill Recorder (Source) 应用添加到 ~/Applications（可从 Spotlight、Launchpad 或 Dock 重新启动）。在 Ubuntu 上，会添加一个匹配的应用程序入口。

Windows (PowerShell)

$commit="<40-character-release-commit>"; $env:SKILL_RECORDER_COMMIT=$commit; irm "https://raw.githubusercontent.com/microsoft/skill-recorder/$commit/install.ps1" | iex

这会在你的桌面和开始菜单添加 Skill Recorder (Source) 快捷方式。

然后录制

1. 授予屏幕录制权限。 首次启动时，macOS 会请求屏幕录制权限；授予后即可开始录制。
2. 录制、分析、创建。 执行你的任务，然后点击分析。首次分析时，如果你尚未登录，Skill Recorder 会提示登录 Copilot。

如果想在运行前检查脚本、设置安装选项、更新或卸载，请参见 INSTALL.md。

⚠️ 请勿在录制中包含敏感信息。 不要录制、输入、粘贴或旁述密码、token、API key 或其他机密信息。选择分析后，录制数据会被发送到 GitHub 云端。Skill Recorder 会在每次录制前提醒你。详见 What gets captured。

---

以下内容面向想了解细节或想修改代码的人。

捕捉内容

录制、存储、帧提取和可选的旁白转录全部在你的电脑上完成；录制期间没有任何内容离开本机。只有当你选择分析时，Skill Recorder 才会将事件时间线（窗口/文档标题、URL 和剪贴板预览）、提取的屏幕图像以及旁白文本发送到 GitHub 云端，由 Copilot 处理。

应用内的"录制你的屏幕和活动"面板明确列出了收集的内容：

• 窗口追踪： 活跃应用/窗口切换。
• 浏览器 URL： 你所在的页面（macOS）。
• 屏幕视频： 由 Chromium 录制；仅在屏幕变化或心跳触发时保留低频率快照。
• 剪贴板： 复制的文本的简短预览，用于关联步骤。
• 旁白 (可选)：语音解说，在设备上使用 Whisper 支持的 99 种语言中的任意一种进行转录（首次使用时需一次性下载约 252 MB 的模型）。

⚠️ 请勿捕捉敏感信息。 密码、access token、API key、凭证和其他机密信息绝不应在会话期间被录制、输入、粘贴、展示、复制或旁述。

从源码开发

需要 Node.js 24。检出发布版本后：

npm ci
npm run compliance:licenses
npm run dev

npm run dev 启动 Vite 并以热重载方式启动 Electron 应用；⌘⇧R（macOS）/ Ctrl+Shift+R（Windows）可从任何地方切换录制。完整的手动设置、构建和 dist 脚本，以及本地源码构建与可再分发包之间的许可边界，请参见 INSTALL.md。维护人员修改版本、依赖、资源或发布时，必须遵循 RELEASING.md。

Evals

Copilot describer 和 builders 有一套基于 fixture 的 eval 套件；请参见 evals/README.md。

npm run eval            # score the describer against synthetic recordings
npm run eval:builder    # score the skill/automation generalization

文档

• INSTALL.md： 安装选项、先检查后安装、更新、卸载以及手动开发者设置。
• RELEASING.md： 维护者发布操作手册。
• evals/README.md： describer / builder eval 框架。
• THIRD-PARTY-NOTICES.md： 捆绑依赖的许可证。

安全

请勿通过公开 GitHub issue 报告安全漏洞。请参见 SECURITY.md 了解 Microsoft 的协调披露流程和报告渠道。

支持

通过 GitHub Issues 提交 bug 和功能请求（先搜索现有 issue 以避免重复）。支持范围限于 SUPPORT.md 中描述的资源。

许可证

MIT

贡献

本项目欢迎贡献和建议。大多数贡献需要你同意一份贡献者许可协议（CLA），声明你有权并实际授予我们使用你贡献的权利。详情请访问 Contributor License Agreements。

当你提交 pull request 时，CLA bot 会自动判断你是否需要提供 CLA，并相应地标注 PR（如状态检查、评论）。只需按照 bot 提供的说明操作即可。你只需要在所有使用我们 CLA 的仓库中执行一次此操作。

本项目采用 Microsoft Open Source Code of Conduct。更多信息请参见 Code of Conduct FAQ，或联系 opencode@microsoft.com 咨询其他问题或意见。

商标

本项目可能包含项目、产品或服务的商标或徽标。Microsoft 商标或徽标的授权使用必须遵守 Microsoft's Trademark & Brand Guidelines。在本项目的修改版本中使用 Microsoft 商标或徽标不得引起混淆或暗示 Microsoft 赞助。任何第三方商标或徽标的使用均受相应第三方政策约束。