Retro Failure Linter — AIエージェント連続失敗・5大不全検出CLI【無料MIT】
- Digital0 JPY

Retro Failure Linter — AIエージェント連続失敗・5大不全検出CLI【無料MIT】 AI エージェントの作業ログ(JSONL または Markdown)を読み、同じ失敗の繰り返しなど 5 種類の不全パターンを行番号つきで検出する、無料のコマンドラインツールです(v1.0.0 / MIT ライセンス)。同じ失敗の署名が 3 回目に現れると escalate: true を出し、終了コード 1 で止めます。 Node.js 20 以上の標準ライブラリのみで動作し、npm の追加パッケージ・外部通信・タイムスタンプ依存はありません。同じログからは常に同じレポートが出ます。 ■ 検出する 5 つのモード ・repeat_failure … 同じ失敗の反復(番号・パス・ハッシュ等を正規化して同一署名として集計) ・unverified_claim … 根拠のない「完了/修正済み/テスト全通過」の宣言 ・guardrail_drift … --no-verify、git push --force、rm -rf などの防護の迂回 ・scope_creep … 依頼範囲を超えた作業の拡大 ・tool_misuse … ツールの誤用、同じ呼び出しの連続ループ ■ 2 回失敗したら止める(エスカレーション規則) ・同じ署名の失敗が 2 回 … repeat_failure(medium)。次の試行は再試行ではなくエスカレーションが必要です。 ・3 回以上 … escalate: true、repeat_failure(high)、人が読める escalation_reason を出力し、終了コード 1。 ■ 使い方(30 秒) node bin/retro-lint.mjs session.jsonl node bin/retro-lint.mjs session.jsonl --format json --out report.json ・終了コード: 0 = 問題なし/1 = エスカレーションまたは high の指摘あり/2 = 引数・ファイルの誤り ・JSONL、Markdown、混在ファイルに対応。CRLF と UTF-8 BOM も扱えます。 ・JavaScript API(lintFile / lintLog / renderMarkdown など)も使えます。 ■ 同梱内容(ZIP: free-02-retro-failure-linter-v1.0.0.zip) LICENSE(MIT)、README.md / README.ja.md、bin/retro-lint.mjs、src/linter.mjs、test/linter.test.mjs、package.json ■ 検証状況(Windows 11 / Node.js 24.14.0) ・同梱テスト 21 件すべて合格 ■ 制限事項(事前明記) ・パターンベースの検査であり、判定器ではありません。珍しい言い回しの失敗は見逃すことがあり、無害な文を指摘することもあります。指摘は「見直しの合図」としてお使いください。 ・パターンは英語と一部の日本語表現が対象です。 ・unverified_claim は直前 8 イベントに成功結果があるかで判断します。それより前や文章中だけの根拠は見えません。 ・これは事後検査です。動作中のエージェントを止めることはできません。 ■ ライセンス MIT ライセンス(同梱 LICENSE)。商用利用・改変・再配布が可能です。 ■ 関連ツール・上位版 有料の CLI ツールを含む他の作品はこちら: https://pikuto.booth.pm/
