让 Agent 像一名谨慎的
电脑维修工程师

先取证，再判断；先计划，再修改。

一个可安装到 Codex、Claude Code、OpenClaw 等 Agent 的跨平台电脑诊断与维修 Skill。电脑变慢、断网、更新失败、打印机离线、C 盘爆满、驱动异常、Windows 启动失败、OpenClaw 配置问题——直接用自然语言描述，Agent 会按平台和风险选择合适的排障流程。

npx skills add 88lin/computer-repair-skill
四种安装方式 看 58 个 Playbook
  • 58专项 Playbook
  • 3覆盖平台
  • AGPL3.0 开源
一次典型排障对话

$ npx skills add 88lin/computer-repair-skill

computer-repair-skill → ~/.codex/skills/

> Windows 11 最近经常断网，先只读检查网卡、DHCP、DNS、代理和 VPN，不要重置网络。

1/7 明确目标平台 Windows · 约束：不重置网络

2/7 路由 Playbookwindows-network-diagnostics

3/7 只读诊断Get-NetAdapter · Get-DnsClientServerAddress · Test-NetConnection · netsh winhttp show proxy

4/7 提出修复计划等待你明确确认后才动手

它是什么，
它不是什么

它不是装机软件，而是一套让 Agent 按步骤诊断、解释风险，并在你确认后修复问题的电脑维修流程。

不安装后台程序，不接管你的电脑

Computer Repair Skill 的定位对照
序号 它是 它不是
给 Agent 读取的 Skill 包提供诊断步骤、确认规则和安全边界，由你的 Agent 执行。 一个桌面软件没有安装包、没有界面、没有后台进程。
复制进 Skills 目录的资源~/.codex/skills/、~/.claude/skills/、~/.agents/skills/。 配套程序、模型或云端 APISkill 本身是 Markdown / YAML 资源，不需要额外装任何东西。
先审查差异、风险和回滚路径确认之后再执行最小变更。 「一键优化 Windows」优化配置可能影响更新、隐私、驱动、企业策略和回滚。
58 个按需加载的专项 Playbook通过路由索引按问题加载，减少无关上下文。 一次性塞满上下文的巨型提示词按问题只加载相关流程，避免混入无关步骤。
可审计、可回滚的维修流程改变状态时保留计划、验证步骤和回滚命令。 维修资质或数据恢复承诺遇到冒烟、进液、异响、过热、电池鼓包或原盘物理故障，立即停工升级给专业人员。

一次对话怎么走

从描述问题到验证结果，Agent 始终按七个步骤推进。任何修改都要先说明原因、影响和回滚方式，再等待你确认。

  1. 明确目标

    把请求拆成症状、目标状态和不可改变的约束。多个目标逐项保留——不用删除替代迁移，不用重装替代修复，不跳过明确要求。

    动作分级：只读审计 · 可逆变更 · 高影响变更 · 系统级红线

  2. 路由 Playbook

    读取路由索引，按症状、平台和触发词选最具体的一个 Playbook。只加载当前任务需要的那一份，不一次读全部。

    Playbook 是诊断协议，不是执行授权

  3. 只读诊断

    先跑范围窄、不改状态的检查，记录命令、退出码、测量值、路径、服务状态和时间点。命令输出是证据，单一异常不等于根因。

    默认只传元数据：不读文件正文、密码库、Cookie 或私钥

  4. 提出修复计划必须停下

    在安装、升级、长时间任务、管理员操作或任何状态变更之前，先展示：已确认的现象与最可能原因、具体动作和影响范围、是否需要提权／联网／重启、回滚点、修复后的验证命令和成功标准。

    等待用户明确确认。之前对另一组动作的确认，不覆盖新出现的高影响动作。

    整个 Skill 的支点在这里

  5. 执行最小变更

    只执行已经展示过的动作；范围一扩大就重新展示计划。用字面路径和结构化参数，不依赖当前目录或宽泛通配符。清理逐项留下目标路径、大小／哈希、原位置、时间和恢复位置。

    优先回收站或隔离目录，不用永久删除代替「清理」

  6. 验证结果

    重跑与故障直接相关的诊断，不以命令退出成功代替问题解决。对比变更前后数据，并检查相邻功能是否回归。

    Playbook 定义了成功标准时逐项满足

  7. 收尾

    用你当前的语言简洁报告：根因或当前最可信结论、实际执行的命令与改动、验证证据和最终状态、尚未处理的风险与回滚命令。

    不声称已修复未经验证的问题

安全红线

删除文件、使用管理员权限、修改磁盘或启动配置都可能带来高风险。Computer Repair Skill 会按影响分级，越危险的动作，需要越明确的范围、回滚方案和单独确认。

用户对普通修复的确认，不覆盖这些对象。

Computer Repair Skill·系统级红线

四级风险分层

  1. L1

    只读

    观察系统但不改变状态，例如查询网络、磁盘、进程、服务、日志和文件元数据。

    限定范围后可直接执行
  2. L2

    可逆变更

    低影响且有明确回滚，例如刷新 DNS、重启普通服务、移动单个文件。

    先展示计划、影响和回滚，取得确认
  3. L3

    高影响变更

    删除、终止进程、清缓存、改权限、安装、升级、卸载、管理员命令、批量移动、修改启动项或安全设置。

    展示精确命令、目标范围、恢复方案和验证，单独确认
  4. L4

    系统级红线

    启动卷、系统根目录、分区表、固件、BIOS/UEFI、系统密钥链、凭据数据库、整棵用户目录，或关闭核心安全机制。

    停止执行，转向厂商或企业恢复路径

删除前必须走完的六步

Inspect Before Delete · 对任何删除都适用

  1. 用字面绝对路径确定目标，不依赖当前目录。
  2. 用只读命令列出目标、大小、修改时间、类型和关键内容。
  3. 确认检查结果确实对应将删除的具体对象。
  4. 展示目标列表、理由、预计影响和恢复方式。
  5. 取得用户对本次具体目标的确认。
  6. 删除明确子项，随后验证目标与相邻目录状态。

绝不执行

这些写法根本不进入执行阶段

  • 把远程响应直接交给 Shell 的管道：irm | iex、iwr | iex、curl | powershell、curl | bash、wget | sh、bash -c "$(curl …)"。
  • 对用户数据、应用数据或凭据目录使用 *、递归根目录或祖先目录清扫。
  • 通过管道、xargs、eval、命令替换、编码载荷或动态变量隐藏删除目标。
  • 在聊天中输出密码、恢复密钥、私钥、token 或完整敏感路径。
  • 主动关闭 Defender、SmartScreen、UAC、防火墙、Windows Update 或核心隔离——这些只做状态审计。
  • 盗版激活、未知下载器、强制卸载 Edge、未审计的一键优化包。

每个高影响动作都留一条记录

时间 | 目标 | 动作 | 风险级别 | 用户确认 | 退出状态 | 验证 | 回滚

记录命令模板时移除秘密；路径涉及用户名或公司信息时只保留诊断所需部分。

装进你的 Agent

四种方式，从「一句话交给 Agent」到「手动复制目录」。只支持聊天、不具备本机文件或终端能力的客户端，无法替你真正安装。

把一句话交给 Agent

最适合新手。打开 Codex、Claude Code、Hermes、OpenClaw、Cursor 或其他支持 Agent Skills 的工具，把右边这段话直接发给它。

Agent 需要能访问 GitHub、读取本机文件并执行必要的安装命令。

prompt 
请安装这个 Agent Skill：https://github.com/88lin/computer-repair-skill
先审查仓库内容和 SKILL.md，再安装到你当前 Agent 的 Skills 目录；如果已经安装旧版本，先备份再更新。
完成后告诉我实际安装路径、目标 Agent 和验证结果。

58 个专项 Playbook

从电脑变慢、断网和磁盘爆满，到系统更新、启动修复与 OpenClaw 配置。搜索你的症状，或点开任意一行查看适用场景和示例提问。

按分类

分类数量

按平台

「跨平台」指流程不依赖单一操作系统，例如 DNS、邮件、身份服务、SSH、Wi-Fi、Outlook、OpenClaw、凭据与本地数据审计。

58 个 Playbook 的完整路由索引
No. Playbook 分类 平台 路由 ID
01建立系统健康基线，适合交接、验收和维修前留档健康、性能、存储与备份跨平台health-baseline-check
02CPU、内存压力、IO、风扇和无响应健康、性能、存储与备份macOSperformance-forensics
03CPU、内存、磁盘瓶颈、启动慢和应用无响应健康、性能、存储与备份Windowswindows-performance-forensics
04负载、CPU、内存、交换、IO 等待和容器限额健康、性能、存储与备份Linuxlinux-performance-forensics
05缓存、权限和基础安全维护健康、性能、存储与备份macOSmac-tune-up
06大文件、缓存和可释放空间审计健康、性能、存储与备份macOSdisk-space-recovery
07系统盘爆满、更新空间不足和安全释放健康、性能、存储与备份Windowswindows-disk-space-recovery
08按路径和大小解释空间分配健康、性能、存储与备份Windowswindows-storage-inventory
09微信重复文件、浏览器缓存和包缓存健康、性能、存储与备份Windowswindows-application-cleanup
10WinGet、Chocolatey、Appx、来源、发布者和残留健康、性能、存储与备份Windowswindows-application-lifecycle-audit
11本地硬件、序列号、配置、开箱证据和首次设置健康、性能、存储与备份Windowswindows-new-device-intake
12文件系统、inode、日志和容器存储增长健康、性能、存储与备份Linuxlinux-disk-space-recovery
13离职、设备回收前盘点敏感数据健康、性能、存储与备份跨平台local-data-audit
14时间戳、完整性、可读性和独立目标恢复健康、性能、存储与备份跨平台backup-verify-restore
15Time Machine 和基础备份策略健康、性能、存储与备份macOSsetup-backup
16Wi-Fi、地址、路由、DNS 和网页访问网络、DNS、VPN、身份与邮件macOSnetwork-diagnostics
17网卡、DHCP、路由、DNS、代理、VPN 和 HTTP网络、DNS、VPN、身份与邮件Windowswindows-network-diagnostics
18链路、地址、路由、DNS、防火墙和命名空间网络、DNS、VPN、身份与邮件Linuxlinux-network-diagnostics
19连接、掉线、分流和 DNS 异常网络、DNS、VPN、身份与邮件macOSvpn-troubleshooting
20MX、SPF、DKIM、DMARC 和邮件域名记录网络、DNS、VPN、身份与邮件跨平台dns-record-check
21SMTP、IMAP、POP3 和邮件服务器网络、DNS、VPN、身份与邮件跨平台email-connectivity-test
22Entra ID、Google Workspace 和 SSO 端点网络、DNS、VPN、身份与邮件跨平台identity-provider-test
23家庭或企业 WPA2/WPA3 配置网络、DNS、VPN、身份与邮件跨平台setup-wifi-profile
24Apple Mail 或 Outlook 添加邮箱网络、DNS、VPN、身份与邮件macOSsetup-email-account
25崩溃、打不开、权限和配置损坏应用、系统更新与打印macOSapp-doctor
26同步、卡信、崩溃和配置文件应用、系统更新与打印跨平台outlook-troubleshooting
27下载、安装和更新卡住应用、系统更新与打印macOSupdate-troubleshooting
28错误码、服务、待重启和更新缓存应用、系统更新与打印Windowswindows-update-troubleshooting
29队列、CUPS 和设备发现应用、系统更新与打印macOSprinter-repair
30离线状态、打印队列和 Spooler应用、系统更新与打印Windowswindows-printer-repair
31隐私、电源、去臃肿设置的差异、风险和回滚应用、系统更新与打印Windowswindows-configuration-review
32硬件 ID、官方来源、重装、回滚和兼容性Windows 维修、启动与硬件Windowswindows-driver-lifecycle-audit
33开关、权限、系统设备和会议软件Windows 维修、启动与硬件Windowswindows-av-input-triage
34No Boot Device、启动循环、UEFI/Legacy 和启动界面Windows 维修、启动与硬件Windowswindows-boot-failure-triage
35SFC、DISM、安全模式、启动修复和还原Windows 维修、启动与硬件Windowswindows-winre-system-repair
36加密状态、TPM/BIOS、恢复密钥和离线清单Windows 维修、启动与硬件Windowswindows-bitlocker-recovery-triage
37邻接空间、备份、移动分区和离线操作边界Windows 维修、启动与硬件Windowswindows-partition-resize-audit
38断电放电、ESD、清灰、换件和停工条件Windows 维修、启动与硬件Windowswindows-hardware-maintenance-safety
39防病毒、防火墙、更新和可疑活动安全与凭据跨平台endpoint-security-check
40扩展、密码存储、版本和安全设置安全与凭据跨平台browser-security-audit
41Chrome、Edge、Firefox、Brave 策略和遥测安全与凭据Windowswindows-browser-policy-audit
42启动项、服务、计划任务、右键菜单和文件关联安全与凭据Windowswindows-persistence-audit
43SSH key、token、云凭据和事件后残留安全与凭据跨平台credential-cleanup
44先成像、只读扫描、报告，再写入独立目标Windows 数据恢复Windowswindows-data-recovery-triage
45安装、配置和基础诊断开发环境与基础设置macOSsetup-homebrew
46Ubuntu、Debian、RHEL/Fedora 的驱动与工具链开发环境与基础设置Linuxsetup-cuda
47生成、GitHub 配置和 publickey 排障开发环境与基础设置跨平台setup-ssh-key
48Node.js、网关、渠道和安装验证OpenClaw跨平台setup-openclaw
49安装或核对 OpenClaw 所需运行时OpenClaw跨平台setup-openclaw/install-node
50模型、渠道、会话和自动化OpenClaw跨平台setup-openclaw/configure
51查询配置项和安全默认值OpenClaw跨平台setup-openclaw/config-reference
52机器人身份接入OpenClaw跨平台setup-openclaw/add-feishu
53用户身份和文档能力OpenClaw跨平台setup-openclaw/add-feishu-official
54Bot 接入和连通性OpenClaw跨平台setup-openclaw/add-telegram
55登录、重新配置和会话状态OpenClaw跨平台setup-openclaw/add-whatsapp
56火山、Moonshot、DeepSeek、Qwen、GLMOpenClaw跨平台setup-openclaw/china-models
57网关、渠道、模型和日志OpenClaw跨平台setup-openclaw/troubleshooting
58停止服务、移除配置和验证残留OpenClaw跨平台setup-openclaw/uninstall

你可以直接说的话

安装后直接描述问题，不需要记 Playbook 名称。说清楚 平台 + 症状 + 约束 + 期望动作，Agent 就能更准确地选择排障流程。

  • Windows 11 最近经常断网，先只读检查网卡、DHCP、DNS、代理和 VPN，不要重置网络。

    Windows相关 Playbookwindows-network-diagnostics

  • 这台 Linux 服务器磁盘满了，先按挂载点和 inode 找原因，不要删除日志或容器数据。

    Linux相关 Playbooklinux-disk-space-recovery

  • Mac 越来越慢，先做健康基线和性能取证，修复前把发现的问题和预计影响列出来。

    macOS相关 Playbookperformance-forensics

  • 打印机显示离线，先检查队列、Spooler 和连接方式，清空卡住的作业前先让我确认。

    Windows相关 Playbookwindows-printer-repair

  • 帮我做一次 Windows 维修前体检，同时检查 C 盘空间、启动项和备份状态；全部先只读。

    多目标相关 Playbookhealth-baseline-check

  • 我准备进入 PE，请先在当前 Windows 检查 BitLocker 状态；不要输出恢复密钥。

    Windows相关 Playbookwindows-bitlocker-recovery-triage

标准工作顺序：确认平台和约束 → 读取证据 → 说明候选原因 → 给出最小变更计划 → 等待确认 → 执行 → 验证并记录结果。

常见问题

关于安装方式、Agent 能力、安全边界和开源许可，这里集中回答。

  • 它是 Skill，不是后台软件Skill 提供流程，实际执行能力仍取决于 Agent 拥有的工具和权限。

  • 默认只读，修改前确认安装、删除、提权和重启必须先说明影响与回滚方式。

  • 描述问题，不用记 Playbook写清平台、症状、约束和期望动作，Agent 会自动路由。

还有问题？去 Issues 提

  • 不是。它是给 Agent 读取的 Skill 包，提供诊断步骤、确认规则和安全边界。实际执行依赖你的 Agent 是否有本机终端、文件、网络和确认机制。

下一次电脑出问题，
让 Agent 先取证。

一行命令装好，然后用自然语言描述症状就行。

npx skills add 88lin/computer-repair-skill --global
GitHub 仓库 skills.sh 页面