🛠️ Computer Repair Skill
让 Agent 像一名谨慎的电脑维修工程师：先取证，再判断；先计划，再修改。
一个可安装到 Codex、Claude Code、OpenClaw 等 Agent 的跨平台电脑诊断与维修 Skill。
官方网站 · 在线浏览 64 个 Playbook
[!NOTE]
C 盘爆满、电脑卡顿、应用与数据迁移、流氓软件、弹窗广告、网路问题、OpenClaw 配置问题……直接用自然语言描述，Agent 会按平台和风险选择合适的修复流程。
🧑🏻💻 作者：88lin · GitHub · 📦 仓库：github.com/88lin/computer-repair-skill
💖 赞助商
想出现在这里？联系 [email protected]
✨ 为什么选择 Computer Repair Skill
- 证据优先：先读取系统状态、日志、配置和硬件事实，再建立候选原因，不凭症状猜结论。
- 只读优先：诊断和盘点可以先做；删除、安装、提权、重启、分区和服务修改会先给出影响、回滚与验证方案。
- 按需加载：64 个专项 Playbook 通过路由索引按问题加载，减少无关上下文，也方便维护和扩展。
- 跨平台：覆盖 Windows、macOS、Linux，并提供 DNS、邮件、身份、SSH、Wi-Fi 和 OpenClaw 等跨平台流程。
- 适合真实维修：包含新机验收、BitLocker/PE 前置分诊、WinRE、数据恢复、拆机安全和设备回收等维修现场边界。
- 不绑定桌面应用：Skill 以 Markdown/YAML 资源为主，不需要配套桌面程序、额外模型或专用云端 API；可选的 Git 存储审计脚本使用宿主已有的 Python 3.10+ 和 Git。
- 可审计可回滚：命令会映射到宿主 Agent 的终端、文件和网络工具；需要改变状态时保留计划和验证步骤。
- 存储结论可核对：大目录逐层下钻并说明扫描覆盖范围；区分 Git 本地数据、可重建产物与模型/数据库，清理后分别报告处理量和实测释放空间。
🖥️ 能力范围
| 平台 | 主要覆盖 |
|---|
| Windows | 网络、性能、存储盘点、应用安装/卸载与清理、驱动与音视频、启动/WinRE、BitLocker/分区、硬件维护、新机验收、浏览器策略、Windows Update、配置审查、打印机、安全与数据恢复 |
| macOS | 网络、VPN、性能、磁盘、应用清理与修复、系统更新、打印机、Homebrew、Time Machine、邮箱配置 |
| Linux | 网络、性能、磁盘与 inode、XDG/Flatpak/Snap 应用清理、CUDA、通用安全与备份检查 |
| 跨平台 | DNS、邮件、身份服务、SSH、Wi-Fi、Outlook、OpenClaw、凭据与本地数据审计 |
🚀 安装
方式一：把一句话交给 Agent（最适合新手）
打开你正在使用的 Codex、Claude Code、Hermes、OpenClaw、Cursor 或其他支持 Agent Skills 的工具，把下面这句话直接发给它：
请安装这个 Agent Skill：https://github.com/88lin/computer-repair-skill
先审查仓库内容和 SKILL.md，再安装到你当前 Agent 的 Skills 目录；如果已经安装旧版本，先备份再更新。
完成后告诉我实际安装路径、目标 Agent 和验证结果。
Agent 需要能访问 GitHub、读取本机文件并执行必要的安装命令。只支持聊天、不具备本机文件或终端能力的客户端，无法替你真正安装。
电脑已安装 Node.js 和 npm 时，在终端运行：
npx skills add 88lin/computer-repair-skill
第一次运行会让你选择安装范围和目标 Agent。常用的全局安装示例：
npx skills add 88lin/computer-repair-skill --global
只安装给 Codex，或安装给 Claude Code：
npx skills add 88lin/computer-repair-skill --global --agent codex
npx skills add 88lin/computer-repair-skill --global --agent claude-code
安装完成后重启或刷新 Agent 的 Skills 列表。Skills CLI 的安装范围、目标 Agent 和链接来源以其当前文档为准：https://skills.sh/docs。
先下载仓库：
git clone https://github.com/88lin/computer-repair-skill.git
cd computer-repair-skill
Windows PowerShell：
.\scripts\install.ps1 -Target codex
.\scripts\install.ps1 -Target claude
.\scripts\install.ps1 -Target agents
macOS / Linux：
./scripts/install.sh --target codex
./scripts/install.sh --target claude
./scripts/install.sh --target agents
其中 codex、claude、agents 会使用对应的默认 Skills 根目录。需要自定义位置时：
.\scripts\install.ps1 -Target custom -Destination "D:\path\to\skills"
./scripts/install.sh --target custom --destination "/path/to/skills"
目标目录已存在时，安装器默认拒绝覆盖；确认升级时显式加 -Force 或 --force，旧版本会先备份到相邻的 external/computer-repair-skill/backups。
安装器会拒绝与源码重叠的路径、文件目标，以及包含符号链接或 Junction 的安装路径。由 Skills CLI 或其他管理工具维护的链接安装，请通过原工具更新。并发安装会被锁阻止；若进程被强制中止，先确认没有安装进程、检查备份与暂存状态，再移除提示中的锁文件或锁目录重试。
把仓库中的 skills/computer-repair-skill 整个目录复制到目标 Agent 的 Skills 根目录。例如：
~/.codex/skills/computer-repair-skill/
~/.claude/skills/computer-repair-skill/
~/.agents/skills/computer-repair-skill/
目录中必须保留 SKILL.md、agents/、references/ 和 scripts/，不要只复制某一个 Playbook。
🧭 如何使用
安装后直接说问题，不需要记 Playbook 名称。描述越具体，路由越准确：平台 + 症状 + 约束 + 期望动作。
Windows 11 的 C 盘快满了，先只读盘点哪几类内容占用最多，再按风险分级给出清理计划；未经我确认，不要删除任何文件。
这台 Windows 电脑越用越卡，开机也很慢。先找出最占 CPU、内存和磁盘的进程，列出可能原因；给出修复方案前不要做任何改动。
流氓软件卸载后还会自启动或弹出广告。先只读列出残留、启动项和相关证据，逐项经我确认后再清理，并说明每项的恢复方式。
系统盘空间不足，想把部分应用迁移到 D 盘。先检查目标盘空间、进程占用和回滚方案，复制校验完成后再保留原路径，确保随时可以还原。
Wi-Fi 已连接但网页打不开。先从 DNS、代理查到路由逐层定位，未经确认不要重置网络，也不要修改浏览器配置。
跨平台与专项场景同样可以直接描述：
这台 Linux 服务器磁盘满了，先按挂载点和 inode 找原因，不要删除日志或容器数据。
Mac 越来越慢，先做健康基线和性能取证，修复前把发现的问题和预计影响列出来。
打印机显示离线，先检查队列、Spooler 和连接方式，清空卡住的作业前先让我确认。
Windows 更新失败，先检查错误码、服务和待重启状态，不要关闭更新或清空缓存。
Windows 进不了桌面，先做无损启动修复分诊，不要重装系统或改 BIOS。
你也可以组合多个目标：
帮我做一次 Windows 维修前体检，同时检查 C 盘空间、启动项和备份状态；全部先只读。
标准工作顺序是：确认平台和约束 → 读取证据 → 说明候选原因 → 给出最小变更计划 → 等待确认 → 执行 → 验证并记录结果。
🧰 功能总览
本 Skill 内置 64 个可按需加载的专项 Playbook。下面的分类数量与完整路由索引一致。
| 分类 | 数量 | 主要内容 |
|---|
| 健康、性能、存储与备份 | 20 | 体检、性能、磁盘/目录盘点、三平台应用清理、文件夹迁移、备份和新机验收 |
| 网络、DNS、VPN、身份与邮件 | 9 | Wi-Fi、路由、DNS、VPN、邮件连通性、SSO 和邮箱配置 |
| 应用、系统更新与打印 | 8 | 应用崩溃、卸载残留、Outlook、macOS/Windows 更新、打印机和 Windows 配置审查 |
| Windows 维修、启动与硬件 | 7 | 驱动、摄像头/音频、启动失败、WinRE、BitLocker、分区和拆机安全 |
| Windows 数据恢复 | 1 | 镜像优先、只读扫描和独立目标恢复 |
| 安全与凭据 | 5 | 终端安全、浏览器、浏览器策略、持久化和凭据清理 |
| 开发环境与基础设置 | 3 | Homebrew、CUDA 和 SSH Key |
| OpenClaw | 11 | 安装、配置、渠道、国产模型、排障和卸载 |
This is the beginning of the README. Read the rest at the original. Read the full README ↗
