Our review

This skill guides root cause analysis before modifying code, preventing symptom-driven fixes.

When to use it

Use this skill before any code modification to resolve a bug or error.

When not to use it

Avoid it for trivial fixes (typo, constant change) or when a quick solution is imperative.

Examples

Bug fix in auth module

I need to fix the login error that shows 'Invalid credentials' for valid users.

Test failure root cause

The unit test for the payment service is failing. Help me find the root cause.

Japanese prompt example

このバリデーションエラーを修正してください。

name: fix-checklist description: Use when about to fix code, modify implementation, or address errors. MUST read before saying "修正します", "fix", "修正する", "直す", "対処する". Prevents symptom-driven fixes. allowed-tools: [Read, Glob, Grep]

症状駆動の修正を防ぐため、コード変更前に根本原因を特定する。

手順

| エラー箇所 | 根本原因の典型 | |-----------|--------------| | 実行時バリデーション | スキーマ定義 | | 型不一致 | インターフェース契約 | | テスト失敗 | 実装ロジック |

Bad: 「X が Y にないので Y に X を追加」→ なぜ X が生成されるか未調査 Good: 「なぜ X が生成される？設計上 X は不正 → 生成元を修正」

複雑な問題は tmp/investigation/<issue>/ に mermaid図で構造化する（overview.md, trace.md, root-cause.md）。1ファイル500行以内。