Communityコーディング&開発github.com

会勇禾口王のCLAUDE.md 診断スキル

CLAUDE.md をランタイム設定として扱うベストプラクティスに基づき、プロジェクトを0〜100点でスコアリングし、改善提案を提供する診断ツールです。

会勇禾口王のCLAUDE.md 診断スキル とは?

このスキルは、AIエージェント(Claude Codeなど)の設定ファイルであるCLAUDE.mdを、単なるメモ書きではなく「ランタイム設定」として適切に活用できているかを評価するための診断ツールです。プロジェクトのCLAUDE.mdを解析し、ベストプラクティスに基づいたスコアリング(0〜100点)と具体的な改善提案を提供します。内部的にはPythonで実装されており、外部依存関係が不要で、CLIから直接実行するか、Claude Code内で「檢查我的 CLAUDE.md」と指示することで呼び出せます。開発者にとっては、CLAUDE.mdの品質を客観的に把握し、効果的なAIエージェントとの連携を実現するための強力なフィードバックループを提供します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add huiyonghkw/hekouwang-claude-md-doctor-skill

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

会勇禾口王のCLAUDE.md 診断スキル は何をしますか?

会勇禾口王のAIノート · CLAUDE.md 診断器:CLAUDE.md をランタイム設定として扱うベストプラクティスに従い、プロジェクトを0〜100点でスコアリングし、改善提案を行います。依存関係のないPythonスクリプトで、Claude Code内で「檢查我的 CLAUDE.md」と言って直接呼び出すこともできます。

使い方

python doctor.py /path/to/project/CLAUDE.md

または、Claude Code内で次のように指示します:

檢查我的 CLAUDE.md

スコアリング基準

CLAUDE.md が以下のベストプラクティスに従っているかをチェックします:

  • 構造化: セクションが明確で、手順が定義されているか
  • 具体性: 抽象的な説明ではなく、具体的なコマンドや設定を含んでいるか
  • 最新性: プロジェクトの現状を反映しているか
  • 一貫性: ツールや依存関係の記述に矛盾がないか
  • 充実度: カバーすべき領域(ビルド、テスト、デプロイなど)を網羅しているか

出力例

スコア: 72/100
✅ 構造化: 良好(セクションが明確)
⚠️ 具体性: 改善余地あり(コマンド例が不足)
❌ 最新性: 古い設定を参照している

インストール

リポジトリをクローンして、スクリプトを直接使用します:

git clone https://github.com/huiyonghkw/hekouwang-claude-md-doctor-skill.git
cd hekouwang-claude-md-doctor-skill

依存関係

  • Python 3.6以上(標準ライブラリのみ)
  • 外部パッケージは不要

フィードバック

問題や改善提案があれば、GitHub Issueを作成してください。

関連スキル