mcpField
S
self-improving-for-codex

self-improving-for-codex

github.com/godgod126エージェントワークフロー12960 回インストール11 週間前に更新
リポジトリ

self-improving-for-codex について

`AGENTS.md`と構造化されたメモリディレクトリを使い、Codexに継続的な自己改善ループを設定するスキルです。既存設定の監査、メモリ整理、ルールの昇格、任意の夜間レビューを支援し、`AGENTS.md`の自動編集を防ぎます。

主な機能

  1. 01既存ルールとメモリの監査
  2. 025つのメモリファイルの整理
  3. 03`AGENTS.md`を介したメモリ運用
  4. 04学びを昇格するルールの定義
  5. 05任意の夜間レビュー

活用シーン

  1. 01Codexの継続的なメモリ設定
  2. 02学びとデバッグ記録の整理
  3. 03定期的なメモリ保守の設計

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/godgod126/self-improving-for-codex --skill self-improving-for-codex

インストール後、Claude Code で/self-improving-for-codexを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE
README.md
agents/
openai.yaml
references/
agents-snippet.md
nightly-review.md
memory-files.md

詳細

Codex の自己改善

概要

このスキルを使用すると、SOUL や HEARTBEAT.md などの OpenClaw 専用プリミティブに依存せず、Codex ネイティブの永続的な自己改善ループを構築できます。

このスキルでは、安定したルールエントリーファイルと、安定したメモリディレクトリを使用します。

  • グローバルルールエントリー：~/.codex/AGENTS.md
  • グローバルメモリディレクトリ：~/.codex/memories/ を推奨

ワークフロー

1. 現状を監査する

まず、次の場所を確認します。

  • グローバル AGENTS.md
  • メモリディレクトリの候補
  • 既存の PROFILE.md、ACTIVE.md、LEARNINGS.md、ERRORS.md、FEATURE_REQUESTS.md
  • 夜間レビューやメモリのメンテナンスに関連する既存の自動化

環境にすでに部分的なセットアップがある場合は、無条件に置き換えるのではなく、維持したうえで拡張してください。

2. メモリの構成を整える

グローバルメモリディレクトリに、次のファイルを作成するか、構成を整えます。

  • PROFILE.md
  • ACTIVE.md
  • LEARNINGS.md
  • ERRORS.md
  • FEATURE_REQUESTS.md

これらのファイルを作成または修復する際は、references/memory-files.md を参照してください。

次のように、一貫して使い分けます。

  • PROFILE.md：長期的に安定したユーザープロフィールとコミュニケーションの好み
  • ACTIVE.md：今後のタスク開始時に読む価値のある、優先度の高い簡潔なルール
  • LEARNINGS.md：トップレベルのルールにまだ昇格していない、再利用可能な学びや修正点
  • ERRORS.md：再利用可能なデバッグ情報や環境の障害に関する知識
  • FEATURE_REQUESTS.md：セッションをまたいで追跡する価値のある、不足している機能
3. AGENTS.md を通じてループを構成する

AGENTS.md を Codex ネイティブの単一エントリーポイントとして使用します。

その役割は、Codex に次の内容を伝えることです。

  • 作業を開始する前に読むべきメモリファイル
  • 新しいエントリーを記録するタイミング
  • エントリーをファイルごとに分類する方法
  • 生ログの内容を ACTIVE.md に昇格させるタイミング
  • ユーザーから明示的に依頼されない限り、AGENTS.md 自体を自動編集してはならないこと

AGENTS.md のテキストを提案または更新する前に、references/agents-snippet.md を参照してください。

ユーザーから直接編集するよう明示的に依頼されていない場合は、正確な AGENTS.md のスニペットをチャットで提案し、ユーザー自身に適用してもらいます。

4. 任意の夜間レビューループを追加する

ユーザーが定期的なメンテナンスを希望する場合は、次の作業を行う夜間の自動化を作成します。

  • 現在のメモリファイルをレビューする
  • 主に LEARNINGS.md、ERRORS.md、FEATURE_REQUESTS.md を改善する
  • メモリファイルへの安全な更新を提案または適用する
  • AGENTS.md を自動編集しない

自動化を設計する前に、references/nightly-review.md を参照してください。

5. ループを検証する

作業を終える前に、セットアップが実際にループとして機能することを確認します。

  1. AGENTS.md が Codex に PROFILE.md と ACTIVE.md を参照させている
  2. 5 つのメモリファイルが存在し、内容が妥当である
  3. 昇格ルールが明確である
  4. 自動化を依頼された場合、自動化プロンプトで、改善のみに専念する役割と昇格ルールが明確に説明されている

昇格ルール

次の昇格ルールを一貫して適用します。

  • 内容が安定しており、複数のタスクで役立ち、今後の作業やコミュニケーションの改善につながる可能性が高い場合に限り、ACTIVE.md に昇格します
  • PROFILE.md には、永続的なユーザーの属性、スタイル、好みに関する情報のみを記載します
  • 一時的なコンテキストは PROFILE.md に含めません
  • 一度限りの雑多な情報は、どのメモリファイルにも含めません
  • 候補の項目が曖昧な場合は、昇格させず、生ログに残すか、提案のままにします

安全ルール

  • Codex が任意のメモリファイルを自動で読むと想定せず、AGENTS.md を通じてループを構成します
  • OpenClaw 専用の仕組みを、Codex にネイティブで備わっているかのように説明しません
  • ユーザーから明示的に依頼されない限り、AGENTS.md を自動編集しません
  • AGENTS.md を肥大化させるより、ACTIVE.md の更新を優先します
  • 長い説明的な要約より、簡潔で保守しやすいルールを優先します

成果物

このスキルを使用する際は、次の一部またはすべてを作成することを目指します。

  • 5 つのコアファイルを含むメモリディレクトリ
  • 提案する AGENTS.md のスニペット
  • 任意の夜間自動化プロンプト
  • 作成したもの、変更しなかったもの、ループの仕組みについての簡単な説明

コメント

Markdown 対応