上方 GitHub 与 npm 徽章是当前来源。 ecc 是 MIT 许可的 Codex 工作流系统，覆盖 12+ 语言生态，并维护公开的 rc.1 发布轨道。
Language / 语言 / 語言 / Dil / Язык / Ngôn ngữ
English | Português (Brasil) | 简体中文 | 繁體中文 | 日本語 | 한국어 | Türkçe | Русский | Tiếng Việt | ไทย
来自 OpenAI 黑客马拉松获胜者的完整 OpenAI Codex 配置集合。
不止是配置文件，而是一整套完整系统：技能体系、本能行为、记忆优化、持续学习、安全扫描，以及研究优先的开发模式。 包含可直接用于生产环境的智能体、技能模块、钩子、规则、MCP 配置，以及兼容传统命令的适配层——所有内容均经过 10 个多月高强度日常使用与真实产品开发迭代打磨而成。
可在 OpenAI Codex、Codex、Cursor、OpenCode、Gemini 及其他 AI 智能体框架中通用。
本仓库是当前事实来源。请使用仓库内维护的文档，不再依赖外部视频或推文线程。
| 文档 | 何时使用 |
|---|---|
| Hermes 设置 | 配置 Hermes x ecc operator workflow |
| rc.1 发布说明 | 了解当前公开 release surface |
| 跨 harness 架构 | 在 harness 之间移植 skills、rules 和 adapters |
| 令牌优化 | 调整 Codex model、compaction 和 cost 设置 |
- 公共表面已与真实仓库同步 —— 元数据、目录数量、插件清单以及安装文档现在都与实际开源表面保持一致。
- 运营与外向型工作流扩展 ——
brand-voice、social-graph-ranker、customer-billing-ops、google-workspace-ops等运营型 skill 已纳入同一系统。 - 媒体与发布工具补齐 ——
manim-video、remotion-video-creation以及社媒发布能力让技术讲解和发布流程直接在同一仓库内完成。 - 框架与产品表面继续扩展 ——
nestjs-patterns、更完整的 Codex/OpenCode 安装表面，以及跨 harness 打包改进，让仓库不再局限于 OpenAI Codex。 - ecc 2.0 alpha 已进入仓库 ——
ecc2/下的 Rust 控制层现已可在本地构建，并提供dashboard、start、sessions、status、stop、resume与daemon命令。
在 2 分钟内快速上手：
注意：插件安装方式较为便捷，但如果你的 OpenAI Codex 版本无法正常解析自托管市场条目，建议使用下方的开源安装脚本，稳定性更高。
# 添加市场
/plugin marketplace add https://github.com/mturac/everything-openai-codex
# 安装插件
/plugin install eoc@eoc安装名称说明：较早的帖子里可能还会出现较长的旧标识符。OpenAI 的 marketplace/plugin 安装是按规范化插件标识符寻址的，因此 ecc 现在统一为
eoc@eoc，让工具名和 slash command 命名空间保持简短。
WARNING: 重要提示： OpenAI Codex 插件无法自动分发
rules。如果你已经通过
/plugin install安装了 ecc，不要再运行./install.sh --profile full、.\install.ps1 --profile full或npx eoc-install --profile full。插件已经会自动加载 ecc 的技能、命令和 hooks；此时再执行完整安装，会把同一批内容再次复制到用户目录，导致技能重复以及运行时行为重复。对于插件安装路径，请只手动复制你需要的
rules/目录。只有在你完全不走插件安装、而是选择“纯手动安装 ecc”时，才应该使用完整安装器。
# 首先克隆仓库
git clone https://github.com/mturac/everything-openai-codex.git
cd Everything OpenAI Codex
# 安装依赖（选择你常用的包管理器）
npm install # 或：pnpm install | yarn install | bun install
# 插件安装路径：只复制规则
mkdir -p ~/.codex/rules
cp -R rules/common ~/.codex/rules/
cp -R rules/typescript ~/.codex/rules/
# 纯手动安装 ecc（不要和 /plugin install 叠加）
# ./install.sh --profile full# Windows 系统（PowerShell）
# 插件安装路径：只复制规则
New-Item -ItemType Directory -Force -Path "$HOME/.codex/rules" | Out-Null
Copy-Item -Recurse rules/common "$HOME/.codex/rules/"
Copy-Item -Recurse rules/typescript "$HOME/.codex/rules/"
# 纯手动安装 ecc（不要和 /plugin install 叠加）
# .\install.ps1 --profile full
# npx eoc-install --profile full如需手动安装说明，请查看 rules/ 文件夹中的 README 文档。手动复制规则文件时，请直接复制整个语言目录（例如 rules/common 或 rules/golang），而非目录内的单个文件，以保证相对路径引用正常、文件名不会冲突。
# 尝试一个命令（插件安装使用命名空间形式）
/eoc:plan "添加用户认证"
# 手动安装（选项2）使用简短形式：
# /plan "添加用户认证"
# 查看可用命令
/plugin list eoc@eoc完成！ 你现在可以使用 60 个代理、232 个技能和 75 个命令。
WARNING: 上面的基础插件 / rules 安装不包含
multi-*命令所需的运行时。如果要使用
/multi-plan、/multi-execute、/multi-backend、/multi-frontend和/multi-workflow，还需要额外安装ccg-workflow运行时。可通过
npx ccg-workflow完成初始化安装。该运行时会提供这些命令依赖的关键组件，包括：
~/.codex/bin/codeagent-wrapper~/.codex/.ccg/prompts/*未安装
ccg-workflow时，这些multi-*命令将无法正常运行。
该插件现已全面支持 Windows、macOS 和 Linux，并与主流 IDE（Cursor、OpenCode、Antigravity）及命令行工具深度集成。所有钩子与脚本均已使用 Node.js 重写，以实现最佳兼容性。
插件自动检测你首选的包管理器（npm、pnpm、yarn 或 bun），优先级如下：
- 环境变量:
CODEX_PACKAGE_MANAGER - 项目配置:
.codex/package-manager.json - package.json:
packageManager字段 - 锁文件: 从 package-lock.json、yarn.lock、pnpm-lock.yaml 或 bun.lockb 检测
- 全局配置:
~/.codex/package-manager.json - 回退: 第一个可用的包管理器
要设置你首选的包管理器：
# 通过环境变量
export CODEX_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或在 OpenAI Codex 中使用 /setup-pm 命令。
使用运行时标记调整严格度或临时禁用特定钩子：
# 钩子严格度配置文件（默认值：standard）
export ecc_HOOK_PROFILE=standard
# 以英文逗号分隔的钩子 ID 列表，用于禁用指定钩子
export ecc_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"这个仓库是一个 OpenAI Codex 插件 - 直接安装或手动复制组件。
Everything OpenAI Codex/
|-- .codex-plugin/ # 插件与应用商店清单
| |-- plugin.json # 插件元数据与组件路径
| |-- marketplace.json # 用于 /plugin marketplace add 的自托管应用商店目录
|
|-- agents/ # 36 个专用子智能体，用于任务委派
| |-- planner.md # 功能实现规划
| |-- architect.md # 系统架构设计决策
| |-- tdd-guide.md # 测试驱动开发
| |-- code-reviewer.md # 代码质量与安全审查
| |-- security-reviewer.md # 漏洞分析
| |-- build-error-resolver.md # 构建错误修复
| |-- e2e-runner.md # Playwright 端到端测试
| |-- 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++ 构建错误修复
| |-- 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 构建错误修复
| |-- rust-reviewer.md # Rust 代码审查
| |-- rust-build-resolver.md # Rust 构建错误修复
| |-- pytorch-build-resolver.md # PyTorch/CUDA 训练错误修复
|
|-- skills/ # 工作流定义与领域知识库
| |-- coding-standards/ # 各语言最佳实践
| |-- clickhouse-io/ # ClickHouse 分析、查询与数据工程
| |-- backend-patterns/ # API、数据库、缓存设计模式
| |-- frontend-patterns/ # React、Next.js 开发模式
| |-- frontend-slides/ # HTML 幻灯片与 PPTX 转网页工作流（新增）
| |-- article-writing/ # 长文本写作，保留指定风格、避免通用 AI 腔调（新增）
| |-- content-engine/ # 多平台社交内容创作与复用工作流（新增）
| |-- market-research/ # 带来源引用的市场、竞品与投资方研究（新增）
| |-- investor-materials/ # 融资路演 PPT、单页摘要、备忘录与财务模型（新增）
| |-- investor-outreach/ # 定制化融资触达与跟进（新增）
| |-- continuous-learning/ # 从会话中自动提取模式（长文本指南）
| |-- continuous-learning-v2/ # 基于本能的学习，附带置信度评分
| |-- iterative-retrieval/ # 为子智能体渐进式优化上下文
| |-- strategic-compact/ # 手动上下文精简建议（长文本指南）
| |-- tdd-workflow/ # 测试驱动开发方法论
| |-- security-review/ # 安全检查清单
| |-- eval-harness/ # 验证循环评估（长文本指南）
| |-- verification-loop/ # 持续验证机制（长文本指南）
| |-- videodb/ # 音视频采集、检索、编辑、生成与推流（新增）
| |-- golang-patterns/ # Go 语言惯用写法与最佳实践
| |-- golang-testing/ # Go 测试模式、TDD 与基准测试
| |-- cpp-coding-standards/ # 遵循 C++ Core Guidelines 的编码规范（新增）
| |-- 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 验证（新增）
| |-- springboot-patterns/ # Java Spring Boot 模式（新增）
| |-- springboot-security/ # Spring Boot 安全（新增）
| |-- springboot-tdd/ # Spring Boot TDD（新增）
| |-- springboot-verification/ # Spring Boot 验证（新增）
| |-- configure-ecc/ # 交互式安装向导（新增）
| |-- java-coding-standards/ # Java 编码规范（新增）
| |-- jpa-patterns/ # JPA/Hibernate 模式（新增）
| |-- postgres-patterns/ # PostgreSQL 优化模式（新增）
| |-- nutrient-document-processing/ # 基于 Nutrient API 的文档处理（新增）
| |-- docs/examples/project-guidelines-template.md # 项目专属技能模板
| |-- database-migrations/ # 数据库迁移模式（Prisma、Drizzle、Django、Go）（新增）
| |-- api-design/ # REST API 设计、分页、错误响应（新增）
| |-- deployment-patterns/ # CI/CD、Docker、健康检查、回滚（新增）
| |-- docker-patterns/ # Docker Compose、网络、数据卷、容器安全（新增）
| |-- e2e-testing/ # Playwright E2E 模式与页面对象模型（新增）
| |-- content-hash-cache-pattern/ # 用于文件处理的 SHA-256 内容哈希缓存（新增）
| |-- cost-aware-llm-pipeline/ # LLM 成本优化、模型路由、预算跟踪（新增）
| |-- regex-vs-llm-structured-text/ # 文本解析：正则与 LLM 选型决策框架（新增）
| |-- swift-actor-persistence/ # 基于 Actor 的 Swift 线程安全数据持久化（新增）
| |-- swift-protocol-di-testing/ # 基于协议的依赖注入，实现可测试 Swift 代码（新增）
| |-- search-first/ # 先调研再编码工作流（新增）
| |-- skill-stocktake/ # 技能与命令质量审计（新增）
| |-- liquid-glass-design/ # iOS 26 Liquid Glass 设计系统（新增）
| |-- foundation-models-on-device/ # 基于 Apple FoundationModels 的端侧大模型（新增）
| |-- swift-concurrency-6-2/ # Swift 6.2 简洁并发编程（新增）
| |-- perl-patterns/ # 现代 Perl 5.36+ 惯用写法与最佳实践（新增）
| |-- perl-security/ # Perl 安全模式、污点模式、安全 I/O（新增）
| |-- perl-testing/ # 基于 Test2::V0、prove、Devel::Cover 的 Perl TDD（新增）
| |-- autonomous-loops/ # 自主循环模式：顺序流水线、PR 循环、DAG 编排（新增）
| |-- plankton-code-quality/ # 基于 Plankton 钩子的实时代码质量管控（新增）
|
|-- commands/ # 维护中的斜杠命令兼容层；优先使用 skills/
| |-- plan.md # /plan - 实现规划
| |-- code-review.md # /code-review - 代码质量审查
| |-- build-fix.md # /build-fix - 修复构建错误
| |-- quality-gate.md # /quality-gate - 验证门禁
| |-- refactor-clean.md # /refactor-clean - 清理无效代码
| |-- 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 历史生成技能（新增）
| |-- instinct-status.md # /instinct-status - 查看已学习本能（新增）
| |-- instinct-import.md # /instinct-import - 导入本能（新增）
| |-- instinct-export.md # /instinct-export - 导出本能（新增）
| |-- evolve.md # /evolve - 将本能聚类为技能
| |-- prune.md # /prune - 删除过期待处理本能（新增）
| |-- 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 - 更新代码映射
| |-- python-review.md # /python-review - Python 代码审查（新增）
|-- legacy-command-shims/ # 已退役短命令的按需归档，例如 /tdd 和 /eval
| |-- tdd.md # /tdd - 优先使用 tdd-workflow 技能
| |-- e2e.md # /e2e - 优先使用 e2e-testing 技能
| |-- eval.md # /eval - 优先使用 eval-harness 技能
| |-- verify.md # /verify - 优先使用 verification-loop 技能
| |-- orchestrate.md # /orchestrate - 优先使用 dmux-workflows 或 multi-workflow
|
|-- rules/ # 必须遵守的规范（复制到 ~/.codex/rules/）
| |-- README.md # 结构概览与安装指南
| |-- common/ # 与语言无关的通用原则
| | |-- coding-style.md # 不可变性、文件组织规范
| | |-- git-workflow.md # 提交格式、PR 流程
| | |-- testing.md # TDD、80% 覆盖率要求
| | |-- performance.md # 模型选型、上下文管理
| | |-- patterns.md # 设计模式、项目骨架
| | |-- hooks.md # 钩子架构、TodoWrite
| | |-- agents.md # 子智能体委派时机
| | |-- security.md # 强制安全检查
| |-- typescript/ # TypeScript/JavaScript 专属规范
| |-- python/ # Python 专属规范
| |-- golang/ # Go 专属规范
| |-- swift/ # Swift 专属规范
| |-- php/ # PHP 专属规范（新增）
|
|-- hooks/ # 基于触发器的自动化逻辑
| |-- README.md # 钩子文档、使用示例与自定义指南
| |-- hooks.json # 全部钩子配置（PreToolUse、PostToolUse、Stop 等）
| |-- memory-persistence/ # 会话生命周期钩子（长文本指南）
| |-- strategic-compact/ # 上下文精简建议（长文本指南）
|
|-- scripts/ # 跨平台 Node.js 脚本（新增）
| |-- lib/ # 通用工具库
| | |-- utils.js # 跨平台文件 / 路径 / 系统工具
| | |-- package-manager.js # 包管理器检测与选择
| |-- hooks/ # 钩子实现
| | |-- session-start.js # 会话启动时加载上下文
| | |-- session-end.js # 会话结束时保存状态
| | |-- pre-compact.js # 上下文精简前状态保存
| | |-- suggest-compact.js # 策略性精简建议
| | |-- evaluate-session.js # 从会话中提取模式
| |-- setup-package-manager.js # 交互式包管理器设置
|
|-- tests/ # 测试套件（新增）
| |-- lib/ # 工具库测试
| |-- hooks/ # 钩子测试
| |-- run-all.js # 运行全部测试
|
|-- contexts/ # 动态注入的系统提示上下文（长文本指南）
| |-- dev.md # 开发模式上下文
| |-- review.md # 代码审查模式上下文
| |-- research.md # 研究 / 探索模式上下文
|
|-- examples/ # 配置与会话示例
| |-- CODEX.md # 项目级配置示例
| |-- user-CODEX.md # 用户级配置示例
| |-- saas-nextjs-CODEX.md # 真实 SaaS 项目（Next.js + Supabase + Stripe）
| |-- go-microservice-CODEX.md # 真实 Go 微服务（gRPC + PostgreSQL）
| |-- django-api-CODEX.md # 真实 Django REST API（DRF + Celery）
| |-- laravel-api-CODEX.md # 真实 Laravel API（PostgreSQL + Redis）（新增）
| |-- rust-api-CODEX.md # 真实 Rust API（Axum + SQLx + PostgreSQL）（新增）
|
|-- mcp-configs/ # MCP 服务端配置
| |-- mcp-servers.json # GitHub、Supabase、Vercel、Railway 等配置
|
|-- marketplace.json # 自托管应用商店配置（用于 /plugin marketplace add）
两种从你的仓库生成 OpenAI Codex 技能的方法：
使用 /skill-create 命令进行本地分析，无需外部服务：
/skill-create # 分析当前仓库
/skill-create --instincts # 还为 continuous-learning 生成直觉这在本地分析你的 git 历史并生成 SKILL.md 文件。
基于直觉的学习系统自动学习你的模式：
/instinct-status # 显示带有置信度的学习直觉
/instinct-import <file> # 从他人导入直觉
/instinct-export # 导出你的直觉以供分享
/evolve # 将相关直觉聚类到技能中
/promote # 将项目级直觉提升为全局直觉
/projects # 查看已识别项目与直觉统计完整文档见 skills/continuous-learning-v2/。
最低版本：v2.1.0 或更高
由于插件系统处理钩子的机制发生变更，本插件要求 OpenAI Codex CLI 版本不低于 v2.1.0。
查看当前版本：
codex --version警告：贡献者请注意：请勿在
.codex-plugin/plugin.json中添加"hooks"字段。回归测试已强制禁止该操作。
OpenAI Codex v2.1+ 会按照约定自动加载已安装插件中的 hooks/hooks.json。若在 plugin.json 中显式声明该文件，会触发重复检测错误：
检测到重复的钩子文件：./hooks/hooks.json 指向已加载的文件
历史说明：该问题曾在本仓库中引发多次「修复-回滚」循环（#29、#52、#103）。因 OpenAI Codex 版本间行为变更导致混淆，现已添加回归测试，防止该问题再次出现。
使用此仓库的最简单方法 - 作为 OpenAI Codex 插件安装：
# 将此仓库添加为市场
/plugin marketplace add https://github.com/mturac/everything-openai-codex
# 安装插件
/plugin install eoc@eoc或直接添加到你的 ~/.codex/settings.json：
{
"extraKnownMarketplaces": {
"ecc": {
"source": {
"source": "github",
"repo": "mturac/everything-openai-codex"
}
}
},
"enabledPlugins": {
"eoc@eoc": true
}
}这让你可以立即访问所有命令、代理、技能和钩子。
注意： OpenAI Codex 插件系统不支持通过插件分发
rules（上游限制）。你需要手动安装规则：# 首先克隆仓库 git clone https://github.com/mturac/everything-openai-codex.git # 方案 A：用户级规则（对所有项目生效） mkdir -p ~/.codex/rules cp -r Everything OpenAI Codex/rules/common ~/.codex/rules/ cp -r Everything OpenAI Codex/rules/typescript ~/.codex/rules/ # 选择你使用的技术栈 cp -r Everything OpenAI Codex/rules/python ~/.codex/rules/ cp -r Everything OpenAI Codex/rules/golang ~/.codex/rules/ cp -r Everything OpenAI Codex/rules/php ~/.codex/rules/ # 方案 B：项目级规则（仅对当前项目生效） mkdir -p .codex/rules cp -r Everything OpenAI Codex/rules/common .codex/rules/ cp -r Everything OpenAI Codex/rules/typescript .codex/rules/ # 选择你使用的技术栈
如果你希望手动控制安装内容，可按以下步骤操作：
# 克隆仓库
git clone https://github.com/mturac/everything-openai-codex.git
# 将智能体文件复制到 Codex 配置目录
cp Everything OpenAI Codex/agents/*.md ~/.codex/agents/
# 复制规则目录（通用规则 + 特定语言规则）
mkdir -p ~/.codex/rules
cp -r Everything OpenAI Codex/rules/common ~/.codex/rules/
cp -r Everything OpenAI Codex/rules/typescript ~/.codex/rules/ # 选择你使用的技术栈
cp -r Everything OpenAI Codex/rules/python ~/.codex/rules/
cp -r Everything OpenAI Codex/rules/golang ~/.codex/rules/
cp -r Everything OpenAI Codex/rules/php ~/.codex/rules/
# 优先复制技能模块（核心工作流）
# 新用户推荐：仅复制核心/通用技能
cp -r Everything OpenAI Codex/.agents/skills/* ~/.codex/skills/
cp -r Everything OpenAI Codex/skills/search-first ~/.codex/skills/
# 可选：仅在需要时添加细分领域/框架专属技能
# for s in django-patterns django-tdd laravel-patterns springboot-patterns quarkus-patterns; do
# cp -r Everything OpenAI Codex/skills/$s ~/.codex/skills/
# done
# 可选：迁移期间保留维护中的斜杠命令兼容
mkdir -p ~/.codex/commands
cp Everything OpenAI Codex/commands/*.md ~/.codex/commands/
# 已退役短命令位于 legacy-command-shims/commands/。
# 仅在仍需要 /tdd 等旧名称时，单独复制对应文件。仅适用于手动安装：如果你没有通过 Codex 插件方式安装 ecc，可以将 hooks/hooks.json 中的钩子配置复制到你的 ~/.codex/settings.json 文件中。
如果你是通过 /plugin install 安装 ecc，请不要再把这些钩子复制到 settings.json。OpenAI Codex v2.1+ 会自动加载插件中的 hooks/hooks.json，重复注册会导致重复执行以及 ${CODEX_PLUGIN_ROOT} 无法解析。
从 mcp-configs/mcp-servers.json 中复制需要的 MCP 服务定义，粘贴到官方 OpenAI Codex 配置文件 ~/.codex/settings.json 中；
若需要仓库本地的 MCP 访问权限，可粘贴到项目级配置文件 .mcp.json 中。
如果你已自行运行 ecc 捆绑的 MCP 服务，设置以下环境变量：
export ecc_DISABLED_MCPS="github,context7,exa,playwright,sequential-thinking,memory"ecc 托管的安装程序和 Codex 同步流程将跳过或移除这些服务，避免重复添加。
重要提示：将配置中的 YOUR_*_HERE 占位符替换为你真实的 API 密钥。
子代理以有限范围处理委托的任务。示例：
---
name: code-reviewer
description: 审查代码的质量、安全性和可维护性
tools: ["Read", "Grep", "Glob", "Bash"]
model: deep
---
你是一名高级代码审查员...技能是由命令或代理调用的工作流定义：
# TDD 工作流
1. 首先定义接口
2. 编写失败的测试（RED）
3. 实现最少的代码（GREEN）
4. 重构（IMPROVE）
5. 验证 80%+ 的覆盖率钩子在工具事件时触发。示例 - 警告 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] 移除 console.log' >&2"
}]
}规则是始终遵循的指南，分为 common/（通用）+ 语言特定目录：
~/.codex/rules/
common/ # 通用原则（必装）
typescript/ # TS/JS 特定模式和工具
python/ # Python 特定模式和工具
golang/ # Go 特定模式和工具
perl/ # Perl 特定模式和工具
插件包含一个全面的测试套件：
# 运行所有测试
node tests/run-all.js
# 运行单个测试文件
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js欢迎并鼓励贡献。
这个仓库旨在成为社区资源。如果你有：
- 有用的代理或技能
- 聪明的钩子
- 更好的 MCP 配置
- 改进的规则
请贡献！请参阅 CONTRIBUTING.md 了解指南。
- 特定语言技能（Rust、C#、Kotlin、Java）—— Go、Python、Perl、Swift 和 TypeScript 已内置
- 特定框架配置（Rails、FastAPI）—— Django、NestJS、Spring Boot 和 Laravel 已内置
- DevOps 智能体（Kubernetes、Terraform、AWS、Docker）
- 测试策略（多种测试框架、视觉回归测试）
- 领域专属知识库（机器学习、数据工程、移动端开发）
自实验性推出以来，我一直在使用 OpenAI Codex，并把重复出现的生产工作流沉淀为可复用的 ecc 技能、钩子、规则和安装配置。
这些配置在多个生产应用中经过了实战测试。
关键： 不要一次启用所有 MCP。如果启用了太多工具，你的 200k 上下文窗口可能会缩小到 70k。
经验法则：
- 配置 20-30 个 MCP
- 每个项目保持启用少于 10 个
- 活动工具少于 80 个
在项目配置中使用 disabledMcpServers 来禁用未使用的。
这些配置适用于我的工作流。你应该：
- 从适合你的开始
- 为你的技术栈进行修改
- 删除你不使用的
- 添加你自己的模式
基于 Everything OpenAI Codex 构建或受其启发的项目：
| 项目 | 介绍 |
|---|---|
| EVC | 营销智能体工作区 — 包含 42 条命令，面向内容运营、品牌管控与多渠道发布。可视化概览。 |
如果你用 ecc 做了项目，欢迎提交 PR 添加到这里。
本项目免费开源。赞助支持项目持续维护与功能迭代。
- Hermes 设置： docs/HERMES-SETUP.md
- 发布说明： docs/releases/2.0.0-rc.1/release-notes.md
- 安全指南： the-security-guide.md
- 来源致谢： NOTICE.md
MIT - 自由使用，根据需要修改，如果可以请回馈。
如果这个仓库有帮助，请给它一个 Star。阅读两个指南。构建一些很棒的东西。