SkillRecorder 使用教程

📖 项目简介

Skill Recorder 是微软开源的桌面软件，MIT 协议。你在电脑上把一件重复的活正常做一遍，它在旁边记下你切了哪个窗口、打开了哪个页面、复制了什么，再整理成一份给 AI 看的教程。

它记的不是鼠标坐标。整理出来的是「一句意图 + 有顺序的步骤」，并且优先让 AI 用命令行和接口去完成，所以换一台电脑、界面稍有变化，还能接着用。你录一次，同类的活它都会做。

录制过程的数据留在你自己电脑上。只有你点「分析」时，记录才会交给 GitHub 上的 Copilot 去整理。生成的教程文件可以放进 Codex 的技能目录，以后说一句话就能按同样的步骤再做一遍。当前版本是 v0.7.0。

📎 相关链接与下载地址（点击展开）

仓库：
github.com/microsoft/skill-recorder

最新 Release（v0.7.0，2026-09-21）：
Release v0.7.0

Windows 11 安装命令（整段复制到 PowerShell）：

$commit="b05d59036182e897e1a60e90651e775cf5f97e8d"; $env:SKILL_RECORDER_COMMIT=$commit; irm "https://raw.githubusercontent.com/microsoft/skill-recorder/$commit/install.ps1" | iex

macOS / Ubuntu 安装命令：

commit="b05d59036182e897e1a60e90651e775cf5f97e8d"; curl -fsSL "https://raw.githubusercontent.com/microsoft/skill-recorder/$commit/install.sh" | SKILL_RECORDER_COMMIT="$commit" bash

安装脚本校验：install.ps1 的 SHA-256 为 7678f7f8d38d600f2fb732f95afeadc8aa4f9b9802989d26e2f932970795770c。
更多教程：关注公众号 / 抖音 / 视频号「IT小圈」

✨ 核心亮点

👀

做一遍就会

不用先把步骤打成文字。你正常做完，它写成教程。

💻

录制留在本机

窗口、网址、剪贴板和截图先存在自己电脑上，点分析才上传。

📋

记步骤不记坐标

优先用命令和接口，不回放鼠标。换台电脑也能跑。

⏰

还能定时跑

同一套步骤可以生成教程，也可以生成到点自己跑的任务。

🧩 它能做什么、输出什么

项目	说明
输入	你在桌面上的一次真实操作：窗口切换、浏览器网址（macOS）、剪贴板短预览、屏幕变化时的截图。可选语音旁白，也可从悬浮条打开一个被记录的终端。
适用类型	会重复做的电脑操作。一个例子会泛化成一类任务，比如录一次提交一张表，同类的表都会提交。
输出	一份 SKILL.md 教程（AI 按需执行），或一个 Automation（同一套步骤挂到定时或触发）。
语言 / 兼容	语音旁白支持 Whisper 的 99 种语言，转写在本机完成。界面本身是英文。
规格 / 容量	分析由固定版本的 GitHub Copilot CLI（1.0.78）完成。终端记录没有应用自己设的长度上限，算进这次会话的本地存储。

🖥️ 环境要求

环境	建议配置
操作系统	Windows 11（x64 或 ARM64）。macOS 是主力平台，Ubuntu 也能装。
运行环境	不用自己装 Node，也不用装 Git。安装命令会下载固定版本的运行时，在本机构建后建快捷方式。
硬件	普通办公电脑即可。不转写语音就不需要独显。
低配 / 无卡方案	关掉语音旁白。需要旁白时，第一次会在本机下载约 252 MB 的语音模型。
关键依赖	一个能登录 GitHub、并且开通了 Copilot 的账号。分析这一步才会用到。

🚀 如何使用

💡

去最新 Release 页复制 Windows 那一整段命令，粘贴到 PowerShell 回车。装完用快捷键录一遍，点分析，再点生成。

准备

系统用 Windows 11。先准备一个开通了 Copilot 的 GitHub 账号。录之前把密码、密钥从屏幕和剪贴板上清掉。

                        powershell
                        # 开始菜单打开 PowerShell，不用管理员
                    

安装

在 GitHub 搜索 microsoft skill-recorder，打开最新 Release，滚到 Commit-pinned installation，复制 Windows 11 那一整段，粘贴到 PowerShell 回车。不要手改版本号，也不要下 Assets 里的源码压缩包。第一次要几分钟，装完会自己打开，开始菜单里叫 Skill Recorder (Source)。完整命令在本页顶部「相关链接」里。

                        powershell
                        # 整段命令从 Release 页复制，粘贴后回车
# 窗口别关，直到软件自己弹出来
                    

录一遍，再分析

任何地方按 Ctrl+Shift+R 开始录（Mac 是 Command+Shift+R）。像平常一样把那件活做完，再按一次停止。点 Analyze。第一次会跳到浏览器登录 GitHub 的 Copilot，授权完回到软件，它会自动重试这次分析。出来的是一句话加上几条步骤，写错了直接改。

录的时候可以开关的项：

项	作用
`Narrate`	边做边说，本机转成文字。不说就关掉。
`Recorded terminal`	只记录从悬浮条打开的那个终端，不监控你原来开着的窗口。
`Ctrl+Shift+R`	开始或停止录制。

生成教程或定时任务

步骤确认后点生成。可以先点 Review 看完整文件再导出。同一套步骤可以生成一份教程，也可以生成一个到点自己跑的任务。想改内容就改步骤清单，预览会作废，需要重新生成。

                        text
                        # 生成前可以先 Review，确认步骤再导出
# 导出的文件名是 SKILL.md
                    

结合 Codex 使用

把 SKILL.md 放进 Codex 的技能目录。文件开头要有 name 和 description。重启 Codex 后，输入 /skills 或 $技能名调用，也可以直接用一句话描述，让它按描述自己选中这份教程。生成的教程默认偏向 Copilot 的工具名，放进 Codex 之前建议先看一眼命令能不能在 Codex 里跑。

                        powershell
                        New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex\skills\repeat-task"
# 把 SKILL.md 放进这个文件夹，然后重启 Codex
# 对话里输入：$repeat-task
                    

✅

下次再说一句同样的活，Codex 会按这份教程做，不用你重新把步骤打一遍。

🎯 典型应用场景

🔁

重复的桌面操作

每周都要做一遍的点击流程，录一次就写成教程。

📝

📈 和手写教程、宏录制比

做法	差别
自己把步骤打成文字	写完往往自己已经做完了，还容易漏步骤。
宏录制	记的是鼠标坐标，换分辨率或界面一变就点偏。
这个工具	记窗口、网址、复制内容和步骤，优先走命令和接口。录制留在本机，点分析才上传。官方说明：录一次提交一张表，可以教 AI 提交所有同类的表。

🧠

它强在「从一次真实操作里抽出规则」，不是把你的鼠标轨迹原样重放。

❓ 常见问题

Q: 和自己写一份教程有什么区别？

自己写要先把每一步想清楚再打字。这个工具是你先做，它再把做过的事整理成步骤，你只负责改错的那几条。

Q: Windows 能装吗？

能。Windows 11 的 x64 和 ARM64 都支持。macOS 是主力平台，Ubuntu 也有安装入口。装的是源码构建，不是一个单独的安装包。

Q: 点了分析没反应，或要求登录？

第一次分析会打开浏览器，走 GitHub Copilot 的网页授权。授权完回到软件，它会自动重试。取消登录或超过五分钟，需要自己再点一次分析。公司账号如果停在企业页面，关掉那个标签，回到软件里点 Authorize Copilot，只登录公司账号不算授权完成。

Q: 没有独显能不能用？

能。录制和整理步骤不需要独显。只有打开语音旁白时，第一次会在本机下载约 252 MB 的语音模型。不用旁白就不要开。

Q: 生成的是教程还是定时任务？

两个都可以。教程是一份 SKILL.md，AI 需要时才跑。定时任务是同一套步骤挂上时间或触发条件。生成前可以先 Review 看全文。

Q: 怎么让 Codex 用上它？

把 SKILL.md 放进用户目录下的 .codex\skills\技能名\。文件头要有 name 和 description。重启 Codex，用 /skills 或 $技能名调用。生成物里的工具名如果是 Copilot 的，先改成 Codex 能跑的命令再放进去。

Q: 它和 Copilot Studio 是什么关系？

分析这一步用的是 GitHub Copilot。生成结果可以给 Scout、Cowork 用，Copilot Studio 的导出在部分地区还标着即将支持。给 Codex 用时，是把生成的 SKILL.md 手动放进 Codex 的技能目录。

Q: 录的时候不小心出现了密码怎么办？

不要点分析。分析会把这次记录发到 GitHub 云端。丢掉这次录制，重新录，并确认屏幕和剪贴板里没有密码、密钥。