mcpField
S
skill-review

skill-review

github.com/jezwebテスト・品質1.1k353 回インストール3 週間前に更新
リポジトリ

skill-review について

9段階のレビュー手順で他のスキルを監査・更新するためのスキルです。ファイルやバージョンの自動検査に加え、API、例、ドキュメントを手動で確認します。

主な機能

  1. 019段階のスキル監査プロセス
  2. 02YAMLとバージョンの自動チェック
  3. 03APIとコード例の検証
  4. 04指摘事項の重大度分類
  5. 05修正とバージョン更新の指針

活用シーン

  1. 01リリース前のスキルレビュー
  2. 02古いAPIや依存関係の発見
  3. 03スキル内ファイルの整合性確認
  4. 04監査結果の優先順位付けと記録

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jezweb/claude-skills --skill skill-review

インストール後、Claude Code で/skill-reviewを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
.claude-plugin/
plugin.json
references/
audit-report-template.md

詳細

スキルレビュースキル

プロセス

実行：/review-skill <skill-name>、または古くなったパターンを検出したときにこのスキルを使用します

本番環境での実績：better-auth の監査（2025-11-08）で、存在しない API のインポートを含む重大な問題が6件見つかりました。誤ったコードを665行削除し、v2.0.0 を実装しました

9段階の監査

  1. レビュー前：スキルをインストールし、バージョン／日付を確認して、検出をテストします
  2. 標準：YAML、キーワード、三人称の文体、ディレクトリ構造を検証します
  3. 公式ドキュメント：WebFetch／Context7 で API パターン、GitHub の更新、npm のバージョン、本番環境のリポジトリを確認します
  4. コード例：インポートの存在、API シグネチャの一致、スキーマの整合性、テンプレートの動作を検証します
  5. ファイル間の整合性：SKILL.md と README.md を比較し、バンドルされたリソースがファイルと一致することを確認します
  6. 依存関係：./scripts/check-versions.sh を実行し、破壊的変更を確認して、「Last Verified」を検証します
  7. 分類：証拠（GitHub／ドキュメント／npm）とともに重大度（🔴 Critical ／ 🟡 High ／ 🟠 Medium ／ 🟢 Low）を付けます
  8. 修正：明確なものは自動修正し、アーキテクチャに関わるものはユーザーに確認し、すべてのファイルを更新して、バージョンを上げます
  9. 検証：検出をテストし、テンプレートの動作、矛盾がないことを確認して、変更履歴とともにコミットします

自動処理（./scripts/review-skill.sh による）：YAML 構文、パッケージのバージョン、リンク切れ、TODO、ファイル構成、古さ

手動処理（AI）：API メソッドとドキュメントの照合、GitHub のイシュー、本番環境との比較、コードの正確性、スキーマの整合性

重大度の分類

🔴 CRITICAL：存在しない API／インポート、無効な設定、依存関係の不足

🟡 HIGH：互いに矛盾する例、一貫性のないパターン、古くなったメジャーバージョン

🟠 MEDIUM：古くなったマイナーバージョン（>90日）、ドキュメントのセクション不足、不完全なエラー情報

🟢 LOW：誤字、書式、任意のメタデータの不足

修正の判断

自動修正：明確である（ドキュメントに基づく正しいインポート）、明確な証拠がある、アーキテクチャへの影響がない

ユーザーに確認：有効なアプローチが複数ある、破壊的変更がある、アーキテクチャ上の選択が必要

バージョンの更新

  • メジャー（v1→v2）：API パターンの変更
  • マイナー（v1.0→v1.1）：新機能、後方互換性あり
  • パッチ（v1.0.0→v1.0.1）：バグ修正のみ

例：better-auth の監査（2025-11-08）

🔴 CRITICAL #1：'better-auth/adapters/d1' から存在しない d1Adapter をインポート

  • 証拠：公式ドキュメントには drizzleAdapter が記載されており、GitHub に d1Adapter のエクスポートはなく、本番環境のリポジトリ4件では Drizzle／Kysely が使用されています
  • 修正：'better-auth/adapters/drizzle' から drizzleAdapter に置き換えました

結果：3ファイルを削除（古いファイル）、3ファイルを作成（正しいパターン）、+1,266行、v1.0→v2.0、3.5時間

防止できた問題（10件）

  1. 偽の API アダプター - 存在しないインポート
  2. 古い API メソッド - シグネチャの変更
  3. スキーマの不整合 - テーブル名の不一致
  4. 古いスクリプト - 非推奨の方法
  5. バージョンの乖離 - 90日以上古いパッケージ
  6. 矛盾する例 - 互いに競合する複数のパターン
  7. リンク切れ - 404 の URL
  8. YAML エラー - 無効なフロントマター
  9. キーワードの不足 - 検出されにくい
  10. 不完全なバンドルリソース - 記載されたファイルが存在しない

バンドルリソース

計画：~/.claude/skills/../planning/SKILL_REVIEW_PROCESS.md またはリポジトリの planning/SKILL_REVIEW_PROCESS.md（9段階の完全ガイド）

スクリプト：リポジトリのルートにある scripts/review-skill.sh（自動検証）

コマンド：リポジトリのルートにある commands/review-skill.md（スラッシュコマンド、~/.claude/commands/ にシンボリックリンク）

リファレンス：references/audit-report-template.md（出力テンプレート）

最終確認日：2026-01-09 | バージョン：1.0.1

コメント

Markdown 対応