everything-claude-code

GitHub
139k 20.8k 简单 207 次阅读 今天MIT开发框架Agent语言模型
AI 解读 由 AI 自动生成,仅供参考

everything-claude-code 是一套专为 AI 编程助手(如 Claude Code、Codex、Cursor 等)打造的高性能优化系统。它不仅仅是一组配置文件,而是一个经过长期实战打磨的完整框架,旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。

通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能,everything-claude-code 能显著提升 AI 在复杂任务中的表现,帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略,使得模型响应更快、成本更低,同时有效防御潜在的攻击向量。

这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库,还是需要 AI 协助进行安全审计与自动化测试,everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目,它融合了多语言支持与丰富的实战钩子(hooks),让 AI 真正成长为懂上下文、守规则、能进化的得力搭档。

使用场景

某初创团队的后端工程师正在利用 Claude Code 快速迭代一个高并发的微服务架构,需要在短时间内完成从代码生成到安全部署的全流程。

没有 everything-claude-code 时

  • 上下文丢失严重:AI 代理在长对话中频繁“遗忘”之前的架构决策,导致生成的代码风格不一致,甚至重复编写已存在的模块。
  • 安全隐患裸露:自动生成的代码缺乏实时的安全扫描,开发者需手动审查潜在的注入漏洞或依赖风险,极易遗漏 CVE 威胁。
  • 资源消耗失控:由于缺乏 Token 优化策略,每次任务都消耗大量上下文窗口,导致运行成本高昂且响应速度随对话长度显著下降。
  • 技能复用困难:针对特定业务逻辑的调试经验无法沉淀为可复用的“技能”,每次遇到类似问题都要重新向 AI 解释规则。

使用 everything-claude-code 后

  • 记忆持久化增强:通过内置的记忆优化钩子(Hooks),AI 能长期记住项目架构规范和历史决策,确保跨文件的代码风格高度统一。
  • 主动安全防御:集成的 AgentShield 组件在代码生成阶段即自动拦截攻击向量并进行沙箱测试,将安全漏洞阻断在提交之前。
  • 极致性能优化:系统自动精简系统提示词并管理后台进程,大幅降低 Token 消耗,使复杂任务的执行速度提升且成本减半。
  • 技能本能化:将团队的最佳实践转化为 AI 的“本能”和自定义技能,新任务可直接调用过往积累的研发经验,无需重复指令。

everything-claude-code 将原本松散、昂贵且存在风险的 AI 编码过程,转型为一个具备持续学习能力、安全可控且高效低耗的生产级研发系统。

运行环境要求

操作系统
  • Linux
  • macOS
  • Windows
GPU

未说明

内存

未说明

依赖
notes该工具是基于 Node.js 的 AI Agent 配置与优化系统,而非本地运行的深度学习模型,因此无需 GPU。安装需先克隆仓库,并通过提供的 Shell (install.sh) 或 PowerShell (install.ps1) 脚本安装规则文件。支持多种包管理器(npm, pnpm, yarn, bun)。可选使用 PM2 进行多代理编排,使用 SQLite 存储会话状态。
python未说明
Node.js/npm/pnpm/yarn/bun
Git
SQLite
everything-claude-code hero image

快速开始

**语言:**英语 | 葡萄牙语(巴西) | 简体中文 | 繁体中文 | 日语 | 韩语 | 土耳其语

一切 Claude Code

星标  Forks 贡献者 npm ecc-universal npm ecc-agentshield GitHub 应用安装 许可证 Shell TypeScript Python Go Java Perl Markdown

超过 5 万个 Star | 6000 多个 Fork | 30 位贡献者 | 支持 7 种语言 | Anthropic 杯黑客马拉松冠军



面向 AI 代理的性能优化系统,由 Anthropic 杯黑客马拉松冠军打造。

不只是配置!一套完整的系统:技能、直觉、内存优化、持续学习、安全扫描,以及以研究为导向的开发流程。经过 10 多个月的密集日常使用,我们打造出的生产级代理、挂钩、命令、规则,以及 MCP 配置,最终实现了真实产品的落地。

适用于 Claude CodeCodexCowork 等各类 AI 代理工具。


指南

本仓库仅包含原始代码。指南将为您详细讲解所有内容。

Everything Claude Code 简写指南 Everything Claude Code 长篇指南 Everything Agentic 安全性简写指南
简写指南
设置、基础概念、哲学理念。请先阅读此部分。
长篇指南
令牌优化、内存持久化、评估机制、并行化。
安全指南
攻击向量、沙盒隔离、 sanitization、CVE 编号、AgentShield。
主题 您将学到的内容
令牌优化 模型选择、系统提示精简、后台进程
内存持久化 自动保存并加载会话上下文的挂钩
持续学习 自动从会话中提取模式,将其转化为可重用的技能
校验循环 通过检查点与连续评估相结合,采用不同的评分类型,实现“通过@k”指标
并行化 Git 工作树、级联方法、何时需要扩展实例数量
子代理编排 上下文问题、迭代式检索模式

新功能

v1.9.0 — 选择性安装与语言扩展(2026年3月)

  • 选择性安装架构 — 采用 Manifest 驱动的安装流程,通过 install-plan.jsinstall-apply.js 实现针对性组件的安装。状态存储会跟踪已安装的内容,并支持增量更新。
  • 新增 6 个代理typescript-reviewerpytorch-build-resolverjava-build-resolverjava-reviewerkotlin-reviewerkotlin-build-resolver 将语言覆盖范围拓展至 10 种语言。
  • 新增技能 — 为深度学习工作流提供 pytorch-patterns,为 API 参考研究提供 documentation-lookup,为现代 JS 工具链提供 bun-runtimenextjs-turbopack,此外还新增 8 项运营领域技能以及 mcp-server-patterns
  • 会话与状态基础设施 — 使用 SQLite 状态存储,并配备查询 CLI;通过会话适配器进行结构化记录;建立技能进化基础,助力技能自我提升。
  • 编排系统全面升级 — 让审计评分变得更加确定,强化编排状态与启动器的兼容性,通过 5 层防护机制防止观察者循环。
  • 观察者可靠性 — 通过限流和尾部采样修复了内存爆炸问题,修复了沙盒访问权限,引入了延迟启动逻辑,并增强了重新进入保护机制。
  • 12 种语言生态系统 — Java、PHP、Perl、Kotlin/Android/KMP、C++、Rust 等新规则加入现有 TypeScript、Python、Go 以及通用规则体系。
  • 社区贡献 — 提供韩语和中文翻译,新增安全挂钩、生物群落挂钩优化、视频处理技能、运营技能、PowerShell 安装程序,以及 Antigravity IDE 支持。
  • CI 强化 — 修复了 19 处测试失败问题,严格控制了目录计数,验证了安装清单,并确保了完整测试套件顺利通过。

v1.8.0 — 代理性能系统(2026年3月)

  • 首次发布代理系统 — ECC 现在被明确定位为代理性能系统,而不仅仅是配置包。
  • 挂钩可靠性全面升级 — 增加了 SessionStart 根据地的回退机制、停止阶段的会话摘要,以及基于脚本的挂钩,取代了脆弱的内联单行代码。
  • 挂钩运行时控制 — 通过 ECC_HOOK_PROFILE=minimal|standard|strictECC_DISABLED_HOOKS=...,实现运行时的条件限制,无需手动编辑挂钩文件。
  • 新增代理命令/harness-audit/loop-start/loop-status/quality-gate/model-route
  • NanoClaw v2 — 模型路由、技能热加载、会话分支/搜索/导出/压缩/指标管理。
  • 跨代理一致性 — 在 Claude Code、Cursor、OpenCode 以及 Codex 应用/CLI 之间,行为规范得到进一步收紧。
  • 997 项内部测试全部通过 — 在挂钩/运行时重构及兼容性更新后,整套测试均顺利通过,且完全绿色。

v1.7.0 — 跨平台扩展与演示构建器(2026年2月)

  • Codex 应用 + CLI 支持 — 直接支持基于 AGENTS.md 的 Codex,提供目标安装程序以及 Codex 文档
  • frontend-slides 技能 — 无需依赖任何其他工具的 HTML 演示构建器,具备 PPTX 转换指南,并严格遵循视口适配规则
  • 新增 5 项通用业务/内容技能文章写作内容引擎市场调研投资者资料投资者沟通
  • 更广泛的功能覆盖 — 突破性地强化了 Cursor、Codex 与 OpenCode 的支持,确保同一仓库可在所有主流框架中顺畅运行
  • 992 次内部测试 — 在插件、钩子、技能及打包等环节,进一步扩大了验证与回归测试的覆盖率

v1.6.0 — Codex CLI、AgentShield 与 Marketplace(2026年2月)

  • Codex CLI 支持 — 新增 /codex-setup 命令,可自动生成 codex.md 文件,以实现 OpenAI Codex CLI 的兼容性
  • 新增 7 项技能搜索优先Swift Actor 持久化Swift 协议调试测试正则表达式 vs LLM 结构化文本内容哈希缓存模式成本感知 LLM 流程技能盘点
  • AgentShield 集成/security-scan 技能可直接从 Claude Code 运行 AgentShield;已通过 1282 次测试,涵盖 102 条规则
  • GitHub Marketplace — ECC Tools GitHub 应用现已上线,网址为 github.com/marketplace/ecc-tools,提供免费版、专业版与企业版三种版本
  • 合并 30 多条社区 PR — 来自 30 位贡献者、涵盖 6 种语言的贡献
  • 978 次内部测试 — 在代理、技能、命令、钩子及规则等环节,进一步扩展了验证套件

v1.4.1 — 修复 Bug(2026年2月)

  • 修复了 instinct 导入时的内容丢失问题 — 在 /instinct-import 中,parse_instinct_file() 会在前言部分(如“行动”、“证据”、“示例”等章节)之后悄然丢弃所有内容。(#148#161)

v1.4.0 — 多语言规则、安装向导与 PM2(2026年2月)

  • 交互式安装向导 — 新增的 configure-ecc 技能可引导用户完成设置,并自动检测是否需要合并或覆盖现有配置
  • PM2 与多代理编排 — 新增 6 条命令(/pm2/multi-plan/multi-execute/multi-backend/multi-frontend/multi-workflow),用于管理复杂的多服务工作流
  • 多语言规则架构 — 规则已从扁平化文件重构为 common/typescript/python/golang/ 目录结构。只需安装您所需的语言版本
  • 中文(zh-CN)翻译 — 已完成所有代理、命令、技能及规则的完整翻译(共 80 多个文件)
  • GitHub Sponsors 支持 — 通过 GitHub Sponsors 为项目提供赞助
  • 增强的 CONTRIBUTING.md — 为每种贡献类型提供了详细的 PR 模板

v1.3.0 — OpenCode 插件支持(2026年2月)

  • 全面集成 OpenCode — 12 个代理、24 条命令、16 项技能,并可通过 OpenCode 的插件系统实现钩子支持(涵盖 20 多种事件类型)
  • 3 项原生自定义工具 — 包括 run-tests、check-coverage 和 security-audit
  • LLM 文档 — 提供 llms.txt,为 OpenCode 提供全面的文档支持

v1.2.0 — 统一命令与技能(2026年2月)

  • Python/Django 支持 — Django 模式、安全、TDD 以及验证相关技能
  • Java Spring Boot 技能 — Spring Boot 的模式、安全、TDD 与验证相关技能
  • 会话管理/sessions 命令可用于查看会话历史记录
  • 持续学习 v2 — 基于 instinct 的学习方式,具备信心评分、导入/导出功能,且能够不断进化

请参阅完整的变更日志:发布版本


快速入门

不到 2 分钟即可上手使用:

步骤 1:安装插件

# 添加 Marketplace
/plugin marketplace add affaan-m/everything-claude-code

# 安装插件
/plugin install everything-claude-code@everything-claude-code

步骤 2:安装规则(必选)

注意:重要提示:Claude Code 插件无法自动分发“规则”。请手动安装:

# 先克隆代码库
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

# 安装依赖项(根据您的包管理器选择)
npm install        # 或:pnpm install | yarn install | bun install

# macOS/Linux

# 推荐:安装 Everything(完整配置)
./install.sh --profile full

# 或仅针对特定语言进行安装
./install.sh typescript    # 或 python、golang、swift、php
# ./install.sh typescript python golang swift php
# ./install.sh --target cursor typescript
# ./install.sh --target antigravity typescript
# Windows PowerShell

# 推荐:安装 Everything(完整配置)
.\install.ps1 --profile full

# 或仅针对特定语言进行安装
.\install.ps1 typescript   # 或 python、golang、swift、php
# .\install.ps1 typescript python golang swift php
# .\install.ps1 --target cursor typescript
# .\install.ps1 --target antigravity typescript

# npm 安装的兼容性入口点同样适用于跨平台
npx ecc-install typescript

如需手动安装说明,请参阅 rules/ 文件夹中的 README。在手动复制规则时,请复制整个语言目录(例如 rules/commonrules/golang),而非其内部的文件,这样相对路径引用仍能正常工作,文件名也不会发生冲突。

步骤 3:开始使用

# 尝试执行一条命令(插件安装采用命名空间形式)
/everything-claude-code:plan "添加用户认证"

# 手动安装(选项 2)采用更简短的形式:
# /plan "添加用户认证"

# 查看可用命令
/plugin list everything-claude-code@everything-claude-code

如此便完成了! 您现在可以访问 30 个代理、136 项技能以及 60 条命令。

多模型命令需额外设置

注意:multi-* 命令并未包含在上述基础插件/规则的安装中。

若要使用 /multi-plan/multi-execute/multi-backend/multi-frontend 以及 /multi-workflow,您还需安装 ccg-workflow 运行时。

使用 npx ccg-workflow 进行初始化。

该运行时会提供这些命令所依赖的外部依赖项,包括:

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

若未安装 ccg-workflow,这些 multi-* 命令将无法正常运行。


跨平台支持

本插件现已全面支持 Windows、macOS 与 Linux,并能与各大 IDE(Cursor、OpenCode、Antigravity)以及 CLI 工具实现紧密集成。所有钩子与脚本均已改写为 Node.js 版本,以实现最佳兼容性。

包管理器检测

该插件会自动检测您首选的包管理器(npm、pnpm、yarn 或 bun),其优先级如下:

  1. 环境变量CLAUDE_PACKAGE_MANAGER
  2. 项目配置.claude/package-manager.json
  3. package.jsonpackageManager 字段
  4. 锁定文件:从 package-lock.jsonyarn.lockpnpm-lock.yamlbun.lock 中进行检测
  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

或者在 Claude Code 中使用 /setup-pm 命令。

插件运行时控制

通过运行时标志来调整严格程度,或临时禁用特定的钩子:

# 钩子严格度配置(默认为标准)
export ECC_HOOK_PROFILE=standard

# 以逗号分隔的钩子 ID,用于禁用
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

内容概览

本仓库是一个 Claude Code 插件——您可以直接安装它,也可以手动复制相关组件。

everything-claude-code/
|-- .claude-plugin/   # 插件与市场目录清单
|   |-- plugin.json         # 插件元数据及组件路径
|   |-- marketplace.json    # 用于 /plugin 市场的市场目录
|
|-- agents/           # 30 个专门用于委托执行的子代理
|   |-- 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 # Harness 配置调优
|   |-- 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 转 Web 演示工作流(全新)
|   |-- article-writing/            # 以特定语气撰写长篇内容,避免通用 AI 风格(全新)
|   |-- content-engine/             # 多平台社交内容与内容再利用工作流(全新)
|   |-- market-research/            # 基于来源的市场、竞争对手及投资者研究(全新)
|   |-- investor-materials/         # 投资者推介文稿、单页演示文稿、备忘录及财务模型(全新)
|   |-- investor-outreach/          # 个性化筹款沟通与跟进(全新)
|   |-- continuous-learning/        # 从会话中自动提取模式(长篇指南)
|   |-- continuous-learning-v2/     # 基于直觉的学习,并附带信心评分
|   |-- iterative-retrieval/        # 为子代理逐步优化上下文
|   |-- strategic-compact/          # 手动压缩建议(长篇指南)
|   |-- tdd-workflow/               # TDD 方法论
|   |-- security-review/            # 安全检查清单
|   |-- eval-harness/               # 验证循环评估(长篇指南)
|   |-- verification-loop/          # 持续验证(长篇指南)
|   |-- videodb/                   # 视频与音频:采集、搜索、编辑、生成、流式传输(全新)
|   |-- golang-patterns/            # Golang 语义与最佳实践
|   |-- golang-testing/             # Golang 测试模式、TDD、基准测试
|   |-- cpp-coding-standards/         # C++ 编码标准,源自 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 测试(全新)
|   |-- 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 进行文档处理(全新)
|   |-- project-guidelines-example/   # 项目专用技能模板
|   |-- 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/ # 决策框架:正则表达式 vs LLM 用于文本解析(全新)
|   |-- swift-actor-persistence/     # 使用线程安全的 Swift 数据持久化,结合 Actor(全新)
|   |-- swift-protocol-di-testing/   # 基于协议的 DI,适用于可测试的 Swift 代码(全新)
|   |-- search-first/               # 在编码前进行调研的工作流(全新)
|   |-- skill-stocktake/            # 对技能和命令进行审核,以提升质量(全新)
|   |-- liquid-glass-design/         # iOS 26 液体玻璃设计系统(全新)
|   |-- foundation-models-on-device/ # Apple 设备端 LLM 与 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/         # 用于快速执行的快捷命令
|   |-- tdd.md              # /tdd - 测试驱动开发
|   |-- plan.md             # /plan - 实施规划
|   |-- e2e.md              # /e2e - E2E 测试生成
|   |-- code-review.md      # /code-review - 质量评审
|   |-- build-fix.md        # /build-fix - 修复构建错误
|   |-- refactor-clean.md   # /refactor-clean - 删除死代码
|   |-- learn.md            # /learn - 在会话中途提取模式(长篇指南)
|   |-- learn-eval.md       # /learn-eval - 提取、评估并保存模式(全新)
|   |-- checkpoint.md       # /checkpoint - 保存验证状态(长篇指南)
|   |-- verify.md           # /verify - 运行验证循环(长篇指南)
|   |-- 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 - 通用多服务工作流(全新)
|   |-- orchestrate.md      # /orchestrate - 多代理协调
|   |-- sessions.md         # /sessions - 会话历史管理
|   |-- eval.md             # /eval - 按照标准进行评估
|   |-- test-coverage.md    # /test-coverage - 测试覆盖率分析
|   |-- update-docs.md      # /update-docs - 更新文档
|   |-- update-codemaps.md  # /update-codemaps - 更新代码映射
|   |-- python-review.md    # /python-review - Python 代码评审(全新)
|
|-- rules/            # 严格遵循各项指导原则(复制至 ~/.claude/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 # 交互式 PM 设置
|
|-- tests/            # 测试套件(全新)
|   |-- lib/                     # 库测试
|   |-- hooks/                   # 插件测试
|   |-- 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 等
|
|-- marketplace.json  # 自托管市场配置(用于 /plugin 市场添加)

生态系统工具

技能创建器

从您的代码库中生成 Claude Code 技能有以下两种方式:

方式 A:本地分析(内置功能)

使用 /skill-create 命令,无需依赖外部服务即可进行本地分析:

/skill-create                    # 分析当前代码库
/skill-create --instincts        # 同时生成用于持续学习的本能

此命令会本地分析您的 Git 历史记录,并生成 SKILL.md 文件。

方式 B:GitHub 应用(高级功能)

适用于高级功能需求(1 万次以上提交、自动 PR、团队共享):

安装 GitHub 应用 | ecc.tools

# 在任何问题上发表评论:
/skill-creator analyze

# 或在推送至默认分支时自动触发

两种方式均可生成:

  • SKILL.md 文件——为 Claude Code 准备就绪的技能
  • 本能集合——用于持续学习 v2
  • 模式提取——从您的提交历史中学习

AgentShield — 安全审计器

该工具由 Claude Code 黑客马拉松(Cerebral Valley x Anthropic,2026 年 2 月)打造。共进行了 1282 次测试,覆盖率达到 98%,并包含 102 条静态分析规则。

扫描您的 Claude Code 配置,查找漏洞、错误配置以及注入风险。

# 快速扫描(无需安装)
npx ecc-agentshield scan

# 自动修复安全问题
npx ecc-agentshield scan --fix

# 进行深度分析,同时启用三款 Opus 4.6 代理
npx ecc-agentshield scan --opus --stream

# 从零开始生成安全配置
npx ecc-agentshield init

扫描内容:CLAUDE.md、settings.json、MCP 配置、钩子、代理定义以及各类技能——包括秘密检测(14 种模式)、权限审计、钩子注入分析、MCP 服务器风险画像,以及代理配置审查。

--opus 标志 会以红队/蓝队/审计员的流程运行三款 Claude Opus 4.6 代理。攻击者可发现漏洞利用链,防御者评估防护措施,而审计员则将两者整合,形成优先级排序的风险评估报告。这不仅依靠模式匹配,更运用了对抗性推理。

输出格式:终端显示(按颜色分级 A-F)、JSON(CI 流水线)、Markdown、HTML。若发现严重问题,退出码为 2,用于构建门禁。 您可以在 Claude Code 中使用 /security-scan 命令运行此工具,或将其添加到 CI 流水线中,通过 GitHub Action 实现。

GitHub | npm

持续学习 v2

基于本能的学习系统会自动学习您的模式:

/instinct-status        # 显示已学习的本能,并附带置信度评分
/instinct-import <file> # 导入他人的本能
/instinct-export        # 导出您的本能,以便分享
/evolve                 # 将相关本能聚合成技能

如需完整文档,请参阅 skills/continuous-learning-v2/


需求

Claude Code CLI 版本

最低版本:v2.1.0 及以上

由于插件系统对钩子的处理方式发生了变化,本插件需要 Claude Code CLI v2.1.0+。

请检查您的版本:

claude --version

重要提示:钩子自动加载行为

警告:对于贡献者而言:请勿在 .claude-plugin/plugin.json 中添加 "hooks" 字段。这一限制由回归测试强制执行。

Claude Code v2.1+ 会根据约定,自动加载任何已安装插件中的 hooks/hooks.json。如果在 plugin.json 中显式声明该文件,则会引发重复检测错误:

检测到重复的钩子文件:./hooks/hooks.json 会被解析为已加载的文件

历史沿革:这一问题曾导致该仓库反复出现修复与回滚的循环(见 #29#52#103)。不同 Claude Code 版本之间该行为有所变化,一度造成混乱。如今,我们已引入回归测试,以防止此类问题再次发生。


安装

方法一:作为插件安装(推荐)

使用本仓库最简单的方式——将其作为 Claude Code 插件安装:

# 将此仓库添加至市场
/plugin marketplace add affaan-m/everything-claude-code

# 安装插件
/plugin install everything-claude-code@everything-claude-code

或者直接将插件添加至您的 ~/.claude/settings.json

{
  "extraKnownMarketplaces": {
    "everything-claude-code": {
      "source": {
        "source": "github",
        "repo": "affaan-m/everything-claude-code"
      }
    }
  },
  "enabledPlugins": {
    "everything-claude-code@everything-claude-code": true
  }
}

这样,您便可即时访问所有命令、代理、技能及钩子。

注意:Claude Code 插件系统不支持通过插件分发 规则(上游限制详见 code.claude.com/docs/en/plugins-reference)。您需要手动安装规则:

# 先克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git

方法 A:用户级规则(适用于所有项目)

mkdir -p ~/.claude/rules cp -r everything-claude-code/rules/common ~/.claude/rules/ cp -r everything-claude-code/rules/typescript ~/.claude/rules/ # 选择您的栈 cp -r everything-claude-code/rules/python ~/.claude/rules/ cp -r everything-claude-code/rules/golang ~/.claude/rules/ cp -r everything-claude-code/rules/php ~/.claude/rules/

方法 B:项目级规则(仅适用于当前项目)

mkdir -p .claude/rules cp -r everything-claude-code/rules/common .claude/rules/ cp -r everything-claude-code/rules/typescript .claude/rules/ # 选择您的栈 ```


方法二:手动安装

如果您更倾向于手动控制安装内容:

# 克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git

# 将代理复制至您的 Claude 配置
cp everything-claude-code/agents/*.md ~/.claude/agents/

# 复制规则目录(通用 + 语言特定)
mkdir -p ~/.claude/rules
cp -r everything-claude-code/rules/common ~/.claude/rules/
cp -r everything-claude-code/rules/typescript ~/.claude/rules/   # 选择您的栈
cp -r everything-claude-code/rules/python ~/.claude/rules/
cp -r everything-claude-code/rules/golang ~/.claude/rules/
cp -r everything-claude-code/rules/php ~/.claude/rules/

# 复制命令
cp everything-claude-code/commands/*.md ~/.claude/commands/

# 复制技能(核心 vs 独特技能)
# 推荐(新用户):仅复制核心/通用技能
cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/
cp -r everything-claude-code/skills/search-first ~/.claude/skills/

# 可选:仅在必要时添加特定于某个框架或领域的技能
# for s in django-patterns django-tdd laravel-patterns springboot-patterns; do
# cp -r everything-claude-code/skills/$s ~/.claude/skills/

# 已完成

settings.json 中添加钩子

hooks/hooks.json 中的钩子复制到您的 ~/.claude/settings.json

配置 MCP 服务器

将所需的 MCP 服务器从 mcp-configs/mcp-servers.json 复制到您的 ~/.claude.json

重要提示: 请将 YOUR_*_HERE 占位符替换为您的实际 API 密钥。


关键概念

代理

子代理负责执行范围有限的委托任务。示例:

---
name: 代码评审员
description: 评审代码,确保其质量、安全性和可维护性
tools: ["读取", "grep", "glob", "Bash"]
model: opus
---

您是一名资深代码评审员……

技能

技能是通过命令或代理调用的工作流定义:

# TDD 工作流

1. 首先定义接口
2. 编写失败的测试(红色)
3. 实现最小化代码(绿色)
4. 进行重构(改进)
5. 验证 80% 以上的覆盖率

钩子

钩子会在工具事件发生时触发。示例——提醒您注意 console.log:

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

规则

规则是始终遵循的指导方针,分别组织在 common/(语言无关)和语言特定的目录中:

rules/
  common/          # 通用原则(务必安装)
  typescript/      # TS/JS 特定模式与工具
  python/          # Python 特定模式与工具
  golang/          # Go 特定模式与工具
  swift/           # Swift 特定模式与工具
  php/             # PHP 特定模式与工具

有关安装及结构详情,请参阅 rules/README.md


我该使用哪个代理?

不知道从何开始?请参考这份快速指南:

我想... 使用此命令 使用的代理
计划新功能 /everything-claude-code:plan \"添加身份验证,采用 OAuth\" planner
设计系统架构 /everything-claude-code:plan + architect 代理 architect
先编写带测试的代码 /tdd tdd-guide
审核我刚刚编写的代码 /code-review code-reviewer
修复失败的构建 /build-fix build-error-resolver
运行端到端测试 /e2e e2e-runner
找出安全漏洞 /security-scan security-reviewer
移除冗余代码 /refactor-clean refactor-cleaner
更新文档 /update-docs doc-updater
审核 Go 代码 /go-review go-reviewer
审核 Python 代码 /python-review python-reviewer
审核 TypeScript/JavaScript 代码 (直接调用 typescript-reviewer) typescript-reviewer
审核数据库查询 (自动委托) database-reviewer

常用工作流

启动新功能:

/everything-claude-code:plan \"添加基于 OAuth 的用户身份验证\"
                                              → planner 创建实现蓝图
/tdd                                          → tdd-guide 强制执行“先写测试”的原则
/code-review                                  → code-reviewer 检查您的工作

修复错误:

/tdd                                          → tdd-guide:编写一个能够重现错误的失败测试
                                              → 实现修复方案,并验证测试通过
/code-review                                  → code-reviewer:捕捉回归问题

准备生产环境:

/security-scan                                → security-reviewer:进行 OWASP Top 10 审计
/e2e                                          → e2e-runner:执行关键的用户流程测试
/test-coverage                                → 验证 80% 以上的覆盖率

常见问题解答

如何查看已安装的代理和命令?
/plugin list everything-claude-code@everything-claude-code

此命令会显示插件中所有可用的代理、命令和技能。

我的钩子无法正常工作 / 看到“重复的钩子文件”错误

这是最常见的问题。请勿在 .claude-plugin/plugin.json 中添加 "hooks" 字段。 Claude Code v2.1+ 会自动从已安装的插件中加载 hooks/hooks.json。如果显式声明该字段,会导致重复检测错误。请参阅 #29#52#103

我可以将 ECC 与 Claude Code 结合使用,用于自定义 API 端点或模型网关吗?

可以。ECC 不会硬编码 Anthropic 托管的传输设置。它通过 Claude Code 的常规 CLI/插件界面在本地运行,因此适用于以下场景:

  • 由 Anthropic 托管的 Claude Code
  • 使用 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN 的官方 Claude Code 网关配置
  • 与 Anthropic API 相容的自定义端点,这些端点符合 Claude Code 所需的 API 格式

最小示例:

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

如果您的网关对模型名称进行了重映射,请在 Claude Code 中进行配置,而非在 ECC 中。一旦 claude CLI 已经正常运行,ECC 的钩子、技能、命令和规则便与模型提供商无关。

官方参考:

我的上下文窗口正在缩小 / Claude 的上下文空间不足

过多的 MCP 服务器会占用您的上下文空间。每个 MCP 工具的描述都会消耗您 20 万字节上下文中的令牌,可能导致上下文空间减少至仅约 7 万字节。

解决方法: 按项目禁用未使用的 MCP:

// 在项目的 .claude/settings.json 中
{
  "disabledMcpServers": ["supabase", "railway", "vercel"]
}

请保持启用的 MCP 少于 10 个,且活跃的工具数量少于 80 个。

我可以只使用部分组件(例如,仅使用代理吗?)

可以。您可以选择选项 2(手动安装),并仅复制您所需的部分:

# 仅使用代理
cp everything-claude-code/agents/*.md ~/.claude/agents/

仅限规则

mkdir -p ~/.claude/rules/ cp -r everything-claude-code/rules/common ~/.claude/rules/


每个组件都完全独立自主。
</details>

<details>
<summary><b>此功能是否适用于 Cursor / OpenCode / Codex / Antigravity?</b></summary>

是的。ECC 具备跨平台特性:
- **Cursor**:已预先翻译好的配置文件,位于 `.cursor/` 目录中。详情请参阅 [Cursor IDE 支持](#cursor-ide-support)。
- **OpenCode**:在 `.opencode/` 目录中提供完整的插件支持。详情请参阅 [OpenCode 支持](#-opencode-support)。
- **Codex**:对 macOS 应用和命令行工具均提供一流的支持,并具备适配器漂移保护机制以及 SessionStart 备份方案。详情请参阅 PR [#257](https://github.com/affaan-m/everything-claude-code/pull/257)。
- **Antigravity**:为工作流、技能以及扁平化规则提供了高度集成的设置方案,位于 `.agent/` 目录中。详情请参阅 [Antigravity 指南](docs/ANTIGRAVITY-GUIDE.md)。
- **Claude Code**:原生支持——这是主要的目标平台。
</details>

<details>
<summary><b>如何贡献新的技能或代理?</b></summary>

请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。简要说明如下:
1. 复制并 Fork 该仓库。
2. 在 `skills/your-skill-name/SKILL.md` 中创建您的技能(使用 YAML 前言字段)。
3. 或者在 `agents/your-agent.md` 中创建代理。
4. 提交 PR,清晰地描述其功能及适用场景。
</details>

---

## 运行测试

该插件包含一套全面的测试套件:

```bash
# 运行所有测试
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、NestJS)——Django、Spring Boot、Laravel 已经包含在内。
  • DevOps 代理(Kubernetes、Terraform、AWS、Docker)
  • 测试策略(不同框架、视觉回归测试)
  • 领域特定的知识(机器学习、数据工程、移动开发)

Cursor IDE 支持

ECC 提供了 完整的 Cursor IDE 支持,涵盖钩子、规则、代理、技能、命令以及 MCP 配置,这些配置均针对 Cursor 的原生格式进行了优化与适配。

快速入门(Cursor)

# 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

包含内容

组件 数量 详细信息
钩子事件 15 sessionStart、beforeShellExecution、afterFileEdit、beforeMCPExecution、beforeSubmitPrompt,以及另外 10 个事件
钩子脚本 16 通过共享适配器,将脚本委托至 scripts/hooks/ 目录中的精简 Node.js 脚本
规则 34 9 个通用规则(始终应用)+ 25 个语言特定规则(TypeScript、Python、Go、Swift、PHP)
代理 共享 通过根目录下的 AGENTS.md 文件实现(由 Cursor 原生读取)
技能 共享 + 打包 通过根目录下的 AGENTS.md 文件,以及 .cursor/skills/ 目录,用于翻译补充内容
命令 共享 若已安装,则位于 .cursor/commands/ 目录中
MCP 配置 共享 若已安装,则位于 .cursor/mcp.json 目录中

钩子架构(DRY 适配器模式)

Cursor 的钩子事件数量多于 Claude Code(20 个 vs 8 个)。.cursor/hooks/adapter.js 模块会将 Cursor 的 stdin JSON 转换为 Claude Code 的格式,从而允许复用现有的 scripts/hooks/*.js 脚本,避免重复编写。

Cursor stdin JSON → adapter.js → 转换 → scripts/hooks/*.js
                                              (与 Claude Code 共享)

关键钩子:

  • beforeShellExecution — 阻止在 tmux 外部运行开发服务器(退出 2),并执行 Git 推送审查
  • afterFileEdit — 自动格式化、TypeScript 检查以及控制台警告日志记录
  • beforeSubmitPrompt — 在提示中检测密钥相关参数(如 sk-、ghp_、AKIA 等模式)
  • beforeTabFileRead — 阻止 Tab 读取 .env、.key、.pem 文件(退出 2)
  • beforeMCPExecution / afterMCPExecution — 记录 MCP 审计日志

规则格式

Cursor 规则采用 YAML 前言字段,包含 descriptionglobs 以及 alwaysApply

---
description: "TypeScript 编码风格,扩展通用规则"
globs: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"]
alwaysApply: false
---

Codex macOS 应用 + CLI 支持

ECC 提供了 一流的 Codex 支持,既适用于 macOS 应用,也适用于命令行工具。该支持包含参考配置、Codex 特定的 AGENTS.md 补充内容,以及共享技能。

快速入门(Codex 应用 + CLI)

# 在仓库中运行 Codex CLI — AGENTS.md 和 .codex/ 会被自动检测到
codex

# 自动化设置:将 ECC 资源(AGENTS.md、技能、MCP 服务器)同步至 ~/.codex
npm install && bash scripts/sync-ecc-to-codex.sh
# 或:pnpm install && bash scripts/sync-ecc-to-codex.sh
# 或:yarn install && bash scripts/sync-ecc-to-codex.sh
# 或:bun install && bash scripts/sync-ecc-to-codex.sh

# 或手动复制参考配置至您的主目录
cp .codex/config.toml ~/.codex/config.toml

同步脚本会以“只增不删”的策略,安全地将 ECC MCP 服务器合并至您现有的 ~/.codex/config.toml 中——绝不会删除或修改您已有的服务器。运行时可使用 --dry-run 预览更改,或使用 --update-mcp 强制刷新 ECC 服务器至最新推荐的配置。

对于 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 有意未固定 modelmodel_provider,因此 Codex 会使用其自身的当前默认值,除非您另行覆盖。
  • 可选:将 .codex/config.toml 复制至 ~/.codex/config.toml,以实现全局默认配置;若非特别需要,建议将多代理角色文件保留在项目本地,除非您也复制了 .codex/agents/

包含内容

组件 数量 详细信息
配置 1 .codex/config.toml — 顶级审批/沙盒/网页搜索、MCP 服务器、通知、个人资料
AGENTS.md 2 根目录(通用)+ .codex/AGENTS.md(Codex 特定补充内容)
技能 16 .agents/skills/ — SKILL.md + 各项技能对应的 agents/openai.yaml 文件
MCP 服务器 6 Supabase、Playwright、Context7、GitHub、Memory、Sequential Thinking(通过“只增不删”同步机制自动合并)
个人资料 2 strict(只读沙盒)和 yolo(完全自动审批)
代理角色 3 .codex/agents/ — 探索者、审核员、文档研究员

技能

.agents/skills/ 目录下定义的技能将由 Codex 自动加载:

技能 说明
tdd-workflow 采用测试驱动开发方法,覆盖率达到 80% 以上
security-review 全面的安全检查清单
coding-standards 通用的编码规范
frontend-patterns React/Next.js 的各类模式与设计模式
frontend-slides HTML 演示文稿、PPTX 转换、视觉风格探索
article-writing 从笔记和语音参考中撰写长篇内容
content-engine 平台原生的社交内容及内容再利用
market-research 基于来源数据的市场与竞品调研
investor-materials 投资者推介材料,包括演示文稿、备忘录、模型及简报
investor-outreach 个性化的投资者拓展、跟进沟通以及简介文案
backend-patterns API 设计、数据库设计、缓存机制
e2e-testing 使用 Playwright 进行 E2E 测试
eval-harness 以评估驱动的开发方式
strategic-compact 上下文管理
api-design REST API 设计模式
verification-loop 构建、测试、代码检查、类型检查、安全检测

关键限制

Codex 目前尚未实现 Claude 风格的钩子执行对等性。在 ECC 中,权限控制主要基于指令,通过 AGENTS.md 文件进行配置,同时可选择性地覆盖 model_instructions_file 文件,还可通过沙盒或审批设置来进一步调整。

多代理支持

当前的 Codex 构建支持实验性的多代理工作流。

  • .codex/config.toml 中启用 features.multi_agent = true
  • [agents.<name>] 下定义角色
  • 将每个角色指向 .codex/agents/ 目录下的某个文件
  • 在 CLI 中使用 /agent 命令来查看或引导子代理的工作

ECC 提供了三组示例角色配置:

角色 用途
explorer 在编辑前,仅用于读取代码库中的证据信息
reviewer 对代码的正确性、安全性及缺失测试进行审核
docs_researcher 在发布或文档变更前,对文档及 API 进行验证

OpenCode 支持

ECC 提供了全面的 OpenCode 支持,涵盖插件与钩子功能。

快速入门

# 安装 OpenCode
npm install -g opencode

# 在仓库根目录运行
opencode

配置会自动从 .opencode/opencode.json 中被检测到。

功能对等性

功能 Claude 代码 OpenCode 状态
代理 PASS:30 个代理 PASS:12 个代理 Claude 代码更具优势
命令 PASS:60 条命令 PASS:31 条命令 Claude 代码更具优势
技能 PASS:136 项技能 PASS:37 项技能 Claude 代码更具优势
钩子 PASS:8 种事件类型 PASS:11 个事件 OpenCode 的功能更多!
规则 PASS:29 条规则 PASS:13 条指令 Claude 代码更具优势
MCP 服务器 PASS:14 台服务器 FULL 完全对等
自定义工具 PASS:通过钩子实现 PASS:6 个原生工具 OpenCode 更加出色

通过插件支持钩子

OpenCode 的插件系统比 Claude 代码更加完善,拥有超过 20 种事件类型:

Claude 代码钩子 OpenCode 插件事件
PreToolUse tool.execute.before
PostToolUse tool.execute.after
Stop session.idle
SessionStart session.created
SessionEnd session.deleted

额外的 OpenCode 事件file.editedfile.watcher.updatedmessage.updatedlsp.client.diagnosticstui.toast.show 等。

可用命令(31+)

命令 说明
/plan 创建实施计划
/tdd 强制执行 TDD 工作流
/code-review 审核代码变更
/build-fix 修复构建错误
/e2e 生成 E2E 测试
/refactor-clean 移除冗余代码
/orchestrate 多代理工作流
/learn 从会话中提取模式
/checkpoint 保存验证状态
/verify 运行验证循环
/eval 根据标准进行评估
/update-docs 更新文档
/update-codemaps 更新代码映射
/test-coverage 分析代码覆盖率
/go-review 进行 Go 代码评审
/go-test 使用 Go 进行 TDD 工作流
/go-build 修复 Go 构建错误
/python-review Python 代码评审(PEP 8、类型提示、安全性)
/multi-plan 多模型协作规划
/multi-execute 多模型协作执行
/multi-backend 以后端为重点的多模型工作流
/multi-frontend 以前端为重点的多模型工作流
/multi-workflow 全面的多模型开发工作流
/pm2 自动生成 PM2 服务命令
/sessions 管理会话历史记录
/skill-create 从 Git 中生成技能
/instinct-status 查看已学习的直觉
/instinct-import 导入直觉
/instinct-export 导出直觉
/evolve 将直觉集群化为技能
/promote 将项目直觉提升至全局范围
/projects 列出已知的项目及直觉统计
/prune 删除过期且待处理的直觉(30 天有效期)
/learn-eval 在保存前提取并评估模式
/setup-pm 配置包管理器
/harness-audit 审核Harness 的可靠性、评估准备情况及风险态势
/loop-start 启动受控的代理循环执行模式
/loop-status 检查活动循环的状态及各检查点
/quality-gate 对路径或整个仓库运行质量门禁检查
/model-route 根据复杂度与预算,将任务路由至相应模型

插件安装

选项 1:直接使用

cd everything-claude-code
opencode

选项 2:作为 npm 包安装

npm install ecc-universal

然后在 opencode.json 中添加如下配置:

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

该 npm 插件条目可启用 ECC 发布的 OpenCode 插件模块(钩子/事件及插件工具)。 不过,它并不会自动将 ECC 的完整命令/代理/指令目录添加到您的项目配置中。

如需完成完整的 ECC OpenCode 设置,您可以:

  • 在此仓库内部运行 OpenCode,或
  • 将捆绑好的 .opencode/ 配置资产复制到您的项目中,并在 opencode.json 中配置好 instructionsagentcommand 项。

文档

  • 迁移指南.opencode/MIGRATION.md
  • OpenCode 插件 README.opencode/README.md
  • 整合规则.opencode/instructions/INSTRUCTIONS.md
  • LLM 文档llms.txt(包含 LLM 的完整 OpenCode 文档)

交叉工具功能的平等性

ECC 是首个能够最大化利用各类主流 AI 编码工具的插件。以下是各工具之间的对比情况:

功能 Claude Code Cursor IDE Codex CLI OpenCode
代理 21 共享(AGENTS.md) 共享(AGENTS.md) 12
命令 52 共享 基于指令的命令 31
技能 102 共享 10(原生格式) 37
钩子事件 8 种 15 种 目前尚无 11 种
钩子脚本 20 多个脚本 16 个脚本(DRY 适配器) 插件钩子
规则 34 条(通用 + 语言相关) 34 条(YAML 前置信息) 基于指令的规则 13 条指令
自定义工具 通过钩子 通过钩子 6 个原生工具
MCP 服务器 14 共享(mcp.json) 7 个(通过 TOML 解析器自动合并) 完全支持
配置格式 settings.json hooks.json + 规则/ config.toml opencode.json
上下文文件 CLAUDE.md + AGENTS.md AGENTS.md AGENTS.md AGENTS.md
密钥检测 基于钩子 在提交提示前执行钩子 基于沙盒环境 基于钩子
自动格式化 PostToolUse 钩子 在文件编辑完成后执行钩子 file.edited 钩子
版本 插件 插件 参考配置 1.9.0

关键架构决策:

  • 根目录下的 AGENTS.md 是通用的跨工具文件(所有 4 款工具均可读取)。
  • DRY 适配器模式 让 Cursor 能够重复使用 Claude Code 的钩子脚本,而无需重复编写。
  • 技能格式(SKILL.md,附带 YAML 前置信息)可在 Claude Code、Codex 和 OpenCode 之间无缝切换。
  • Codex 缺乏钩子的功能,可通过 AGENTS.md、可选的 model_instructions_file 替代方案,以及沙盒权限来弥补。

背景

自实验版推出以来,我一直在使用 Claude Code。2025 年 9 月,我与 @DRodriguezFX 共同赢得了 Anthropic x Forum Ventures 的黑客松大奖——我们完全基于 Claude Code 构建了 zenith.chat

这些配置已在多个生产应用中经过了严格考验。


令牌优化

如果你没有合理管理令牌消耗,使用 Claude Code 可能会带来高昂的成本。这些设置能够在不牺牲质量的前提下大幅降低成本。

推荐设置

~/.claude/settings.json 中添加以下内容:

{
  "model": "sonnet",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"
  }
}
设置 默认值 推荐值 影响
model opus sonnet 成本可降低约 60%;可处理 80% 以上的编码任务
MAX_THINKING_TOKENS 31,999 10,000 每次请求的隐式思考成本可降低约 70%
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 95 50 提前进行压缩——在长时间会话中能获得更高质量的结果

仅在需要深度架构推理时才切换至 Opus:

/model opus

日常工作流命令

命令 使用时机
/model sonnet 适用于大多数任务的默认选择
/model opus 适用于复杂架构、调试以及深度推理的任务
/clear 在完成无关任务之间使用(自由重置,即时清空)
/compact 在逻辑任务断点处执行(已完成研究、达成阶段性目标)
/cost 在会话期间监控令牌消耗情况

策略性压缩

此插件中包含的“策略性压缩”技能建议在逻辑断点处执行 /compact,而非依赖于在 95% 上下文时自动压缩。完整决策指南请参阅 skills/strategic-compact/SKILL.md

何时进行压缩:

  • 在完成研究或探索后,准备实施之前
  • 在达成阶段性目标后,开始下一阶段之前
  • 在调试之后,继续推进功能开发之前
  • 在尝试新方案之前,若已失败过一次

何时不进行压缩:

  • 在实现过程中(你可能会丢失变量名、文件路径、部分状态)

上下文窗口管理

重要提醒: 切勿一次性启用所有 MCP。每种 MCP 工具的描述都会占用你 20 万字的上下文窗口,可能导致实际可用上下文减少至约 7 万字。

  • 每个项目中最多启用 10 个 MCP
  • 每个项目中最多保持 80 个工具处于活跃状态
  • 在项目配置中使用 disabledMcpServers,以禁用未使用的工具。

代理团队成本警告

代理团队会生成多个上下文窗口。每个代理成员都会独立消耗令牌。仅在并行化能带来显著价值的任务(如多模块协作、并行评审)中使用代理团队。对于简单的顺序任务,子代理的令牌消耗更为高效。


注意事项:重要提示

令牌优化

如果遇到每日限制?请参阅 令牌优化指南,了解推荐设置和工作流技巧。

快速优化方案:

// ~/.claude/settings.json
{
  "model": "sonnet",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
  }
}

在无关任务之间使用 /clear,在逻辑断点处执行 /compact,并通过 /cost 监控令牌消耗情况。

自定义配置

这些配置已为我的工作流量身定制。你应该:

  1. 从最契合自身需求的配置入手
  2. 根据自己的技术栈进行调整
  3. 删除那些不再使用的功能
  4. 添加适合自己的自定义模式

赞助商

本项目免费且开源。赞助商有助于持续维护并推动项目发展。

成为赞助商 | 赞助商等级 | 赞助计划


星星历史

星星历史图表


链接


许可证

MIT — 允许自由使用、根据需要进行修改、并在有能力的情况下回馈贡献。


如果这个仓库对你有帮助,请给它点个星!阅读这两份指南,打造属于你的精彩作品。

版本历史

v1.9.02026/03/21
v1.8.02026/03/05
v1.7.02026/02/27
v1.6.02026/02/24
v1.5.02026/02/11
v1.4.12026/02/06
v1.4.02026/02/06
v1.3.02026/02/05
v1.2.02026/02/01
v1.1.02026/01/26
v1.0.02026/01/22

常见问题

相似工具推荐

stable-diffusion-webui

stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面,旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点,将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。 无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师,还是想要深入探索模型潜力的开发者与研究人员,都能从中获益。其核心亮点在于极高的功能丰富度:不仅支持文生图、图生图、局部重绘(Inpainting)和外绘(Outpainting)等基础模式,还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外,它内置了 GFPGAN 和 CodeFormer 等人脸修复工具,支持多种神经网络放大算法,并允许用户通过插件系统无限扩展能力。即使是显存有限的设备,stable-diffusion-webui 也提供了相应的优化选项,让高质量的 AI 艺术创作变得触手可及。

162.1k|★★★☆☆|今天
开发框架图像Agent

ComfyUI

ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎,专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式,采用直观的节点式流程图界面,让用户通过连接不同的功能模块即可构建个性化的生成管线。 这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景,也能自由组合模型、调整参数并实时预览效果,轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性,不仅支持 Windows、macOS 和 Linux 全平台,还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构,并率先支持 SDXL、Flux、SD3 等前沿模型。 无论是希望深入探索算法潜力的研究人员和开发者,还是追求极致创作自由度的设计师与资深 AI 绘画爱好者,ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能,使其成为当前最灵活、生态最丰富的开源扩散模型工具之一,帮助用户将创意高效转化为现实。

107.7k|★★☆☆☆|2天前
开发框架图像Agent

NextChat

NextChat 是一款轻量且极速的 AI 助手,旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性,以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发,NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。 这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言,它也提供了便捷的自托管方案,支持一键部署到 Vercel 或 Zeabur 等平台。 NextChat 的核心亮点在于其广泛的模型兼容性,原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型,让用户在一个界面即可自由切换不同 AI 能力。此外,它还率先支持 MCP(Model Context Protocol)协议,增强了上下文处理能力。针对企业用户,NextChat 提供专业版解决方案,具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能,满足公司对数据隐私和个性化管理的高标准要求。

87.6k|★★☆☆☆|今天
开发框架语言模型

ML-For-Beginners

ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程,旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周,包含 26 节精炼课程和 52 道配套测验,内容涵盖从基础概念到实际应用的完整流程,有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。 无论是希望转型的开发者、需要补充算法背景的研究人员,还是对人工智能充满好奇的普通爱好者,都能从中受益。课程不仅提供了清晰的理论讲解,还强调动手实践,让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持,通过自动化机制提供了包括简体中文在内的 50 多种语言版本,极大地降低了全球不同背景用户的学习门槛。此外,项目采用开源协作模式,社区活跃且内容持续更新,确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路,ML-For-Beginners 将是理想的起点。

85k|★★☆☆☆|今天
图像数据工具视频

ragflow

RAGFlow 是一款领先的开源检索增强生成(RAG)引擎,旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体(Agent)能力相结合,不仅支持从各类文档中高效提取知识,还能让模型基于这些知识进行逻辑推理和任务执行。 在大模型应用中,幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构(如表格、图表及混合排版),显著提升了信息检索的准确度,从而有效减少模型“胡编乱造”的现象,确保回答既有据可依又具备时效性。其内置的智能体机制更进一步,使系统不仅能回答问题,还能自主规划步骤解决复杂问题。 这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统,还是致力于探索大模型在垂直领域落地的创新者,都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口,既降低了非算法背景用户的上手门槛,也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目,它正成为连接通用大模型与行业专有知识之间的重要桥梁。

77.1k|★★★☆☆|昨天
Agent图像开发框架

PaddleOCR

PaddleOCR 是一款基于百度飞桨框架开发的高性能开源光学字符识别工具包。它的核心能力是将图片、PDF 等文档中的文字提取出来,转换成计算机可读取的结构化数据,让机器真正“看懂”图文内容。 面对海量纸质或电子文档,PaddleOCR 解决了人工录入效率低、数字化成本高的问题。尤其在人工智能领域,它扮演着连接图像与大型语言模型(LLM)的桥梁角色,能将视觉信息直接转化为文本输入,助力智能问答、文档分析等应用场景落地。 PaddleOCR 适合开发者、算法研究人员以及有文档自动化需求的普通用户。其技术优势十分明显:不仅支持全球 100 多种语言的识别,还能在 Windows、Linux、macOS 等多个系统上运行,并灵活适配 CPU、GPU、NPU 等各类硬件。作为一个轻量级且社区活跃的开源项目,PaddleOCR 既能满足快速集成的需求,也能支撑前沿的视觉语言研究,是处理文字识别任务的理想选择。

74.9k|★★★☆☆|今天
语言模型图像开发框架