ECC — AIエージェント開発環境を最適化するツールボックス
affaan-m/ECC
★ 305,600 ・ JavaScript ・ MIT
概要
ECC(The agent harness performance optimization system)は、AIコーディングエージェントの動作環境(ハーネス)に向けたパフォーマンス最適化および開発支援システムです。Claude Code、Codex、Kimi Codeをはじめ、CursorやOpenCodeなど複数の開発支援ツールに対応しています。
近年のAIコーディングエージェントは高度なコード生成能力を持っていますが、プロンプトごとに指示を細かく組み立て直す手間が発生しやすいという側面があります。ECCはそうした課題に対し、「計画(plan)→テスト(test)→実装(implement)→レビュー(review)→検証(verify)→記憶(remember)→改善(improve)」というエンジニアリングプロセスをエージェントに組み込むことで、体系的な開発サイクルを自動で回せるように設計されています。
プロンプトの工夫だけに頼らず、エージェントの振る舞いを標準化して継続的な品質改善やセキュリティチェックを行いたい開発者に向いているツールです。
主な特徴
- 体系化されたエンジニアリングサイクル:計画の立案からテスト駆動開発(TDD)、新鮮なコンテキストでの自己レビュー、セッションの記憶に至る一連の流れをエージェントの標準動作として定義します。
- 豊富な専門エージェントとスキル群:計画立案、コードレビュー、ビルド修正、アーキテクチャ設計、セキュリティなどの目的に特化した72種類のエージェントと、327種類のスキルが提供されます。
- ランタイムフックと永続メモリ:コンテキストウィンドウを効率的に活用しつつ、重要な教訓やセッション要約、行動原則(ルール)を永続化し、継続的な学習とルール強制を可能にします。
- AgentShield によるセキュリティ検証:プロンプト、設定フック、MCP(Model Context Protocol)設定、権限、シークレット漏洩、エージェント定義ファイルのスキャンを行い、安全な実行環境を保ちます。
- 多様なエージェントハーネスへの対応:Claude Code向けのネイティブプラグイン(
ecc@ecc)やCodex、Kimi Code向けのガイド付きインストーラーを備えるほか、Cursor、OpenCode、Gemini、Zedなど向けのアダプターも同梱されています。
使い方
ECCは npm パッケージ ecc-universal を介して導入します。動作環境として Node.js 18以上、Git、および Claude Code 2.1以上(Claudeプラグイン利用時)がシステム上の PATH に通っている必要があります。
導入手順(Claude Code の推奨セットアップ)
対話型のウィザードを実行してインストールを行います。
npx ecc-universal@2.2.3 setup
パッケージランナーに応じて以下のコマンドも利用可能です。
# pnpm を使用する場合
pnpm dlx ecc-universal@2.2.3 setup
# Bun を使用する場合
bunx ecc-universal@2.2.3 setup
Windows環境の場合は、PowerShellを開いて前提ツールのバージョンを確認した後に上記のセットアップコマンドを実行します。対話画面でスコープ(例: Global user)とフック設定(例: Standard)を選択して確定すると導入が完了します。Claude Codeセッションを新しく起動し、/plugin list を実行することで ecc@ecc プラグインが有効化されているか確認できます。
複数ハーネスの一括構成
Claude Codeだけでなく、CodexやKimi Codeなど複数の環境をまとめて設定したい場合はマルチハーネスウィザードを使用します。
npx ecc-universal@2.2.3 install --guided
自動化スクリプトやCIなどでオプションを明示して実行する場合は、以下のように指定できます。
npx ecc-universal@2.2.3 install --guided \
--harness claude --harness codex --harness kimi \
--claude-scope local --claude-hooks standard \
--profile core --yes
変更を適用せずに事前確認を行いたい場合は、--dry-run フラグを付与して実行可能です。
npx ecc-universal@2.2.3 install --guided --harness codex --dry-run
技術的なポイント
ECCは主にJavaScript(Node.js環境)で実装されており、配布パッケージとして ecc-universal およびセキュリティスキャナーの ecc-agentshield がnpmレジストリ上に公開されています。
技術的な中核コンセプトとして「コンテキストウィンドウを最適化し、それ以外を永続化する(Optimize the context window. Persist everything else.)」という方針が掲げられています。LLMのコンテキストウィンドウは容量が限られているため、セッションを圧迫しないよう一時的な会話と長期的に保持すべき知識(スキル、ルール、インスティンクト)を明確に分離して管理するアプローチが採られています。
また、エージェント環境ごとのライフサイクル管理にも配慮されています。Claude Codeでは公式マーケットプレイスやローカルスコープを事前に検査した上でプラグインを配置し、Codexではネイティブのプラグイン機構を利用、Kimi Codeではプロジェクトローカルな管理ファイル(./.kimi-code)を展開するなど、ハーネスの設計思想に応じた導入処理を切り替えています。
注意点
- 公式配布元からの入手:READMEではセキュリティ上の注意喚起として、第三者による非公式な再配布やミラーにはマルウェアが含まれる危険性があるため、公式GitHubリポジトリ(
affaan-m/ECC)や公式npmパッケージ(ecc-universal,ecc-agentshield)、公式ドメイン(ecc.tools)以外からのインストールを行わないよう明記されています。 - ハーネスごとの機能差:現時点ではClaude Codeとの親和性が最も高く作られており、CodexやQoder向けにはネイティブパスが存在するものの、Cursor、OpenCode、Gemini、Zed、GitHub Copilot向けのアダプターは機能制限があることが注記されています。同一の機能がすべての環境で完全に利用できるわけではないため、サポート状況を確認する必要があります。
- 実行前提条件:Node.js 18以上が必須です。また、Claude Codeと統合する場合はClaude Code 2.1以上とGitが事前にインストールされている必要があります。
- ライセンス:オープンソースリポジトリは MIT ライセンスで公開されています。なお、プライベートリポジトリ向けのホステッドGitHub Appとして「ECC Pro」という有償プランも展開されています。
まとめ
ECCは、AIコーディングエージェントに体系的な開発フローと広範な専門スキルを追加するためのエンジニアリング最適化ツールです。プロンプトの属人化を防ぎ、テスト検証やセキュリティチェックを組み込んだ堅牢なエージェント運用を行いたい場合に有用な選択肢となります。





