mcpField
A
add-diagnostic

add-diagnostic

github.com/vercel-labs開発24044 回インストール4 週間前に更新
リポジトリ

add-diagnostic について

add-diagnostic は、nostics の診断カタログにコードを追加する開発者向けのスキルガイドです。コードの命名、定義フィールド、呼び出し方を扱い、公開済みコードの安定性を重視します。

主な機能

  1. 01適切な診断カタログの特定
  2. 02規約に沿った安定コードの選定
  3. 03原因と任意の修正案の追加
  4. 04実行時フィールドの受け渡しと診断呼び出し

活用シーン

  1. 01新しいエラー種別の診断登録
  2. 02複数領域にまたがるカタログの拡張
  3. 03診断へのパラメーター付き原因と修正案の追加

インストール

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

$npx skills add https://github.com/vercel-labs/nostics --skill add-diagnostic

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

詳細

新しい診断コードを追加する

  1. カタログを見つけます。 defineDiagnostics を検索して、新しいエントリーを追加する codes オブジェクトを特定します。カタログが複数ある場合は、領域に応じて選択します。
  2. コードを決めます。 PREFIX_XNNNN:PREFIX はプロジェクト名を大文字にしたもの(NUXT、I18N)、X は領域を表す文字(B はビルド、R はランタイム、C は設定、D は非推奨)、NNNN は次に利用可能な番号です。既存のコードを確認して選んでください。公開済みのコードの名前を変更したり、再利用したりしないでください。
  3. エントリーを追加します。
LIB_R0001: {
  why: (p: { hook: string }) => `${p.hook}() must run at the top of setup().`, // string or typed fn; becomes Error.message (required)
  fix: 'Move the call into setup() or a composable it calls.', // optional, but add whenever the fix is known
  docs: 'https://example.com/custom', // optional: overrides docsBase, or `false` to opt out
},
  • 必須フィールドは why のみです。why と fix のパラメーターを組み合わせたものが、呼び出し側で必須になります。
  • 実行時フィールド(cause、sources)は呼び出し側で渡し、定義には含めません。
  1. 呼び出します: 報告するには diagnostics.LIB_R0001({ hook })、例外をスローするには throw diagnostics.LIB_R0001({ hook, cause: err }) を使います。どちらもレポーターを実行します。

API とレポーター/フォーマッター/プラグインの詳細については、nostics スキルを参照してください。

コメント