Agent skill

failure-logging

エラー発生時、アプローチ失敗時に使用。失敗DBを構築し同じ失敗を繰り返さない。

Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/TakumiOkayasu/dotfile-work/tree/main/claude/skills/failure-logging

SKILL.md

Failure Logging

トリガー条件

以下のいずれかに該当する場合、このスキルを即時発動する:

  • コマンドがエラーになった時
  • 試したアプローチがうまくいかなかった時
  • 同じ問題で2回以上つまずいた時
  • 新しいアプローチを試みる直前
  • /compact 後(コンテキストリセット後の再開時)

前提条件

  • claude_tmp/failure_log/ ディレクトリが存在すること(なければ作成)
  • 連番は既存ファイルの最大連番から継続する

手順

フェーズ1: 失敗記録(失敗発生時)

Step 1. 対象ファイルを特定する

claude_tmp/failure_log/[連番範囲]-fail.md
例: 1-100-fail.md(1〜100件目)

Step 2. 次の連番を確認する(既存ファイルの末尾を読む)

Step 3. 以下フォーマットで追記する:

markdown
## [連番]
- 何をしようとしたか:
- 試した手法/コマンド:
- 結果 (エラー内容):
- 原因 (明確な場合のみ):

Step 4. 100件到達時は新ファイルを作成する(101-200-fail.md 等)


フェーズ2: 履歴参照(新アプローチ実施前)

Step 1. claude_tmp/failure_log/ 内の全ファイルを列挙する

Step 2. 関連する失敗エントリを検索する(問題キーワードで絞り込む)

Step 3. ✅ 解決済み マークの有無を確認する

Step 4. 過去の失敗手法を除外した上でアプローチを選定する


フェーズ3: 解決時の更新

Step 1. 該当エントリに ✅ 解決済み をマークする

Step 2. 解決方法を追記する:

markdown
## [連番] ✅ 解決済み
- 何をしようとしたか:
- 試した手法/コマンド:
- 結果 (エラー内容):
- 原因 (明確な場合のみ):
- 解決方法:

出力形式

記録完了時は以下を出力する:

✅ 失敗記録: claude_tmp/failure_log/1-100-fail.md #[連番]

参照完了時は以下を出力する:

📋 履歴確認済み: [件数]件の関連失敗を確認。除外手法: [手法名]

禁止事項

禁止 理由
失敗を記録せずに次へ進む 失敗DBが構築されない
履歴を読まずに同じアプローチを試す 同じ失敗を繰り返す
過去の失敗DBを無視する 蓄積が無意味になる
原因不明時に原因を推測記入する 誤情報が混入する
フォーマットを変更する 検索・参照が困難になる

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results