8000 ECC/docs/ja-JP/README.md at main · AdnanAhmed14/ECC · GitHub
[go: up one dir, main page]
Skip to content

README.md

Latest commit

 

History

History
2015 lines (1524 loc) · 135 KB

README.md

File metadata and controls

2015 lines (1524 loc) · 135 KB
Raw

ECC - ゚ヌゞェントハヌネスのオペレヌティングシステム

GitHub Trending Repository of the Day Star History Global Rank

Language: English | Português (Brasil) | 简䜓䞭文 | 繁體䞭文 | 日本語 | 한국얎 | TÃŒrkçe | РусскОй | Tiếng Việt | à¹„àž—àž¢ | Deutsch | Español | УкраїМська | Polski

Discord Website GitHub App MIT ラむセンス

Stars Forks Contributors GitHub App むンストヌル数

ecc-universal npm ダりンロヌド数 ecc-agentshield npm ダりンロヌド数

Shell TypeScript Python Go Java Perl Markdown

Warning

公匏゜ヌスからのみむンストヌルしおください。 ECC は怜蚌枈みのチャネルからのみむンストヌルしおください。GitHub リポゞトリ github.com/affaan-m/ECC、npm パッケヌゞ ecc-universal ず ecc-agentshield、GitHub App、plugin スラッグ ecc@ecc、そしおプロゞェクト公匏サむト ecc.tools です。第䞉者による再アップロヌドや非公匏ミラヌはプロゞェクトが保守・レビュヌしおおらず、マルりェアを含む可胜性がありたす。

Claude Code でむンストヌル

ガむド付きセットアップたたはネむティブ plugin コマンドを䜿甚しおください。どちらも同じ ecc@ecc plugin をむンストヌルしたす。どちらか䞀方を遞び、その䞊にフルの手動 Claude むンストヌルを重ねないでください。

OSS は今埌も無料です。 このリポゞトリは氞久に MIT ラむセンスです。ECC Pro はプラむベヌトリポゞトリ向けのホスト型 GitHub App です。スポンサヌず Pro 賌読者がこの掻動を支えおいたす。だからこそ、たった䞀人のメンテナヌが 7 ぀のハヌネスに察しお毎週リリヌスを続けられるのです。

パヌトナヌ & スポンサヌ

CodeRabbit    Greptile    Moonshot AI - Kimi    ItÎ Markets    SerpApi: Web Search API

過去のスポンサヌ: Atlas Cloud · Mike Morgan (inactive)

コミュニティスポンサヌ: @jasonwu513 · @1anter · @massimotodaro · @meadmccabe

スポンサヌになる · スポンサヌティア · スポンサヌシッププログラム

むンストヌルぞゞャンプ ↓

ECC

あなたの゚ヌゞェントはコヌドを曞けたすが、ECC はそこに協調的な゚ンゞニアリングシステムずツヌルボックスを䞎えたす。構築の前に蚈画し、テストで倉曎を怜蚌し、新しいコンテキストから自分の䜜業をレビュヌし、重芁なこずを蚘憶し、繰り返し成功したこずを再利甚可胜な skills ずワヌクフロヌに倉えおいきたす。

plan -> test -> implement -> review -> verify -> remember -> improve

このプロセスをプロンプトのたびに組み立お盎すのではなく、䞀床むンストヌルしお゚ヌゞェントの働き方の䞀郚にしたす。

コンテキストりィンドりを最適化し、それ以倖はすべお氞続化する。

ECC は MIT ラむセンスのオヌプン゜ヌスです。珟時点では Claude Code で最もよく機胜し、サポヌト察象の Codex 同期パスを備え、Cursor、OpenCode、Gemini、Zed、GitHub Copilot、Antigravity、Qwen、その他のハヌネス向けには機胜が限定されたアダプタヌを提䟛しおいたす。機胜の同等性を前提にする前に、サポヌト状況マトリクスを確認しおください。

68 の agents、293 の skills、94 のレガシヌ command シムに加えお、hooks、rules、メモリ、継続的孊習、AgentShield セキュリティスキャンを利甚できたす。agents は蚈画、レビュヌ、ビルド修埩、セキュリティ、アヌキテクチャ、ドメむン䜜業に特化しおいたす。

含たれるもの 数 埗られるもの
Agents 68 agents 蚈画、レビュヌ、ビルド修埩、セキュリティ、アヌキテクチャ、ドメむン䜜業
Skills 293 skills TDD、リサヌチ、セキュリティ、ドキュメント、フロント゚ンド、デヌタ、ML、運甚など
Commands 94 commands ECC が skills ファヌストの構成ぞ移行する間の䟿利な゚ントリヌポむント
Hooks ずメモリ ランタむム 匷制、セッションサマリヌ、継続的孊習、instincts、コンテキスト制埡
Rules 遞択匏 蚀語やプロゞェクトごずに遞ぶ、垞時ロヌドされる暙準
AgentShield 同梱 プロンプト、hooks、MCP 蚭定、パヌミッション、シヌクレット、agent ファむルのスキャン

ECC のスタヌ履歎: 2026幎1月18日から2月7日たでの最初の 40,000 スタヌ

ECC のむンストヌル

Important

ECC 2.2 には Claude Code、Codex、Kimi Code 向けのガむド付きパッケヌゞセットアップが含たれおいたす。 ナニバヌサルパッケヌゞには Node.js 18 以降が必芁です。Claude plugin のセットアップには、 さらに Git ず Claude Code 2.1 以降が PATH 䞊にあるこずが必芁です。

掚奚: ナニバヌサルガむド付きセットアップ

Claude Code plugin のセットアップ、曎新、スコヌプ倉曎、hook プロファむルの倉曎には次を䜿いたす。

npx ecc-universal@2.2.1 setup

npm がバヌゞョンたたはキャッシュの゚ラヌを報告した堎合は、再詊行する前にレゞストリのバヌゞョンを確認しおください。

npm view ecc-universal version

ECC 2.2 は、モダンなパッケヌゞランナヌでも同じガむド付きセットアップをサポヌトしおいたす。

パッケヌゞランナヌ ガむド付きセットアップコマンド
npm / npx npx ecc-universal@2.2.1 setup
pnpm pnpm dlx ecc-universal@2.2.1 setup
Yarn 2+ yarn dlx ecc-universal@2.2.1 setup
Bun bunx ecc-universal@2.2.1 setup

これらの䟋では、このリポゞトリのリリヌスバヌゞョンに察応する公開枈みの ECC 2.2.1 リリヌスを指定しおいたす。バヌゞョンのピン留めはセキュリティ監査でも敎合性チェックでもありたせん。パッケヌゞのコヌドを実行する前にリリヌスの゜ヌスずレゞストリの敎合性を確認し、未リリヌスの倉曎にはレビュヌ枈みのチェックアりトを䜿甚しおください。

Yarn Classic 1 には yarn dlx がありたせん。npx を䜿うか、パッケヌゞをグロヌバルにむンストヌルするか、䞀時的なワンショット実行のために Yarn をアップグレヌドしおください。

りィザヌドは倉曎を加える前に公匏マヌケットプレむスずすべおのネむティブ Claude むンストヌルスコヌプを棚卞しし、その埌、遞択したスコヌプに ecc@ecc をむンストヌル、曎新、たたは安党に移動したす。ECC を曎新したいずき、スコヌプを倉えたいずき、hook プロファむルを倉えたいずきは、い぀でも同じコマンドを再実行しおください。このセットアップりィザヌドが珟圚蚭定するのは Claude Code plugin です。Codex や Kimi Code には、䞋蚘のマルチハヌネスりィザヌドを䜿甚しおください。

耇数のコヌディング゚ヌゞェントを䞀぀のレビュヌ枈みフロヌで蚭定するには、マルチハヌネスりィザヌドを䜿甚したす。

npx ecc-universal@2.2.1 install --guided

Claude Code、Codex、Kimi Code の任意の組み合わせを遞択でき、各むンストヌルチャネルず配眮先を衚瀺し、最初の曞き蟌み前にすべおの遞択をプリフラむトし、最埌に䞀床だけ確認を求めたす。

ハヌネス ガむド付きむンストヌルの動䜜
Claude Code user、project、local のいずれか䞀぀のスコヌプず ECC hook プロファむルを持぀ネむティブ ecc@ecc plugin
Codex ネむティブ Codex マヌケットプレむス/plugin ラむフサむクル。hook のレビュヌず信頌は Codex 偎が管理
Kimi Code ./.kimi-code 配䞋の管理されたプロゞェクトファむル。ECC hooks、モデル/プロバむダヌ蚭定、認蚌は蚭定されたせん

自動化のためには、プロバむダヌ固有の遞択をすべお明瀺しおください。

npx ecc-universal@2.2.1 install --guided \
  --harness claude --harness codex --harness kimi \
  --claude-scope local --claude-hooks standard \
  --profile core --yes

ネむティブのガむド付き Codex パスず管理された Kimi パスを、曞き蟌みなしで先に怜蚌するには次を実行したす。

npx ecc-universal@2.2.1 install --guided --harness codex --dry-run
npx ecc-universal@2.2.1 install --profile core --target kimi --dry-run

2.2 ゚むリアスを通じお、远加のパッケヌゞ名コマンドも利甚できたす。

npx ecc-universal@2.2.1 consult "security reviews" --target claude
npx ecc-universal@2.2.1 install --profile minimal --target claude --with capability:machine-learning
npx ecc-universal@2.2.1 doctor --target kimi

npx ecc-install --profile minimal --target claude は䜿甚しないでください。ecc-install は ecc-universal 内のバむナリ名であり、個別に公開された npm パッケヌゞではありたせん。

ECC は cursor、antigravity、gemini、opencode、codebuddy、joycode、qwen、zed、hermes、openclaw 向けの高床な管理アダプタヌも提䟛しおいたす。これらのタヌゲットは、各アダプタヌがガむド付きの衝突、曎新、修埩、アンむンストヌルのラむフサむクルマトリクスを通過するたで、ドキュメント化された ecc install --target ... パスを匕き続き䜿甚したす。どちらのりィザヌドも、怜出されたすべおのハヌネスに黙っおむンストヌルするこずはありたせん。

パスは䞀぀だけ遞ぶハヌネスごず

ECC は Claude Code、Codex、その他のハヌネスで同時に䜿甚できたす。ハヌネスごずに䞀぀のむンストヌル方法を遞んでください。

  • 掚奚デフォルト: 䞊蚘のガむド付き Claude plugin セットアップを実行する
  • Claude Code でもサポヌト: ネむティブ plugin コマンドを䜿甚する
  • リリヌス 2.2 で利甚可胜: Claude Code、Codex、Kimi Code 向けのガむド付きパッケヌゞセットアップ
  • 動䜜したす: Claude Code plugin + Codex ネむティブ plugin
  • 動䜜したす: Claude Code plugin + レガシヌ Codex 同期フロヌ
  • 避けおください: Claude Code plugin + フル Claude 手動むンストヌル
  • 避けおください: Codex 同期 + Codex マヌケットプレむス plugin

むンストヌル方法を重ねないでください。 同じハヌネスに ECC を二床むンストヌルするず、skills、commands、hooks、蚭定が重耇するこずがありたす。耇数のハヌネスにそれぞれ䞀床ず぀むンストヌルする分には問題ありたせん。

すでに耇数のむンストヌルを重ねおしたい、重耇しおいるように芋える堎合は、ECC のリセット / アンむンストヌルに盎接進んでください。

むンストヌルで困っおいたすか 短いむンストヌルたたはランタむムの問題フォヌムを開くか、ecc feedback を実行しおください。ECC が蚺断情報を自動でアップロヌドするこずはありたせん。

Claude Code の詳现

代わりに、Claude Code 内で Claude Code のネむティブ plugin コマンドを実行するこずもできたす。

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

ネむティブパスは ECC の skills、agents、commands、および plugin 管理の hooks をむンストヌルしたす。この方法を遞んだ堎合は、そこで止めおください。Claude Code にフルの手動むンストヌルを远加で実行しないでください。

これらの組み蟌みコマンドは Claude Code が所有しおおり、マヌケットプレむス、plugin、たたは競合するスコヌプがすでに存圚する堎合の゚ラヌも同様です。ECC はそのパヌサヌに介入できたせん。いずれかのネむティブコマンドが既存のむンストヌルやスコヌプの競合を報告した堎合は、2.2 のガむド付きセットアップを䜿甚するか、競合しおいる Claude plugin スコヌプを解決しおから再詊行しおください。その䞊に手動むンストヌルを重ねないでください。

ECC のむンストヌル埌は、/ecc:configure-ecc が名前空間付きの Claude 内再蚭定 skill になりたす。これは同じ安党なセットアップフロヌに委譲したすが、plugin のむンストヌル埌にのみ利甚可胜で、初回むンストヌル時に Claude Code 組み蟌みの /plugin コマンドを眮き換えるこずはできたせん。

Claude Code plugins は rules を配垃できないため、本圓に必芁な rule パックだけを远加しおください。

git clone https://github.com/affaan-m/ECC.git
cd ECC
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/  # 䜿甚しおいるスタックに眮き換えおください

rules/common ず、実際に䜿甚しおいる蚀語たたはフレヌムワヌクのパックを䞀぀入れるずころから始めおください。plugin をむンストヌルした堎合は、その埌で ./install.sh --profile full を実行しないでください。

settings.json 掟ですかマヌケットプレむスを宣蚀的に远加する

~/.claude/settings.json に盎接远加したす。

{
  "extraKnownMarketplaces": {
    "ecc": {
      "source": {
        "source": "github",
        "repo": "affaan-m/ECC"
      }
    }
  },
  "enabledPlugins": {
    "ecc@ecc": true
  }
}

これにより、䞊蚘の二぀の /plugin コマンドず同じ結果が埗られたす。

呜名ず移行に関する泚蚘ecc@ecc、affaan-m/ECC、ecc-universal

ECC には䞉぀の公開識別子があり、これらは互いに眮き換えられたせん。

  • GitHub ゜ヌスリポゞトリ: affaan-m/ECC
  • Claude マヌケットプレむス/plugin 識別子: ecc@ecc
  • npm パッケヌゞ: ecc-universal

これは意図的なものです。Anthropic のマヌケットプレむス/plugin むンストヌルは正芏の plugin 識別子をキヌずするため、ECC は厳栌な Desktop/API バリデヌタヌに察しおツヌル名ずスラッシュコマンドの名前空間を十分に短く保぀ために ecc@ecc を䜿甚しおいたす。叀い投皿には以前の長いマヌケットプレむス識別子が残っおいる堎合がありたすが、それはレガシヌ゚むリアスずしおのみ扱っおください。䞀方、npm パッケヌゞは ecc-universal のたたなので、npm むンストヌルずマヌケットプレむスむンストヌルは意図的に異なる名前を䜿甚しおいたす。

npm リリヌスはコミットごずではなくバヌゞョンタグごずに切られるため、ecc-universal は main ぞのすべおのプッシュではなく、リリヌス2.1、2.2、...を远跡したす。最新の開発版が必芁な堎合は git からむンストヌルしおください。

ロヌカルの Claude セットアップが消去たたはリセットされた堎合でも、䜕かを買い盎す必芁があるわけではありたせん。たず node scripts/ecc.js list-installed から始め、次に node scripts/ecc.js doctor ず node scripts/ecc.js repair を実行しおから再むンストヌルしおください。通垞はこれで、セットアップを組み盎すこずなく ECC 管理のファむルが埩元されたす。

Codex App ず CLI

珟圚の Codex リリヌスでは、ECC をネむティブのリポゞトリマヌケットプレむス plugin ずしおむンストヌルできたす。マヌケットプレむス゚ントリはリポゞトリルヌトを䜿甚するため、Codex のキャッシュはマニフェストずずもに、参照されるすべおの skills、MCP 蚭定、hook ランタむム、スクリプト、アセットを受け取りたす。

codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc
codex plugin list --json
node scripts/codex/check-plugin-cache.js

どちらの add コマンドも冪等です。埌で曎新するには、codex plugin marketplace upgrade ecc に続けお codex plugin add ecc@ecc を実行したす。Codex はアクティブな CODEX_HOME に䞀぀の有効化された plugin 状態を保存し、Claude の user、project、local スコヌプは提䟛したせん。そのネむティブ hooks は明瀺的な信頌の決定を必芁ずし、Claude の四぀の ECC hook プロファむルは䜿甚したせん。Codex 内では、ガむド付きのプロバむダヌ察応フロヌずしお $configure-ecc を呌び出しおください。

埓来の scripts/sync-ecc-to-codex.sh パスは、~/.codex にコピヌおよびマヌゞされた蚭定を意図的に必芁ずするナヌザヌ向けの非掚奚互換オプションであり、ネむティブ plugin には䞍芁です。新しい同期の実行では所有暩マニフェストを曞き出すため、クリヌンアップ時に倉曎されたナヌザヌファむルを保護できたす。たず Codex を䞀床実行しお ~/.codex/config.toml が存圚する状態にしおから、次を実行したす。

git clone https://github.com/affaan-m/ECC.git
cd ECC
npm install
bash scripts/sync-ecc-to-codex.sh

Codex の䌚話やネむティブ plugin キャッシュに觊れずに、そのレガシヌレむダヌを確認たたは削陀するには次を実行したす。

node scripts/ecc.js uninstall --legacy-codex-sync --dry-run
node scripts/ecc.js uninstall --legacy-codex-sync

マニフェスト以前のむンストヌルは保守的に扱われたす。ECC はマヌクされた AGENTS.md ブロックを削陀したすが、所有を蚌明できないコピヌ枈みファむルは保持し、レビュヌ甚に報告したす。

プロゞェクトロヌカルのセットアップずしお、ECC リポゞトリを Codex で盎接開くこずもできたす。Codex はグロヌバル同期なしで、ルヌトの AGENTS.md ず .codex/ 内の信頌枈みプロゞェクト蚭定を読み取りたす。同期フロヌの䞊にネむティブマヌケットプレむス plugin を远加しないでください。

リポゞトリのナビゲヌション、サヌフェスの所有暩、PR 差分パケットのガむダンスに぀いおは、Codex ECC Navigation Map を参照しおください。ネむティブラむフサむクルの詳现は .codex plugin notes を参照しおください。

その他の゚ヌゞェントず゚ディタヌ

Cursor、OpenCode、Gemini、Zed、Antigravity、Qwen、Hermes、OpenClaw、Kimi、CodeBuddy、JoyCode、Copilot

ECC を䞀床クロヌンし、䜿甚しおいるハヌネスに合ったタヌゲットを遞択したす。

git clone https://github.com/affaan-m/ECC.git
cd ECC
ハヌネス むンストヌルたたはセットアップ 備考
Cursor ./install.sh --profile minimal --target cursor プロゞェクトロヌカルの .cursor/ アダプタヌ
OpenCode npm install && npm run build:opencode && ./install.sh --profile full --target opencode --enable-hooks フルむンストヌルの前に plugin ペむロヌドをビルド
Gemini CLI ./install.sh --profile minimal --target gemini プロゞェクトロヌカルの .gemini/ 蚭定
Zed ./install.sh --profile minimal --target zed プロゞェクトロヌカルの .zed/ アダプタヌ
Antigravity ./install.sh --profile minimal --target antigravity Antigravity ガむドを参照
Qwen CLI ./install.sh --profile minimal --target qwen Qwen ガむドを参照
Hermes ./install.sh --profile minimal --target hermes Hermes セットアップガむドを参照
OpenClaw ./install.sh --profile minimal --target openclaw 管理されたホヌムディレクトリむンストヌル
Kimi Code CLI ./install.sh --profile minimal --target kimi プロゞェクトロヌカルの .kimi-code/ むンストヌル · Kimi Code を入手
CodeBuddy ./install.sh --profile minimal --target codebuddy プロゞェクトロヌカルの .codebuddy/ むンストヌル
JoyCode ./install.sh --profile minimal --target joycode プロゞェクトロヌカルの .joycode/ むンストヌル

GitHub Copilot のサポヌトはすでにこのリポゞトリに含たれおいたす。.github/copilot-instructions.md が指瀺レむダヌを提䟛し、.github/prompts/ には再利甚可胜な /plan、/tdd、/security-review、/build-fix、/refactor のプロンプトが含たれ、.vscode/settings.json が chat.promptFiles を有効にしたす。

ネむティブの ECC タヌゲットがないハヌネスには、手動適甚ガむドを䜿甚しおください。hooks やネむティブの skill 怜出が利甚できるふりをせずに、少数の ECC skills ずワヌクフロヌ指瀺をチャット型ツヌルに持ち蟌む方法を説明しおいたす。

Cursor は agent 定矩を .cursor/agents/ecc-*.md 配䞋にむンストヌルしたす。Cursor ネむティブのロヌド動䜜は Cursor のビルドによっお異なる堎合がありたす。ECC はルヌトの AGENTS.md を .cursor/ にむンストヌルしたせん。このアダプタヌは Cursor のコンテキストをネむティブの rules ず agent サヌフェスに限定したす。

ハヌネスごずの詳现な泚蚘機胜の同等性、hook アダプタヌ、制限事項は、䞋蚘のプラットフォヌムサポヌトにありたす。

高床なむンストヌルオプション

hook ランタむムなしの䜎コンテキストむンストヌル

䜎コンテキスト / hooks なしパス

ランタむム hooks なしで ECC の rules、agents、commands、プラットフォヌム蚭定、コアワヌクフロヌを䜿いたい堎合はこちらを䜿甚したす。

npx ecc-universal@2.2.1 install --profile minimal --target claude

゜ヌスチェックアりトからの同等のコマンドは次のずおりです。

./install.sh --profile minimal --target claude

Windows:

.\install.ps1 --profile minimal --target claude

このプロファむルは意図的に hooks-runtime を陀倖しおいたす。

Claude の手動むンストヌルでは、Claude Code が怜出できるように各 skill を ~/.claude/skills/<skill-name>/claude-project の堎合は .claude/skills/<skill-name>/の盎䞋に配眮したす。叀い ECC 手動むンストヌルをアップグレヌドする堎合、むンストヌラヌは ECC のむンストヌル状態に蚘録されたネストされた skills/ecc/ ファむルのみを移行したす。フラットな skill ディレクトリがナヌザヌ所有の堎合、ECC はそれを保持しお競合の譊告を衚瀺し、ナヌザヌファむルを䞊曞きする代わりに、叀い管理コピヌを安党なアンむンストヌルのために远跡し続けたす。

hooks を無効にした通垞の core プロファむルの堎合:

./install.sh --profile core --without baseline:hooks --target claude
./install.sh --profile core --no-hooks --target claude

hook ランタむムが必芁になった堎合にのみ、埌から远加したす。

./install.sh --target claude --modules hooks-runtime --enable-hooks

プロファむルたたはモゞュヌルによっお hook ランタむムが実䜓化されるむンストヌルでは、 明瀺的な決定が必芁です。--enable-hooks も --no-hooks も指定されおいない堎合、 むンストヌラヌは hooks でできるこずを衚瀺し、䜕も曞き蟌たずに停止したす。ガむド付き むンストヌラヌecc install --guidedはこの遞択を察話的に尋ねたす。

必芁なコンポヌネントだけを遞ぶ

たず適切なコンポヌネントを芋぀ける

同梱のアドバむザヌに、あなたの䜜業に合うコンポヌネントを尋ねおください。

node scripts/ecc.js consult "security reviews" --target claude

䞀臎するコンポヌネント、関連するプロファむル、プレビュヌ/むンストヌルコマンドが返されたす。正確なファむル蚈画を確認したい堎合は、むンストヌル前にプレビュヌコマンドを䜿甚しおください。

明瀺的に skills や capability を指定しおむンストヌルするこずもできたす。

./install.sh --target claude --skills tdd-workflow,security-review
node scripts/ecc.js install --profile minimal --target claude --with capability:machine-learning

コンポヌネントごずの手動コピヌも可胜です。各コンポヌネントは完党に独立しおいたす。

# agents のみ
cp agents/*.md ~/.claude/agents/

# rules ディレクトリcommon + 蚀語固有
mkdir -p ~/.claude/rules/ecc
cp -r rules/common ~/.claude/rules/ecc/
cp -r rules/typescript ~/.claude/rules/ecc/   # 䜿甚しおいるスタックを遞択

# コア/汎甚 skills のみClaude Code は ~/.claude/skills の盎䞋から skills をロヌドしたす。
# 手動むンストヌルを ~/.claude/skills/ecc/ 配䞋にネストしないでください
mkdir -p ~/.claude/skills
cp -r .agents/skills/* ~/.claude/skills/
cp -r skills/search-first ~/.claude/skills/

# オプション: 移行期間䞭に維持されるスラッシュコマンド互換
mkdir -p ~/.claude/commands
cp commands/*.md ~/.claude/commands/

廃止されたシムは legacy-command-shims/ にありたす。/tdd などの叀い名前がただ必芁な堎合にのみ、そこから個別のファむルをコピヌしおください。

グロヌバル rules の代わりにプロゞェクトロヌカル rules を䜿う

ECC の暙準をすべおの Claude Code セッションではなく䞀぀のリポゞトリにだけ適甚したい堎合は、プロゞェクトロヌカル rules を䜿甚したす。

cd your-project
mkdir -p .claude/rules/ecc
cp -R /path/to/ECC/rules/common .claude/rules/ecc/
cp -R /path/to/ECC/rules/typescript .claude/rules/ecc/

rules は垞時ロヌドされるコンテキストなので、common ず実際に䜿甚しおいるスタックのパック䞀぀から始めおください。rules を手動でコピヌする際は、盞察参照が機胜し続け、ファむル名が衝突しないように、䞭のファむルではなく蚀語ディレクトリ党䜓たずえば rules/common や rules/golangをコピヌしおください。

完党手動の Claude むンストヌル

plugin パスを意図的にスキップする堎合にのみ䜿甚しおください。

git clone https://github.com/affaan-m/ECC.git
cd ECC
./install.sh --profile full

Windows:

git clone https://github.com/affaan-m/ECC.git
cd ECC
.\install.ps1 --profile full

このパスを遞んだ堎合は、そこで止めおください。/plugin install を远加で実行しないでください。

厳遞した手動むンストヌルの堎合、Claude は ~/.claude/skills/ の盎䞋の子ずしお skills を怜出したす。~/.claude/skills/ecc/ 配䞋にネストしないでください。

hooks のむンストヌル

リポゞトリの生の hooks/hooks.json を ~/.claude/settings.json や ~/.claude/hooks/hooks.json にコピヌしないでください。そのファむルは plugin/リポゞトリ向けのものです。hook コマンドのパスが正しく曞き換えられるよう、むンストヌラヌを䜿甚しおください。

bash ./install.sh --target claude --modules hooks-runtime --enable-hooks

これにより hook スクリプトが ~/.claude/ 配䞋にむンストヌルされ、解決枈みの hook ゚ントリが ~/.claude/settings.json に登録されたす。既存のナヌザヌ蚭定ず hooks は 保持されたす。ECC 所有の゚ントリは安定した ID で远跡されるため、冪等な曎新ず 安党なアンむンストヌルが可胜です。

/plugin install で ECC をむンストヌルした堎合は、それらの hooks を settings.json にコピヌしないでください。Claude Code v2.1+ はすでに plugin の hooks/hooks.json を自動ロヌドしおおり、settings.json に重耇させるず二重実行やクロスプラットフォヌムの hook 競合が発生したす。

Windows では、Claude の蚭定ルヌトは %USERPROFILE%\.claude です。hook ランタむムは次のようにむンストヌルしおください。

pwsh -File .\install.ps1 --target claude --modules hooks-runtime --enable-hooks

MCP の蚭定

Claude plugin むンストヌルは、ECC に同梱された MCP サヌバヌ定矩を意図的に自動有効化したせん。これにより、厳栌なサヌドパヌティゲヌトりェむでの plugin MCP ツヌル名の長すぎる問題を回避し぀぀、手動での MCP セットアップは匕き続き可胜です。

皌働䞭の Claude Code サヌバヌ倉曎には、Claude Code の /mcp コマンドたたは CLI 管理の MCP セットアップを䜿甚しおください。Claude Code はそれらの遞択を ~/.claude.json に氞続化したす。リポゞトリロヌカルの MCP アクセスには、mcp-configs/mcp-servers.json から必芁な MCP サヌバヌ定矩をプロゞェクトスコヌプの .mcp.json にコピヌしおください。

ECC が同梱するデフォルトコネクタヌはちょうど䞀぀chrome-devtoolsだけです。それ以倖はすべお CLI/REST API をラップする skill か、オプトむンのカタログ゚ントリです。このルヌルず、以前の六぀のデフォルトを廃止した 2026幎6月の監査は docs/MCP-CONNECTOR-POLICY.md にありたす。

ECC 同梱の MCP を自分でも別途実行しおいる堎合は、次を蚭定しおください。

export ECC_DISABLED_MCPS="chrome-devtools"

ECC 管理のむンストヌルおよび Codex 同期フロヌは、重耇を再远加する代わりに、それらの同梱サヌバヌをスキップたたは削陀したす。ECC_DISABLED_MCPS は ECC のむンストヌル/同期フィルタヌであり、皌働䞭の Claude Code のトグルではありたせん。

重芁: YOUR_*_HERE プレヌスホルダヌを実際の API キヌに眮き換えおください。

マルチモデル commands には远加のセットアップが必芁

multi-* commands は、基本の plugin/rules むンストヌルには含たれおいたせん。

/multi-plan、/multi-execute、/multi-backend、/multi-frontend、/multi-workflow を䜿甚するには、ccg-workflow ランタむムもむンストヌルする必芁がありたす。䞊流の CCG むンストヌルガむドを䜿っお正確なリリヌスを遞択・レビュヌし、そのむンストヌル枈みランタむムを初期化しおください。ECC は CCG を同梱しおおらず、互換性があり監査枈みの CCG リリヌスを保蚌するものでもありたせん。このガむドは、特定されおいないレゞストリバヌゞョンをブヌトストラップしたせん。

このランタむムは、これらの commands が期埅する倖郚䟝存関係を提䟛したす。たずえば次のものです。

  • ~/.claude/bin/codeagent-wrapper
  • ~/.claude/.ccg/prompts/*

ccg-workflow がない堎合、これらの multi-* commands は正しく動䜜したせん。

リセット、修埩、たたはアンむンストヌル

ECC のリセット / アンむンストヌル

ナニバヌサルパッケヌゞからむンストヌルした堎合は、むンストヌル時に䜿甚したのず同じ プロゞェクトディレクトリから次のコマンドを実行しおください。

npx ecc-universal@2.2.1 list-installed
npx ecc-universal@2.2.1 doctor
npx ecc-universal@2.2.1 repair
npx ecc-universal@2.2.1 uninstall --dry-run
npx ecc-universal@2.2.1 uninstall

゜ヌスチェックアりトからの堎合は、再むンストヌルの前に管理状態を確認しおください。

node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair
node scripts/ecc.js uninstall --dry-run

゜ヌスチェックアりトから盎接アンむンストヌルするには次を実行したす。

node scripts/uninstall.js --dry-run
node scripts/uninstall.js

ECC をやめる堎合、アンむンストヌルコマンドは任意の20秒フィヌドバックフォヌムを衚瀺したす。これは公開の GitHub issue であり、アンむンストヌルを劚げるこずはなく、ECC が蚺断情報をアップロヌドするこずもありたせん。問題報告、フィヌドバック、機胜芁望の窓口を確認するには、い぀でも ecc feedback を実行できたす。

plugin ナヌザヌは Claude Code から plugin を削陀し、その埌、手動でコピヌしお䞍芁になった rule フォルダヌだけを削陀しおください。ECC はむンストヌル状態に蚘録されたファむルのみを削陀したす。ハヌネスディレクトリ内の無関係なファむルを自分のものずしお扱うこずはありたせん。

耇数の方法を重ねおしたった堎合は、次の順序でクリヌンアップしおください。

  1. Claude Code plugin のむンストヌルを削陀したす。
  2. 管理察象の install-state を含むプロゞェクトディレクトリから ECC のアンむンストヌルコマンドを実行したす。
  3. 手動でコピヌした、もう䞍芁な rules フォルダヌを削陀したす。
  4. 単䞀の経路を䜿っお䞀床だけ再むンストヌルしたす。

ECC を䜿い始める

カタログ党䜓ではなく、必芁なワヌクフロヌから始めたしょう。

やりたいこず ここから始める
機胜を構築する /ecc:plan "describe the feature"、その埌 tdd-workflow
バグを修正する 倱敗するテストで再珟しおから tdd-workflow を䜿甚
新しいコヌドをレビュヌする /code-review で新しいコンテキストからのレビュヌ
ビルドを修埩する /build-fix
コヌドベヌスをクリヌンアップする /refactor-clean
コンテキストの圧迫を確認する /context-budget
長いセッションを終える /save-session たたは /learn-eval
埌で再開する /resume-session
agent 蚭定を監査する レビュヌ枈みのスキャナヌで /security-scan、たたはむンストヌル枈みの agentshield scan --path .
Plugin コマンドず手動コマンド

Claude Code の plugin コマンドはネヌムスペヌス付きの圢匏を䜿いたす

/ecc:plan "Add authentication"

手動むンストヌルでは、より短い互換圢匏が䜿える堎合がありたす

/plan "Add authentication"

Skills が䞻芁なワヌクフロヌの入口です。コマンドは䟿利な゚ントリヌポむントおよび互換シムずしお残っおいたす。むンストヌル枈みの内容は次のコマンドで確認できたす

/plugin list ecc@ecc
どの agent を䜿えばよいですか

Skills が正芏のワヌクフロヌの入口です。メンテナンスされおいるスラッシュ゚ントリヌは、コマンドファヌストのワヌクフロヌ向けに匕き続き利甚できたす。

やりたいこず 䜿う入口 䜿甚される agent
新機胜を蚈画する /ecc:plan "Add auth" planner
システムアヌキテクチャを蚭蚈する /ecc:plan + architect agent architect
テストファヌストでコヌドを曞く tdd-workflow skill tdd-guide
曞いたばかりのコヌドをレビュヌする /code-review code-reviewer
倱敗するビルドを修正する /build-fix build-error-resolver
゚ンドツヌ゚ンドテストを実行する e2e-testing skill e2e-runner
セキュリティ脆匱性を芋぀ける /security-scan security-reviewer
デッドコヌドを削陀する /refactor-clean refactor-cleaner
ドキュメントを曎新する /update-docs doc-updater
Go コヌドをレビュヌする /go-review go-reviewer
Python コヌドをレビュヌする /python-review python-reviewer
F# コヌドをレビュヌする fsharp-reviewer を盎接呌び出す fsharp-reviewer
TypeScript/JavaScript コヌドをレビュヌする typescript-reviewer を盎接呌び出す typescript-reviewer
HarmonyOS アプリを開発する harmonyos-app-resolver を盎接呌び出す harmonyos-app-resolver
デヌタベヌスク゚リを監査する 自動委譲 database-reviewer
本番 ML の倉曎をレビュヌする mle-workflow skill + mle-reviewer agent mle-reviewer
よくあるワヌクフロヌ

以䞋のスラッシュ圢匏は、メンテナンスされおいるコマンド矀に残っおいるものを瀺しおいたす。/tdd や /eval のような廃止された短瞮名シムは、明瀺的なオプトむン専甚ずしお legacy-command-shims/ にありたす。

新機胜を始める

/ecc:plan "Add user authentication with OAuth"
                                              -> planner creates implementation blueprint
tdd-workflow skill                            -> tdd-guide enforces write-tests-first
/code-review                                  -> code-reviewer checks your work

バグを修正する

tdd-workflow skill                            -> tdd-guide: write a failing test that reproduces it
                                              -> implement the fix, verify test passes
/code-review                                  -> code-reviewer: catch regressions

本番環境に向けた準備

/security-scan                                -> security-reviewer: OWASP Top 10 audit
e2e-testing skill                             -> e2e-runner: critical user flow tests
/test-coverage                                -> verify 80%+ coverage

セルフホストモデルずカスタム゚ンドポむント

ECC は各ハヌネスの通垞の蚭定を通じお動䜜するため、ECC のワヌクフロヌを倉曎するこずなく、公匏プロバむダヌ、互換性のあるカスタム API ゚ンドポむントやモデルゲヌトりェむ、あるいはセルフホストモデルを利甚できたす。

Claude Code に぀いお、ECC は Anthropic ホストのトランスポヌト蚭定をハヌドコヌドしおいたせん。最小限のゲヌトりェむの䟋

export ANTHROPIC_BASE_URL=https://your-gateway.example.com
export ANTHROPIC_AUTH_TOKEN=your-token
claude

ゲヌトりェむがモデル名を再マッピングする堎合は、ECC ではなく Claude Code 偎で蚭定しおください。claude CLI がすでに動䜜しおいる状態であれば、ECC の hooks、skills、コマンド、rules はモデルプロバむダヌに䟝存したせん。Anthropic の LLM ゲヌトりェむドキュメント ず モデル蚭定ドキュメント を参照しおください。

そのゲヌトりェむの背埌で任意のオヌプン゜ヌスモデルを実行たたはセルフホストするには、別途コンピュヌトずサヌビングのセットアップが必芁です。GPU 容量が必芁な堎合、ItÃŽ は ECC の掚奚コンピュヌトスポンサヌですが、どの GPU プロバむダヌでも動䜜したす。このスポンサヌシップのリンクは受動的なものです。RFQ の発行、容量の予玄、コンピュヌトのプロビゞョニング、サヌビングの蚭定は行いたせん。これずは別に、ecc ito find は明瀺的に蚭定された正芏の ItÃŽ CLI を呌び出し、認蚌枈みのラむブ RFQ を送信したすが、容量の予玄は行いたせん。ItÃŽ によるマネヌゞド掚論はただ提䟛されおいたせん。

ECC + ItÃŽ コンピュヌトで Kimi をセルフホストする

Kimi Code ハヌネスずモデルサヌビングレむダヌは別物です。ECC は agent ハヌネスを蚭定したす。API ゚ンドポむントを甚意するKimi API キヌを取埗か、自身の GPU 容量でオヌプンりェむトの Kimi モデルをセルフホストするのはナヌザヌ偎です。このアダプタヌは Kimi Code 0.31.x@moonshot-ai/kimi-codeで怜蚌枈みです

ItÃŽ Markets
1. GPU 容量を確保する
ItÃŽ たたは任意の GPU プロバむダヌを利甚したす。 		Moonshot AI - Kimi
2. Kimi をサヌブする
遞択したチェックポむントを互換゚ンドポむント経由で公開したす。 		ECC Tools
3. ECC で Kimi Code を実行する
プロゞェクトの指瀺ず skills をむンストヌルし、Kimi Code を起動したす。

Kimi Code の公匏プロバむダヌガむドに埓っお゚ンドポむントを蚭定し、ECC をむンストヌルしたす

bash ./install.sh --target kimi --profile minimal
node scripts/ecc.js doctor --target kimi
kimi

Kimi Code はむンストヌルされた .kimi-code/AGENTS.md の指瀺ず .kimi-code/skills/ のワヌクフロヌをネむティブに怜出したす。プロゞェクトレベルの .agents/skills/ も公匏の怜出堎所です。ECC はプロゞェクトの MCP ゚ントリヌを .kimi-code/mcp.json に安党にマヌゞし、ナヌザヌレベルの ~/.kimi-code/config.toml は倉曎したせん。Kimi Code はネむティブ hooks をサポヌトしおいたすが、ECC の珟圚のマネヌゞドプロゞェクトアダプタヌはそれらを蚭定しないため、このむンストヌラヌは Kimi の hook プロファむルを提䟛したせん。むンストヌラヌのドラむランず回垰テストスむヌトにより、マネヌゞドな Kimi ぞの曞き蟌みがすべおプロゞェクトロヌカルの .kimi-code/ ルヌト内に収たるこずが怜蚌されおいたす。

ItÃŽ コンピュヌト CLI ブリッゞ

ecc ito は別途むンストヌルされた正芏の ItÃŽ クラむアントに委譲したす。ECC は 2 ぀目の API クラむアントを保守したせん。ecc ito login [--no-browser] はデバむス認可を実行し、デフォルトで ItÃŽ の怜蚌ペヌゞを開き、デバむストヌクンを macOS Keychain に保存したす。--no-browser はペヌゞの匕き枡しを抑制したす。ECC 自䜓はブラりザ自動化を行いたせん。ecc ito auth は怜蚌専甚で、--no-browser を拒吊したす。利甚可胜な操䜜は ecc ito login、ecc ito auth、ecc ito find、ecc ito status、および別途ゲヌトされた ecc ito evals です。察応する MCP ツヌルは匕き続き ito_auth、ito_find、ito_status です。ito_auth は既存の認蚌情報を怜蚌し、ノヌド資栌の確認は CLI 専甚です。

ito-compute-cli パッケヌゞは珟圚未公開です。ItÃŽ ランタむムリポゞトリデスクの堅牢化が進むたで非公開。デザむンパヌトナヌにはアクセス暩が提䟛されたすの cli/ito-compute-cli からロヌカルでビルドし、npm ci ず npm run check を実行しおから、ECC_ITO_CLI_EXECUTABLE にそのビルドの dist/bin/ito.js の絶察パスを蚭定しおください。login は ITO_API_KEY を決しお継承したせん。auth、find、status は蚭定されおいれば ITO_API_KEY を盎接転送し、ITO_AUTH_MODE=legacy は䞍芁です。ecc ito logout は珟圚のデバむス認蚌情報を倱効させ、リモヌトでの倱効が確認できない堎合はロヌカルコピヌを保持したす。デバむストヌクンはデフォルトで macOS Keychain を䜿甚したす。明瀺的なファむルフォヌルバックでは、所有者のみがアクセスできるディレクトリ/ファむルのパヌミッションを維持する必芁がありたす。ECC はこの認蚌情報を持぀クラむアントを PATH 経由で怜出したせん。RFQ の暩限ず MCP セットアップの契玄の党容に぀いおは ito-compute skill を参照しおください。

find は認蚌枈みのラむブ RFQ を送信したす。容量の予玄は行いたせん。evals には ITO_ENABLE_SIXTYTWO_LIVE=1 ず --live-sixtytwo の䞡方、別途むンストヌルされた sixtytwo-cli==0.3.33、明瀺的なノヌドリスト、および既存の絶察パスの蚭定ディレクトリが必芁です。レンタル、起動、埩旧、修埩、賌入はできたせん。ECC は芋積もりロック、賌入、ワヌクロヌド、掚論のいずれの経路も公開せず、クラむアントの欠劂やラむブ呌び出しの倱敗をロヌカルの結果で眮き換えるこずも決しおありたせん。

新機胜

珟圚のリリヌス2.2.12026-08-31。2.2 系のハむラむト

  • Claude Code、Codex、Kimi Code にわたるガむド付きのマニフェスト駆動セットアップ。install-state の所有暩管理、doctor、repair、uninstall を備えおいたす。
  • ネむティブの Antigravity むンストヌル、薄い Pi アダプタヌ、そしお Linux、macOS、Windows でテストされたパック枈みアヌティファクトのリリヌスゲヌト。
  • Plan Canvas によるブラりザレビュヌ、統合メモリボヌルトecc memory、ItÃŽ コンピュヌト skill ファミリヌ。

完党な履歎CHANGELOG.md。リリヌスごずのノヌトず゚ビデンスは docs/releases/ にありたす。

v2.0.0: Agent Harness Operating System2026幎6月

2.0 系の安定版ぞの昇栌コントロヌルペヌン基盀、worktree ラむフサむクルサヌビス、orch-* オヌケストレヌタヌファミリヌ、Discord コミュニティ。ノヌトdocs/releases/2.0.0/release-notes.md。

䞭身

ECC/
|-- agents/           # 委譲甚の 68 の専門サブ゚ヌゞェント
|-- skills/           # オンデマンドで読み蟌たれる 293 の再利甚可胜なワヌクフロヌ
|-- commands/         # メンテナンスされおいる 94 のスラッシュコマンドシム
|-- rules/            # オプトむンの共通暙準ず蚀語別暙準
|-- hooks/            # ランタむムの自動化ず匷制
|-- scripts/          # むンストヌル、修埩、同期、オヌケストレヌション、チェック
|-- .claude-plugin/   # Claude Code マヌケットプレむスマニフェスト
|-- .codex/           # Codex リファレンス蚭定ず agent ロヌル
|-- .opencode/        # OpenCode plugin、コマンド、指瀺
|-- .cursor/          # Cursor rules ず hook アダプタヌ
|-- docs/             # 公開されたセットアップ、アヌキテクチャ、運甚ガむド

ルヌトが信頌できる唯䞀の情報源です。プラットフォヌムアダプタヌは、別のコピヌを保守するのではなく、これらの同じワヌクフロヌをパッケヌゞ化たたはマッピングしたす。

泚釈付きコンポヌネントカタログ 
ECC/
|-- .claude-plugin/   # Plugin ずマヌケットプレむスのマニフェスト
|   |-- plugin.json         # Plugin メタデヌタずコンポヌネントパス
|   |-- marketplace.json    # /plugin marketplace add 甚のマヌケットプレむスカタログ
|
|-- agents/           # 委譲甚の 67 の専門サブ゚ヌゞェント
|   |-- planner.md           # 機胜実装の蚈画
|   |-- architect.md         # システム蚭蚈の意思決定
|   |-- tdd-guide.md         # テスト駆動開発
|   |-- code-reviewer.md     # 品質ずセキュリティのレビュヌ
|   |-- security-reviewer.md # 脆匱性分析
|   |-- build-error-resolver.md
|   |-- e2e-runner.md        # Playwright E2E テスト
|   |-- refactor-cleaner.md  # デッドコヌドのクリヌンアップ
|   |-- doc-updater.md       # ドキュメントの同期
|   |-- docs-lookup.md       # ドキュメント/API の怜玢
|   |-- chief-of-staff.md    # コミュニケヌションのトリアヌゞず䞋曞き
|   |-- loop-operator.md     # 自埋ルヌプの実行
|   |-- harness-optimizer.md # ハヌネス蚭定のチュヌニング
|   |-- cpp-reviewer.md      # C++ コヌドレビュヌ
|   |-- cpp-build-resolver.md # C++ ビルド゚ラヌの解決
|   |-- fsharp-reviewer.md   # F# 関数型コヌドレビュヌ
|   |-- go-reviewer.md       # Go コヌドレビュヌ
|   |-- go-build-resolver.md # Go ビルド゚ラヌの解決
|   |-- python-reviewer.md   # Python コヌドレビュヌ
|   |-- database-reviewer.md # デヌタベヌス/Supabase レビュヌ
|   |-- typescript-reviewer.md # TypeScript/JavaScript コヌドレビュヌ
|   |-- java-reviewer.md     # Java/Spring Boot コヌドレビュヌ
|   |-- java-build-resolver.md # Java/Maven/Gradle ビルド゚ラヌ
|   |-- kotlin-reviewer.md   # Kotlin/Android/KMP コヌドレビュヌ
|   |-- kotlin-build-resolver.md # Kotlin/Gradle ビルド゚ラヌ
|   |-- harmonyos-app-resolver.md # HarmonyOS/ArkTS アプリ開発
|   |-- rust-reviewer.md     # Rust コヌドレビュヌ
|   |-- rust-build-resolver.md # Rust ビルド゚ラヌの解決
|   |-- pytorch-build-resolver.md # PyTorch/CUDA トレヌニング゚ラヌ
|   |-- mle-reviewer.md      # 本番 ML パむプラむン、評䟡、サヌビング、監芖のレビュヌ
|
|-- skills/           # ワヌクフロヌ定矩ずドメむン知識
|   |-- coding-standards/           # 蚀語別ベストプラクティス
|   |-- clickhouse-io/              # ClickHouse 分析、ク゚リ、デヌタ゚ンゞニアリング
|   |-- backend-patterns/           # API、デヌタベヌス、キャッシュのパタヌン
|   |-- frontend-patterns/          # React、Next.js のパタヌン
|   |-- frontend-slides/            # HTML スラむドデッキず PPTX から Web ぞのプレれンテヌションワヌクフロヌ
|   |-- article-writing/            # 汎甚的な AI 口調を避け、指定された文䜓で曞く長文ラむティング
|   |-- content-engine/             # マルチプラットフォヌムの゜ヌシャルコンテンツず再利甚ワヌクフロヌ
|   |-- market-research/            # 出兞を明蚘した垂堎、競合、投資家のリサヌチ
|   |-- investor-materials/         # ピッチデッキ、ワンペヌゞャヌ、メモ、財務モデル
|   |-- investor-outreach/          # パヌ゜ナラむズされた資金調達アりトリヌチずフォロヌアップ
|   |-- continuous-learning/        # レガシヌ v1 の Stop hook によるパタヌン抜出
|   |-- continuous-learning-v2/     # 信頌床スコアリング付きの instinct ベヌス孊習
|   |-- iterative-retrieval/        # サブ゚ヌゞェント向けの段階的なコンテキスト粟緻化
|   |-- strategic-compact/          # 手動コンパクション提案長文ガむド
|   |-- tdd-workflow/               # TDD 方法論
|   |-- security-review/            # セキュリティチェックリスト
|   |-- eval-harness/               # 怜蚌ルヌプ評䟡長文ガむド
|   |-- verification-loop/          # 継続的怜蚌長文ガむド
|   |-- videodb/                    # 動画ず音声取り蟌み、怜玢、線集、生成、ストリヌミング
|   |-- golang-patterns/            # Go のむディオムずベストプラクティス
|   |-- golang-testing/             # Go のテストパタヌン、TDD、ベンチマヌク
|   |-- cpp-coding-standards/       # C++ Core Guidelines に基づく C++ コヌディング暙準
|   |-- cpp-testing/                # GoogleTest、CMake/CTest による C++ テスト
|   |-- django-patterns/            # Django のパタヌン、モデル、ビュヌ
|   |-- django-security/            # Django セキュリティベストプラクティス
|   |-- django-tdd/                 # Django TDD ワヌクフロヌ
|   |-- django-verification/        # Django 怜蚌ルヌプ
|   |-- laravel-patterns/           # Laravel アヌキテクチャパタヌン
|   |-- laravel-security/           # Laravel セキュリティベストプラクティス
|   |-- laravel-tdd/                # Laravel TDD ワヌクフロヌ
|   |-- laravel-verification/       # Laravel 怜蚌ルヌプ
|   |-- python-patterns/            # Python のむディオムずベストプラクティス
|   |-- python-testing/             # pytest による Python テスト
|   |-- quarkus-patterns/           # Java Quarkus パタヌン
|   |-- quarkus-security/           # Quarkus セキュリティ
|   |-- quarkus-tdd/                # Quarkus TDD
|   |-- quarkus-verification/       # Quarkus 怜蚌
|   |-- rails-patterns/             # Rails アヌキテクチャパタヌン
|   |-- springboot-patterns/        # Java Spring Boot パタヌン
|   |-- springboot-security/        # Spring Boot セキュリティ
|   |-- springboot-tdd/             # Spring Boot TDD
|   |-- springboot-verification/    # Spring Boot 怜蚌
|   |-- configure-ecc/              # むンタラクティブむンストヌルりィザヌド
|   |-- security-scan/              # AgentShield セキュリティ監査ツヌルの統合
|   |-- java-coding-standards/      # Java コヌディング暙準
|   |-- jpa-patterns/               # JPA/Hibernate パタヌン
|   |-- postgres-patterns/          # PostgreSQL 最適化パタヌン
|   |-- nutrient-document-processing/ # Nutrient API によるドキュメント凊理
|   |-- database-migrations/        # マむグレヌションパタヌンPrisma、Drizzle、Django、Go
|   |-- api-design/                 # REST API 蚭蚈、ペヌゞネヌション、゚ラヌレスポンス
|   |-- deployment-patterns/        # CI/CD、Docker、ヘルスチェック、ロヌルバック
|   |-- docker-patterns/            # Docker Compose、ネットワヌキング、ボリュヌム、コンテナセキュリティ
|   |-- e2e-testing/                # Playwright E2E パタヌンず Page Object Model
|   |-- content-hash-cache-pattern/ # ファむル凊理向けの SHA-256 コンテンツハッシュキャッシュ
|   |-- cost-aware-llm-pipeline/    # LLM コスト最適化、モデルルヌティング、予算远跡
|   |-- regex-vs-llm-structured-text/ # 刀断フレヌムワヌクテキスト解析における正芏衚珟 vs LLM
|   |-- swift-actor-persistence/    # actor によるスレッドセヌフな Swift デヌタ氞続化
|   |-- swift-protocol-di-testing/  # テスト可胜な Swift コヌドのためのプロトコルベヌス DI
|   |-- search-first/               # コヌディング前にリサヌチするワヌクフロヌ
|   |-- skill-stocktake/            # skills ずコマンドの品質監査
|   |-- liquid-glass-design/        # iOS 26 Liquid Glass デザむンシステム
|   |-- foundation-models-on-device/ # FoundationModels による Apple オンデバむス LLM
|   |-- swift-concurrency-6-2/      # Swift 6.2 Approachable Concurrency
|   |-- mle-workflow/               # 本番 ML のデヌタ契玄、評䟡、デプロむ、監芖
|   |-- perl-patterns/              # モダン Perl 5.36+ のむディオムずベストプラクティス
|   |-- perl-security/              # Perl セキュリティパタヌン、taint モヌド、安党な I/O
|   |-- perl-testing/               # Test2::V0、prove、Devel::Cover による Perl TDD
|   |-- autonomous-loops/           # 自埋ルヌプパタヌン逐次パむプラむン、PR ルヌプ、DAG オヌケストレヌション
|   |-- plankton-code-quality/      # Plankton hooks による曞き蟌み時のコヌド品質匷制
|   |-- codehealth-mcp/             # オプションの CodeScene Code Health MCP skillオプトむン
|   |-- docs/examples/project-guidelines-template.md  # プロゞェクト固有 skills のテンプレヌト
|
|-- commands/         # メンテナンスされおいるスラッシュ゚ントリヌの互換局。skills/ を優先
|   |-- plan.md             # /plan - 実装蚈画
|   |-- code-review.md      # /code-review - 品質レビュヌ
|   |-- build-fix.md        # /build-fix - ビルド゚ラヌの修正
|   |-- refactor-clean.md   # /refactor-clean - デッドコヌドの削陀
|   |-- quality-gate.md     # /quality-gate - 怜蚌ゲヌト
|   |-- learn.md            # /learn - セッション途䞭でのパタヌン抜出長文ガむド
|   |-- learn-eval.md       # /learn-eval - パタヌンの抜出、評䟡、保存
|   |-- checkpoint.md       # /checkpoint - 怜蚌状態の保存長文ガむド
|   |-- setup-pm.md         # /setup-pm - パッケヌゞマネヌゞャヌの蚭定
|   |-- go-review.md        # /go-review - Go コヌドレビュヌ
|   |-- go-test.md          # /go-test - Go TDD ワヌクフロヌ
|   |-- go-build.md         # /go-build - Go ビルド゚ラヌの修正
|   |-- skill-create.md     # /skill-create - git 履歎から skills を生成
|   |-- instinct-status.md  # /instinct-status - 孊習した instincts の衚瀺
|   |-- instinct-import.md  # /instinct-import - instincts のむンポヌト
|   |-- instinct-export.md  # /instinct-export - instincts の゚クスポヌト
|   |-- evolve.md           # /evolve - instincts をクラスタリングしお skills に倉換
|   |-- prune.md            # /prune - 期限切れの保留䞭 instincts を削陀
|   |-- pm2.md              # /pm2 - PM2 サヌビスラむフサむクル管理
|   |-- multi-plan.md       # /multi-plan - マルチ゚ヌゞェントのタスク分解
|   |-- multi-execute.md    # /multi-execute - オヌケストレヌションされたマルチ゚ヌゞェントワヌクフロヌ
|   |-- multi-backend.md    # /multi-backend - バック゚ンドのマルチサヌビスオヌケストレヌション
|   |-- multi-frontend.md   # /multi-frontend - フロント゚ンドのマルチサヌビスオヌケストレヌション
|   |-- multi-workflow.md   # /multi-workflow - 汎甚マルチサヌビスワヌクフロヌ
|   |-- sessions.md         # /sessions - セッション履歎管理
|   |-- test-coverage.md    # /test-coverage - テストカバレッゞ分析
|   |-- update-docs.md      # /update-docs - ドキュメントの曎新
|   |-- update-codemaps.md  # /update-codemaps - codemaps の曎新
|   |-- python-review.md    # /python-review - Python コヌドレビュヌ
|-- legacy-command-shims/   # /tdd や /eval などの廃止シムのオプトむンアヌカむブ
|   |-- tdd.md              # /tdd - tdd-workflow skill を掚奚
|   |-- e2e.md              # /e2e - e2e-testing skill を掚奚
|   |-- eval.md             # /eval - eval-harness skill を掚奚
|   |-- verify.md           # /verify - verification-loop skill を掚奚
|   |-- orchestrate.md      # /orchestrate - dmux-workflows たたは multi-workflow を掚奚
|
|-- rules/            # 垞に埓うガむドラむン~/.claude/rules/ecc/ にコピヌ
|   |-- README.md            # 構成の抂芁ずむンストヌルガむド
|   |-- common/              # 蚀語非䟝存の原則
|   |   |-- coding-style.md    # 䞍倉性、ファむル構成
|   |   |-- git-workflow.md    # コミット圢匏、PR プロセス
|   |   |-- testing.md         # TDD、80% カバレッゞ芁件
|   |   |-- performance.md     # モデル遞択、コンテキスト管理
|   |   |-- patterns.md        # デザむンパタヌン、スケルトンプロゞェクト
|   |   |-- hooks.md           # Hook アヌキテクチャ、TodoWrite
|   |   |-- agents.md          # サブ゚ヌゞェントぞ委譲するタむミング
|   |   |-- security.md        # 必須セキュリティチェック
|   |-- typescript/          # TypeScript/JavaScript 固有
|   |-- python/              # Python 固有
|   |-- golang/              # Go 固有
|   |-- swift/               # Swift 固有
|   |-- php/                 # PHP 固有
|   |-- arkts/               # HarmonyOS / ArkTS 固有
|
|-- hooks/            # トリガヌベヌスの自動化
|   |-- README.md                 # Hook のドキュメント、レシピ、カスタマむズガむド
|   |-- hooks.json                # すべおの hooks 蚭定PreToolUse、PostToolUse、Stop など
|   |-- memory-persistence/       # セッションラむフサむクル hooks長文ガむド
|   |-- strategic-compact/        # コンパクション提案長文ガむド
|
|-- scripts/          # クロスプラットフォヌムの Node.js スクリプト
|   |-- lib/                     # 共有ナヌティリティ
|   |   |-- utils.js             # クロスプラットフォヌムのファむル/パス/システムナヌティリティ
|   |   |-- package-manager.js   # パッケヌゞマネヌゞャヌの怜出ず遞択
|   |-- hooks/                   # Hook の実装
|   |   |-- session-start.js     # セッション開始時にコンテキストを読み蟌む
|   |   |-- session-end.js       # セッション終了時に状態を保存する
|   |   |-- pre-compact.js       # コンパクション前の状態保存
|   |   |-- suggest-compact.js   # 戊略的コンパクション提案
|   |   |-- evaluate-session.js  # セッションからパタヌンを抜出
|   |-- setup-package-manager.js # むンタラクティブなパッケヌゞマネヌゞャヌ蚭定
|
|-- tests/            # テストスむヌト
|   |-- lib/                     # ラむブラリテスト
|   |-- hooks/                   # Hook テスト
|   |-- run-all.js               # すべおのテストを実行
|
|-- contexts/         # 動的システムプロンプト泚入コンテキスト長文ガむド
|   |-- dev.md              # 開発モヌドコンテキスト
|   |-- review.md           # コヌドレビュヌモヌドコンテキスト
|   |-- research.md         # リサヌチ/探玢モヌドコンテキスト
|
|-- examples/         # 蚭定ずセッションの䟋
|   |-- CLAUDE.md             # プロゞェクトレベル蚭定の䟋
|   |-- user-CLAUDE.md        # ナヌザヌレベル蚭定の䟋
|   |-- saas-nextjs-CLAUDE.md   # 実際の SaaSNext.js + Supabase + Stripe
|   |-- go-microservice-CLAUDE.md # 実際の Go マむクロサヌビスgRPC + PostgreSQL
|   |-- django-api-CLAUDE.md      # 実際の Django REST APIDRF + Celery
|   |-- laravel-api-CLAUDE.md     # 実際の Laravel APIPostgreSQL + Redis
|   |-- rust-api-CLAUDE.md        # 実際の Rust APIAxum + SQLx + PostgreSQL
|
|-- mcp-configs/      # MCP サヌバヌ蚭定
|   |-- mcp-servers.json    # GitHub、Supabase、Vercel、Railway など
|
|-- ecc_dashboard.py  # デスクトップ GUI ダッシュボヌドTkinter
|
|-- marketplace.json  # セルフホストマヌケットプレむス蚭定/plugin marketplace add 甚
ダッシュボヌド GUI

デスクトップダッシュボヌドを起動しお、ECC のコンポヌネントを芖芚的に探玢できたす

npm run dashboard
# たたは
python3 ./ecc_dashboard.py

機胜

  • タブ圢匏のむンタヌフェヌスAgents、Skills、Commands、Rules、Settings
  • ダヌク/ラむトテヌマの切り替え
  • フォントのカスタマむズファミリヌずサむズ
  • ヘッダヌずタスクバヌのプロゞェクトロゎ
  • すべおのコンポヌネントを暪断した怜玢ずフィルタヌ

䞻芁な抂念

Agents、skills、hooks、rules の解説

Agents

サブ゚ヌゞェントは、限定されたスコヌプで委譲されたタスクを凊理したす。䟋

---
name: code-reviewer
description: Reviews code for quality, security, and maintainability
tools: Read, Grep, Glob, Bash
model: opus
---

You are a senior code reviewer...

Skills

Skills が䞻芁なワヌクフロヌの入口です。盎接呌び出すこずも、自動的に提案されるこずも、agents から再利甚されるこずもできたす。ECC は移行期間䞭もメンテナンスされおいる commands/ を匕き続き同梱しおおり、廃止された短瞮名シムは明瀺的なオプトむン専甚ずしお legacy-command-shims/ に眮かれおいたす。新しいワヌクフロヌの開発は、たず skills/ に眮くべきです。

# TDD Workflow

1. Define interfaces first
2. Write failing tests (RED)
3. Implement minimal code (GREEN)
4. Refactor (IMPROVE)
5. Verify 80%+ coverage

Hooks

Hooks はツヌルむベントで発火したす。䟋console.log に぀いお譊告する

{
  "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
  "hooks": [{
    "type": "command",
    "command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
  }]
}

Rules

Rules は垞に埓うべきガむドラむンで、common/蚀語非䟝存+ 蚀語固有のディレクトリに敎理されおいたす

rules/
  common/          # 普遍的な原則垞にむンストヌル
  typescript/      # TS/JS 固有のパタヌンずツヌル
  python/          # Python 固有のパタヌンずツヌル
  golang/          # Go 固有のパタヌンずツヌル
  swift/           # Swift 固有のパタヌンずツヌル
  php/             # PHP 固有のパタヌンずツヌル
  arkts/           # HarmonyOS / ArkTS のパタヌンず制玄

むンストヌル方法ず構成の詳现は rules/README.md を参照しおください。

ガむド

このリポゞトリは生のコヌドです。ガむドがすべおを説明しおいたす。

ECC 簡朔ガむド
簡朔ガむド
セットアップ、基瀎、初日からの䜿い方。たずこれを読んでください。スレッド 		ECC 長文ガむド
長文ガむド
コンテキストの経枈性、メモリ、評䟡、䞊列゚ヌゞェント。スレッド 		ECC セキュリティガむド
セキュリティガむド
プロンプトむンゞェクション、hooks、MCP、AgentShield。スレッド
トピック 孊べる内容
トヌクン最適化 モデル遞択、システムプロンプトの削枛、バックグラりンドプロセス
メモリ氞続化 セッション間でコンテキストを自動的に保存/読み蟌みする hooks
継続的孊習 セッションからパタヌンを自動抜出しお再利甚可胜な skills に倉換
怜蚌ルヌプ チェックポむント評䟡ず継続的評䟡、グレヌダヌの皮類、pass@k メトリクス
䞊列化 Git worktree、カスケヌド方匏、むンスタンスをスケヌルすべきタむミング
サブ゚ヌゞェントのオヌケストレヌション コンテキスト問題、反埩怜玢パタヌン

コマンド クむックリファレンス | 手動適甚ガむド | トラブルシュヌティング FAQ | ロヌドマップ

なぜ ECC を遞ぶのか

仕組みがない堎合 ECC がある堎合
蚈画はチャット履歎の䞭に消えおいく 蚈画は実装開始前に線集可胜な成果物になる
「TDD を䜿っおください」はモデルが忘れるかもしれない指瀺 TDD は蚌拠付きのゲヌト化された RED -> GREEN -> REFACTOR ワヌクフロヌになる
同じコンテキストがコヌドを曞き、レビュヌもする 新しいコンテキストのレビュアヌがリグレッションず盲点を探す
メモリずは巚倧なトランスクリプトを保存するこず セッションは芁玄、instincts、再利甚可胜な skills に蒞留される
品質チェックはリマむンダヌ頌み hooks がプロンプトの倖偎で決定論的なチェックを匷制できる
゚ヌゞェント蚭定はデフォルトで信頌される AgentShield がハヌネス自䜓を攻撃察象領域ずしおスキャンする

TDDテスト駆動開発

/ecc:plan "Add usage-based billing alerts"
  -> confirm or edit the plan
  -> activate tdd-workflow
  -> capture RED evidence before implementation
  -> implement until GREEN
  -> review from fresh context
  -> fix findings with regression tests
  -> verify build, lint, types, and tests

成果物は単なるコヌドではありたせん。蚈画、倱敗するテスト、成功するテスト、レビュヌでの指摘、最終怜蚌ずいう蚌拠の軌跡です。

Skills がコンテキストを集䞭させる

rules、skills、agents、hooks はそれぞれ異なる問題を解決したす。これらの圹割を分離しおおくこずで、ECC はリポゞトリ党䜓をすべおのセッションに流し蟌むこずなく胜力を远加できたす。

抂念 䜕をするか コンテキストでの振る舞い
Skills TDD、セキュリティレビュヌ、ディヌプリサヌチなどの再利甚可胜なワヌクフロヌ タスクが必芁ずするずきに読み蟌たれる
Agents 独自のコンテキストずツヌル暩限を持぀スコヌプ限定のワヌカヌ 蚈画、実装、レビュヌを分離する
Rules 氞続的なプロゞェクト暙準や蚀語暙準 垞に読み蟌たれるため、遞択的にむンストヌルする
Hooks ハヌネスのむベントでトリガヌされるスクリプト モデルのコンテキスト倖で実行される
Instincts 実際のセッションから孊習された信頌床スコア付きのパタヌン 関連するずきに呌び出される

ハヌネス間でコンテキストを共有する

ECC の Memory Vault は、Claude、Codex、Hermes、OpenClaw、Kimi、その他のハヌネスに察しお、氞続的なコンテキストず匕き継ぎのための単䞀のロヌカルで怜査可胜な Markdown 圢匏を提䟛したす。プロゞェクトおよびチヌムのメモリは .ecc/memory/ に、ナヌザヌのメモリは ~/.ecc/memory/ に眮かれたす。

skill のみ、minimal、manual、Claude plugin のむンストヌルでは、Memory Vault ランタむムは PATH に配眮されたせん。CLI やオプションの MCP サヌバヌを䜿う前に、npm ランタむムを別途むンストヌルしおください

npm install -g ecc-universal@2.2.1
ecc memory init --scope project
ecc memory search "authentication migration" --target-harness codex
ecc memory doctor

メモリは未レビュヌのコンテキストであり、実行可胜なポリシヌではありたせん。重芁な䞻匵は暩嚁ある情報源ず照合しお怜蚌し、受け入れた知識は管理されたプロゞェクトドキュメントに昇栌させおください。オプションの ecc-memory-mcp サヌバヌは、デフォルトでは自身を有効化するこずなく、同じ範囲に限定された save、search、read、doctor の機胜を公開したす。

Unified Memory ワヌクフロヌを開く →

Memory Vault の詳现スコヌプ、匕き継ぎ、信頌境界

Memory Vault は、ベンダヌのトランスクリプトをコピヌしたり゚ヌゞェント間でコンテキストをメヌルしたりする代わりに、移怍可胜な ecc.memory.v1 Markdown ドキュメントを保存したす。プロゞェクトメモリはフェむルクロヌズドの .gitignore で保護されおいたす。チヌムスコヌプは、人間が怜査しバヌゞョン管理された共有にのみ䜿甚しおください。チヌムメモリはコミットされた埌も未レビュヌのコンテキストのたたです。

䞊蚘のランタむムをむンストヌルしたら、CLI ずオプションの MCP ゚ントリポむントが利甚可胜であるこずを確認しおください

ecc memory --help
command -v ecc-memory-mcp
# プロゞェクトの vault を初期化する。
ecc memory init --scope project

# 匕き継ぎ本文を通垞のファむルに曞き、次のハヌネスを指定する。
ecc memory handoff \
  --from hermes \
  --target codex \
  --title "Continue authentication migration" \
  --body-file ./handoff.md

# 別のハヌネスから呌び出す。
ecc memory search "authentication migration" --target-harness codex
ecc memory read <memory-id>

# チヌムメモリを共有する前に vault を怜蚌する。
ecc memory doctor

メモリ本文は --stdin たたは --body-file 経由でのみ受け付けられ、コマンドラむン匕数の倀ずしおは受け付けられたせん。最初のリリヌスでは、すべおの vault ゚ントリは未レビュヌか぀䜜成のみです。人間のレビュヌは、メモリの信頌床を倉えるのではなく、受け入れた知識を管理されたプロゞェクトドキュメントに昇栌させたす。通垞の怜玢による呌び出しは、アクティブなプロゞェクトメモリずチヌムメモリを返したす。ID を盎接指定した読み取りでは、非アクティブな゚ントリを怜査できたす。ナヌザヌスコヌプの呌び出しは明瀺的に芁求する必芁がありたす。゚ヌゞェントは重芁な䞻匵を暩嚁ある情報源ず照合しお怜蚌しなければならず、呌び出した本文を実行可胜な指瀺やポリシヌずしお扱っおはなりたせん。

オプトむンの MCP アクセスには、mcp-configs/mcp-servers.json の ecc-memory-vault ゚ントリを必芁な各ハヌネスに远加し、ecc-memory-mcp を実行しおください。サヌバヌが公開するのは memory_save、memory_search、memory_read、memory_doctor のみです。各サヌバヌは小文字の ECC_MEMORY_HARNESS アむデンティティを指定しお起動する必芁がありたす。このアむデンティティはサヌバヌに束瞛されおおり、ツヌル呌び出し偎から指定するこずはできたせん。ナヌザヌスコヌプにはさらに、オペレヌタヌが管理する ECC_MEMORY_ALLOW_USER_SCOPE=1 のオプトむンが必芁です。ワヌクフロヌず信頌境界に぀いおは skills/unified-memory/SKILL.md を、機胜契玄に぀いおは docs/design/ecc-memory-vault.md を参照しおください。

プラットフォヌムサポヌト

ECC のコアずなる Node.js CLI ずマネヌゞドむンストヌラヌは Windows、macOS、Linux で動䜜したすが、オプション機胜は完党に同等ではありたせん。䞀郚の継続的孊習、GAN、オヌケストレヌションのパスは䟝然ずしお Bash たたは Python を必芁ずし、ハヌネスごずに公開されおいる hook、agent、skill の API も異なりたす。

プラットフォヌム ステヌタス 珟圚の制限
Linux コアをサポヌト オプション機胜には Bash、Python、たたはプロバむダヌ固有のツヌルが必芁な堎合がありたす。
macOS コアをサポヌト スタンドアロンの GAN シェルパスはシステムの Bash 3.2 ず互換性がなく、珟圚スコア解析の䞍具合がありたす#2674。
Windows + WSL コアをサポヌト WSL は Linux のパスに埓いたす。Windows ホスト偎の統合はハヌネスによっお異なりたす。
Windows ネむティブ 制限付きでサポヌト 継続的孊習 v2 のオブザヌバヌデヌモンず memory-vault の曞き蟌みには、ネむティブ Windows での未解決の䞍具合がありたす#2489、#2626。シェルに䟝存するオプション機胜には Git Bash/WSL が必芁か、利甚できたせん。

以䞋の stable、beta、experimental、instruction-only は、マヌケティング䞊の等玚ではなく、機胜の状態を瀺すものずしお扱っおください。

ハヌネス ステヌタス 掚奚される配垃方法 重芁な制限
Claude Code Stable䞻芁 Plugin たたは遞択的むンストヌラヌ plugin はむンストヌル枈みカタログをモデルに通知したす。コンテキストの占有量が重芁な堎合は、遞択的/manual profile を䜿甚しおください。シェルに䟝存するオプションの skills はすべおの OS に移怍可胜ではありたせん。
Codex ネむティブ plugin をサポヌト Codex マヌケットプレむス plugin たたはリポゞトリ蚭定 ネむティブ hooks には明瀺的な信頌の決定が必芁で、Claude の hook profile は䜿甚したせん。レガシヌの sync は互換性維持のみです。
Cursor Beta プロゞェクトアダプタヌ .cursor/ ぞの遞択的むンストヌラヌ agent の怜出は Cursor のビルドによっお異なり、ECC のむンストヌラヌパスはただ同䞀の hook セットを公開しおいたせん#2419。
OpenCode Beta ビルド枈み plugin plugin をビルドしおから遞択的むンストヌラヌ ECC はカタログのサブセットを同梱しおいたす。OpenCode でプロバむダヌを接続しモデルを遞択しおください#2617。
GitHub Copilot Instruction-only チェックむンされた instructions ずプロンプトファむル ECC の hooks、ランタむム agents、委譲、ネむティブの skill 怜出はありたせん。
Gemini、Zed、Antigravity、Qwen、Hermes、OpenClaw、Kimi、CodeBuddy、JoyCode Experimental/最小限のアダプタヌ ハヌネス固有の遞択的タヌゲット ファむル配眮ず instructions の移怍性はテスト枈みです。Claude ずの完党な機胜同等性は䞻匵しおいたせん。
パッケヌゞマネヌゞャヌの怜出

plugin は、以䞋の優先順䜍でお奜みのパッケヌゞマネヌゞャヌnpm、pnpm、yarn、bunを自動怜出したす

  1. 環境倉数CLAUDE_PACKAGE_MANAGER
  2. プロゞェクト蚭定.claude/package-manager.json
  3. package.jsonpackageManager フィヌルド
  4. ロックファむルpackage-lock.json、yarn.lock、pnpm-lock.yaml、bun.lockb からの怜出
  5. グロヌバル蚭定~/.claude/package-manager.json
  6. フォヌルバック最初に利甚可胜なパッケヌゞマネヌゞャヌ

お奜みのパッケヌゞマネヌゞャヌを蚭定するには

# 環境倉数で蚭定
export CLAUDE_PACKAGE_MANAGER=pnpm

# グロヌバル蚭定で蚭定
node scripts/setup-package-manager.js --global pnpm

# プロゞェクト蚭定で蚭定
node scripts/setup-package-manager.js --project bun

# 珟圚の蚭定を怜出
node scripts/setup-package-manager.js --detect

たたは /setup-pm コマンドを䜿甚しおください。

Hook ランタむム制埡環境倉数

ランタむムフラグを䜿っお厳栌さを調敎したり、特定の hooks を䞀時的に無効化したりできたす

# Hook の厳栌さ profileデフォルトstandard
export ECC_HOOK_PROFILE=standard

# 無効化する hook ID をカンマ区切りで指定
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

# SessionStart の远加コンテキストの䞊限デフォルト8000 文字
export ECC_SESSION_START_MAX_CHARS=4000

# 䜎コンテキスト/ロヌカルモデル環境向けに SessionStart の远加コンテキストを完党に無効化
export ECC_SESSION_START_CONTEXT=off

# セッション䞀時ファむルの保持期間日数、デフォルト30。
# 0、off、false、disabled、never、none のいずれかを蚭定するずすべおのセッションを保持削陀を無効化。
export ECC_SESSION_RETENTION_DAYS=14

# SessionStart がコンテキストに泚入する孊習枈み instincts の䞊限デフォルト6
export ECC_MAX_INJECTED_INSTINCTS=6

# instinct が泚入されるために必芁な最小信頌床、0-1デフォルト0.7
export ECC_INSTINCT_CONFIDENCE_THRESHOLD=0.7

# SessionStart は泚入する instincts を信頌床 + プロゞェクト/スタックずの関連性で
# ランク付けするデフォルトon。プロゞェクトスコヌプの instincts、および
# domain/trigger が怜出されたスタック蚀語、フレヌムワヌク、加えお terraform/dbt マヌカヌに
# 䞀臎する instincts は、無関係な高信頌床のものより䞊に衚瀺されるよう
# 小さなランキングブヌストを受ける。off/false/0/no を蚭定するず信頌床のみでランク付けする。
export ECC_INSTINCT_RELEVANCE_RANKING=on

# コンテキスト/スコヌプ/ルヌプの譊告は維持し぀぀、API 埓量課金のコスト芋積もりを抑制
export ECC_CONTEXT_MONITOR_COST_WARNINGS=off

Windows PowerShell

[Environment]::SetEnvironmentVariable('ECC_CONTEXT_MONITOR_COST_WARNINGS', 'off', 'User')
[Environment]::SetEnvironmentVariable('ECC_SESSION_RETENTION_DAYS', '14', 'User')
Agent デヌタホヌムマルチハヌネスの分離

メモリ氞続化 hooksセッション芁玄、孊習枈み skills、セッション゚むリアス、メトリクスは、単䞀の agent デヌタルヌトの䞋にデヌタを保存したす。デフォルトではそのルヌトは ~/.claude です。同じマシンで Claude Code ず Cursor の䞡方で ECC を䜿甚する堎合、2぀の環境が互いのセッションファむルを䞊曞きしないように、Cursor 甚に別のルヌトを蚭定しおください

# Cursor 専甚の境界Claude Code はデフォルトの ~/.claude を維持
export ECC_AGENT_DATA_HOME="$HOME/.cursor/ecc"

このルヌトの䞋で解決されるパスには以䞋が含たれたす

  • $ECC_AGENT_DATA_HOME/session-data/セッション芁玄
  • $ECC_AGENT_DATA_HOME/skills/learned/evaluate-session による孊習枈み skills
  • $ECC_AGENT_DATA_HOME/session-aliases.jsonセッション゚むリアス
  • $ECC_AGENT_DATA_HOME/metrics/コストずアクティビティのメトリクス

affaan-m/ECC#2065 を参照しおください。

ツヌル暪断の機胜マップずハヌネスごずの泚蚘

ツヌル暪断の機胜マップ

機胜 Claude Code Codex Cursor OpenCode GitHub Copilot
Instructions ネむティブ ネむティブ AGENTS.md プロゞェクト rules Plugin の instructions ネむティブ instruction ファむル
Skills ネむティブのむンストヌル枈みセット ネむティブ plugin セット ビルド䟝存/プロゞェクトセット ビルド枈みサブセット プロンプト/instruction からの参照のみ
Agents/委譲 ネむティブ agents Codex マルチ゚ヌゞェントロヌル。Claude の agent ファむルはロヌルずしおむンストヌルされない ビルド䟝存のプロゞェクト agents Plugin の agents 非察応
ECC hooks ネむティブ plugin hooks 明瀺的な信頌を䌎うネむティブのレビュヌ枈みサブセット Cursor hook アダプタヌ。むンストヌルパスの差異は残る Plugin むベント 非察応
MCP 蚭定 利甚可胜、明瀺的な有効化が必芁 ネむティブ plugin マニフェスト。レガシヌ sync は TOML をマヌゞ可胜 明瀺的なプロゞェクト/ナヌザヌ蚭定 プロバむダヌ/plugin 蚭定 ECC からは提䟛されない
Claude Code ずの同等性 䞻芁リファレンス 郚分的 郚分的 郚分的 同等性の察象倖

䞻芁なアヌキテクチャ䞊の決定

  • ルヌトの AGENTS.md はツヌル暪断の汎甚ファむルですClaude Code、Cursor、Codex、OpenCode が読み蟌みたす。GitHub Copilot は代わりに .github/copilot-instructions.md を䜿甚したす
  • DRY アダプタヌパタヌンにより、Cursor は Claude Code の hook スクリプトを重耇なく再利甚できたす
  • Skills 圢匏YAML frontmatter 付きの SKILL.mdは Claude Code、Codex、OpenCode で共通に機胜したす
  • Codex のより限定的なネむティブ hook セットは、AGENTS.md、オプションの model_instructions_file オヌバヌラむド、サンドボックス暩限によっお補完されたす
Cursor IDE サポヌトの詳现

ECC は、Cursor のプロゞェクトレむアりトに合わせお調敎された hooks、rules、agents、skills、コマンド、MCP 蚭定による Cursor IDE サポヌトを提䟛したす。

# macOS/Linux
./install.sh --target cursor typescript
./install.sh --target cursor python golang swift php
# Windows PowerShell
.\install.ps1 --target cursor typescript
.\install.ps1 --target cursor python golang swift php

Cursor 向けに含たれるもの

コンポヌネント 数 詳现
Hook むベント 15 sessionStart、beforeShellExecution、afterFileEdit、beforeMCPExecution、beforeSubmitPrompt、その他 10 個
Hook スクリプト 16 共有アダプタヌ経由で scripts/hooks/ に委譲する薄い Node.js スクリプト
Rules 34 共通 9 個alwaysApply+ 蚀語固有 25 個TypeScript、Python、Go、Swift、PHP
Agents 48 むンストヌル時に .cursor/agents/ecc-*.md ずしお配眮。ナヌザヌやマヌケットプレむスの agents ずの衝突を避けるためプレフィックス付き
Skills 共有 + 同梱 翻蚳された远加分は .cursor/skills/ に配眮
コマンド 共有 むンストヌル時は .cursor/commands/
MCP 蚭定 共有 むンストヌル時は .cursor/mcp.json

Cursor の読み蟌みに関する泚蚘

ECC はルヌトの AGENTS.md を .cursor/ にむンストヌルしたせん。Cursor はネストされた AGENTS.md ファむルをディレクトリのコンテキストずしお扱うため、ECC のリポゞトリのアむデンティティをホストプロゞェクトにコピヌするず、そのプロゞェクトを汚染しおしたいたす。

Cursor ネむティブの読み蟌み動䜜は Cursor のビルドによっお異なる堎合がありたす。ECC は agents を .cursor/agents/ecc-*.md ずしおむンストヌルしたす。お䜿いの Cursor ビルドがプロゞェクト agents を公開しおいない堎合でも、これらのファむルは隠れたグロヌバルプロンプトコンテキストずしおではなく、明瀺的なリファレンス定矩ずしお機胜したす。

メモリずデヌタの分離Cursor + Claude Code

ECC のメモリ hooks は Claude Code ず同じ scripts/hooks/*.js を再利甚したす。Cursor では、ECC はメモリを自動的に ~/.claude の倖に保぀よう詊みたす

  1. Cursor の sessionStart hook--target cursor で .cursor/hooks.json にむンストヌルが、composer セッション党䜓に ECC_AGENT_DATA_HOME を泚入したす。
  2. Hook ランタむムのデフォルトCURSOR_VERSION たたは CURSOR_PROJECT_DIR が存圚する堎合、環境倉数が未蚭定なら hooks はデフォルトで ~/.cursor/ecc を䜿甚したす。
  3. プロゞェクト蚭定.cursor/ecc-agent-data.json がパスagentDataHomeを文曞化し、䞊曞きしたす。
  4. 垞時有効な rule.cursor/rules/ecc-agent-data-home.mdc が、メモリの保存堎所を agent に思い出させたす。

明瀺的に䞊曞きするこずも匕き続き可胜です

export ECC_AGENT_DATA_HOME="$HOME/.cursor/ecc"

意図的に Claude Code ずメモリを共有するには、シェルたたは .cursor/ecc-agent-data.json で ECC_AGENT_DATA_HOME=~/.claude を蚭定しおください。

継続的孊習 v2 の instincts は、匕き続き CLV2_HOMUNCULUS_DIRデフォルト ~/.local/share/ecc-homunculusの䞋に別途保存されたす。

Hook アヌキテクチャDRY アダプタヌパタヌン

Cursor は Claude Code より倚くの hook むベントを持っおいたす20 察 8。.cursor/hooks/adapter.js モゞュヌルが Cursor の stdin JSON を Claude Code の圢匏に倉換するため、既存の scripts/hooks/*.js を重耇なく再利甚できたす。

Cursor stdin JSON -> adapter.js -> transforms -> scripts/hooks/*.js
                                                (shared with Claude Code)

䞻芁な hooks

  • beforeShellExecutiontmux 倖での開発サヌバヌ起動をブロックexit 2、git push のレビュヌ
  • afterFileEdit自動フォヌマット + TypeScript チェック + console.log の譊告
  • beforeSubmitPromptプロンプト内のシヌクレットsk-、ghp_、AKIA パタヌンを怜出
  • beforeTabFileReadTab による .env、.key、.pem ファむルの読み取りをブロックexit 2
  • beforeMCPExecution / afterMCPExecutionMCP の監査ログ

Rules の圢匏

Cursor の rules は description、globs、alwaysApply を持぀ YAML frontmatter を䜿甚したす

---
description: "TypeScript coding style extending common rules"
globs: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"]
alwaysApply: false
---
Codex macOS アプリ + CLI サポヌトの詳现

ECC は、macOS アプリず CLI 向けに、サポヌト察象のネむティブ Codex マヌケットプレむス plugin ずリポゞトリロヌカルの蚭定を提䟛したす。ネむティブ plugin には共有 skills、MCP 蚭定、レビュヌ枈みの hook サブセットが含たれ、Codex は hook の信頌をナヌザヌの明瀺的な管理䞋に眮きたす。埓来の sync パスは互換性維持のみずしお残っおいたす。リポゞトリのナビゲヌション、各領域の所有暩、PR diff パケットのガむダンスに぀いおは、docs/CODEX-NAVIGATION-GUIDE.md から始めおください。

# 珟圚掚奚されるむンストヌルリポゞトリのマヌケットプレむスから ECC のネむティブ plugin を远加
codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc
codex plugin list --json

# たたはリポゞトリ内で Codex CLI を実行AGENTS.md ず .codex/ が自動怜出される
codex

意図的に必芁な堎合は、レガシヌのコピヌ匏蚭定による互換性も匕き続き利甚できたす

# 互換性維持のみのマネヌゞド sync を ~/.codex に実行
npm install && bash scripts/sync-ecc-to-codex.sh

# たたはリファレンス蚭定のみを手動でコピヌ
cp .codex/config.toml ~/.codex/config.toml

sync スクリプトは、远加のみの戊略を䜿っお ECC の MCP サヌバヌを既存の ~/.codex/config.toml に安党にマヌゞしたす。既存のサヌバヌを削陀したり倉曎したりするこずは決しおありたせん。倉曎をプレビュヌするには --dry-run を、ECC サヌバヌを最新の掚奚蚭定に匷制的に曎新するには --update-mcp を付けお実行しおください。

Context7 に぀いおは、ECC は正芏の Codex セクション名 [mcp_servers.context7] を䜿甚し぀぀、匕き続き @upstash/context7-mcp パッケヌゞを起動したす。すでにレガシヌの [mcp_servers.context7-mcp] ゚ントリがある堎合、--update-mcp がそれを正芏のセクション名に移行したす。

Codex macOS アプリ

  • このリポゞトリをワヌクスペヌスずしお開きたす。
  • ルヌトの AGENTS.md は自動怜出されたす。
  • .codex/config.toml ず .codex/agents/*.toml はプロゞェクトロヌカルに保぀のが最適です。
  • リファレンスの .codex/config.toml は意図的に model や model_provider を固定しおいないため、䞊曞きしない限り Codex は自身の珟圚のデフォルトを䜿甚したす。
  • オプショングロヌバルなデフォルトずしお .codex/config.toml を ~/.codex/config.toml にコピヌできたす。.codex/agents/ もコピヌしない限り、マルチ゚ヌゞェントのロヌルファむルはプロゞェクトロヌカルに保っおください。

リポゞトリずレガシヌ蚭定レむダヌに含たれるもの

コンポヌネント 数 詳现
蚭定 1 .codex/config.tomlトップレベルの approvals/sandbox/web_search、MCP サヌバヌ、通知、profiles
AGENTS.md 2 ルヌト汎甚+ .codex/AGENTS.mdCodex 固有の補足
Skills 32 .agents/skills/skill ごずに SKILL.md + agents/openai.yaml
MCP サヌバヌ 6 GitHub、Context7、Exa、Memory、Playwright、Sequential Thinking--update-mcp sync で Supabase を加えるず 7
Profiles 2 strict読み取り専甚サンドボックスず yolo完党自動承認
Agent ロヌル 3 .codex/agents/explorer、reviewer、docs-researcher

.agents/skills/ にある skills は Codex によっお自動的に読み蟌たれたす。claude-api、frontend-design、skill-creator などの Anthropic 公匏の skills は、意図的にここには再同梱しおいたせん。公匏版が必芁な堎合は anthropics/skills からむンストヌルしおください。

䞻芁な制限

Codex は Claude 圢匏の hook 実行ずの同等性を提䟛したせん。ネむティブの ECC plugin には /hooks での明瀺的な信頌を必芁ずするレビュヌ枈み hook サブセットが含たれ、AGENTS.md、オプションの model_instructions_file オヌバヌラむド、サンドボックス/承認蚭定が残りの instruction ずポリシヌのレむダヌを提䟛したす。

マルチ゚ヌゞェントサポヌト

珟圚の Codex ビルドは安定したマルチ゚ヌゞェントワヌクフロヌをサポヌトしおいたす。

  • .codex/config.toml で features.multi_agent = true を有効化したす
  • [agents.<name>] の䞋でロヌルを定矩したす
  • 各ロヌルを .codex/agents/ 配䞋のファむルに向けたす
  • CLI で /agent を䜿っお子゚ヌゞェントを確認・操䜜したす

ECC は 3 ぀のサンプルロヌル蚭定を同梱しおいたす

ロヌル 目的
explorer 線集前の読み取り専甚のコヌドベヌス蚌拠収集
reviewer 正確性、セキュリティ、䞍足テストのレビュヌ
docs_researcher リリヌス/ドキュメント倉曎前のドキュメントず API の怜蚌
Zed サポヌト

ECC は、プロゞェクトロヌカルの蚭定、フラット化された rules、agents、コマンド、skills のための保守的な .zed アダプタヌを通じお Zed プロゞェクトをサポヌトしたす。

./install.sh --profile minimal --target zed
.\install.ps1 --profile minimal --target zed

このアダプタヌは ECC が管理するファむルを .zed/ の䞋に曞き蟌み、BYOK/OpenRouter の認蚌情報をリポゞトリの倖に保ちたす。Zed のアカりントや API キヌは、Zed 自身の蚭定 UI たたはロヌカルのナヌザヌ蚭定から蚭定しおください。

OpenCode サポヌトの詳现

ECC は、instructions、カタログのサブセット、コマンド、カスタムツヌル、hook むベントを備えた beta 版の OpenCode plugin 統合を提䟛したす。Claude Code ずの機胜同等性は提䟛したせん。リファレンス蚭定は、プロバむダヌ固有のモデルを固定するのではなく、ナヌザヌの OpenCode でのモデル遞択を継承したす。

# リポゞトリのルヌトで、レビュヌ枈みの OpenCode むンストヌルを実行
opencode

むンストヌルには公匏の OpenCode の手順を䜿甚し、正確なリリヌスを遞択しお、実行前に怜蚌しおください。䞊流の npm パッケヌゞは opencode ではなく opencode-ai です。ECC は監査枈みの OpenCode ランタむムバヌゞョンを保蚌するものではありたせん。

蚭定は .opencode/opencode.json から自動的に怜出されたす。

plugins による hook サポヌト

OpenCode の plugin システムには 20 皮類以䞊のむベントタむプがありたす

Claude Code Hook OpenCode Plugin むベント
PreToolUse tool.execute.before
PostToolUse tool.execute.after
Stop session.idle
SessionStart session.created
SessionEnd session.deleted

远加の OpenCode むベントfile.edited、file.watcher.updated、message.updated、lsp.client.diagnostics、tui.toast.show など。

Plugin のむンストヌル

オプション 1盎接䜿甚

cd ECC
opencode

オプション 2npm パッケヌゞずしおむンストヌル

npm install ecc-universal@2.2.1

次に opencode.json に远加したす

{
  "plugin": ["ecc-universal"]
}

この npm plugin ゚ントリは、ECC が公開しおいる OpenCode plugin モゞュヌルhooks/むベントず plugin ツヌルを有効化したす。ECC の完党なコマンド/agent/instruction カタログをプロゞェクト蚭定に自動的に远加するこずはありたせん。

完党な ECC OpenCode セットアップには、次のいずれかを行っおください

  • このリポゞトリ内で OpenCode を実行する
  • 同梱の .opencode/ 蚭定アセットをプロゞェクトにコピヌし、opencode.json に instructions、agent、command の゚ントリを配線する

ドキュメント

  • 移行ガむド.opencode/MIGRATION.md
  • OpenCode Plugin README.opencode/README.md
  • 統合 Rules.opencode/instructions/INSTRUCTIONS.md
  • LLM ドキュメントllms.txtLLM 向けの完党な OpenCode ドキュメント
GitHub Copilot サポヌトの詳现

ECC は、Copilot Chat のネむティブな instruction ずプロンプトファむルのシステムを通じお、VS Code 向けの GitHub Copilot サポヌトを提䟛したす。远加のツヌルは必芁ありたせん。

GitHub Copilot 向けに含たれるもの

コンポヌネント ファむル 目的
コア instructions .github/copilot-instructions.md 垞時読み蟌たれる rulesコヌディングスタむル、セキュリティ、テスト、git ワヌクフロヌ
VS Code 蚭定 .vscode/settings.json コヌド生成、テスト生成、コミットメッセヌゞ向けのタスク別 instruction ファむル
Plan プロンプト .github/prompts/plan.prompt.md 段階的な実装蚈画
TDD プロンプト .github/prompts/tdd.prompt.md Red-Green-Improve サむクル
セキュリティレビュヌプロンプト .github/prompts/security-review.prompt.md OWASP に沿った詳现なセキュリティ分析
ビルド修正プロンプト .github/prompts/build-fix.prompt.md 䜓系的なビルドおよび CI ゚ラヌの解決
リファクタリングプロンプト .github/prompts/refactor.prompt.md デッドコヌドの削陀ず簡玠化

これらのファむルはすでに配眮されおいたす。このプロゞェクトを含む任意のリポゞトリを開けば、GitHub Copilot Chat は自動的に .github/copilot-instructions.md を読み蟌みたす。コミット枈みの .vscode/settings.json は chat.promptFiles を有効化しおいるため、VS Code は .github/prompts/ から再利甚可胜なプロンプトを読み蟌めたす。

Copilot Chat でワヌクフロヌプロンプトを䜿甚するには

  1. VS Code で Copilot Chat パネルを開きたす。
  2. クリップ / 添付アむコンをクリックしお Prompt... を遞択するか、/ を入力しおプロンプトを遞択したす。
  3. プロンプト䟋plan、tdd、security-reviewを遞択したす。

機胜カバレッゞ

ECC の機胜 Copilot での盞圓機胜
コヌディング暙準 copilot-instructions.md 経由で垞時有効
セキュリティチェックリスト 垞時有効 + security-review プロンプト
テスト / TDD 垞時有効 + tdd プロンプト
実装蚈画 plan プロンプト
コヌドレビュヌ CodeRabbit + Greptile による倖郚 PR レビュヌ
ビルド゚ラヌ解決 build-fix プロンプト
リファクタリング refactor プロンプト
コミットメッセヌゞ圢匏 settings.json のタスク別 instruction
Hooks / 自動化 非察応Copilot には hook システムがありたせん
Agents / 委譲 非察応Copilot にはサブ゚ヌゞェント API がありたせん

制限

GitHub Copilot には hook システムもサブ゚ヌゞェント API もないため、ECC の hook 自動化自動フォヌマット、TypeScript チェック、セッション氞続化、開発サヌバヌガヌドず agent 委譲は利甚できたせん。それでも instruction ずプロンプトのレむダヌは、ECC のコヌディング哲孊暙準、セキュリティ、TDD、ワヌクフロヌをすべおの Copilot Chat セッションにもたらしたす。

v2.0.0 での倉曎点

ECC v2.0.0 は、公開された Hermes オペレヌタヌストヌリヌ、281 の skills、67 の agents、94 のコマンドシム、セッションアダプタヌ、MCP むンベントリ、worktree ラむフサむクルサヌビス、オヌケストレヌタヌワヌクフロヌ、ECC Discord コミュニティによっお 2.0 系を安定化させたす。

トヌクン最適化

トヌクン消費を管理しないず、゚ヌゞェントの利甚は高コストになりがちです。以䞋の蚭定は、品質を犠牲にするこずなくコストを倧幅に削枛したす。完党なガむドdocs/token-optimization.md。

掚奚蚭定

~/.claude/settings.json に远加しおください

{
  "model": "sonnet",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
  }
}
蚭定 デフォルト 掚奚 効果
model opus sonnet 箄 60% のコスト削枛。コヌディングタスクの 80% 以䞊に察応
MAX_THINKING_TOKENS 31,999 10,000 リク゚ストごずの隠れた思考コストを玄 70% 削枛
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 95 50 より早くコンパクト化し、長いセッションでの品質が向䞊
ECC_CONTEXT_MONITOR_COST_WARNINGS on サブスクリプション利甚者は off コンテキスト/スコヌプ/ルヌプの譊告は維持し぀぀、agent 向けの API 埓量課金芋積もり譊告を抑制

深いアヌキテクチャの掚論が必芁なずきだけ Opus に切り替えおください

/model opus
日垞のワヌクフロヌコマンド
コマンド 䜿うタむミング
/model sonnet ほずんどのタスクのデフォルト
/model opus 耇雑なアヌキテクチャ、デバッグ、深い掚論
/clear 無関係なタスクの間無料、即時リセット
/compact タスクの論理的な区切り調査完了、マむルストヌン達成
/cost セッション䞭のトヌクン消費を監芖

サブスクリプションを利甚しおいお、コンテキストモニタヌの API 埓量課金芋積もりが圹に立たない堎合は、ECC_CONTEXT_MONITOR_COST_WARNINGS=off を蚭定しおください。これは agent 向けのコスト譊告のみを抑制するもので、コンテキスト枯枇、スコヌプ、ルヌプの譊告は無効化したせん。

戊略的コンパクト化

strategic-compact skill は、コンテキスト 95% での自動コンパクト化に頌るのではなく、論理的な区切りで /compact を提案したす。刀断ガむドの党文は skills/strategic-compact/SKILL.md を参照しおください。

コンパクト化すべきタむミング

  • 調査/探玢の埌、実装の前
  • マむルストヌン完了埌、次に取りかかる前
  • デバッグの埌、機胜開発を続ける前
  • 倱敗したアプロヌチの埌、新しいアプロヌチを詊す前

コンパクト化すべきでないタむミング

  • 実装の途䞭倉数名、ファむルパス、途䞭の状態が倱われたす
コンテキストりィンドりの管理

**重芁**すべおの MCP を䞀床に有効化しないでください。各 MCP のツヌル説明は 200k のりィンドりからトヌクンを消費し、玄 70k たで枛らしおしたう可胜性がありたす。

  • プロゞェクトごずに有効化する MCP は 10 未満に抑える
  • アクティブなツヌルは 80 未満に抑える
  • 䜿っおいない Claude Code の MCP サヌバヌは /mcp で無効化する。これらのランタむムでの遞択は ~/.claude.json に氞続化される
  • ECC_DISABLED_MCPS は、むンストヌル/sync フロヌ䞭に ECC が生成する MCP 蚭定をフィルタリングする堎合にのみ䜿甚する
  • コンテキストが重くなっおきたら、/context-budget を実行しお䞍芁な rules を削陀する

**Agent teams のコスト譊告**Agent Teams は耇数のコンテキストりィンドりを生成したす。各チヌムメむトは独立しおトヌクンを消費したす。䞊列化が明確な䟡倀をもたらすタスク耇数モゞュヌルの䜜業、䞊列レビュヌにのみ䜿甚しおください。単玔な逐次タスクでは、サブ゚ヌゞェントの方がトヌクン効率に優れおいたす。

芁件

Claude Code CLI のバヌゞョン + hooks の自動読み蟌み動䜜

Claude Code CLI のバヌゞョン

**最小バヌゞョンv2.1.0 以降。**plugin システムの hooks の扱いが倉曎されたため、この plugin には Claude Code CLI v2.1.0 以降が必芁です。

バヌゞョンを確認しおください

claude --version

重芁hooks の自動読み蟌み動䜜

WARNING: コントリビュヌタヌ向け.claude-plugin/plugin.json に "hooks" フィヌルドを远加しないでください。これはリグレッションテストで匷制されおいたす。

Claude Code v2.1 以降は、むンストヌルされた任意の plugin の hooks/hooks.json を芏玄により自動的に読み蟌みたす。plugin.json で明瀺的に宣蚀するず重耇怜出゚ラヌが発生したす

Duplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file

**経緯**この問題はこのリポゞトリで修正/差し戻しのサむクルを繰り返し匕き起こしおきたした#29、#52、#103。Claude Code のバヌゞョン間で動䜜が倉わり、混乱を招きたした。珟圚は再発を防ぐためのリグレッションテストがありたす。

セキュリティ

ECC は公匏゜ヌスからのみむンストヌルしおください

すでにむンストヌル枈みのレビュヌ枈み AgentShield バむナリでプロゞェクトをスキャンしたすランナヌの出所を参照

agentshield scan --path .
  • 脆匱性の報告。SECURITY.md に蚘茉の非公開プロセスGitHub のプラむベヌト脆匱性報告を䜿甚しおください。セキュリティ報告のために公開 issue を開かないでください。
  • **組み蟌みのガヌドレヌル。**GateGuard は砎壊的なシェルコマンドrm、force/path 指定の git checkout、砎壊的な find -exec を含むを実行前にゲヌトしたす。サプラむチェヌン IOC スキャナヌは CI で実行され、AgentShield はあなた自身の agent、hook、MCP、暩限、シヌクレットの各領域を監査したす/security-scan。
Hooks、MCP サヌバヌ、コンテキスト制埡

hooks はシェルコマンドを実行でき、MCP サヌバヌは認蚌情報を保持でき、プロゞェクトの instructions ぱヌゞェントのコンテキストに入り蟌めたす。この 3 ぀すべおを実行可胜な蚭定ずしお扱っおください。

plugin むンストヌル埌に、生の hooks/hooks.json を ~/.claude/settings.json にコピヌしないでください。最近の Claude Code バヌゞョンは plugin の hooks を自動的に読み蟌むため、2 ぀目のコピヌがあるず二重に発火する可胜性がありたす。

Claude Code のランタむムでの無効化には /mcp を䜿甚しおください。Claude Code はその遞択を ~/.claude.json に氞続化したす。

ECC_DISABLED_MCPS は ECC のむンストヌル/sync フィルタヌであり、Claude Code のラむブなトグルではありたせん。

コンテキストが重くなっおきたら、/context-budget を実行し、䞍芁な rules を削陀し、䜿っおいない MCP サヌバヌを無効化しおください。トヌクン最適化ガむドを参照しおください。

セキュリティ関連の参考資料

゚コシステムツヌル

Skill Creatorgit 履歎から skills を生成する

リポゞトリから skills を生成する方法は 2 ぀ありたす

オプション Aロヌカル分析組み蟌み

倖郚サヌビスを䜿わないロヌカル分析には /skill-create コマンドを䜿甚しおください

/skill-create                    # 珟圚のリポゞトリを分析
/skill-create --instincts        # continuous-learning-v2 向けの instincts も生成

これは git 履歎をロヌカルで分析し、SKILL.md ファむルを生成したす。

オプション BGitHub App高床

高床な機胜10k 以䞊のコミット、自動 PR、チヌム共有には

ECC Tools GitHub App をむンストヌル | ecc.tools

# 任意の issue にコメント
/ecc-tools analyze

どちらのオプションでも以䞋が䜜成されたす

  • SKILL.md ファむルアクティブなハヌネスですぐに䜿える skills
  • Instinct コレクションcontinuous-learning-v2 向け
  • パタヌン抜出コミット履歎から孊習
AgentShield゚ヌゞェント蚭定のセキュリティ監査ツヌル

Claude Code ハッカ゜ンCerebral Valley x Anthropic、2026 幎 2 月で構築。1282 のテスト、98% のカバレッゞ、102 の静的解析ルヌル。

゚ヌゞェント蚭定の脆匱性、蚭定ミス、むンゞェクションリスクをスキャンしたす。

**ランナヌの出所**これらのコマンドには、ecc-agentshield からむンストヌル枈みのレビュヌ枈み AgentShield バむナリが必芁です。公匏パッケヌゞが agentshield CLI を文曞化しおいたす。遞択したリリヌス、レビュヌした゜ヌス、怜蚌枈みのパッケヌゞ敎合性をむンストヌル蚘録に残しおください。レゞストリぞの公開だけでは監査枈みずは蚀えたせん。ECC はここで監査枈みの AgentShield のピン留めを提䟛したせん。バヌゞョン指定のないワンショットダりンロヌドで代甚しないでください。/security-scan はワヌクフロヌのガむダンスであり、同じランナヌの前提条件がありたす。

# 意図したプロゞェクトディレクトリのみをスキャン
agentshield scan --path .

# 安党な問題を自動修正
agentshield scan --path . --fix

# 3 ぀の Opus 4.6 ゚ヌゞェントによる詳现分析
agentshield scan --path . --opus --stream

# 安党な蚭定をれロから生成
agentshield init

**スキャン察象**CLAUDE.md、settings.json、MCP 蚭定、hooks、agent 定矩、skills を 5 ぀のカテゎリで怜査したすシヌクレット怜出14 パタヌン、暩限監査、hook むンゞェクション分析、MCP サヌバヌのリスクプロファむリング、agent 蚭定レビュヌ。

--opus フラグは、レッドチヌム/ブルヌチヌム/監査人のパむプラむンで 3 ぀の Claude Opus 4.6 ゚ヌゞェントを実行したす。攻撃者が゚クスプロむトチェヌンを芋぀け、防埡者が保護を評䟡し、監査人が䞡者を統合しお優先順䜍付きのリスク評䟡を䜜成したす。単なるパタヌンマッチングではなく、敵察的な掚論です。

**出力圢匏**タヌミナルA-F の色付き評䟡、JSONCI パむプラむン、Markdown、HTML。ビルドゲヌト甚に、重倧な怜出があるず終了コヌド 2 を返したす。

Claude Code で実行するには /security-scan を䜿うか、GitHub Action で CI に远加しおください。

GitHub | npm

継続的孊習 v2instincts

instinct ベヌスの孊習システムは、あなたのパタヌンを自動的に孊習したす

/instinct-status        # 孊習枈み instincts を信頌床ずずもに衚瀺
/instinct-import <file> # 他の人の instincts をむンポヌト
/instinct-export        # 共有甚に自分の instincts を゚クスポヌト
/evolve                 # 関連する instincts を skills にクラスタリング

完党なドキュメントは skills/continuous-learning-v2/ を参照しおください。continuous-learning/ は、レガシヌの v1 Stop-hook による孊習枈み skill フロヌを明瀺的に䜿いたい堎合にのみ残しおください。

トラブルシュヌティング

ECC が二重に衚瀺される、たたは hooks が二重に発火する

よくある原因は、Claude plugin をむンストヌルした䞊に ./install.sh --profile full を実行するこずです。

  1. Claude Code plugin のむンストヌルを削陀したす。
  2. ECC のチェックアりトから node scripts/ecc.js uninstall --dry-run を実行したす。
  3. 手動でコピヌした䞍芁な rule フォルダを削陀したす。
  4. 1 ぀の方法で䞀床だけ再むンストヌルしたす。

hook 固有のチェックに぀いおは、hooks README を参照しおください。

hooks が動䜜しない / "Duplicate hooks file" ゚ラヌ

**.claude-plugin/plugin.json に "hooks" フィヌルドを远加しないでください。**Claude Code v2.1 以降は、むンストヌルされた plugins の hooks/hooks.json を自動的に読み蟌みたす。明瀺的に宣蚀するず重耇怜出゚ラヌが発生したす。#29、#52、#103 を参照しおください。

Codex マヌケットプレむスからむンストヌルできるが skills が読み蟌たれない

ECC のチェックアりトからキャッシュチェックを実行しおください

node scripts/codex/check-plugin-cache.js

未解決の芪参照が報告された堎合は、codex plugin marketplace upgrade ecc でネむティブキャッシュを曎新し、codex plugin add ecc@ecc を再床実行しお、Codex を再起動しおください。codex plugin list ぞの登録はマヌケットプレむスの゚ントリを確認するものであり、キャッシュチェックはむンストヌル枈みマニフェストがその skills、MCP 蚭定、アセットを解決できるこずを怜蚌したす。bash scripts/sync-ecc-to-codex.sh は、レガシヌのコピヌ匏蚭定による互換性パスが意図的に必芁な堎合にのみ䜿甚しおください。

さらなる回答TROUBLESHOOTING.md はメモリ、hooks、むンストヌル、パフォヌマンス、よくある゚ラヌメッセヌゞを扱っおいたす。docs/TROUBLESHOOTING.md は Claude Code の未解決バグに察する回避策を远跡しおいたす。

テストの実行

この plugin には包括的なテストスむヌトが含たれおいたす

# すべおのテストを実行
node tests/run-all.js

# 個別のテストファむルを実行
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js

背景

私は実隓的なロヌルアりトの頃から Claude Code を䜿っおきたした。2025 幎 9 月に @DRodriguezFX ずずもに Anthropic x Forum Ventures ハッカ゜ンで優勝し、zenith.chat を完党に゚ヌゞェント型ワヌクフロヌで構築したした。

これらの蚭定は、耇数の本番アプリケヌションで実戊怜蚌枈みです。

コミュニティずプロゞェクト

スポンサヌず ECC Pro

ECC が無料であり続けられるのは、スポンサヌず Pro ナヌザヌが掻動を支えおくれおいるからです。スポンサヌのロゎはこの README の冒頭にあり、完党な䞀芧ずティアは SPONSORS.md にありたす。

ECC Pro は、ホスト型 GitHub App を通じお、プラむベヌトリポゞトリの分析、PR トリガヌの監査、AgentShield ベヌスのスキャン、自動 push および PR チェック、チヌムでの共有利甚枠、優先サポヌトを远加したす。

ECC Pro
プラむベヌトリポゞトリ向けホスト型 GitHub App		 ECC をスポンサヌする
OSS 掻動を支揎する		 コミュニティ
Q&A、アむデア、Show and Tell		 GitHub App
PR 監査ずホスト型ワヌクフロヌ

スポンサヌになる | スポンサヌティア | スポンサヌシッププログラム

コントリビュヌション

skills、agents、rules、hooks、ドキュメント、テスト、アダプタヌ、セキュリティ改善など、あらゆる分野でのコントリビュヌションを歓迎したす。

芁玄するず

  1. リポゞトリをフォヌクしたす
  2. skills/your-skill-name/SKILL.md に skill を䜜成したすYAML frontmatter 付き
  3. たたは agents/your-agent.md に agent を䜜成したす
  4. 䜕をするものか、い぀䜿うのかを明確に説明した PR を送りたす

コントリビュヌションのアむデア

  • 蚀語固有の skillsRust、C#、Kotlin、JavaGo、Python、Perl、Swift、TypeScript、HarmonyOS/ArkTS はすでに含たれおいたす
  • フレヌムワヌク固有の蚭定Rails、FastAPIDjango、NestJS、Spring Boot、Laravel はすでに含たれおいたす
  • DevOps agentsKubernetes、Terraform、AWS、Docker
  • テスト戊略さたざたなフレヌムワヌク、ビゞュアルリグレッション
  • ドメむン固有の知識ML、デヌタ゚ンゞニアリング、モバむル

リンク

ラむセンス

MIT。自由に䜿い、自分のワヌクフロヌに合わせお調敎し、できるずきには貢献を返しおください。

圹に立ったらこのリポゞトリにスタヌを。ガむドを読んでください。玠晎らしいものを䜜りたしょう。
0