Codex Autoresearch(Codex 自律反復)
leo-lilinxiao/codex-autoresearch
★ 3,168
概要
Codex Autoresearch は、OpenAI の Codex を「自律的な研究エージェント」として使うための簡潔なプロトコル実装です。ユーザーは達成したい目標(goal)、その達成度を測る評価指標(metric)、および動作確認用の検証コマンド(verify)を設定するだけで、あとは Codex がコードの「修正(modify)→検証(verify)→保持 or 破棄(retain or discard)→繰り返し(repeat)」というループを自動で回します。研究や実験を継続的に回して自己改善させるための枠組みで、設定の自由度が高く、軽量な Shell ベースのユーティリティとして提供されています。
リポジトリの統計情報
- スター数: 42
- フォーク数: 13
- ウォッチャー数: 42
- コミット数: 5
- ファイル数: 12
- メインの言語: Shell
主な特徴
- 自律ループ: modify → verify → retain/discard を無限に繰り返すプロトコルを備える。
- 簡潔な設定: goal、metric、verify コマンドを定義すれば動作する設計。
- Codex Skill 統合: Codex の生成能力を活用してコード修正と試行を行う。
- 軽量・拡張可能: Shell スクリプト中心で、既存ツールや CI に組み込みやすい。
技術的なポイント
Codex Autoresearch のコアは「自己反復的な改良ループ」を自動化することにあります。ユーザー側で指定するのは大まかに三点(goal:達成したい状態の自然言語説明、metric:進捗や性能を数値化する評価基準、verify:結果を判定するためのシェルコマンドやテスト)。これらを入力として、Codex に変更案の生成を依頼し、提案された修正をローカルで適用して verify を実行。verify が合格なら変更を保持し、改善が見られなければ破棄して次の案へ進みます。こうしたサイクルを無期限に回すことで、探索的な改良やバグ修正、実験設計の自動化が可能になります。
実装面では Shell を主軸にしているため、軽量で依存が少ない点が特徴です。Codex とのやり取りは Skill インターフェースや API 経由を想定した設計になっており、生成されたパッチの適用・巻き戻しは git を使ったワークフローと馴染みやすくなっています。ログやメトリクスの扱いはユーザー定義に委ねられており、CI/CD への統合や実験トラッキングとの連携がしやすい構造です。また Karpathy の autoresearch 概念に触発された思想を具体化しており、手動で試行錯誤する工程を自動化することで反復効率を高めます。セキュリティや生成内容の検証はユーザー実装に依存するため、実運用時は検証ルールの厳格化やサンドボックス化が推奨されます。
プロジェクトの構成
主要なファイルとディレクトリ:
- .gitignore: file
- CONTRIBUTING.md: file
- EXAMPLES.md: file
- GUIDE.md: file
- INSTALL.md: file
…他 7 ファイル
まとめ
Codex を使った自律的な反復改良を試したい開発者や研究者向けの軽量プロトコル実装。
リポジトリ情報:
- 名前: codex-autoresearch
- 説明: Codex Autoresearch Skill — A self-directed iterative system for Codex that continuously cycles through: modify, verify, retain or discard, and repeat indefinitely. Inspired by Karpathy’s autoresearch concept.
- スター数: 42
- 言語: Shell
- URL: https://github.com/leo-lilinxiao/codex-autoresearch
- オーナー: leo-lilinxiao
- アバター: https://avatars.githubusercontent.com/u/36369803?v=4
READMEの抜粋:
Codex Autoresearch
Autonomous iteration protocol for Codex. Define a goal, a metric, and a verify command – Codex handles the rest.
[
Claude(Anthropic)のCode機能を利用した「MAFIA Code-Review harness」は、フルオートのコードレビュー自動化パイプラインです。プラグインとしてClaude Codeに組み込み、リポジトリに対して設定ファイル(コード規約・ADRなど)を用意することで、Gitと連携した自動レビューを実行します。インストールはClaude内のプラグインマーケットプレイス経由で簡単に行え、フロー図やサンプル設定が同梱されています(約300字)。
usecomputer — AIエージェント向け高速デスクトップ自動化CLI
usecomputerは、AIエージェントからデスクトップ操作を直接行えることを目的に作られた高速なCLIツールです。macOSのQuartzイベントをはじめ、プラットフォーム固有のキー注入経路(macOS / Windows / Linux X11)を備え、マウス移動・クリック・ドラッグ・カーソル位置取得やキーボード合成(type / press)をネイティブで実行します。Zigで実装されたN-APIモジュール経由で動作し、ネイティブコマンドをライブラリ関数としてエクスポートするため、CLIだけでなくエージェントやスクリプトからの組み込み利用にも適しています。
opencli-skill — OpenCLIでSNSやコンテンツサイトを操作するスキル
Claude Code(大規模モデル)と opencli を組み合わせ、Chromeのログイン状態を再利用してBilibili、知乎、Twitter/X、YouTube、微博、Redditなど16のプラットフォームを自然言語で操作できるスキル群。APIキー不要でブラウザ操作を自動化し、検索・トレンド確認・投稿や取得などのタスクを言語指示で実行できるようにするリポジトリです。(約300字)
ghfs — GitHub Issues/PR をファイルシステム化するツール
GitHub の Issues と Pull Requests をローカルのファイルシステムに同期し、オフラインで閲覧・一括操作を行える CLI ツール。人間の操作とエージェントによる自動化の両方を想定して設計されており、リポジトリ内に .ghfs ディレクトリを作成して issue/pull を Markdown ファイルとして表現します。現状は開発中(WIP)で、TypeScript で実装されています。
claude-review-loop — 自動コードレビューループ(Claude + Codex)
Claude Codeのプラグインで、タスク実行時に自動で独立した二次レビューを挿入するワークフローを提供します。ユーザーが /review-loop を実行すると、まずClaudeが実装を行い、完了時のストップフックでOpenAIのCodexによる独立レビューを自動起動。CodexのフィードバックをClaudeに渡して修正させるため、1タスクに対して「実装 → 第2の目によるレビュー → 改善」のループを自動化します。CIや日常の開発フローで人の手を減らしつつ品質向上を狙うツールです。





