88lin/computer-repair-skill

让 Codex、Claude Code 等 AI Agent 成为你的跨平台电脑维修助手：64 个按需加载的 Playbook，覆盖诊断、清理、性能、网络与安全维护——C 盘爆满、电脑卡顿、流氓软件、应用迁移、数据恢复都能直接问；先取证、再计划，确认后修改。

📦 什么是 Computer Repair Skill？

Computer Repair Skill 是一个插件（称为 Skill），可以添加到 Codex、Claude Code、OpenClaw、Cursor 等 AI 驱动的编码助手。安装后，该 Skill 会为代理提供一个包含 64 个现成 "Playbook" 的库，这些 Playbook 描述了在 Windows、macOS 和 Linux 上诊断和修复常见计算机问题的分步、证据优先程序。

核心思想是：

  1. 首先收集证据 – 读取日志、系统状态、硬件信息、磁盘使用情况、网络配置等。
  2. 解释可能的原因 – 在不更改任何内容的情况下，呈现排序列表。
  3. 提出影响最小的计划 – 显示确切的命令、影响、回滚步骤和验证方法。
  4. 仅在用户明确确认后执行。

该 Skill 是纯数据（Markdown/YAML）加上一些辅助脚本；它不附带 GUI 或单独的 AI 模型。宿主代理负责繁重的工作（运行命令、提示用户、记录日志）。

🛠️ 如何安装

方法 适用对象 快速步骤
一句话聊天 已经拥有可以获取 Git 仓库的代理的新用户 向代理发送 README 中的句子（它会告诉代理克隆仓库、查看 SKILL.md 并安装 Skill）。
Skills CLI 熟悉 Node.js/npm 的用户 npx skills add 88lin/computer-repair-skill（添加 --global 和 `--agent codex
仓库安装程序 希望完全控制安装位置的用户 克隆仓库，然后使用 --target（codex、claude、agents 或 custom）运行 install.ps1（Windows）或 install.sh（macOS/Linux）。
手动复制 命令行工具不可用的环境 将整个 skills/computer-repair-skill 文件夹复制到代理的 skills 目录中。

所有安装程序都会验证目标路径，备份任何现有版本，并拒绝覆盖符号链接或 junction。它们还会锁定安装过程以避免并发运行。

🎯 它能做什么（精选示例）

系统健康与存储（20 个 Playbook）

  • 全面健康检查 – 用于交接或维修前文档的基线报告。
  • Windows / macOS / Linux 性能分析（CPU、内存、I/O、容器限制）。
  • 磁盘空间审计 – 列出最大的文件夹、可安全删除的缓存和迁移计划。
  • 应用程序迁移 – 复制数据、验证完整性、创建 NTFS junction，并保留回滚计划。
  • 新机器验收 – 硬件清单、序列号、首次设置检查清单。

网络与身份（9 个 Playbook）

  • Wi-Fi / 以太网诊断 – 从链路启动到 DNS 的逐层检查。
  • VPN 故障排除 – 分流隧道、DNS 泄漏和端点可达性。
  • 电子邮件连接测试 – 无需发送真实邮件即可检查 SMTP/IMAP/POP3 端口和 TLS。

应用、更新与打印机（8 个 Playbook）

  • 卸载残留清理 – 注册表备份、文件系统审计、回收站安全网。
  • Outlook 同步问题 – 隔离网络问题与配置文件问题。
  • 打印机队列恢复 – macOS 上的 CUPS，Windows 上的 Spooler。

Windows 专属修复（7 个 Playbook）

  • 驱动程序审计 – 识别硬件 ID、查找官方来源、规划回滚。
  • 启动失败分诊 – 区分缺少启动设备、UEFI/传统配置错误或 BCD 损坏。
  • WinRE 工作流 – SFC/DISM、安全模式启动、还原点。
  • 进入 PE 前的 BitLocker 预检 – 状态、TPM 健康、恢复密钥位置。

数据恢复（1 个 Playbook）

  • 在任何写操作之前进行只读镜像、扫描和报告。

安全与凭据（5 个 Playbook）

  • 端点安全审计 – AV、防火墙、可疑活动日志。
  • 浏览器策略审查 – 扩展程序、密码存储、AI 相关遥测。
  • 凭据清单 – SSH 密钥、云令牌，不打印任何秘密值。

开发环境（3 个 Playbook）

  • macOS 上的 Homebrew 安装与健康检查。
  • Linux 上的 CUDA 驱动程序与工具包验证。
  • SSH 密钥生成与 GitHub 配置。

OpenClaw 集成（11 个 Playbook）

  • 安装、配置和排查 OpenClaw LLM 网关（Node.js 版本、模型选择、飞书、Telegram、WhatsApp 等渠道插件）。
  • 安全卸载，在删除前列出服务、配置文件和数据目录。

所有操作都遵循先读取、确认后再写入的策略，并包含明确的回滚说明。

🔐 安全与隐私保证

  • 只读优先 – 每个 Playbook 都从证据收集开始；在用户明确批准之前，不会发生文件或注册表更改。
  • 无秘密泄漏 – 密码、恢复密钥、私有令牌永远不会回显；只显示哈希或掩码值。
  • 无危险默认值 – Skill 绝不会禁用 Defender、SmartScreen、UAC、Windows Update 或防火墙。
  • 离线兼容 – Skill 假定宿主代理可能失去网络（例如，进入 WinRE 时）。所有步骤都有文档记录，因此人类可以在没有代理的情况下继续。
  • 可审计 – 每个命令都会被记录，Skill 可以运行 Git 存储审计脚本（scripts/git_storage_audit.py），该脚本会输出本地仓库的 JSON 清单。

📚 谁应该使用它？

  • IT 支持技术人员 – 想要可由 AI 助手运行的可重复、证据驱动的检查清单。
  • 高级用户 – 经常在 Windows/macOS/Linux 上清理磁盘、迁移应用或排查网络问题的用户。
  • AI 代理开发者 – 寻找展示安全系统修改工作流的现成 Skill 包。
  • 组织 – 需要可从对话界面调用的文档化、可审计的修复流程。

🗂️ 仓库结构（概览）

skills/computer-repair-skill/   # 核心 Skill 包
│   SKILL.md          # 路由表和安全工作流
│   agents/openai.yaml # 用于 Codex 显示的元数据
│   references/       # 64 个 Playbook Markdown 文件 + 索引
│   scripts/          # 安装脚本、git 审计辅助工具
│   tests/validate_skill.py  # CI 验证器（无外部依赖）
assets/                # 封面插图
docs/                  # 静态网站（GitHub Pages）– 双语言界面
tools/                 # 数据提取和站点构建辅助工具
LICENSE、NOTICE、SECURITY.md、CONTRIBUTING.md

✅ 总结

Computer Repair Skill 是一个真正的开源项目，为 AI 编码助手提供了全面、安全第一的实用计算机诊断和维修工具箱。它不是教程列表或简单演示；它提供了结构化的 64 个 Playbook、安装辅助工具、CI 验证和清晰的安全模型，使其成为任何想要 AI 增强、可审计的 PC 维护方法的人的有用资产。

相关

  • 项目
    cisco-ai-defense/skill-scanner

    Skill Scanner 是一个用于 AI 代理技能包（例如 OpenAI Codex、Cursor、Claude）的开源安全扫描器。它结合基于签名的 YARA/YAML 规则、基于 AST 的数据流分析、可选的 LLM 作为评判，以及 CEL 决策层，以检测提示注入、数据外泄和恶意代码模式。可通过 pip 安装，从 CLI 或 Python SDK 运行，并可通过 GitHub Actions 或 pre-commit hook 集成到 CI/CD。发现结果会以严重性级别报告；干净扫描仅为尽力而为，不保证安全。

  • 项目
    MoizIbnYousaf/ai-agent-skills

    一个真正的基于 npm 的 CLI/TUI 工具，提供一个精心挑选的 AI 代理技能库，让你能够构建和管理自己的技能集合，并通过 Agent Skills 规范与多种 LLM 代理集成。

  • 项目
    GPTomics/bioSkills

    bioSkills 是一个包含即用型代码模板（“技能”）的库，可教会LLM编码代理如何执行生物信息学分析——从序列输入输出到单细胞分析、变异检测、结构生物学、化学信息学及工作流管理。可通过 Claude Code、Codex、Gemini/Antigravity、OpenCode 和 OpenClaw 的轻量脚本安装，提供最佳实践命令行标志、示例脚本和使用指南，提升AI生成的生物信息学代码的准确性。

  • 项目
    NVIDIA/SkillSpector

    SkillSpector 是一款用于 AI 代理“技能”的开源安全扫描器。它能对代码包进行静态检查，涵盖 71 种已知漏洞模式（如提示词注入、数据外泄、权限提升等），并可选择执行基于 LLM 的语义分析。它支持目录、zip 文件、Git URL 或单个 SKILL.md 文件作为输入，可生成终端、JSON、Markdown 或 SARIF 格式报告，并支持基准抑制以隐藏已知的误报。可通过 `uv tool install` 或 Docker 安装，并可配置多种 LLM 提供者（OpenAI、Anthropic、Bedrock、NVIDIA Build、Gemini、Ollama、Azure 等）进行选配的第二阶段分析。专为开发人员与安全团队设计，用于在将技能发布至 NVIDIA Verified Skills 目录或内部注册表之前进行审核。

  • 项目
    amd/skills

    AMD Skills 是一个可重用的、代理兼容的“技能”目录，编码了 AMD 特定的 AI 工作流知识（ROCm 诊断、Quark 量化、在 Instinct/EPYC 上提供 LLM 服务等）。通过 `skills` CLI（`npx skills add amd/skills`）或手动安装，然后通过 Cursor、Claude Code、Codex 或 Gemini 等编码助手调用技能。每个技能捆绑了 `SKILL.md` 描述、可选的脚本和参考资料，使代理能够自动执行 AMD 硬件的设置、优化和调试步骤。