computer-repair-skill

🛠️ Computer Repair Skill

让 Agent 像一名谨慎的电脑维修工程师：先取证，再判断；先计划，再修改。

一个可安装到 Codex、Claude Code、OpenClaw 等 Agent 的跨平台电脑诊断与维修 Skill。

官方网站 · 在线浏览 64 个 Playbook

[!NOTE] C 盘爆满、电脑卡顿、应用与数据迁移、流氓软件、弹窗广告、网路问题、OpenClaw 配置问题……直接用自然语言描述，Agent 会按平台和风险选择合适的修复流程。

🧑🏻‍💻 作者：88lin · GitHub · 📦 仓库：github.com/88lin/computer-repair-skill

💖 赞助商

想出现在这里？联系 bytevian@qq.com

✨ 为什么选择 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	安装、配置、渠道、国产模型、排障和卸载

💬 能做什么｜你可以这样问

🩺 健康、性能、存储与备份（20）

能力	你可以这样问
全面体检 — 建立系统健康基线，适合交接、验收和维修前留档	“帮我给这台电脑做一次全面体检，先只读并输出报告。”
macOS 性能取证 — CPU、内存压力、IO、风扇和无响应	“Mac 风扇一直转，帮我判断是 CPU、内存还是磁盘 IO。”
Windows 性能取证 — CPU、内存、磁盘瓶颈、启动慢和应用无响应	“Windows 很卡，先找出最占 CPU、内存和磁盘的进程。”
Linux 性能取证 — 负载、CPU、内存、交换、IO 等待和容器限额	“服务器负载很高，区分是 CPU 饱和、IO 等待还是容器限额。”
Mac 调优 — 缓存、权限和基础安全维护	“Mac 变慢了，先做低风险维护，不要删我的个人文件。”
macOS 磁盘恢复 — 大文件、缓存和可释放空间审计	“Mac 磁盘快满了，先列出可以安全释放的空间。”
Windows 磁盘恢复 — 系统盘爆满、更新空间不足和安全释放	“C 盘快满了，先按风险分级给出清理计划。”
Windows 存储盘点 — 按路径和大小解释空间分配	“帮我找出 C 盘最大的目录，但不要删除任何东西。”
Windows 大文件夹管理 — 懒加载系统/应用数据/自定义目录，明确分类后再 offload	“先异步统计几个大文件夹，确认后把指定应用数据迁移到 D 盘。”
Windows 应用迁移 — 复制校验后用 Junction 保留原路径，支持回滚	“把这个应用迁移到 D 盘，先检查 NTFS、空间、进程占用和恢复方案。”
Windows 迁移历史恢复 — 检查 Junction、幽灵记录并安全还原	“这个软件迁移后打不开，先检查链接状态，不要覆盖原目录。”
Windows 应用清理 — 微信重复文件、浏览器缓存和包缓存	“帮我清理微信重复文件，聊天记录和原文件不能动。”
macOS 应用清理 — 容器与缓存边界、微信重复文件和开发者缓存	“Mac 上微信占了几十 G，先只读列出可以清的重复文件，聊天记录别动。”
Linux 应用清理 — XDG/Flatpak/Snap 数据根、重复文件和包缓存	“这个 Flatpak 应用缓存太大了，先分清哪些是缓存哪些是我的数据。”
Windows 应用生命周期审计 — WinGet、Chocolatey、Appx、来源、发布者和残留	“审计这台电脑装了什么应用，先不要卸载。”
Windows 新机验收 — 本地硬件、序列号、配置、开箱证据和首次设置	“先做新机本地验收，不联网激活；查保修前先问我。”
Linux 磁盘恢复 — 文件系统、inode、日志和容器存储增长	“Linux 根分区满了，先判断是 inode、日志还是容器占用。”
本地数据审计 — 离职、设备回收前盘点敏感数据	“这台电脑要回收，先盘点敏感数据和残留账号，不要删除。”
备份验证与抽样恢复 — 时间戳、完整性、可读性和独立目标恢复	“验证备份能不能恢复一个测试文件，不要覆盖现有数据。”
macOS 备份设置 — Time Machine 和基础备份策略	“帮我规划 Mac 的自动备份，先检查现有磁盘和空间。”

🌐 网络、DNS、VPN、身份与邮件（9）

能力	你可以这样问
macOS 网络诊断 — Wi-Fi、地址、路由、DNS 和网页访问	“Mac 能连 Wi-Fi 但打不开网页，按层排查。”
Windows 网络诊断 — 网卡、DHCP、路由、DNS、代理、VPN 和 HTTP	“Windows 只有部分网站打不开，先区分 DNS、代理还是路由。”
Linux 网络诊断 — 链路、地址、路由、DNS、防火墙和命名空间	“容器不能联网，先检查宿主和容器的网络边界。”
macOS VPN 排障 — 连接、掉线、分流和 DNS 异常	“VPN 能连接但内网域名打不开，先查分流和 DNS。”
DNS 记录检查 — MX、SPF、DKIM、DMARC 和邮件域名记录	“检查 example.com 的 MX 和 SPF，告诉我哪些记录缺失。”
邮件连通性测试 — SMTP、IMAP、POP3 和邮件服务器	“只测试邮件服务器端口和 TLS，不要发送真实邮件。”
身份提供商测试 — Entra ID、Google Workspace 和 SSO 端点	“SSO 登录失败，先测试端点和时间/证书问题。”
Wi-Fi 配置 — 家庭或企业 WPA2/WPA3 配置	“配置企业 Wi-Fi；密码不要出现在输出和日志里。”
macOS 邮箱配置 — Apple Mail 或 Outlook 添加邮箱	“帮我配置邮箱，先确认服务器和认证方式，不要把密码发出来。”

🧩 应用、系统更新与打印（8）

能力	你可以这样问
macOS 应用修复 — 崩溃、打不开、权限和配置损坏	“某个 Mac 应用一打开就崩，先收集日志和配置证据。”
Windows 卸载残留清理 — 厂商卸载优先、严格匹配、注册表备份和回收站恢复	“卸载后还有残留，先预览证据和回滚，不要直接强删。”
Outlook 排障 — 同步、卡信、崩溃和配置文件	“Outlook 邮件不同步，先判断是网络、账户还是配置文件。”
macOS 更新排障 — 下载、安装和更新卡住	“macOS 更新失败，先检查错误原因，不要抹掉系统。”
Windows Update 排障 — 错误码、服务、待重启和更新缓存	“Windows 更新卡住，先修复更新链路，不要关闭更新。”
macOS 打印机修复 — 队列、CUPS 和设备发现	“Mac 打印队列卡住了，先保留作业内容再处理。”
Windows 打印机修复 — 离线状态、打印队列和 Spooler	“Windows 打印机离线，清除卡住作业前先告诉我影响。”
Windows 配置审查 — 隐私、电源、去臃肿与 Windows AI 设置的差异、风险和回滚	“帮我关掉 Recall 和 Copilot，先告诉我当前状态、影响和怎么恢复。”

🪟 Windows 维修、启动与硬件（7）

能力	你可以这样问
驱动生命周期审计 — 硬件 ID、官方来源、重装、回滚和兼容性	“未知 USB 设备找不到驱动，先识别硬件 ID 和官方来源。”
摄像头与音视频输入分诊 — 开关、权限、系统设备和会议软件	“Teams 找不到麦克风，按硬件、权限、驱动、应用四层排查。”
启动失败分诊 — No Boot Device、启动循环、UEFI/Legacy 和启动界面	“开机提示 No Boot Device，不能改 BIOS，先判断磁盘还是启动项。”
WinRE 系统修复 — SFC、DISM、安全模式、启动修复和还原	“Windows 进不了桌面，先做无损修复分诊，不要重装。”
BitLocker/PE 前置分诊 — 加密状态、TPM/BIOS、恢复密钥和离线清单	“我准备进入 PE，请先在当前 Windows 检查 BitLocker 状态；不要输出恢复密钥。”
分区扩容审计 — 邻接空间、备份、移动分区和离线操作边界	“C 盘太小，先评估能否安全扩容，不要立即移动分区。”
硬件维护安全 — 断电放电、ESD、清灰、换件和停工条件	“笔记本发热，先判断是否值得拆机清灰，并列出停工条件。”

新机和 PE/BitLocker 的正确使用方式：新机验收先执行本地离线检查；联网查厂商支持、保修或激活信息必须等宿主有网络且用户确认。进入 PE/WinRE 前，在当前可用系统中完成 BitLocker 分诊、备份和清单保存；PE/WinRE 阶段不假设有网络或 Agent，按清单由用户/技师操作，回到可用宿主后再让 Agent 复核。

🧯 Windows 数据恢复（1）