50K+ stars | 6K+ forks | 30 contributors | 6 种语言支持 | Anthropic 黑客松获胜者
为 AI 智能体(Agent)框架打造的性能优化系统。源自 Anthropic 黑客松获胜作品。
这不仅仅是配置文件。它是一个完整的系统:包含技能(Skills)、本能(Instincts)、内存优化、持续学习、安全扫描以及研究优先的开发模式。这些生产级的智能体(Agents)、钩子(Hooks)、命令(Commands)、规则(Rules)以及 MCP 配置,是在构建真实产品的 10 个多月高强度日常使用中演化而来的。
适用于 Claude Code, Codex, Cowork 以及其他 AI 智能体框架。
本仓库仅包含原始代码。指南部分解释了所有细节。
|
|
| 简明指南 (Shorthand Guide) 设置、基础知识、哲学。请先阅读此篇。 |
详细指南 (Longform Guide) 令牌(Token)优化、内存持久化、评测(Evals)、并行化。 |
| 主题 | 你将学到什么 |
|---|---|
| 令牌(Token)优化 | 模型选择、系统提示词瘦身、后台进程 |
| 内存持久化 | 跨会话自动保存/加载上下文的钩子 (Hooks) |
| 持续学习 | 自动将会话模式提取为可重用的技能 (Skills) |
| 验证循环 | 检查点 vs 持续评测、评分器类型、pass@k 指标 |
| 并行化 | Git worktrees、级联方法、何时扩展实例 |
| 子智能体编排 | 上下文问题、迭代检索模式 |
- Codex 应用 + CLI 支持 — 直接支持基于
AGENTS.md的 Codex,安装器目标定位及 Codex 文档 frontend-slides技能 (Skill) — 无依赖的 HTML 演示文稿生成器,包含 PPTX 转换指南和严格的视口自适应规则- 5 个新型通用业务/内容技能 —
article-writing(文章写作)、content-engine(内容引擎)、market-research(市场研究)、investor-materials(融资材料)、investor-outreach(投资者对接) - 更广的工具覆盖 — 强化了 Cursor、Codex 和 OpenCode 的支持,使同一仓库能在所有主流框架中无缝运行
- 992 项内部测试 — 扩展了插件、钩子 (Hooks)、技能 (Skills) 及打包的验证与回归覆盖率
- Codex CLI 支持 — 新增
/codex-setup命令,生成用于 OpenAI Codex CLI 兼容的codex.md - 7 个新技能 —
search-first、swift-actor-persistence、swift-protocol-di-testing、regex-vs-llm-structured-text、content-hash-cache-pattern、cost-aware-llm-pipeline、skill-stocktake - AgentShield 集成 —
/security-scan技能可直接从 Claude Code 运行 AgentShield;包含 1282 项测试,102 条规则 - GitHub 市场 (Marketplace) — ECC Tools GitHub 应用已在 github.com/marketplace/ecc-tools 上线,提供免费/专业/企业版
- 合并 30+ 社区 PR — 来自 6 种语言的 30 位贡献者的贡献
- 978 项内部测试 — 扩展了涵盖智能体、技能、命令、钩子和规则的验证套件
- 修复本能 (Instinct) 导入内容丢失问题 —
parse_instinct_file()在执行/instinct-import时会静默丢弃 Frontmatter 之后的所有内容(Action、Evidence、Examples 部分)。由社区贡献者 @ericcai0814 修复 (#148, #161)
- 交互式安装向导 — 新增
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 模板
- 全面集成 OpenCode — 12 个智能体、24 个命令、16 个技能,通过 OpenCode 的插件系统(20+ 事件类型)支持钩子
- 3 个原生自定义工具 — run-tests(运行测试)、check-coverage(检查覆盖率)、security-audit(安全审计)
- LLM 文档 — 提供
llms.txt以获取全面的 OpenCode 文档
- Python/Django 支持 — Django 模式、安全、TDD 和验证技能
- Java Spring Boot 技能 — Spring Boot 的模式、安全、TDD 和验证
- 会话管理 —
/sessions命令用于查看会话历史 - 持续学习 v2 — 基于本能的带置信评分、导入/导出、进化的学习系统
在 Releases 中查看完整变更日志。
在 2 分钟内启动并运行:
# 添加市场
/plugin marketplace add affaan-m/everything-claude-code
# 安装插件
/plugin install everything-claude-code@everything-claude-code
⚠️ 重要提示: Claude Code 插件无法自动分发rules(规则)。请手动安装:
# 首先克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
# 推荐:使用安装脚本(安全处理通用规则和语言规则)
./install.sh typescript # 或 python 或 golang
# 你可以传递多种语言:
# ./install.sh typescript python golang
# 或者针对 cursor 安装:
# ./install.sh --target cursor typescript有关手动安装的说明,请参阅 rules/ 文件夹中的 README。
# 尝试一个命令(插件安装使用命名空间形式)
/everything-claude-code:plan "添加用户身份验证"
# 手动安装(选项 2)使用简短形式:
# /plan "添加用户身份验证"
# 查看可用命令
/plugin list everything-claude-code@everything-claude-code✨ 完成! 你现在可以访问 13 个智能体(Agents)、56 个技能(Skills)和 32 个命令(Commands)。
该插件现已全面支持 Windows, macOS 和 Linux。所有钩子和脚本已使用 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.lockb 检测
- 全局配置:
~/.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 命令。
本仓库是一个 Claude Code 插件 —— 你可以直接安装,也可以手动复制组件。
everything-claude-code/
|-- .claude-plugin/ # 插件与市场清单文件
| |-- plugin.json # 插件元数据与组件路径
| |-- marketplace.json # 用于 /plugin marketplace add 的市场目录
|
|-- agents/ # 专门用于任务委派的子智能体 (Subagents)
| |-- planner.md # 功能实现规划
| |-- architect.md # 系统设计决策
| |-- tdd-guide.md # 测试驱动开发 (TDD)
| |-- code-reviewer.md # 质量与安全审查
| |-- security-reviewer.md # 漏洞分析
| |-- build-error-resolver.md # 构建错误修复
| |-- e2e-runner.md # Playwright E2E 测试
| |-- refactor-cleaner.md # 废弃代码清理
| |-- doc-updater.md # 文档同步更新
| |-- go-reviewer.md # Go 代码审查
| |-- go-build-resolver.md # Go 构建错误修复
| |-- python-reviewer.md # Python 代码审查 (新增)
| |-- database-reviewer.md # 数据库/Supabase 审查 (新增)
|
|-- 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/ # 商业计划书、一页纸介绍、备忘录和财务模型 (新增)
| |-- investor-outreach/ # 个性化融资对接与后续跟进 (新增)
| |-- continuous-learning/ # 从会话中自动提取模式 (详细指南)
| |-- continuous-learning-v2/ # 基于本能的带置信评分的学习系统
| |-- iterative-retrieval/ # 为子智能体提供的渐进式上下文精炼
| |-- strategic-compact/ # 手动压缩建议 (详细指南)
| |-- tdd-workflow/ # TDD 方法论
| |-- security-review/ # 安全自查表
| |-- eval-harness/ # 验证循环评测 (详细指南)
| |-- verification-loop/ # 持续验证 (详细指南)
| |-- golang-patterns/ # Go 惯用法与最佳实践
| |-- golang-testing/ # Go 测试模式、TDD、基准测试
| |-- cpp-coding-standards/ # 源自 C++ Core Guidelines 的 C++ 编码标准 (新增)
| |-- cpp-testing/ # 使用 GoogleTest, CMake/CTest 的 C++ 测试 (新增)
| |-- django-patterns/ # Django 模式、模型、视图 (新增)
| |-- django-security/ # Django 安全最佳实践 (新增)
| |-- django-tdd/ # Django TDD 工作流 (新增)
| |-- django-verification/ # Django 验证循环 (新增)
| |-- 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 模式与页面对象模型 (POM) (新增)
| |-- content-hash-cache-pattern/ # 用于文件处理的 SHA-256 内容哈希缓存 (新增)
| |-- cost-aware-llm-pipeline/ # LLM 成本优化、模型路由、预算追踪 (新增)
| |-- regex-vs-llm-structured-text/ # 决策框架:正则 vs LLM 解析文本 (新增)
| |-- swift-actor-persistence/ # 使用 Actor 的线程安全 Swift 数据持久化 (新增)
| |-- swift-protocol-di-testing/ # 基于协议的 DI 用于可测试的 Swift 代码 (新增)
| |-- search-first/ # 编码前研究工作流 (新增)
| |-- skill-stocktake/ # 审核技能与命令的质量 (新增)
| |-- liquid-glass-design/ # iOS 26 Liquid Glass 设计系统 (新增)
| |-- foundation-models-on-device/ # 使用 FoundationModels 的 Apple 端侧 LLM (新增)
| |-- swift-concurrency-6-2/ # Swift 6.2 易用并发 (新增)
| |-- autonomous-loops/ # 自主循环模式:顺序流水线、PR 循环、DAG 编排 (新增)
| |-- plankton-code-quality/ # 使用 Plankton 钩子在编写时强制执行代码质量 (新增)
|
|-- commands/ # 用于快速执行的斜杠命令 (Slash 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 - 将相关本能聚类为技能
| |-- 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 - 更新代码映射 (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 特定
|
|-- 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)
| |-- rust-api-CLAUDE.md # 真实 Rust API (Axum + SQLx + PostgreSQL) (新增)
|
|-- mcp-configs/ # MCP 服务器配置
| |-- mcp-servers.json # GitHub, Supabase, Vercel, Railway 等
|
|-- marketplace.json # 自托管市场配置 (用于 /plugin marketplace add)
有两种方法可以从你的仓库生成 Claude Code 技能 (Skills):
使用 /skill-create 命令进行本地分析,无需外部服务:
/skill-create # 分析当前仓库
/skill-create --instincts # 同时生成用于持续学习的本能 (instincts)这将本地分析你的 git 历史并生成 SKILL.md 文件。
适用于高级功能(10k+ 提交、自动 PR、团队共享):
# 在任何 issue 下留言:
/skill-creator analyze
# 或者在推送到默认分支时自动触发两个选项都会创建:
- SKILL.md 文件 - 可供 Claude Code 直接使用的技能
- 本能集合 (Instinct collections) - 适用于 continuous-learning-v2
- 模式提取 (Pattern extraction) - 从你的提交历史中学习
在 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 配置, 钩子 (Hooks), 智能体定义以及 5 个类别的技能 —— 密钥检测(14 种模式)、权限审计、钩子注入分析、MCP 服务器风险分析以及智能体配置审查。
--opus 标志 在红队/蓝队/审计员流水线中运行三个 Claude Opus 4.6 智能体。攻击者寻找攻击链,防御者评估防护措施,审计员将两者整合为优先排序的风险评估。这是对抗性推理,而非简单的模式匹配。
输出格式: 终端(彩色分级 A-F)、JSON(CI 流水线)、Markdown、HTML。发现严重问题时退出代码为 2,用于构建门禁。
在 Claude Code 中使用 /security-scan 运行,或通过 GitHub Action 添加到 CI。
Plankton(鸣谢:@alxfazio)是推荐的代码编写时质量强制执行伙伴。它通过 PostToolUse 钩子在每次文件编辑时运行格式化程序和 20+ 个 linter,然后产生 Claude 子进程(根据违规复杂程度路由至 Haiku/Sonnet/Opus)来修复主智能体遗漏的问题。三阶段架构:静默自动格式化(解决 40-50% 的问题)、收集剩余违规为结构化 JSON、将修复委派给子进程。包含配置保护钩子,防止智能体为了通过检查而修改 linter 配置。支持 Python, TypeScript, Shell, YAML, JSON, TOML, Markdown 和 Dockerfile。配合 AgentShield 使用,可实现安全 + 质量覆盖。完整集成指南请见 skills/plankton-code-quality/。
基于本能的学习系统会自动学习你的模式:
/instinct-status # 显示已学习的本能及其置信度
/instinct-import <file> # 导入他人的本能
/instinct-export # 导出你的本能进行分享
/evolve # 将相关本能聚类为技能 (Skills)完整文档请见 skills/continuous-learning-v2/。
最低版本:v2.1.0 或更高
由于插件系统处理钩子 (Hooks) 方式的变更,该插件需要 Claude Code CLI v2.1.0+。
检查你的版本:
claude --version
⚠️ 致贡献者: 请勿在.claude-plugin/plugin.json中添加"hooks"字段。这已通过回归测试强制执行。
Claude Code v2.1+ 会按约定从任何已安装的插件中自动加载 hooks/hooks.json。在 plugin.json 中显式声明会导致重复检测错误:
Duplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file
历史背景: 这在该仓库中曾导致反复的修复/回滚循环(#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 插件系统目前不支持通过插件分发
rules(规则)(上游限制)。你需要手动安装规则:# 首先克隆仓库 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/ # 选项 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/
# 复制规则(通用规则 + 特定语言规则)
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 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 springboot-patterns; do
# cp -r everything-claude-code/skills/$s ~/.claude/skills/
# done将 hooks/hooks.json 中的钩子复制到你的 ~/.claude/settings.json 中。
将 mcp-configs/mcp-servers.json 中所需的 MCP 服务器复制到你的 ~/.claude.json 中。
重要提示: 请将 YOUR_*_HERE 占位符替换为你真实的 API 密钥。
子智能体 (Subagents) 处理范围内受限的委派任务。示例:
---
name: code-reviewer
description: 审查代码的质量、安全性和可维护性
tools: ["Read", "Grep", "Glob", "Bash"]
model: opus
---
你是一名资深代码审查员...技能是由命令或智能体调用的工作流定义:
# 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] Remove console.log' >&2"
}]
}规则是必须遵守的准则,组织在 common/(语言无关)+ 特定语言目录中:
rules/
common/ # 通用原则(始终安装)
typescript/ # TS/JS 特定模式与工具
python/ # Python 特定模式与工具
golang/ # Go 特定模式与工具
安装和结构细节请参见 rules/README.md。
不确定从哪里开始?请参考此快速指南:
| 我想... | 使用此命令 | 使用的智能体 (Agent) |
|---|---|---|
| 规划新功能 | /everything-claude-code:plan "添加认证" |
planner |
| 设计系统架构 | /everything-claude-code:plan + architect 智能体 |
architect |
| 先写测试再写代码 | /tdd |
tdd-guide |
| 审查我刚写的代码 | /code-review |
code-reviewer |
| 修复构建失败 | /build-fix |
build-error-resolver |
| 运行端到端 (E2E) 测试 | /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 |
| 审计数据库查询 | (自动委派) | database-reviewer |
开始新功能:
/everything-claude-code:plan "使用 OAuth 添加用户身份验证"
→ planner 创建实现蓝图
/tdd → tdd-guide 强制执行先写测试
/code-review → code-reviewer 检查你的工作
修复 Bug:
/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这将显示插件中所有可用的智能体、命令和技能。
我的钩子 (Hooks) 没生效 / 我看到了 "Duplicate hooks file" 错误
这是最常见的问题。请勿在 .claude-plugin/plugin.json 中添加 "hooks" 字段。 Claude Code v2.1+ 会自动从已安装的插件中加载 hooks/hooks.json。显式声明会导致重复检测错误。参见 #29, #52, #103。
我的上下文窗口正在缩小 / Claude 耗尽了上下文
过多的 MCP 服务器会消耗你的上下文。每个 MCP 工具描述都会从你 200k 的窗口中消耗令牌,可能会将其减少到 ~70k。
解决方法: 按项目禁用不使用的 MCP:
// 在项目的 .claude/settings.json 中
{
"disabledMcpServers": ["supabase", "railway", "vercel"]
}保持启用少于 10 个 MCP,且活动工具少于 80 个。
我能只使用部分组件吗(例如只用智能体)?
可以。使用选项 2(手动安装)并仅复制你需要的部分:
# 仅智能体
cp everything-claude-code/agents/*.md ~/.claude/agents/
# 仅规则
cp -r everything-claude-code/rules/common/* ~/.claude/rules/每个组件都是完全独立的。
这是否适用于 Cursor / OpenCode / Codex?
是的。ECC 是跨平台的:
- Cursor: 预翻译的配置位于
.cursor/。参见 Cursor IDE 支持。 - OpenCode: 完整的插件支持位于
.opencode/。参见 OpenCode 支持。 - Codex: 具有适配器偏移保护和 SessionStart 降级的一流支持。参见 PR #257。
- Claude Code: 原生支持 —— 这是主要目标。
如何贡献新的技能或智能体?
参见 CONTRIBUTING.md。简短版本:
- Fork 本仓库
- 在
skills/your-skill-name/SKILL.md(带 YAML Frontmatter)中创建你的技能 - 或在
agents/your-agent.md中创建智能体 - 提交 PR,并清晰描述其功能及使用场景
插件包含一个全面的测试套件:
# 运行所有测试
node tests/run-all.js
# 运行单个测试文件
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js欢迎并鼓励各类贡献。
本仓库旨在成为社区资源。如果你有:
- 有用的智能体 (Agents) 或技能 (Skills)
- 巧妙的钩子 (Hooks)
- 更好的 MCP 配置
- 改进的规则 (Rules)
请贡献出来!准则请参见 CONTRIBUTING.md。
- 特定语言技能(Rust, C#, Swift, Kotlin)—— 已包含 Go, Python, Java
- 特定框架配置(Rails, Laravel, FastAPI, NestJS)—— 已包含 Django, Spring Boot
- DevOps 智能体(Kubernetes, Terraform, AWS, Docker)
- 测试策略(不同框架、视觉回归)
- 特定领域知识(机器学习、数据工程、移动端)
ECC 提供了完整的 Cursor IDE 支持,包含适配 Cursor 原生格式的钩子、规则、智能体、技能、命令和 MCP 配置。
# 为你的语言安装
./install.sh --target cursor typescript
./install.sh --target cursor python golang swift| 组件 | 数量 | 详情 |
|---|---|---|
| 钩子事件 | 15 | sessionStart, beforeShellExecution, afterFileEdit, beforeMCPExecution, beforeSubmitPrompt, 以及另外 10 个 |
| 钩子脚本 | 16 | 极简 Node.js 脚本,通过共享适配器委派给 scripts/hooks/ |
| 规则 (Rules) | 29 | 9 条通用规则 (alwaysApply) + 20 条语言特定规则 (TypeScript, Python, Go, Swift) |
| 智能体 (Agents) | 共享 | 通过根目录的 AGENTS.md(被 Cursor 原生读取) |
| 技能 (Skills) | 共享 + 打包 | 通过根目录的 AGENTS.md 以及 .cursor/skills/ 中翻译的补充内容 |
| 命令 (Commands) | 共享 | 如果安装,位于 .cursor/commands/ |
| MCP 配置 | 共享 | 如果安装,位于 .cursor/mcp.json |
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 之外的开发服务器运行 (exit 2),审查 git push
- afterFileEdit —— 自动格式化 + TypeScript 检查 + console.log 警告
- beforeSubmitPrompt —— 在提示词中检测密钥(sk-, ghp_, AKIA 等模式)
- beforeTabFileRead —— 阻止 Tab 读取 .env, .key, .pem 文件 (exit 2)
- beforeMCPExecution / afterMCPExecution —— MCP 审计日志记录
Cursor 规则使用带有 description, globs 和 alwaysApply 的 YAML Frontmatter:
---
description: "扩展通用规则的 TypeScript 编码风格"
globs: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"]
alwaysApply: false
---ECC 提供了一流的 Codex CLI 支持,包含参考配置、Codex 特定的 AGENTS.md 补充以及 16 个移植的技能。
# 将参考配置复制到你的用户目录
cp .codex/config.toml ~/.codex/config.toml
# 在仓库中运行 Codex —— 将自动检测 AGENTS.md
codex| 组件 | 数量 | 详情 |
|---|---|---|
| 配置 | 1 | .codex/config.toml —— 模型、权限、MCP 服务器、持久化指令 |
| AGENTS.md | 2 | 根目录(通用)+ .codex/AGENTS.md(Codex 特定补充) |
| 技能 (Skills) | 16 | .agents/skills/ —— 每个技能包含 SKILL.md + agents/openai.yaml |
| MCP 服务器 | 4 | GitHub, Context7, Memory, Sequential Thinking (基于命令) |
| 配置文件 (Profiles) | 2 | strict(只读沙箱)和 yolo(全自动确认) |
.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 | 构建、测试、lint、类型检查、安全 |
Codex CLI 目前尚不支持钩子 (OpenAI Codex Issue #2109, 430+ 赞)。安全强制执行是通过 config.toml 中的 persistent_instructions 以及沙箱权限系统基于指令实现的。
ECC 提供了完整的 OpenCode 支持,包括插件和钩子 (Hooks)。
# 安装 OpenCode
npm install -g opencode
# 在仓库根目录运行
opencode配置将自动从 .opencode/opencode.json 检测。
| 功能 | Claude Code | OpenCode | 状态 |
|---|---|---|---|
| 智能体 (Agents) | ✅ 13 个 | ✅ 12 个 | Claude Code 领先 |
| 命令 (Commands) | ✅ 33 个 | ✅ 24 个 | Claude Code 领先 |
| 技能 (Skills) | ✅ 50+ 个 | ✅ 37 个 | Claude Code 领先 |
| 钩子 (Hooks) | ✅ 8 种事件类型 | ✅ 11 个事件 | OpenCode 更多! |
| 规则 (Rules) | ✅ 29 条规则 | ✅ 13 条指令 | Claude Code 领先 |
| MCP 服务器 | ✅ 14 个 | ✅ 完整支持 | 功能持平 |
| 自定义工具 | ✅ 通过钩子实现 | ✅ 6 个原生工具 | OpenCode 更好 |
OpenCode 的插件系统比 Claude Code 更复杂,拥有 20 多种事件类型:
| Claude Code 钩子 | 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 等。
| 命令 | 描述 |
|---|---|
/plan |
创建实现计划 |
/tdd |
强制执行 TDD 工作流 |
/code-review |
审查代码变更 |
/build-fix |
修复构建错误 |
/e2e |
生成 E2E 测试 |
/refactor-clean |
移除废弃代码 |
/orchestrate |
多智能体工作流 |
/learn |
从会话中提取模式 |
/checkpoint |
保存验证状态 |
/verify |
运行验证循环 |
/eval |
根据准则评测 |
/update-docs |
更新文档 |
/update-codemaps |
更新代码映射 (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 |
查看已学本能 (instincts) |
/instinct-import |
导入本能 |
/instinct-export |
导出本能 |
/evolve |
将本能聚类为技能 |
/promote |
将项目本能提升至全局范围 |
/projects |
列出已知项目及本能统计 |
/learn-eval |
在保存前提取并评测模式 |
/setup-pm |
配置包管理器 |
选项 1:直接使用
cd everything-claude-code
opencode选项 2:作为 npm 包安装
npm install ecc-universal然后添加到你的 opencode.json:
{
"plugin": ["ecc-universal"]
}- 迁移指南:
.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 |
|---|---|---|---|---|
| 智能体 (Agents) | 13 | 共享 (AGENTS.md) | 共享 (AGENTS.md) | 12 |
| 命令 (Commands) | 33 | 共享 | 基于指令 | 24 |
| 技能 (Skills) | 50+ | 共享 | 10 (原生格式) | 37 |
| 钩子事件 | 8 种类型 | 15 种类型 | 尚无 | 11 种类型 |
| 钩子脚本 | 9 个脚本 | 16 个脚本 (DRY 适配器) | N/A | 插件钩子 |
| 规则 (Rules) | 29 (通用+语言) | 29 (YAML Frontmatter) | 基于指令 | 13 条指令 |
| 自定义工具 | 通过钩子实现 | 通过钩子实现 | N/A | 6 个原生工具 |
| MCP 服务器 | 14 | 共享 (mcp.json) | 4 (基于命令) | 完整支持 |
| 配置格式 | settings.json | hooks.json + rules/ | config.toml | opencode.json |
| 上下文文件 | CLAUDE.md + AGENTS.md | AGENTS.md | AGENTS.md | AGENTS.md |
| 密钥检测 | 基于钩子 | beforeSubmitPrompt 钩子 | 基于沙箱 | 基于钩子 |
| 自动格式化 | PostToolUse 钩子 | afterFileEdit 钩子 | N/A | file.edited 钩子 |
| 版本 | 插件 | 插件 | 参考配置 | 1.6.0 |
关键架构决策:
- 根目录下的 AGENTS.md 是通用的跨工具文件(被所有 4 种工具读取)
- DRY 适配器模式 让 Cursor 能够重用 Claude Code 的钩子脚本而无需重复
- 技能格式(带 YAML Frontmatter 的 SKILL.md)可跨 Claude Code, Codex 和 OpenCode 使用
- Codex 缺乏钩子的弱点通过
persistent_instructions和沙箱权限得到了弥补
我从实验性发布阶段就开始使用 Claude Code。在 2025 年 9 月与 @DRodriguezFX 一起,完全使用 Claude Code 开发了 zenith.chat,并赢得了 Anthropic x Forum Ventures 黑客松。
这些配置在多个生产级应用中经过了实战测试。
如果你不管理令牌消耗,使用 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 |
监控会话期间的令牌支出 |
本插件包含的 strategic-compact 技能建议在逻辑断点处执行 /compact,而不是依赖 95% 上下文时的自动压缩。完整决策指南请参见 skills/strategic-compact/SKILL.md。
何时进行压缩:
- 研究/探索后,实现代码前
- 完成一个里程碑后,开始下一个前
- 调试完成后,继续功能开发前
- 方案失败后,尝试新方案前
何时不要压缩:
- 实现过程中(你会丢失变量名、文件路径、部分状态)
至关重要: 不要一次性启用所有 MCP。每个 MCP 工具描述都会从你 200k 的窗口中消耗令牌,可能会将其减少到 ~70k。
- 每个项目保持启用少于 10 个 MCP
- 保持活动工具少于 80 个
- 在项目配置中使用
disabledMcpServers来禁用不使用的服务
智能体团队会产生多个上下文窗口。每个团队成员独立消耗令牌。仅在并行化能带来明显价值的任务中使用(多模块工作、并行审查)。对于简单的顺序任务,子智能体 (Subagents) 更节省令牌。
达到每日限额了?请参阅 令牌优化指南 以获取推荐设置和工作流建议。
快速见效方案:
// ~/.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
- zenith.chat: zenith.chat
- 技能目录: awesome-agent-skills(社区维护的智能体技能目录)
MIT - 自由使用,根据需要修改,如果可以请回馈贡献。
如果本项目对你有帮助,请点亮 Star。阅读两份指南。构建伟大的产品。