AgentSkillsCN

error-debugging-execution-rules

GrouMap 项目在出现错误时的排查与处理方案。在应对错误或进行调试请求时,用以统一终端命令的执行方式及权限授予的操作步骤。

SKILL.md
--- frontmatter
name: error-debugging-execution-rules
description: GrouMapプロジェクトでエラーが発生したときの調査・実行方針。エラー対応やデバッグ依頼時に、ターミナルでのコマンド実行・権限付与の進め方を統一するために使う。

Error Debugging Execution Rules

目的

エラー調査は、ユーザーの日本語だけでも原因仮説を立て、ターミナルで自分が再現・検証・修正まで進めることを標準にする。

実行ルール

以下を必ず順守する。

  1. 先に動く: 追加情報がなくても、まず自分で原因仮説を立ててコマンドを実行する。
  2. 再現を優先: 可能なら最短の再現手順を試し、ログやエラーを自分で取得する。
  3. 不足は後回し: 情報不足は自分の調査を進めた後に質問する。
  4. 権限は自分で実行: 権限が必要な操作は、承認を得て自分が実行する。ユーザーに手動実行させない。
  5. ログイン後は引き継ぐ: ログインが必要な場合はユーザーに依頼し、完了後は自分が続行する。

実行指針

迷ったら以下を優先する。

  • rg で該当箇所を特定し、関連ファイルを開く。
  • 直近のログや出力を自分で取得する(例: flutter run, dart run, firebase functions:log)。
  • 変更の影響範囲が大きい場合は、最小修正で切り分ける。

認証・再認証の扱い

  • Firebase CLI の認証が必要な場合は、firebase login --reauth を自分で実行する。
  • ブラウザでのログイン操作はユーザーに依頼し、完了後は自分が続行する。