everything-claude-code
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
未说明
未说明

快速开始
**语言:**英语 | 葡萄牙语(巴西) | 简体中文 | 繁体中文 | 日语 | 韩语 | 土耳其语
一切 Claude Code
超过 5 万个 Star | 6000 多个 Fork | 30 位贡献者 | 支持 7 种语言 | Anthropic 杯黑客马拉松冠军
面向 AI 代理的性能优化系统,由 Anthropic 杯黑客马拉松冠军打造。
不只是配置!一套完整的系统:技能、直觉、内存优化、持续学习、安全扫描,以及以研究为导向的开发流程。经过 10 多个月的密集日常使用,我们打造出的生产级代理、挂钩、命令、规则,以及 MCP 配置,最终实现了真实产品的落地。
适用于 Claude Code、Codex、Cowork 等各类 AI 代理工具。
指南
本仓库仅包含原始代码。指南将为您详细讲解所有内容。
|
|
|
| 简写指南 设置、基础概念、哲学理念。请先阅读此部分。 |
长篇指南 令牌优化、内存持久化、评估机制、并行化。 |
安全指南 攻击向量、沙盒隔离、 sanitization、CVE 编号、AgentShield。 |
| 主题 | 您将学到的内容 |
|---|---|
| 令牌优化 | 模型选择、系统提示精简、后台进程 |
| 内存持久化 | 自动保存并加载会话上下文的挂钩 |
| 持续学习 | 自动从会话中提取模式,将其转化为可重用的技能 |
| 校验循环 | 通过检查点与连续评估相结合,采用不同的评分类型,实现“通过@k”指标 |
| 并行化 | Git 工作树、级联方法、何时需要扩展实例数量 |
| 子代理编排 | 上下文问题、迭代式检索模式 |
新功能
v1.9.0 — 选择性安装与语言扩展(2026年3月)
- 选择性安装架构 — 采用 Manifest 驱动的安装流程,通过
install-plan.js和install-apply.js实现针对性组件的安装。状态存储会跟踪已安装的内容,并支持增量更新。 - 新增 6 个代理 —
typescript-reviewer、pytorch-build-resolver、java-build-resolver、java-reviewer、kotlin-reviewer、kotlin-build-resolver将语言覆盖范围拓展至 10 种语言。 - 新增技能 — 为深度学习工作流提供
pytorch-patterns,为 API 参考研究提供documentation-lookup,为现代 JS 工具链提供bun-runtime和nextjs-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|strict和ECC_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/common 或 rules/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),其优先级如下:
- 环境变量:
CLAUDE_PACKAGE_MANAGER - 项目配置:
.claude/package-manager.json - package.json:
packageManager字段 - 锁定文件:从
package-lock.json、yarn.lock、pnpm-lock.yaml或bun.lock中进行检测 - 全局配置:
~/.claude/package-manager.json - 回退选项:首选可用的包管理器
要设置您偏好的包管理器:
# 通过环境变量设置
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、团队共享):
# 在任何问题上发表评论:
/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 实现。
持续学习 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_URL和ANTHROPIC_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 前言字段,包含 description、globs 以及 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有意未固定model或model_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.edited、file.watcher.updated、message.updated、lsp.client.diagnostics、tui.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中配置好instructions、agent和command项。
文档
- 迁移指南:
.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 监控令牌消耗情况。
自定义配置
这些配置已为我的工作流量身定制。你应该:
- 从最契合自身需求的配置入手
- 根据自己的技术栈进行调整
- 删除那些不再使用的功能
- 添加适合自己的自定义模式
赞助商
本项目免费且开源。赞助商有助于持续维护并推动项目发展。
星星历史
链接
- 简要指南(从这里开始): 《Everything Claude Code 简要指南》
- 详细指南(进阶篇): 《Everything Claude Code 详细指南》
- 安全指南: 安全指南 | 讨论区
- 关注我们: @affaanmustafa
许可证
MIT — 允许自由使用、根据需要进行修改、并在有能力的情况下回馈贡献。
如果这个仓库对你有帮助,请给它点个星!阅读这两份指南,打造属于你的精彩作品。
版本历史
v1.9.02026/03/21v1.8.02026/03/05v1.7.02026/02/27v1.6.02026/02/24v1.5.02026/02/11v1.4.12026/02/06v1.4.02026/02/06v1.3.02026/02/05v1.2.02026/02/01v1.1.02026/01/26v1.0.02026/01/22常见问题
相似工具推荐
stable-diffusion-webui
stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面,旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点,将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。 无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师,还是想要深入探索模型潜力的开发者与研究人员,都能从中获益。其核心亮点在于极高的功能丰富度:不仅支持文生图、图生图、局部重绘(Inpainting)和外绘(Outpainting)等基础模式,还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外,它内置了 GFPGAN 和 CodeFormer 等人脸修复工具,支持多种神经网络放大算法,并允许用户通过插件系统无限扩展能力。即使是显存有限的设备,stable-diffusion-webui 也提供了相应的优化选项,让高质量的 AI 艺术创作变得触手可及。
ComfyUI
ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎,专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式,采用直观的节点式流程图界面,让用户通过连接不同的功能模块即可构建个性化的生成管线。 这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景,也能自由组合模型、调整参数并实时预览效果,轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性,不仅支持 Windows、macOS 和 Linux 全平台,还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构,并率先支持 SDXL、Flux、SD3 等前沿模型。 无论是希望深入探索算法潜力的研究人员和开发者,还是追求极致创作自由度的设计师与资深 AI 绘画爱好者,ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能,使其成为当前最灵活、生态最丰富的开源扩散模型工具之一,帮助用户将创意高效转化为现实。
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 提供专业版解决方案,具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能,满足公司对数据隐私和个性化管理的高标准要求。
ML-For-Beginners
ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程,旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周,包含 26 节精炼课程和 52 道配套测验,内容涵盖从基础概念到实际应用的完整流程,有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。 无论是希望转型的开发者、需要补充算法背景的研究人员,还是对人工智能充满好奇的普通爱好者,都能从中受益。课程不仅提供了清晰的理论讲解,还强调动手实践,让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持,通过自动化机制提供了包括简体中文在内的 50 多种语言版本,极大地降低了全球不同背景用户的学习门槛。此外,项目采用开源协作模式,社区活跃且内容持续更新,确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路,ML-For-Beginners 将是理想的起点。
ragflow
RAGFlow 是一款领先的开源检索增强生成(RAG)引擎,旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体(Agent)能力相结合,不仅支持从各类文档中高效提取知识,还能让模型基于这些知识进行逻辑推理和任务执行。 在大模型应用中,幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构(如表格、图表及混合排版),显著提升了信息检索的准确度,从而有效减少模型“胡编乱造”的现象,确保回答既有据可依又具备时效性。其内置的智能体机制更进一步,使系统不仅能回答问题,还能自主规划步骤解决复杂问题。 这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统,还是致力于探索大模型在垂直领域落地的创新者,都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口,既降低了非算法背景用户的上手门槛,也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目,它正成为连接通用大模型与行业专有知识之间的重要桥梁。
PaddleOCR
PaddleOCR 是一款基于百度飞桨框架开发的高性能开源光学字符识别工具包。它的核心能力是将图片、PDF 等文档中的文字提取出来,转换成计算机可读取的结构化数据,让机器真正“看懂”图文内容。 面对海量纸质或电子文档,PaddleOCR 解决了人工录入效率低、数字化成本高的问题。尤其在人工智能领域,它扮演着连接图像与大型语言模型(LLM)的桥梁角色,能将视觉信息直接转化为文本输入,助力智能问答、文档分析等应用场景落地。 PaddleOCR 适合开发者、算法研究人员以及有文档自动化需求的普通用户。其技术优势十分明显:不仅支持全球 100 多种语言的识别,还能在 Windows、Linux、macOS 等多个系统上运行,并灵活适配 CPU、GPU、NPU 等各类硬件。作为一个轻量级且社区活跃的开源项目,PaddleOCR 既能满足快速集成的需求,也能支撑前沿的视觉语言研究,是处理文字识别任务的理想选择。
