Menu
バグ、テスト失敗、予期しない挙動に遭遇した時に使用。修正提案の前に根本原因を特定する規律スキル。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | systematic-debugging |
| description | バグ、テスト失敗、予期しない挙動に遭遇した時に使用。修正提案の前に根本原因を特定する規律スキル。 |
| version | 1.0.1 |
| tags | ["discipline","debugging","root-cause","systematic"] |
当てずっぽうの修正は時間の無駄であり、新たなバグを生む。
Core principle: 修正の前に必ず根本原因を特定せよ。症状の修正は失敗である。
根本原因の調査なしに修正を提案するな
Investigation を完了していないなら、修正を提案する資格はない。
あらゆる技術的問題に使え:
特にこういう時:
各ステップを完了してから次に進め。ステップは名前で参照する（番号は使わない）。
修正を試みる前に:
エラーメッセージを丁寧に読む
再現を確認する
最近の変更を確認する
git diff、最近のコミットマルチコンポーネントの場合: 各層にログを仕込む
各コンポーネント境界で:
- 入力データをログ
- 出力データをログ
- 環境/設定の伝播を検証
→ 1回実行してどこで壊れるか証拠を集める
→ その特定コンポーネントを調査
データフローを追跡する
科学的方法で:
失敗するテストケースを作る - tdd スキルに従う
1つの修正を実装 - 根本原因に対処。ONE change at a time
修正を検証 - テスト通過？ 他テストは壊れていない？
修正が効かない場合:
| 言い訳 | 現実 |
|---|---|
| 「シンプルだからプロセス不要」 | シンプルなバグにも根本原因がある |
| 「緊急だからプロセス省略」 | 体系的デバッグは当て推量より速い |
| 「まずこれを試してから調査」 | 最初の修正がパターンを決める。最初から正しくやれ |
| 「問題が見えた、直す」 | 症状を見た ≠ 根本原因を理解した |
| 「もう1回だけ修正」（2回失敗後） | 3回失敗 = アーキテクチャの問題。パターンを疑え |
| Step | 主な活動 | 完了条件 |
|---|---|---|
| Investigation | エラー読解、再現、変更確認 | WHATとWHYを理解 |
| Pattern Analysis | 動作例との比較 | 差異を特定 |
| Hypothesis | 仮説立案、最小検証 | 確認または新仮説 |
| Fix | テスト作成、修正、検証 | バグ解決、テスト通過 |
デバッグの学びは creo-memories に記録を推奨:
作業の完了を宣言する前に使用。証拠なき完了宣言を防ぐ規律スキル。
AI agent の action space・tool 定義・observation format を設計し、completion rate を上げる。 agent harness を構築・最適化するときの語彙と判断軸を提供する。
AI agent 自身の failure (loop / drift / max tool call / 環境ズレ) に対する構造化 self-debug。 capture → diagnose → contained recovery → introspection report の 4 phase で、 retry blind を防ぎ human escalation の前に agent が自己修正する。
Chronistaとして活動するための包括的スキルセット。永続記憶、開発フロー、ドキュメント管理、インフラを統合。
Mac M-series で Rust binary を zigbuild で linux/amd64 に cross-compile → slim Dockerfile に COPY → docker buildx --push する開発ループ標準化。 sccache + zig cache + cargo target/ + buildx registry cache の多層 cache を仕込み、 2 回目以降は秒単位の image 更新を実現する。 GH Actions (cargo-chef + GHA cache 10 GiB 制限) からの脱却 path として使う。
コードレビューの実行手法と規律。スコープに応じて Quick / Standard / Deep モードを選択、team-bucciarati の Stand を観点別に dispatch。レビューする側 / 受ける側の両方をカバー。