SuperAPI AI 工具集

computer-repair-skill

办公与效率

查看项目

更新于 10-15 09:44

技能介绍

用途

Computer Repair Skill 用于在用户提出诊断、修复、清理、恢复、迁移、配置、加固或维护 Windows、macOS、Linux 电脑时提供结构化处理流程。其目标是把宿主 Agent 作为推理层,把本机文件、终端和网络工具作为执行层,直接诊断并处理电脑问题:先用证据定位原因,再提出最小修复,获得确认后执行并验证。

本 Skill 不启动独立模型、不调用专用云端 API,也不依赖配套桌面应用,始终服从宿主 Agent 的沙箱、权限和审批机制。

主要能力

  • 覆盖 Windows、macOS、Linux 三个平台,按平台读取对应的工具参考文档(tools-windows.md、tools-macos.md、tools-linux.md)。
  • 包含 64 个可按需加载的 Playbook,通过 playbook-index.md 按症状、平台和触发词选择最具体的 Playbook,只加载当前任务需要的 references/playbook-*.md。
  • 提供工具契约(tool-contract.md),用于把 Playbook 中的语义工具名转换为宿主工具或平台命令。
  • 提供清理协议(cleanup-protocol.md)和规则来源契约(rule-source-contract.md),用于清理、卸载残留、启动项、服务、计划任务、浏览器扩展、文件关联或缓存等任务。
  • 提供安全策略(safety-policy.md),用于删除、权限、磁盘、启动、安全控制、凭据和系统服务操作。
  • 提供 Playbook 编写指南(playbook-authoring.md),支持把教程、运行手册或已完成的修复流程沉淀为 Playbook。

使用方式

执行前先识别实际操作系统、Shell、当前权限和可用工具,不凭用户描述推断平台;确认目标作用于本机或用户明确指定的设备,并保留用户给出的路径、备份、迁移、保留数据等约束。判断宿主是否具有本机执行能力:具备时直接运行诊断;仅有聊天能力时提供带验证点的人工步骤。若目标已进入 PE、WinRE 或安装介质等离线环境,先在宿主仍可用时保存检查清单和证据。

强制工作流包括七个阶段:

  1. 明确目标:把请求拆成症状、目标状态和不可改变的约束,将动作分为只读审计、可逆变更、高影响变更和系统级红线。
  2. 路由 Playbook:读取 playbook-index.md,选择最具体的 Playbook,只加载当前任务需要的文件。
  3. 只读诊断:先运行完成快、范围窄、不修改状态的检查,记录命令、退出码、测量值、相关路径、服务状态和时间点。
  4. 提出修复计划:在安装、升级、长时间任务、管理员操作或任何状态变更之前,向用户展示已确认现象、最可能原因、具体动作、影响范围、权限/联网/重启需求、回滚点和验证标准,等待明确确认。
  5. 执行最小变更:只执行已展示的动作,优先使用宿主结构化工具,其次平台原生命令,最后通用 Shell;使用字面路径和结构化参数。
  6. 验证结果:重跑与故障直接相关的诊断,对比变更前后数据,检查相邻功能是否回归。
  7. 收尾:用用户当前语言简洁报告根因、实际执行的命令与改动、验证证据、最终状态、未处理风险和回滚命令。

适用场景

适用于用户请求诊断、修复、清理、恢复、迁移、配置、加固或维护 Windows、macOS、Linux 电脑的场景,包括但不限于:系统故障排查、清理与卸载残留、启动项与服务管理、浏览器扩展与文件关联处理、缓存清理、备份与云端迁移、安全配置检查等。也适用于把教程或已完成的修复流程整理为可复用 Playbook。

限制

  • 不启动独立模型、不调用专用云端 API、不依赖配套桌面应用。
  • 始终服从宿主 Agent 的沙箱、权限和审批机制,不绕过审批、沙箱和权限提示。
  • 不自动关闭或移除 Defender、SmartScreen、UAC、防火墙、Windows Update、CPU 安全缓解、核心隔离或安全服务;不使用 PsExec 绕过保护;不执行盗版激活、强制卸载 Edge 或修改系统信任链的动作。
  • 不把密码、API Key、Cookie、私钥或完整认证头写进消息、日志、命令历史或知识文件。
  • 禁止把远程脚本直接管道到 Shell(如 irm | iex、curl | bash 或 wget | sh),也不运行未知二进制和未审计的一键优化包。
  • 对目录分析、浏览器策略和安全事件默认只传元数据;不读取文件正文、密码库、Cookie、聊天数据库或私钥内容。
  • 清理类任务先完成只读 inventory 和 analyze/preview,不把“扫描命中”当作执行授权。
  • 同一时间只推进一个执行或恢复批次;定时任务默认只能生成报告或预览。
  • 上游项目、原作者归属和许可证记录在根目录 NOTICE;分发和修改时保留 LICENSE 与 NOTICE。
  • 在安装、下载或调用厂商服务前需复核当前官方文档、版本和 URL;last_reviewed 只表示上游最后复核时间。

本地知识与上游

优先搜索用户已经提供的机器信息、历史修复记录和工作区文档,再重复诊断。只有用户要求持久记忆时才写知识文件,并先确认保存位置和内容。保存事实、已验证命令、版本和日期,把推测标记为推测。网页获取失败时记录失败状态,不根据标题或 URL 补造正文。