Checklist de Correction de Code

VérifiéSûr

Cette compétence fournit une checklist structurée pour éviter les corrections guidées par les symptômes en identifiant la cause racine avant d'écrire du code. Elle vous guide pour lire la documentation, tracer le flux d'exécution et appliquer des modifications minimales. À utiliser lors de la correction de bugs ou de la modification d'implémentation pour éviter d'introduire de nouveaux problèmes.

Spar Skills Guide Bot
DeveloppementIntermédiaire
9002/06/2026
Claude Code
#root-cause-analysis#code-fixing#debugging#symptom-prevention

Recommandé pour

Notre avis

Cette compétence guide l'analyse des causes profondes avant de modifier du code, afin d'éviter les corrections basées uniquement sur les symptômes.

Points forts

  • Encourage une approche méthodique et structurée
  • Réduit les correctifs superficiels et les régressions
  • Favorise la compréhension du design et des flux

Limites

  • Peut ralentir le processus de correction si le problème est évident
  • Nécessite une documentation de conception existante
  • Ne convient pas aux corrections d'urgence en production
Quand l'utiliser

Utilisez cette compétence avant toute modification de code pour résoudre un bug ou une erreur.

Quand l'éviter

Évitez-la pour des corrections triviales (typo, changement de constante) ou quand une solution rapide est impérative.

Analyse de sécurité

Sûr
Score qualité85/100

The skill only uses Read, Glob, Grep tools—no execution of code, network, or destructive actions. It provides a methodological checklist for root-cause analysis, with no risk of malicious or unintended operations.

Aucun point d'attention détecté

Exemples

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]

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

手順

  1. コードを書くな — まず「なぜこのエラーが起きるか」を問う
  2. 設計を読むdocs/ やスキーマから意図された動作を理解する
  3. フローを追う — トリガー → 期待状態 → 乖離点を特定する
  4. 根本原因を特定 — エラー箇所と原因箇所は異なることが多い
  5. 最小限の修正 — 根本原因に対してのみ変更する

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

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

調査出力

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

Skills similaires