Agent skill
systematic-debugging
体系的デバッグスキル。根本原因調査を先に行い、修正は後に行う規律あるアプローチ。
Install this agent skill to your Project
npx add-skill https://github.com/HaRu-LLC/ai-pm_system_notebooklmuse/tree/main/.agent/skills/engineering/systematic-debugging
SKILL.md
目的
問題解決に規律あるアプローチを確立。修正を試みる前に根本原因調査を必須とする。
トリガー語
- 「デバッグ」
- 「バグ調査」
- 「根本原因を特定」
- 「体系的にトラブルシュート」
コアフレームワーク
4つの連続フェーズを必須とする:
1. 根本原因調査
- エラーを分析
- 問題を再現
- 最近の変更をレビュー
- システム層を通じてデータフローを追跡
2. パターン分析
- 動作する例を研究
- 壊れたコードとの違いを特定
3. 仮説とテスト
- 具体的な理論を形成
- 最小限の変更でテスト
4. 実装
- 失敗テストを作成
- 単一の修正を適用
- 結果を検証
絶対ルール
「根本原因調査なしに修正しない」
症状修正は新たな問題を生む。
回避すべきレッドフラグ行動
| 危険パターン | 問題 |
|---|---|
| 理解前に解決策を提案 | プロセスのバイパス |
| 複数の同時変更 | 何が効いたかわからない |
| 3回以上の修正試行 | アーキテクチャ再評価が必要 |
| 時間圧力下での「クイックフィックス」 | 新バグの温床 |
エスカレーションポイント
3回以上の修正試行が失敗した場合
問題は単なるバグではなく、根本的なアーキテクチャ問題の可能性が高い。追加パッチではなく、設計への疑問が必要。
重要な洞察
体系的調査は、試行錯誤アプローチと比較して実際に時間を節約する
スラッシングと新バグ導入の両方を防ぐ。
ライセンス
MIT License (superpowers repository)
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
skills-creator
最高品質のSkillを設計・生成するメタスキル。新しいSkillが欲しい、繰り返し作業を自動化したい、ベストプラクティスに準拠したSkillを作りたいときに使う。
workflow-designer
複数のSkillsを連動させた一連のワークフローを設計するメタスキル。ユーザー確認ポイント、依存関係、エラー時のフォールバックを含む完全なワークフロー定義を生成。
template-miner
過去資料からテンプレ・スタイルガイド・チェックリストを抽出して資産化する。テンプレが無い、文書品質がバラつく、過去資料を活用したいときに使う。
brainstorming
ブレインストーミングスキル。アイデアを実装前に仕様に変換する協調的デザインプロセス。
test-driven-development
テスト駆動開発(TDD)の厳格な実践スキル。テストを先に書き、実装を後に書く規律あるアプローチ。
writing-plans
実装計画作成スキル。マルチステップ開発タスク向けの詳細な計画を生成する。
Didn't find tool you were looking for?