Agent Skills: Failure Logging

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

UncategorizedID: TakumiOkayasu/dotfile-work/failure-logging

Install this agent skill to your local

pnpm dlx add-skill https://github.com/TakumiOkayasu/dotfile-work/tree/HEAD/claude/skills/failure-logging

Skill Files

Browse the full folder contents for failure-logging.

Download Skill

Loading file tree…

claude/skills/failure-logging/SKILL.md

Skill Metadata

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

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. 以下フォーマットで追記する:

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

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. 解決方法を追記する:

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

出力形式

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

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

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

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

[件数] = 関連キーワードでヒットした全エントリ数(解決済み含む)。[手法名] = そのうち未解決エントリの「試した手法/コマンド」欄に記載された手法(カンマ区切り、無ければ「なし」)。


禁止事項

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