Skip to content
cccskills
FreePublished on GitHub

systematic-debugging

バグ・エラー・テスト失敗・ビルド失敗・予期しない挙動のうち、最初の修正で直らなかった時、または原因を1行で説明できない時に使う根本原因調査の規律(根本原因調査→パターン分析→仮説検証→実装の4フェーズ)。症状への場当たり修正を防ぐ。

境界: 原因特定後の修正実装は writing-code、提出前の diff 確認は self-review。

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md3.6 KB
  • references/techniques.md2.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Systematic Debugging

修正の前に根本原因を特定する。症状への修正は、同じ原因から別の場所で再発するため。

Phase 1: 根本原因調査

  1. エラーメッセージを最後まで読む。スタックトレースの行番号・ファイルパス・エラーコードを控える
  2. 確実に再現する。再現できないうちは、修正でなくデータ収集を続ける
  3. 直近の変更を確かめる。git diff・最近のコミット・依存や config の変更・環境差分
  4. 原因を一次情報で特定する。エラーの意味は公式ドキュメント(context7 / WebSearch)で確かめる
  5. 複数コンポーネントの系では境界に診断ログを入れる。各境界で入る値・出る値・環境変数の伝播を記録して一度実行し、どの層で値が不正になるかを確かめてから、その層を調べる
  6. データフローを遡る。エラーが出た場所ではなく、不正な値の発生源を突き止める(references/techniques.md の root-cause-tracing)

Phase 2: パターン分析

  1. 同じコードベースで動いている類似コードを探す
  2. リファレンス実装・公式サンプルがあれば全行読む(パターンだけ真似ると部分理解のバグになる)
  3. 動くものと動かないものの差分をすべて列挙する。「関係ないはず」で外さない

Phase 3: 仮説検証

  1. 仮説を1つ書き出す(「X が根本原因。理由は Y」)
  2. 1仮説につき1変数だけ変えて検証する。複数の修正を同時に入れると、どれで直ったか切り分けられない
  3. 外れたら新しい仮説を立てる。外れた修正の上に修正を積まない
  4. 分からないなら「X が分からない」と書き、調査を続けるかユーザーに聞く

Phase 4: 実装

  1. 失敗するテストケースを先に作る(最小の再現。フレームワークが無ければ使い捨てスクリプトでよい)
  2. 特定した根本原因だけを直す。ついでの改善やリファクタを混ぜない。修正コードを書く前に /writing-code を発動する
  3. 元の再現手順で解消を確かめる
  4. 必要なら、実際にバグが通った経路に多層の防御を足す(references/techniques.md の defense-in-depth)

調べ尽くしても環境・タイミング・外部が原因なら、調べた内容を記録したうえで、リトライ・タイムアウト・エラーメッセージ・監視で扱う。

修正が3回失敗したら

4回目を試す前に止まり、アーキテクチャを疑う。修正のたびに別の場所で問題が出る、修正に大規模なリファクタが要る、のどちらかなら、仮説の外れではなく構造の問題であることが多い。ユーザーと構造を相談してから先へ進む。


出典: obra/superpowers(MIT License)を翻案。詳細はリポジトリルートの NOTICE.md を参照。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

コードベース全体のレビュー・監査。perf/sec/test/arch/cq/docs の6観点を並列委譲し、優先度付き issue ファイルと観点サマリをメモリディレクトリに生成する。コードベース全体の監査・定期レビュー・リリース前品質確認の依頼時、/codebase-review 実行時に使用。境界: PR 単位は pr-review、自ブランチの提出前確認は self-review。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

commit

Free

変更を git-cz 形式でコミットする。リポジトリの直コミット可否の判定手順と、push 後の CI・conflict の確認を含む。/commit 実行時、「コミットして」「pushして」等の依頼時に使用。--push 引数または「pushして」の依頼で push も行う。境界: PR 作成は create-draft-pr、PR コメントへの対応コミットは pr-comment から呼ばれる。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

PR を Draft で作成する。変更をローカルで動かして確かめ、画面が変わるならスクリーンショットを gh の --attach で貼り、PR テンプレートを全セクション埋めて対象 repo の既存 PR の分量に揃え、出した後は CI・レビュー・マージを Monitor で見張る。PR 作成の依頼時、実装が一段落して PR 化する時、/create-draft-pr 実行時に使用(gh pr create を直接実行しない)。引数でベースブランチを指定できる。境界: 個別レビューコメントへの対応は pr-comment、PR 全体のレビューは pr-review、複数 PR 規模の計画は plan-feature-prs。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

スキルを新規作成する。「スキルを作って」「この手順をスキル化して」等の依頼時、/create-skill 実行時に使用。AGENTS.md・context・既存スキルと整合させ、重複・競合を避ける。境界: 既存スキル・指示ファイルの修正は update-inst、指示ファイル全体の監査は instructions-audit。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

抽象的な要件・事業側の要求を深掘りし、既存実装との整合を確認して実装マスタとシステム要件書を作成する。「こういう機能を作りたい」「この要求を満たす機能を設計して」等の抽象要件の提示時、既存機能の拡張や Phase 分割の要件定義開始時、/design-feature 実行時に使用。境界: 要件確定後の実装計画書・PR 分割と実装進行は plan-feature-prs。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

画面の設計判断(ナビゲーション・重ね方・通知と空状態と読み込み・外枠とトークンと状態表現)の型を決定表で選び、アプリ内の全画面で揃える。画面・ページ・レイアウト・ナビゲーション・ダイアログ・コンポーネントを新しく作る・作り直す時、モックやダッシュボードを作る時、サイドバー・タブ・モーダル・シート・toast・バナー・空状態のどれを使うか決める時に使用。PJ に components.json があれば shadcn の部品とトークンへの対応も扱う。主要なデザインシステム(Material・HIG・Carbon・Primer・Atlassian・Fluent・GOV.UK・NN/g・WAI-ARIA APG・WCAG)の一致点を規則にし、食い違いの採否を定めてある。境界: 画面の文言は writing-ui-text、画面に何を出すかと提示前の完了基準は context/ui-artifact-standards.md、コードの実装原則は writing-code、shadcn 部品の API と組み立ては shadcn。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

See all skills by ukwhatn

Report a problem with this skill