88lin/computer-repair-skill

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

📦 Computer Repair Skill란?

Computer Repair Skill은 Codex, Claude Code, OpenClaw, Cursor 등의 AI 기반 코딩 어시스턴트에 추가할 수 있는 플러그인(Skill이라고 함)입니다. 설치하면 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 디렉토리에 복사합니다.

모든 설치 프로그램은 대상 경로를 확인하고, 기존 버전을 백업하며, 심볼릭 링크나 정션을 덮어쓰지 않습니다. 또한 동시 실행을 방지하기 위해 설치 프로세스를 잠급니다.

🎯 수행 가능한 작업(선택 예시)

시스템 상태 및 스토리지(20개 Playbook)

  • 전체 상태 점검 – 인계 또는 수리 전 문서화를 위한 기준 보고서.
  • Windows / macOS / Linux 성능 프로파일링(CPU, 메모리, I/O, 컨테이너 제한).
  • 디스크 공간 감사 – 가장 큰 폴더, 안전하게 삭제 가능한 캐시, 마이그레이션 계획 목록.
  • 애플리케이션 마이그레이션 – 데이터 복사, 무결성 확인, NTFS 정션 생성, 롤백 계획 유지.
  • 새 머신 승인 – 하드웨어 인벤토리, 일련 번호, 초기 설정 체크리스트.

네트워크 및 ID(9개 Playbook)

  • Wi-Fi / 이더넷 진단 – 링크 업부터 DNS까지 레이어별 확인.
  • VPN 문제 해결 – 스플릿 터널, DNS 누출, 엔드포인트 연결 가능성.
  • 이메일 연결 테스트 – 실제 메일을 보내지 않고 SMTP/IMAP/POP3 포트 및 TLS 확인.

앱, 업데이트, 프린터(8개 Playbook)

  • 제거 잔여물 정리 – 레지스트리 백업, 파일 시스템 감사, 휴지통 안전망.
  • Outlook 동기화 문제 – 네트워크 문제와 프로필 문제 분리.
  • 프린터 대기열 복구 – macOS의 CUPS, Windows의 스풀러.

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 버전, 모델 선택, Feishu, Telegram, WhatsApp 등 채널 플러그인).
  • 삭제 전에 서비스, 구성 파일 및 데이터 디렉터리를 나열하는 안전한 제거.

모든 작업은 읽기 우선, 확인 후 쓰기 정책을 따르며 명시적인 롤백 지침을 포함합니다.

🔐 안전 및 개인정보 보호 보장

  • 읽기 전용 우선 – 모든 Playbook은 증거 수집으로 시작합니다. 사용자가 명시적으로 승인할 때까지 파일이나 레지스트리 변경이 없습니다.
  • 비밀 누출 없음 – 비밀번호, 복구 키, 개인 토큰은 절대 표시되지 않습니다. 해시 또는 마스킹된 값만 표시됩니다.
  • 위험한 기본값 없음 – Skill은 Defender, SmartScreen, UAC, Windows Update 또는 방화벽을 비활성화하지 않습니다.
  • 오프라인 호환 – Skill은 호스트 에이전트가 네트워크를 잃을 수 있다고 가정합니다(예: WinRE로 부팅된 경우). 모든 단계가 문서화되어 있어 사람이 에이전트 없이도 계속할 수 있습니다.
  • 감사 준비 – 모든 명령이 기록되며, Skill은 로컬 리포지토리의 JSON 인벤토리를 출력하는 Git 스토리지 감사 스크립트(scripts/git_storage_audit.py)를 실행할 수 있습니다.

📚 누가 사용해야 하나요?

  • IT 지원 기술자 – AI 어시스턴트로 실행할 수 있는 재현 가능하고 증거 기반의 체크리스트를 원하는 분.
  • 파워 유저 – Windows/macOS/Linux에서 디스크 정리, 앱 마이그레이션, 네트워크 문제 해결을 자주 수행하는 분.
  • AI 에이전트 개발자 – 안전한 시스템 수정 워크플로를 보여주는 기성 Skill 패키지를 찾는 분.
  • 조직 – 대화형 인터페이스에서 호출할 수 있는 문서화되고 감사 가능한 복구 프로세스가 필요한 조직.

🗂️ 리포지토리 구조(빠른 개요)

skills/computer-repair-skill/   # 핵심 Skill 패키지
│   SKILL.md          # 라우팅 테이블 및 안전 워크플로
│   agents/openai.yaml # Codex 표시용 메타데이터
│   references/       # 64개 Playbook 마크다운 파일 + 인덱스
│   scripts/          # 설치 스크립트, git 감사 헬퍼
│   tests/validate_skill.py  # CI 검증기(외부 종속성 없음)
assets/                # 표지 일러스트
docs/                  # 정적 사이트(GitHub Pages) – 이중 언어 UI
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-as-a-judge, CEL 결정 계층을 결합하여 프롬프트 주입, 데이터 유출, 악성 코드 패턴을 탐지합니다. pip로 설치하고 CLI 또는 Python SDK에서 실행하며 GitHub Actions 또는 pre-commit 훅을 통해 CI/CD에 통합할 수 있습니다. 발견 사항은 심각도 수준으로 보고됩니다. 깨끗한 스캔은 최선의 노력일 뿐이며 안전을 보장하지 않습니다.

  • 프로젝트
    MoizIbnYousaf/ai-agent-skills

    실제 npm 기반의 CLI/TUI로, AI 에이전트 기술의 정제된 라이브러리를 제공하고, 사용자가 자신의 기술 컬렉션을 빌드하고 관리할 수 있으며, Agent Skills 사양을 통해 여러 LLM 에이전트와 통합됩니다.

  • 프로젝트
    GPTomics/bioSkills

    bioSkills는 시퀀스 I/O에서 싱글셀, 변이 호출, 구조 생물학, 화학 정보학, 워크플로우 관리에 이르기까지 생물정보학 분석을 수행하는 데 사용할 수 있는 사전 준비된 코드 템플릿("스킬")의 라이브러리입니다. 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를 통해 설치할 수 있으며, 선택적인 2단계 분석을 위해 다양한 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 하드웨어에 대한 설정, 최적화 및 디버깅 단계를 자동으로 수행할 수 있도록 합니다.