Communitygithub.com

Loop Engineering Skills(ループ・エンジニアリング・スキル)

AIコーディングエージェントのための「欠けている頭脳」——コードを書く前に検証ゲートを設置し、失敗から学ぶReflexionスタイルのメモリ、そして実アンカーを使った自己修正ループを備えています。Claude Codeなら1コマンドでインストール、その他のAIにはコピペプロンプトで利用可能です。

Loop Engineering Skills(ループ・エンジニアリング・スキル) とは?

Loop Engineering Skillsは、AIコーディングエージェントにReflexionスタイルのメモリ機構を提供するスキルです。各試行の後にエージェントが自身の行動を振り返り、その反省を `.loop/LESSONS.md` に書き留め、次の行動前にそれを読み直すことで、単なるリトライよりも大幅に性能を向上させます。研究(Shinn et al., 2023)では、意思決定タスクで22%、コードタスクで11%の改善が確認されています。Claude Codeでは「mcp-install haidrrrry/loop-engineering-skills」という1行のコマンドでインストールでき、その他のAIエージェント(Cursor, Codexなど)にはSKILL.mdに記載されたプロンプトをコピー&ペーストすることで同じ振る舞いを実現できます。このスキルの価値は「書かれた理由」にあり、単に記憶するのではなく失敗の根本的な原因(誤った仮定)を明文化し、重複する教訓を「Standing rules(常時ルール)」に昇格させてファイルサイズを管理する点にあります。

対応✓Claude Code~Codex CLI~Cursor
npx skills add haidrrrry/loop-engineering-skills

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Loop Memory(ループメモリ)

Reflexionスタイルの言語メモリ:エージェントは各試行について文章で振り返り、その振り返りを保存し、行動前に最近の振り返りを読み直します。研究(Shinn et al., 2023)によれば、このメカニズム——振り返り、保存、再読——は盲目的なリトライを大幅に上回ります(12回の試行での意思決定タスクで+22%、コードで+11%)。また、振り返りのない単なるメモリよりも8ポイント優れています。この利点は、書かれた理由に由来し、単にリトライを強化することからは得られません。

プロトコル

行動前(すべてのタスク)

  1. .loop/LESSONS.md を読む。
  2. Standing rules(常時ルール) セクションを無条件に適用する。
  3. 直近3件のエントリを読む。そのうちいずれかが現在のタスクに関連する場合、どのようにアプローチを変更するかを1行で述べる。関連するものがない場合は、無理に当てはめずにそのまま進む。

行動後(すべての試行、成功または失敗)

以下のフォーマットでエントリを1件ファイルに追加する:

## [日付] — [タスク名、5単語以内] — PASS|FAIL
- 何が起こったか:[1行]
- 根本原因/なぜうまくいったか:[1行]
- 次回:[1つの具体的で検証可能な指示]

「次回」の品質基準:

  • ❌ 「データベースにもっと注意する」——検証不可能
  • ✅ 「シードスクリプトの前に必ず npx prisma migrate deploy を実行する」——検証可能
  • ❌ 「APIがトリッキーだということを覚えておく」——曖昧
  • ✅ 「/users エンドポイントは50件でページネーションする;カウントするときは必ず ?page= を渡す」——検証可能

失敗時の振り返り、特に

試行が失敗した場合、振り返りは次の問いに答えなければなりません:自分は何を信じていたか、それは間違っていたか?失敗した試行は通常、タイプミスではなく誤った仮定に起因します。その仮定を明確にしてください。それが教訓です。

メンテナンス(ファイルが約30エントリを超えた場合)

  1. すべてのエントリを古い順に読む。
  2. 2回以上出現した教訓は Standing rules に昇格させ、1つの命令文として書き直す。
  3. 昇格後、最も古い20エントリを削除する。
  4. ユーザーの承認なしに Standing rules を削除してはいけない。

保存してはいけないもの

  • シークレット、キー、トークン、個人データ——たとえそれが失敗の原因であっても、絶対に保存しない。
  • ナレーション(「次にXを試したところ、Yが起こった…」)——結論のみを保存する。
  • 重複した教訓——すでに存在する場合は再追加せず、昇格を検討する。
  • 非難や自己批判——教訓は指示であり、感情ではない。

避けるべき失敗モード

  • メモリごっこ:エントリを書くが決して読まない。読むステップに価値があり、書くだけのステップは日記に過ぎない。
  • 単一インシデントへの過学習:1回限りの環境の不具合は教訓ではない。再発しないものは記録しない。
  • 無制限の成長:誰も読まない200エントリのファイルは死んだメモリである。圧縮せよ。

関連スキル