mcpField
A
analyzer-config

analyzer-config

github.com/managedcode開発49636 回インストール今日更新
リポジトリ

analyzer-config について

.NET リポジトリのアナライザー設定を扱うコーディングエージェント向けスキルです。ルールの方針をルートの `.editorconfig` に集約し、計画、反復レビュー、検証を通じて具体的な変更を行います。

主な機能

  1. 01設定作業の計画と反復
  2. 02アナライザー重大度の一元管理
  3. 03ルート `.editorconfig` の作成
  4. 04MSBuild とエディター設定の分離
  5. 05ビルドと最終検証

活用シーン

  1. 01リポジトリにルート `.editorconfig` を作成
  2. 02アナライザールールの管理元を明確化
  3. 03重大度設定の競合を解消

インストール

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

$npx skills add https://github.com/managedcode/dotnet-skills --skill analyzer-config

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

同梱ファイル

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

manifest.json
references/
analyzer-config.md
rules.md
template.md

詳細

.NET アナライザー構成

対象となるケース

  • リポジトリのルートに .editorconfig が必要な場合
  • アナライザーの重大度やスタイルの管理場所が不明確な場合
  • ルール構成の信頼できる唯一の情報源をチームが求めている場合

価値

  • コード、ドキュメント、構成、テスト、CI、レビュー成果物など、具体的なプロジェクト差分を作成します
  • 明示的な計画、検証、最終確認のスキルによって曖昧さを減らします
  • 再利用可能なプロジェクトのコンテキストを残し、今後の作業をより迅速かつ安全にします

使用しないケース

  • 構成を変更せずにアナライザーを選定する場合
  • 構成の管理場所について検討せず、フォーマットのみを実行する場合

入力

  • 最も近い AGENTS.md
  • 現在の .editorconfig
  • Directory.Build.props による上書き設定

クイックスタート

  1. 最も近い AGENTS.md を読み、対象範囲と制約を確認します。
  2. 成果が許容できるものになるまで、このスキルの Workflow に従って Ralph Loop を実行します。
  3. 具体的な成果物と検証の証拠を含めて、Required Result Format に従って返します。

ワークフロー

  1. root = true を指定した、リポジトリルートの .editorconfig を1つ用意することを優先します。
  2. より厳格なルール、生成コードの異なる扱い、テストやレガシーコードに対する異なるポリシーなど、サブツリーに明確なスコープ上の目的がある場合は、ネストした .editorconfig ファイルを追加します。
  3. 重大度は IDE の設定に分散させず、.editorconfig に記述します。
  4. 作成するファイルは、独自の「.NET 版」ではなく、正規の EditorConfig 形式にします。
    • ファイル名は小文字の .editorconfig
    • プリアンブルに root = true
    • インラインコメントなし
    • glob にはスラッシュを使用
  5. EnableNETAnalyzers のような一括切り替え設定は .editorconfig ではなく、MSBuild ファイルに記述します。
  6. .globalconfig は例外的なケースとして扱い、通常のリポジトリ構成にはしません。

未設定の場合の初期設定

アナライザー構成が求められているものの、まだ構成されていない場合：

  1. 現在の状態を確認します。
    • rg --files -g '.editorconfig' -g '.globalconfig'
    • rg -n "EnableNETAnalyzers|AnalysisLevel|AnalysisMode" -g '*.csproj' -g 'Directory.Build.*' .
  2. root = true を指定した、リポジトリルートの .editorconfig を1つ作成するか、既存のものを整理します。
  3. ルールの重大度を .editorconfig に移し、一括アナライザー切り替え設定はプロジェクトまたは MSBuild の構成に残します。
  4. サブツリーで異なるスコープのポリシーが実際に必要な場合に限り、ネストした .editorconfig ファイルを追加します。
  5. dotnet build SOLUTION_OR_PROJECT を実行し、status: configured または status: improved を返します。
  6. リポジトリで別の文書化済みアナライザー構成管理モデルを意図的に使用している場合は、status: not_applicable を返します。

成果物

  • 明確に定義されたアナライザー構成管理モデルを1つ
  • エージェントが安全に拡張できる、ルートの .editorconfig 構成

検証

  • ルールの重大度がローカルビルドと CI ビルドで再現可能であること
  • IDE のみの設定が、リポジトリのポリシーを暗黙に上書きしないこと
  • 既定の方法がルートの .editorconfig であり、予期しない代替手段ではないこと

Ralph Loop

ドキュメント、アーキテクチャ、テスト、ツールの作業を含め、すべてのタスクで Ralph Loop を使用します。

  1. まず計画を立てます（必須）。
    • 現在の状態を分析する
    • 目標、制約、リスクを定義する
    • 詳細な実行計画を作成する
    • 最後に実行する検証スキルを、順序と理由とともに列挙する
  2. 計画したステップを1つ実行し、具体的な差分を作成します。
  3. 結果をレビューし、実行可能な次の修正とともに所見を記録します。
  4. 小さな単位で修正を適用し、関連するチェックやレビュー手順を再実行します。
  5. 各イテレーションの後に計画を更新します。
  6. 成果が許容できるものになるか、明示的な例外だけが残るまで繰り返します。
  7. 依存関係が不足している場合は、それを初期設定するか、明確な理由と代替手段を示して status: not_applicable を返します。
必須の結果形式
  • status: complete | clean | improved | configured | not_applicable | blocked
  • plan: 簡潔な計画と現在のイテレーションのステップ
  • actions_taken: 実施した具体的な変更
  • validation_skills: 最後に実行したスキル、または省略した場合はその理由
  • verification: コマンド、チェック、レビューの証拠の概要
  • remaining: 未解決の主な項目、または none

実行を伴わないセットアップのみの依頼では、status: configured と次に実行する正確なコマンドを返します。

参照資料を読み込む

リクエスト例

  • 「.editorconfig を信頼できる唯一の情報源にしてください。」
  • 「このリポジトリ用に、適切なルート .editorconfig を作成してください。」
  • 「この .NET リポジトリで、競合するアナライザーの重大度を修正してください。」

コメント

Markdown 対応