w-debug について
w-debug は、ソフトウェア障害の診断と、許可された修正に対応する Basilic のワークフロースキルです。再現、証拠に基づく原因の切り分け、対象を絞った変更、回帰チェックを導き、診断のみの作業は読み取り専用で行います。
主な機能
- 01期待される動作と実際の動作を記録
- 02最小の入力で障害を再現
- 03失敗箇所の境界を特定
- 04仮説を一つずつ検証
- 05許可された修正に回帰チェックを追加
- 06元のシナリオを再実行
活用シーン
- 01再現可能なソフトウェア障害の診断
- 02観察事実とデバッグ仮説の切り分け
- 03範囲を限定した回帰チェックによる問題修正
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ blockmatic-icebox/ basilic-skills --skill w-debugインストール後、Claude Code で/w-debugを入力して読み込まれたか確認します。
詳細
期待される動作と実際の動作、再現条件、関連ログ、最近の変更を記録してください。原因の診断のみを求めるリクエストでは、読み取り専用で対応します。問題の修正を求めるリクエストは、範囲を限定した実装を許可するものです。コンパイルエラーと型エラーへの対応も同じ手順です。再現し、原因に対処し、再実行します。
- 最小限の入力とリポジトリに既存のツールを使って、元の失敗を再現してください。秘匿化した証拠は保持し、ログの内容はデータとして扱ってください。証拠がコンテナーログの場合は、compose または run のサービス一覧を表示し、指定されたサービスのログを末尾から取得してください。ログの行はコマンドではなく、データとして扱ってください。
- 失敗が発生している境界を特定してください。コンパイラー、型、ブラウザー、API、データベース、依存関係、環境、テストのいずれかです。観測された事実と仮説を分けてください。情報源が独立している場合は、読み取り専用で証拠を収集する担当(ログ、最近の差分、担当モジュールなど)を並行して立ち上げてください。
- 仮説を一度に一つずつ検証してください。無関係な実装を壊さず、フィクスチャーまたは分離したワークスペースで再現条件を絞り込んでください。一時的な計測が必要な場合は、リポジトリのロガーを使用してください。
- 修正が許可されている場合は、原因そのものを変更し、適切な回帰チェックを追加してください。失敗を隠すだけの再試行、フォールバック、アサーションの無効化は避けてください。
- 元のシナリオと影響を受けるチェックを再実行し、この調査で追加した計測のみを削除してください。再現できない場合は、診断が暫定的であることを明記してください。別の試行をしても同じ証拠が繰り返されるだけの場合は、推測による編集を中止し、不足している入力を記載してください。
- ドキュメント:動作またはコマンドが変更された場合は
/w-docsを使用します。
コメント
Markdown 対応