CLAUDE.mdマスタースキル（作成/更新/改善）

--- name: claude-md-master description: CLAUDE.mdライフサイクルのマスタースキル - リポジトリ検証済みコンテンツとマルチモジュールサポートによる作成、更新、改善。CLAUDE.mdファイルの作成または更新時に使用します。 --- # CLAUDE.mdマスター（作成/更新/改善） ## 使用タイミング - ユーザーがCLAUDE.mdファイルの作成、改善、更新、標準化を依頼した場合。 ## 基本ルール - リポジトリまたは設定で検証された情報のみを含める。 - シークレット、トークン、認証情報、ユーザーデータを絶対に含めない。 - タスク固有または一時的な指示を絶対に含めない。 - 簡潔に保つ：ルートは200行以下、モジュールは120行以下。 - 箇条書きを使用し、長い散文を避ける。 - コマンドはコピー＆ペースト可能で、リポジトリのドキュメント/スクリプト/CIから取得すること。 - 空のセクションはスキップし、埋め草を避ける。 ## 必須入力（生成前に分析） - 検出されたスタックに関連するビルド/パッケージ設定（ルート+モジュール）。 - リポジトリで使用される静的解析設定（存在する場合）。 - 実際のモジュール構造とソースパターン（実際のディレクトリ/ファイルをスキャン）。 - モジュールごとの代表的なソースルートを抽出： パッケージ/機能構造、主要な型、使用中のアノテーション。 ## 発見（高速+ターゲット） 1. 既存のCLAUDE.mdバリアントを特定：`CLAUDE.md`、`.claude.md`、`.claude.local.md`。 2. 最小限の読み取りでスタックとエントリーポイントを特定： - `README.md`、関連する`docs/*` - ビルド/パッケージファイル（スタック参照を参照） - ランタイム/設定：`Dockerfile`、`docker-compose.yml`、`.env.example`、`config/*` - CI：`.github/workflows/*`、`.gitlab-ci.yml`、`.circleci/*` 3. リポジトリのスクリプト/設定/ドキュメントに存在する場合のみコマンドを抽出。 4. マルチモジュール構造を検出： - Android/Gradle：`settings.gradle`または`settings.gradle.kts`のincludesを読み取る。 - iOS：`*.xcodeproj`/`*.xcworkspace`内の複数ターゲット/ワークスペースを検出。 - 複数のモジュール/ターゲットに`src/`またはビルド設定がある場合、モジュールCLAUDE.mdファイルを計画。 5. 各モジュール候補について、ビルドファイル+最小限のドキュメントを読み取り、 モジュール固有の目的、エントリーポイント、コマンドを把握。 6. ソースルートをスキャン： - トップレベルのパッケージ/機能フォルダとレイヤー規約。 - 使用中の主要なアノテーション/型（スタック参照ごと）。 - コードベースで使用される命名規約。 7. ドキュメントまたはコードパターンから、明白でないワークフロー/落とし穴を取得。 パフォーマンス： - ファイル一覧+ターゲット読み取りを優先。 - セクションまたはシンボルで十分な場合は、ファイル全体の読み取りを避ける。 - 大きなディレクトリをスキップ：`node_modules`、`vendor`、`build`、`dist`。 ## スタック固有の参照（パターン2） 検出シグナルがある場合のみ、関連する参照を読み取る： - Android/Gradle → `references/android.md` - iOS/Xcode/Swift → `references/ios.md` - PHP → `references/php.md` - Go → `references/go.md` - React（ウェブ） → `references/react-web.md` - React Native → `references/react-native.md` - Rust → `references/rust.md` - Python → `references/python.md` - Java/JVM → `references/java.md` - Nodeツール → `references/node.md` - .NET/C# → `references/dotnet.md` - Dart/Flutter → `references/flutter.md` - Ruby/Rails → `references/ruby.md` - Elixir/Erlang → `references/elixir.md` - C/C++/CMake → `references/cpp.md` - その他/不明 → `references/generic.md`（特定の参照が一致しない場合のフォールバック） 複数のスタックが検出された場合、複数の参照を読み取る。 スタックが認識されない場合、汎用参照を使用する。 ## マルチモジュール出力ポリシー（検出時は必須） - 常にルート`CLAUDE.md`を作成する。 - 意味のある各モジュール/ターゲットルート内にも`CLAUDE.md`を作成する。 - 「意味がある」=独自のビルド設定と`src/`（または同等）を持つ。 - `buildSrc`、`gradle`、`scripts`、`tools`などのツールのみのディレクトリはスキップ。 - モジュールファイルはモジュール固有で、重複を避ける： - 目的、主要パス、エントリーポイント、モジュールテスト、モジュール コマンド（存在する場合）を含める。 - 共有情報は`@/CLAUDE.md`を参照。 ## ビジネスモジュールCLAUDE.mdポリシー（全スタック） モノレポビジネスロジックディレクトリ（`src/`、`lib/`、`packages/`、`internal/`）の場合： - 5ファイルを超えるモジュール、または独自のREADMEがあるモジュールには`CLAUDE.md`を作成 - ユーティリティのみのディレクトリをスキップ：`Helper`、`Utils`、`Common`、`Shared`、`Exception`、`Trait`、`Constants` - レイヤー構造は必須ではない。アーキテクチャに関係なくモジュール情報を提供 - モジュールCLAUDE.mdあたり最大120行 - 共有アーキテクチャ/パターンは`@/CLAUDE.md`でルートを参照 - 含める：目的、構造、主要クラス、依存関係、エントリーポイント ## 必須出力セクション（モジュールCLAUDE.mdごと） コードベースで検出された場合、これらのセクションを含める（存在しない場合のみスキップ）： - **機能/コンポーネントインベントリ**：ソースルート直下のトップレベルディレクトリを一覧表示 - **コア/共有モジュール**：ユーティリティ、共通、または共有コードディレクトリ - **ナビゲーション/ルーティング構造**：ナビゲーショングラフ、ルート、またはルーター - **ネットワーク/APIレイヤーパターン**：APIクライアント、エンドポイント、レスポンスラッパー - **DI/インジェクションパターン**：モジュール、コンテナ、またはインジェクション設定 - **ビルド/設定ファイル**：モジュール固有の設定（proguard、マニフェストなど） 検出および報告する正確なパターンについては、スタック固有の参照を参照。 ## 更新ワークフロー（必ず従う） 1. ターゲットを絞った追加のみを提案し、ファイルごとに差分を示す。 2. 更新を適用する前に承認を求める： **Cursor IDE:** AskQuestionツールを以下のオプションで使用： - id: "approval" - prompt: "これらのCLAUDE.md更新を適用しますか？" - options: [{"id": "yes", "label": "はい、適用"}, {"id": "no", "label": "いいえ、キャンセル"}] **Claude Code（ターミナル）:** 提案された変更を出力して尋ねる： 「これらの更新を承認しますか？（はい/いいえ）」 続行する前に停止してユーザーの応答を待つ。 **その他の環境（フォールバック）:** 構造化された質問ツールが利用できない場合： 1. 提案された変更を明確に表示 2. 尋ねる：「これらの更新を承認しますか？適用するには「はい」、キャンセルするには「いいえ」と返信してください。」 3. 続行する前に明示的なユーザー確認を待つ 3. カスタムコンテンツを保持して更新を適用。 CLAUDE.mdが存在しない場合、承認用に新しいファイルを提案。 ## コンテンツ抽出ルール（必須） - コードベースからのみ： - 抽出：使用される型/クラス/アノテーション名、実際のパスパターン、 命名規約。 - 絶対にしない：ハードコードされた値、シークレット、APIキー、ビジネス固有のロジック。 - 絶対にしない：Do/Do Notルール内のコードスニペット。 ## 書き込み前の検証 - [ ] すべてのルールがコードベースの実際の型/パスを参照している - [ ] Do/Do Notセクションにコード例がない - [ ] パターンがコードベースの実際の内容と一致している（古くない） ## コンテンツルール - 含める：コマンド、アーキテクチャ概要、主要パス、テスト、落とし穴、ワークフローの癖。 - 除外：一般的なベストプラクティス、明白な情報、未検証の記述。 - 重複を避けるために`@path/to/file`インポートを使用。 - Do/Do Not形式は任意。ファイルですでに使用されている場合のみ保持。 - 短いコピー＆ペーストコマンドを除き、コード例を避ける。 ## 既存ファイル戦略 検出： - `<!-- Generated by claude-md-editor skill -->`が存在する場合 → 後続実行 - それ以外 → 初回実行 初回実行+既存ファイル： - `CLAUDE.md`を`CLAUDE.md.bak`にバックアップ - `.bak`をソースとして使用し、再利用可能でプロジェクト固有の情報のみを抽出 - 新しい簡潔なファイルを生成し、マーカーを追加 後続実行： - 古くなっているか不正確でない限り、カスタムセクションと表現を保持 - 現在のリポジトリ状態と矛盾するもののみを更新 - 実際の価値を追加する場合のみ、欠落セクションを追加 `.claude.local.md`を絶対に変更しない。 ## 出力 更新後、簡潔なレポートを印刷： ``` ## CLAUDE.md更新レポート - /CLAUDE.md [作成 | バックアップ+作成 | 更新] - /<module>/CLAUDE.md [作成 | 更新] - バックアップ：`.bak`ファイルを一覧表示 ``` ## 検証チェックリスト - 説明が具体的で、トリガー用語を含む - プレースホルダーが残っていない - シークレットが含まれていない - コマンドが実際に存在し、コピー＆ペースト可能 - レポート優先ルールが尊重されている - 参照が1レベル深さである