본문으로 건너뛰기
cccskills
무료GitHub에 공개

systematic-debugging

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

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

ukwhatn/.claude
설치 방법 보기

포함된 파일(2)

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

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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 を参照。

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

codebase-review

무료

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

ukwhatn/.claude42026년 10월 19일 업데이트

commit

무료

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

ukwhatn/.claude42026년 10월 19일 업데이트

create-draft-pr

무료

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。

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

ukwhatn/.claude42026년 10월 19일 업데이트

create-skill

무료

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

ukwhatn/.claude42026년 10월 19일 업데이트

design-feature

무료

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

ukwhatn/.claude42026년 10월 19일 업데이트

designing-ui

무료

画面の設計判断（ナビゲーション・重ね方・通知と空状態と読み込み・外枠とトークンと状態表現）の型を決定表で選び、アプリ内の全画面で揃える。画面・ページ・レイアウト・ナビゲーション・ダイアログ・コンポーネントを新しく作る・作り直す時、モックやダッシュボードを作る時、サイドバー・タブ・モーダル・シート・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。

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

ukwhatn/.claude42026년 10월 19일 업데이트

ukwhatn의 스킬 모두 보기

이 스킬의 문제 신고