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」**のライブラリを提供します。これらは、Windows、macOS、Linuxで一般的なコンピューターの問題を診断・修正するための、ステップバイステップのエビデンスファーストな手順を説明しています。

核となる考え方は次のとおりです。

  1. まずエビデンスを収集する – ログ、システム状態、ハードウェア情報、ディスク使用量、ネットワーク構成などを読み取ります。
  2. 考えられる原因を説明する – 何も変更せずに、ランク付けされたリストを提示します。
  3. 影響が最小限の計画を提案する – 正確なコマンド、その影響、ロールバック手順、検証方法を示します。
  4. ユーザーが明示的に確認した後にのみ実行する。

このSkillは純粋なデータ（Markdown/YAML）と若干のヘルパースクリプトで構成されており、GUIや独自のAIモデルは同梱されていません。ホストエージェントが主要な処理（コマンドの実行、ユーザーへのプロンプト表示、ログの記録）を行います。

🛠️ インストール方法

方法 対象者 クイック手順
1文チャット 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 / Ethernet診断 – リンクアップから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 を審判とする判定、CEL 決定レイヤーを組み合わせて、プロンプトインジェクション、データ外部送信、悪意のあるコードパターンを検出します。pip でインストールし、CLI または Python SDK から実行し、GitHub Actions や pre-commit フックを介して CI/CD に統合できます。検出結果は重大度レベルで報告されます。クリーンなスキャンはベストエフォートのみであり、安全性を保証するものではありません。

  • プロジェクト
    MoizIbnYousaf/ai-agent-skills

    npm ベースの本格的な CLI/TUI で、AI エージェントスキルのキュレートされたライブラリを提供し、独自のスキルコレクションの構築・管理が可能。エージェントスキル仕様により、多数の 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ハードウェアのセットアップ、最適化、デバッグ手順を自動的に実行できるようにします。