Files
everything-claude-code/docs/zh-CN/README.md
Affaan Mustafa 29277ac273 chore: prepare v1.9.0 release (#666)
- Bump version to 1.9.0 in package.json, package-lock.json, .opencode/package.json
- Add v1.9.0 changelog with 212 commits covering selective install architecture,
  6 new agents, 15+ new skills, session/state infrastructure, observer fixes,
  12 language ecosystems, and community contributions
- Update README with v1.9.0 release notes and complete agents tree (27 agents)
- Add pytorch-build-resolver to AGENTS.md agent table
- Update documentation counts to 27 agents, 109 skills, 57 commands
- Update version references in zh-CN README
- All 1421 tests passing, catalog counts verified
2026-03-20 00:29:20 -07:00

54 KiB
Raw Blame History

语言: English | 简体中文 | 繁體中文 | 日本語 | 한국어

Everything Claude Code

Stars Forks Contributors npm ecc-universal npm ecc-agentshield GitHub App Install License Shell TypeScript Python Go Java Perl Markdown

50K+ stars | 6K+ forks | 30 contributors | 5 languages supported | Anthropic Hackathon Winner


🌐 语言 / 语言 / 語言

English | 简体中文 | 繁體中文 | 日本語 | 한국어


适用于 AI 智能体平台的性能优化系统。来自 Anthropic 黑客马拉松的获奖作品。

不仅仅是配置。一个完整的系统:技能、本能、内存优化、持续学习、安全扫描以及研究优先的开发。经过 10 多个月的密集日常使用和构建真实产品的经验,演进出生产就绪的智能体、钩子、命令、规则和 MCP 配置。

适用于 Claude CodeCodexCowork 以及其他 AI 智能体平台。


指南

此仓库仅包含原始代码。指南解释了一切。

Claude Code 的速记指南/>
</a>
</td>
<td width= Claude Code 的详细指南
Shorthand Guide
设置、基础、理念。 先阅读此部分。
详细指南
令牌优化、记忆持久化、评估、并行化。
主题 你将学到什么
令牌优化 模型选择,系统提示精简,后台进程
内存持久化 自动跨会话保存/加载上下文的钩子
持续学习 从会话中自动提取模式为可重用技能
验证循环 检查点与持续评估评分器类型pass@k 指标
并行化 Git 工作树,级联方法,何时扩展实例
子智能体编排 上下文问题,迭代检索模式

最新动态

v1.8.0 — 平台性能系统2026 年 3 月)

  • 平台优先发布 — ECC 现在被明确构建为一个智能体平台性能系统,而不仅仅是一个配置包。
  • 钩子可靠性大修 — SessionStart 根回退、Stop 阶段会话摘要,以及用基于脚本的钩子替换脆弱的单行内联钩子。
  • 钩子运行时控制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个新的通用业务/内容技能article-writingcontent-enginemarket-researchinvestor-materialsinvestor-outreach
  • 更广泛的工具覆盖 — 加强了对 Cursor、Codex 和 OpenCode 的支持,使得同一代码仓库可以在所有主要平台上干净地部署
  • 992项内部测试 — 在插件、钩子、技能和打包方面扩展了验证和回归测试覆盖

v1.6.0 — Codex CLI、AgentShield 与市场2026年2月

  • Codex CLI 支持 — 新的 /codex-setup 命令生成 codex.md 以实现 OpenAI Codex CLI 兼容性
  • 7个新技能search-firstswift-actor-persistenceswift-protocol-di-testingregex-vs-llm-structured-textcontent-hash-cache-patterncost-aware-llm-pipelineskill-stocktake
  • AgentShield 集成/security-scan 技能直接从 Claude Code 运行 AgentShield1282 项测试102 条规则
  • GitHub 市场 — ECC Tools GitHub 应用已在 github.com/marketplace/ecc-tools 上线,提供免费/专业/企业版
  • 合并了 30+ 个社区 PR — 来自 6 种语言的 30 位贡献者的贡献
  • 978项内部测试 — 在代理、技能、命令、钩子和规则方面扩展了验证套件

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

  • 修复了直觉导入内容丢失问题parse_instinct_file()/instinct-import 期间会静默丢弃 frontmatter 之后的所有内容Action, Evidence, Examples 部分)。已由社区贡献者 @ericcai0814 修复 (#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 — 基于直觉的学习,带有置信度评分、导入/导出、进化

完整的更新日志请参见 Releases


🚀 快速开始

在 2 分钟内启动并运行:

步骤 1安装插件

# Add marketplace
/plugin marketplace add affaan-m/everything-claude-code

# Install plugin
/plugin install everything-claude-code@everything-claude-code

步骤 2安装规则必需

⚠️ 重要提示: Claude Code 插件无法自动分发 rules。请手动安装它们:

# Clone the repo first
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

# Recommended: use the installer (handles common + language rules safely)
./install.sh typescript    # or python or golang or swift or php
# You can pass multiple languages:
# ./install.sh typescript python golang swift php
# or target cursor:
# ./install.sh --target cursor typescript
# or target antigravity:
# ./install.sh --target antigravity typescript

手动安装说明请参阅 rules/ 文件夹中的 README。

步骤 3开始使用

# Try a command (plugin install uses namespaced form)
/everything-claude-code:plan "Add user authentication"

# Manual install (Option 2) uses the shorter form:
# /plan "Add user authentication"

# Check available commands
/plugin list everything-claude-code@everything-claude-code

搞定! 您现在可以访问 16 个智能体、65 项技能和 40 条命令。


🌐 跨平台支持

此插件现已完全支持 Windows、macOS 和 Linux,并与主流 IDECursor、OpenCode、Antigravity和 CLI 平台紧密集成。所有钩子和脚本都已用 Node.js 重写,以实现最大兼容性。

包管理器检测

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

  1. 环境变量CLAUDE_PACKAGE_MANAGER
  2. 项目配置.claude/package-manager.json
  3. package.jsonpackageManager 字段
  4. 锁文件:从 package-lock.json、yarn.lock、pnpm-lock.yaml 或 bun.lockb 检测
  5. 全局配置~/.claude/package-manager.json
  6. 回退方案:第一个可用的包管理器

要设置您首选的包管理器:

# Via environment variable
export CLAUDE_PACKAGE_MANAGER=pnpm

# Via global config
node scripts/setup-package-manager.js --global pnpm

# Via project config
node scripts/setup-package-manager.js --project bun

# Detect current setting
node scripts/setup-package-manager.js --detect

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

钩子运行时控制

使用运行时标志来调整严格性或临时禁用特定钩子:

# Hook strictness profile (default: standard)
export ECC_HOOK_PROFILE=standard

# Comma-separated hook IDs to disable
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

📦 包含内容

此仓库是一个 Claude Code 插件 - 可以直接安装或手动复制组件。

everything-claude-code/
|-- .claude-plugin/   # 插件和市场清单
|   |-- plugin.json         # 插件元数据和组件路径
|   |-- marketplace.json    # 用于 /plugin marketplace add 的市场目录
|
|-- agents/           # 用于委托任务的专用子代理
|   |-- planner.md           # 功能实现规划
|   |-- architect.md         # 系统架构设计决策
|   |-- tdd-guide.md         # 测试驱动开发
|   |-- code-reviewer.md     # 质量与安全代码审查
|   |-- security-reviewer.md # 漏洞分析
|   |-- build-error-resolver.md
|   |-- e2e-runner.md        # Playwright 端到端测试
|   |-- refactor-cleaner.md  # 无用代码清理
|   |-- doc-updater.md       # 文档同步
|   |-- 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 转 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/            # 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 端到端模式与页面对象模型(新增)
|   |-- content-hash-cache-pattern/  # 文件处理中的 SHA-256 内容哈希缓存模式(新增)
|   |-- cost-aware-llm-pipeline/     # LLM 成本优化、模型路由与预算追踪(新增)
|   |-- regex-vs-llm-structured-text/ # 文本解析决策框架regex vs LLM新增
|   |-- swift-actor-persistence/     # 使用 Actor 的线程安全 Swift 数据持久化(新增)
|   |-- swift-protocol-di-testing/   # 基于 Protocol 的依赖注入用于可测试 Swift 代码(新增)
|   |-- search-first/               # 先研究再编码的工作流(新增)
|   |-- skill-stocktake/            # 审计技能和命令质量(新增)
|   |-- liquid-glass-design/         # iOS 26 Liquid Glass 设计系统(新增)
|   |-- foundation-models-on-device/ # Apple 设备端 LLMFoundationModels新增
|   |-- swift-concurrency-6-2/       # Swift 6.2 易用并发(新增)
|   |-- perl-patterns/             # 现代 Perl 5.36+ 习惯用法与最佳实践(新增)
|   |-- perl-security/             # Perl 安全模式、taint 模式与安全 I/O新增
|   |-- perl-testing/              # 使用 Test2::V0、prove、Devel::Cover 的 Perl TDD新增
|   |-- autonomous-loops/           # 自主循环模式顺序流水线、PR 循环与 DAG 编排(新增)
|   |-- plankton-code-quality/      # 使用 Plankton hooks 的编写阶段代码质量控制(新增)
|
|-- commands/         # 快速执行的斜杠命令
|   |-- tdd.md              # /tdd - 测试驱动开发
|   |-- plan.md             # /plan - 实现规划
|   |-- e2e.md              # /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 - 更新代码映射
|   |-- 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           # Hook 架构与 TodoWrite
|   |   |-- agents.md          # 何时委托给子代理
|   |   |-- security.md        # 强制安全检查
|   |-- typescript/          # TypeScript/JavaScript 专用
|   |-- python/              # Python 专用
|   |-- golang/              # Go 专用
|   |-- swift/               # Swift 专用
|   |-- php/                 # PHP 专用(新增)
|
|-- hooks/            # 基于触发器的自动化
|   |-- README.md                 # Hook 文档、示例与自定义指南
|   |-- hooks.json                # 所有 Hook 配置PreToolUse、PostToolUse、Stop 等)
|   |-- memory-persistence/       # 会话生命周期 Hook长文指南
|   |-- strategic-compact/        # 压缩建议(长文指南)
|
|-- scripts/          # 跨平台 Node.js 脚本(新增)
|   |-- lib/                     # 公共工具
|   |   |-- utils.js             # 跨平台文件/路径/系统工具
|   |   |-- package-manager.js   # 包管理器检测与选择
|   |-- hooks/                   # Hook 实现
|   |   |-- session-start.js     # 会话开始时加载上下文
|   |   |-- session-end.js       # 会话结束时保存状态
|   |   |-- pre-compact.js       # 压缩前状态保存
|   |   |-- suggest-compact.js   # 战略压缩建议
|   |   |-- evaluate-session.js  # 从会话中提取模式
|   |-- setup-package-manager.js # 交互式包管理器设置
|
|-- tests/            # 测试套件(新增)
|   |-- lib/                     # 库测试
|   |-- hooks/                   # Hook 测试
|   |-- run-all.js               # 运行所有测试
|
|-- contexts/         # 动态系统提示上下文(长文指南)
|   |-- dev.md              # 开发模式上下文
|   |-- review.md           # 代码审查模式上下文
|   |-- research.md         # 研究/探索模式上下文
|
|-- examples/         # 示例配置与会话
|   |-- CLAUDE.md             # 项目级配置示例
|   |-- user-CLAUDE.md        # 用户级配置示例
|   |-- saas-nextjs-CLAUDE.md   # 实际 SaaS 示例Next.js + Supabase + Stripe
|   |-- go-microservice-CLAUDE.md # 实际 Go 微服务示例gRPC + PostgreSQL
|   |-- django-api-CLAUDE.md      # 实际 Django REST API 示例DRF + Celery
|   |-- 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 技能的两种方式:

选项 A本地分析内置

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

/skill-create                    # Analyze current repo
/skill-create --instincts        # Also generate instincts for continuous-learning

这会在本地分析您的 git 历史记录并生成 SKILL.md 文件。

选项 BGitHub 应用(高级)

适用于高级功能10k+ 提交、自动 PR、团队共享

安装 GitHub 应用 | ecc.tools

# Comment on any issue:
/skill-creator analyze

# Or auto-triggers on push to default branch

两种选项都会创建:

  • SKILL.md 文件 - 可供 Claude Code 使用的即用型技能
  • Instinct 集合 - 用于 continuous-learning-v2
  • 模式提取 - 从您的提交历史中学习

AgentShield — 安全审计器

在 Claude Code 黑客马拉松Cerebral Valley x Anthropic2026年2月上构建。1282 项测试98% 覆盖率102 条静态分析规则。

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

# Quick scan (no install needed)
npx ecc-agentshield scan

# Auto-fix safe issues
npx ecc-agentshield scan --fix

# Deep analysis with three Opus 4.6 agents
npx ecc-agentshield scan --opus --stream

# Generate secure config from scratch
npx ecc-agentshield init

它扫描什么: CLAUDE.md、settings.json、MCP 配置、钩子、代理定义以及 5 个类别的技能 —— 密钥检测14 种模式、权限审计、钩子注入分析、MCP 服务器风险剖析和代理配置审查。

--opus 标志 在红队/蓝队/审计员管道中运行三个 Claude Opus 4.6 代理。攻击者寻找利用链,防御者评估保护措施,审计员将两者综合成优先风险评估。对抗性推理,而不仅仅是模式匹配。

输出格式: 终端(按颜色分级的 A-F、JSONCI 管道、Markdown、HTML。在关键发现时退出代码 2用于构建门控。

在 Claude Code 中使用 /security-scan 来运行它,或者通过 GitHub Action 添加到 CI。

GitHub | npm

🔬 Plankton — 编写时代码质量强制执行

Plankton致谢@alxfazio是用于编写时代码质量强制执行的推荐伴侣。它通过 PostToolUse 钩子在每次文件编辑时运行格式化程序和 20 多个代码检查器,然后生成 Claude 子进程(根据违规复杂度路由到 Haiku/Sonnet/Opus来修复主智能体遗漏的问题。采用三阶段架构静默自动格式化解决 40-50% 的问题),将剩余的违规收集为结构化 JSON委托给子进程修复。包含配置保护钩子防止智能体修改检查器配置以通过检查而非修复代码。支持 Python、TypeScript、Shell、YAML、JSON、TOML、Markdown 和 Dockerfile。与 AgentShield 结合使用,实现安全 + 质量覆盖。完整集成指南请参阅 skills/plankton-code-quality/

🧠 持续学习 v2

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

/instinct-status        # Show learned instincts with confidence
/instinct-import <file> # Import instincts from others
/instinct-export        # Export your instincts for sharing
/evolve                 # Cluster related instincts into skills

完整文档请参阅 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 中显式声明会导致重复检测错误:

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

历史背景: 这已导致此仓库中多次修复/还原循环(#29, #52, #103。Claude Code 版本之间的行为发生了变化,导致了混淆。我们现在有一个回归测试来防止这种情况再次发生。


📥 安装

选项 1作为插件安装推荐

使用此仓库的最简单方式 - 作为 Claude Code 插件安装:

# Add this repo as a marketplace
/plugin marketplace add affaan-m/everything-claude-code

# Install the plugin
/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/
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/     # 选择您的技术栈

🔧 选项 2手动安装

如果您希望对安装的内容进行手动控制:

# Clone the repo
git clone https://github.com/affaan-m/everything-claude-code.git

# Copy agents to your Claude config
cp everything-claude-code/agents/*.md ~/.claude/agents/

# Copy rules (common + language-specific)
cp -r everything-claude-code/rules/common/* ~/.claude/rules/
cp -r everything-claude-code/rules/typescript/* ~/.claude/rules/   # pick your stack
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/

# Copy commands
cp everything-claude-code/commands/*.md ~/.claude/commands/

# Copy skills (core vs niche)
# Recommended (new users): core/general skills only
cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/
cp -r everything-claude-code/skills/search-first ~/.claude/skills/

# Optional: add niche/framework-specific skills only when needed
# for s in django-patterns django-tdd springboot-patterns; do
#   cp -r everything-claude-code/skills/$s ~/.claude/skills/
# done

将钩子添加到 settings.json

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

配置 MCPs

mcp-configs/mcp-servers.json 中所需的 MCP 服务器复制到你的 ~/.claude.json

重要:YOUR_*_HERE 占位符替换为你实际的 API 密钥。


🎯 关键概念

智能体

子智能体处理具有有限范围的委托任务。示例:

---
name: code-reviewer
description: 审查代码的质量、安全性和可维护性
tools: ["Read", "Grep", "Glob", "Bash"]
model: opus
---

您是一位资深代码审查员...

技能

技能是由命令或智能体调用的工作流定义:

# TDD Workflow

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

钩子

钩子在工具事件上触发。示例 - 警告关于 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/          # Universal principles (always install)
  typescript/      # TS/JS specific patterns and tools
  python/          # Python specific patterns and tools
  golang/          # Go specific patterns and tools
  swift/           # Swift specific patterns and tools
  php/             # PHP specific patterns and tools

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


🗺️ 我应该使用哪个代理?

不确定从哪里开始?使用这个快速参考:

我想要... 使用此命令 使用的代理
规划新功能 /everything-claude-code:plan "Add auth" planner
设计系统架构 /everything-claude-code:plan + architect agent 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
审计数据库查询 (自动委派) database-reviewer

常见工作流

开始新功能:

/everything-claude-code:plan "Add user authentication with OAuth"
                                              → planner creates implementation blueprint
/tdd                                          → tdd-guide enforces write-tests-first
/code-review                                  → code-reviewer checks your work

修复错误:

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

准备生产环境:

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

常见问题

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

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

我的钩子不工作 / 我看到“重复钩子文件”错误

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

我能否在自定义API端点或模型网关上使用ECC与Claude Code

是的。ECC 不会硬编码 Anthropic 托管的传输设置。它通过 Claude Code 正常的 CLI/插件接口在本地运行,因此可以与以下系统配合工作:

  • Anthropic 托管的 Claude Code
  • 使用 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN 的官方 Claude Code 网关设置
  • 兼容的自定义端点,这些端点能理解 Anthropic API 并符合 Claude Code 的预期

最小示例:

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 工具描述都会消耗你 200k 窗口的令牌,可能将其减少到约 70k。

修复: 按项目禁用未使用的 MCP

// In your project's .claude/settings.json
{
  "disabledMcpServers": ["supabase", "railway", "vercel"]
}

保持启用的 MCP 少于 10 个,活动工具少于 80 个。

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

是的。使用选项 2手动安装并仅复制你需要的部分

# Just agents
cp everything-claude-code/agents/*.md ~/.claude/agents/

# Just rules
cp -r everything-claude-code/rules/common/* ~/.claude/rules/

每个组件都是完全独立的。

这能与 Cursor / OpenCode / Codex / Antigravity 一起使用吗?

是的。ECC 是跨平台的:

  • Cursor.cursor/ 中的预翻译配置。请参阅 Cursor IDE 支持
  • OpenCode.opencode/ 中的完整插件支持。请参阅 OpenCode 支持
  • Codex:对 macOS 应用和 CLI 的一流支持,带有适配器漂移防护和 SessionStart 回退。请参阅 PR #257
  • Antigravity.agent/ 中针对工作流、技能和扁平化规则的紧密集成设置。
  • Claude Code:原生支持 — 这是主要目标。
我如何贡献新技能或代理?

参见 CONTRIBUTING.md。简短版本:

  1. Fork 仓库
  2. skills/your-skill-name/SKILL.md 中创建你的技能(带有 YAML 前言)
  3. 或在 agents/your-agent.md 中创建代理
  4. 提交 PR清晰描述其功能和使用时机

🧪 运行测试

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

# Run all tests
node tests/run-all.js

# Run individual test files
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, Laravel, FastAPI, NestJS—— Django, Spring Boot 已包含在内
  • DevOps 代理Kubernetes, Terraform, AWS, Docker
  • 测试策略(不同框架,视觉回归)
  • 特定领域知识ML数据工程移动端

Cursor IDE 支持

ECC 提供完整的 Cursor IDE 支持,包括为 Cursor 原生格式适配的钩子、规则、代理、技能、命令和 MCP 配置。

快速开始 (Cursor)

# Install for your language(s)
./install.sh --target cursor typescript
./install.sh --target cursor python golang swift php

包含内容

组件 数量 详情
钩子事件 15 sessionStart, beforeShellExecution, afterFileEdit, beforeMCPExecution, beforeSubmitPrompt 等 10 多个
钩子脚本 16 通过共享适配器委托给 scripts/hooks/ 的精简 Node.js 脚本
规则 34 9 个通用规则alwaysApply+ 25 个语言特定规则TypeScript, Python, Go, Swift, PHP
代理 共享 通过根目录下的 AGENTS.md由 Cursor 原生读取)
技能 共享 + 捆绑 通过根目录下的 AGENTS.md 和 .cursor/skills/ 用于翻译后的补充内容
命令 共享 .cursor/commands/(如果已安装)
MCP 配置 共享 .cursor/mcp.json(如果已安装)

钩子架构DRY 适配器模式)

Cursor 的钩子事件比 Claude Code 多20 对 8.cursor/hooks/adapter.js 模块将 Cursor 的 stdin JSON 转换为 Claude Code 的格式,允许重用现有的 scripts/hooks/*.js 而无需重复。

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

关键钩子:

  • beforeShellExecution — 阻止在 tmux 外启动开发服务器(退出码 2git push 审查
  • afterFileEdit — 自动格式化 + TypeScript 检查 + console.log 警告
  • beforeSubmitPrompt — 检测提示中的密钥sk-、ghp_、AKIA 模式)
  • beforeTabFileRead — 阻止 Tab 读取 .env、.key、.pem 文件(退出码 2
  • beforeMCPExecution / afterMCPExecution — MCP 审计日志记录

规则格式

Cursor 规则使用带有 descriptionglobsalwaysApply 的 YAML 前言:

---
description: "TypeScript coding style extending common rules"
globs: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"]
alwaysApply: false
---

Codex macOS 应用 + CLI 支持

ECC 为 macOS 应用和 CLI 提供 一流的 Codex 支持包括参考配置、Codex 特定的 AGENTS.md 补充文档以及共享技能。

快速开始Codex 应用 + CLI

# Run Codex CLI in the repo — AGENTS.md and .codex/ are auto-detected
codex

# Optional: copy the global-safe defaults to your home directory
cp .codex/config.toml ~/.codex/config.toml

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 —— 顶级 approvals/sandbox/web_search, MCP 服务器,通知,配置文件
AGENTS.md 2 根目录(通用)+ .codex/AGENTS.mdCodex 特定补充)
技能 16 .agents/skills/ —— SKILL.md + agents/openai.yaml 每个技能
MCP 服务器 4 GitHub, Context7, Memory, Sequential Thinking基于命令
配置文件 2 strict(只读沙箱)和 yolo(完全自动批准)
代理角色 3 .codex/agents/ —— explorer, reviewer, docs-researcher

技能

位于 .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 端到端测试
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 支持,包括插件和钩子。

快速开始

# Install OpenCode
npm install -g opencode

# Run in the repository root
opencode

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

功能对等

功能 Claude Code OpenCode 状态
智能体 16 个智能体 12 个智能体 Claude Code 领先
命令 40 条命令 31 条命令 Claude Code 领先
技能 65 项技能 37 项技能 Claude Code 领先
钩子 8 种事件类型 11 种事件 OpenCode 更多!
规则 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.editedfile.watcher.updatedmessage.updatedlsp.client.diagnosticstui.toast.show 等等。

可用命令31+

命令 描述
/plan 创建实施计划
/tdd 强制执行 TDD 工作流
/code-review 审查代码变更
/build-fix 修复构建错误
/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 列出已知项目和本能统计信息
/learn-eval 保存前提取和评估模式
/setup-pm 配置包管理器
/harness-audit 审计平台可靠性、评估准备情况和风险状况
/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(完整的 OpenCode 文档,供 LLM 使用)

跨工具功能对等

ECC 是第一个最大化利用每个主要 AI 编码工具的插件。以下是每个平台的比较:

功能 Claude Code Cursor IDE Codex CLI OpenCode
代理 16 共享AGENTS.md 共享AGENTS.md 12
命令 40 共享 基于指令 31
技能 65 共享 10原生格式 37
钩子事件 8 种类型 15 种类型 暂无 11 种类型
钩子脚本 20+ 脚本 16 个脚本DRY 适配器) N/A 插件钩子
规则 34通用 + 语言) 34YAML 前言) 基于指令 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.9.0

关键架构决策:

  • AGENTS.md 在根目录是通用的跨工具文件(所有 4 个工具都能读取)
  • DRY 适配器模式 让 Cursor 可以重用 Claude Code 的钩子脚本而无需重复
  • 技能格式(带有 YAML 前言的 SKILL.md在 Claude Code、Codex 和 OpenCode 中都能工作
  • Codex 缺少钩子功能,通过 AGENTS.md、可选的 model_instructions_file 覆盖以及沙箱权限来弥补

📖 背景

我从实验性推出以来就一直在使用 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。

  • 每个项目保持启用的 MCP 少于 10 个
  • 保持活动工具少于 80 个
  • 在项目配置中使用 disabledMcpServers 来禁用未使用的 MCP

代理团队成本警告

代理团队会生成多个上下文窗口。每个团队成员独立消耗令牌。仅用于并行性能提供明显价值的任务(多模块工作、并行审查)。对于简单的顺序任务,子代理更节省令牌。


⚠️ 重要说明

令牌优化

达到每日限制?参见 令牌优化指南 获取推荐设置和工作流提示。

快速见效的方法:

// ~/.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. 添加你自己的模式

💜 赞助商

这个项目是免费和开源的。赞助商帮助保持其维护和发展。

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


🌟 Star 历史

Star History Chart


🔗 链接


📄 许可证

MIT - 自由使用,根据需要修改,如果可以请回馈贡献。


如果此仓库对你有帮助,请点星。阅读两份指南。构建伟大的东西。