skill-recorder

环境要求

• macOS、Ubuntu 或 Windows 桌面环境（macOS/Ubuntu 用 install.sh，Windows 用 install.ps1）
• 能访问 GitHub（raw.githubusercontent.com 与 Releases 页面）
• macOS/Ubuntu 需要已安装 bash 与 curl；Windows 使用 PowerShell
• 分析步骤依赖 GitHub Copilot CLI，需自行准备可用的 Copilot 环境
• 如需录制语音讲解，需要可用麦克风（可选）

安装与启动步骤

1. 1获取安装命令

   打开 GitHub 最新 Release 页面，找到对应平台的命令并复制，其中尖括号里的 40 位 commit 需要在页面中替换为真实值。

2. 2macOS/Ubuntu 安装

   把 <40-character-release-commit> 换成 Release 页面给出的真实 40 位 commit 后执行，脚本会下载并构建应用。

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

   复制

3. 3安装后保持常驻

   默认应用随终端关闭而结束，如需关闭终端后继续运行，在管道后追加 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

   复制

4. 4Windows 安装

   在 PowerShell 中把 commit 换成 Release 页面给出的真实值后执行，脚本通过 irm 下载并执行安装脚本。

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

   复制

5. 5启动并开始录制

   从 Spotlight / Launchpad / 应用菜单或桌面快捷方式打开 Skill Recorder，按 ⌘⇧R（Windows 为 Ctrl+Shift+R）开始录制并正常完成你的操作。

6. 6分析并生成技能

   结束录制后点击 Analyze，GitHub Copilot 会还原出整体意图与有序步骤；确认无误后点 Create 生成 SKILL.md 技能或定时触发的 Automation。

关键配置

如何确认成功

macOS 可在 ~/Applications 看到 Skill Recorder (Source)，Ubuntu 出现对应应用条目，Windows 出现桌面与开始菜单快捷方式，启动后能看到置顶录制控制条。

常见问题

注意事项

• README 里的安装命令中 commit 是占位符，必须以 Releases 页面上的真实值替换后才能执行。
• 安装脚本由该 commit 固定，脚本与所构建的源码版本一致，不建议随意改动 commit。
• Analyze 与技能生成依赖 GitHub Copilot CLI，使用前请确认本机已有可用的 Copilot 环境。
• 生成的技能与自动化会优先使用代理原生工具（如 gh CLI、web_fetch），而不是回放界面点击。