observe-before-editing について
コード変更前に実際の出力、ファイル、ログを確認するデバッグ向けスキルです。推測ではなく証拠から問題を特定する手順を示します。
主な機能
- 01ディレクトリとファイルの存在確認
- 02ログ内のエラー確認
- 03失敗したコマンドの手動実行
- 04プロジェクトとグローバルのパス確認
活用シーン
- 01フックの実行状況の調査
- 02キャッシュファイル生成の確認
- 03コマンドエラーからの障害特定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/observe-before-editingを入力して読み込まれたか確認します。
詳細
編集する前に観察する
バグを修正するためにコードを編集する前に、システムが実際に何を出力したかを確認してください。
パターン
出力は嘘をつきません。コードは嘘をつくことがあります。まず出力を確認してください。
推奨事項
- 想定したディレクトリが存在するか確認します：
ls -la .claude/cache/ - 想定したファイルが作成されたか確認します：
ls -la .claude/cache/learnings/ - エラーがないかログを確認します：
tail .claude/cache/*.log - 失敗したコマンドを手動で実行し、実際のエラーを確認します
- その後でのみコードを編集します
禁止事項
- 出力を確認せずに「フックが実行されなかった」と決めつける
- 実際に起きるはずだと思い込んでコードを編集する
- グローバルパスとプロジェクトパスを混同する（両方確認します：
.claude/と~/.claude/）
セッションの記録
- a541f08a：手動実行で判明するまで、トークン制限エラーが見えませんでした
- 6a9f2d7a：誤ったキャッシュパスを確認し（
~/.claude/と.claude/）、フックの失敗だと思い込みました - a8bd5cea：プロジェクトのキャッシュに出力ファイルがあることを確認し、フックが機能したと確かめました
- 1c21e6c8：DB ファイルの存在を確認して、Artifact Index のインデックス作成を検証しました
コメント
Markdown 対応