Everything Claude Code¶

Shell TypeScript Python Java Markdown

140K+ 星标 | 21K+ 分支 | 170+ 贡献者 | 12+ 语言生态 | Anthropic 黑客马拉松获胜者

语言 / Language / 语言 / Dil / Язык / Ngôn ngữ

面向 AI 智能体 harness 的性能优化系统。来自 Anthropic 黑客马拉松获胜者。

不仅仅是配置。它是一个完整系统：skills、instincts、内存优化、持续学习、安全扫描以及研究优先的开发。生产就绪的智能体、hooks、命令、规则和 MCP 配置，在 10 多个月的每日高强度使用和构建真实产品过程中开发而成。

适用于 Claude Code、Codex、Cursor、OpenCode、Gemini 以及其他 AI 智能体 harness。

指南¶

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


简版指南配置、基础、哲学。请先阅读此篇。	完整指南 Token 优化、内存持久化、evals、并行化。	安全指南攻击向量、沙箱、净化、CVE、AgentShield。

主题	你将学到什么
Token 优化	模型选择、系统提示词缩减、后台进程
内存持久化	自动在会话之间保存/加载上下文的 hooks
持续学习	从会话中自动提取模式为可复用 skills
验证循环	Checkpoint 与持续 evals、评估器类型、pass@k 指标
并行化	Git worktrees、cascade 方法、何时扩展实例
子智能体编排	上下文问题、迭代恢复模式

新内容¶

v2.2.2 — 多 harness 引导安装（2026 年 8 月）¶

为 Claude Code、Codex 和 Kimi Code 添加可审查的安装，并提供同步的 npm 命令入口。

v2.1.0 — 智能体 harness 操作系统（2026 年 6 月）¶

2.0 系列的稳定毕业：261 个 skills、control-pane 基底、MCP 清单、worktrees 生命周期服务以及 Discord 社区。

v2.0.0-rc.1 — 表面同步、运营流程与 ECC 2.0 Alpha（2026 年 4 月）¶

与真实仓库同步的公开表面 — 元数据、目录计数、插件 manifests 和安装文档现在反映实际交付的 OSS 表面。
运营与外部流程扩展 — brand-voice、social-graph-ranker、customer-billing-ops、google-workspace-ops 及相关 skills 强化了同一系统内的运营路径。
媒体与发布工具 — manim-video、remotion-video-creation 以及社交发布流程将技术讲解和发布放在同一仓库中。
框架与产品表面增长 — nestjs-patterns、更丰富的 Codex/OpenCode 安装表面以及跨 harness 打包改进将使用范围扩展到 Claude Code 之外。
ECC 2.0 alpha 已在仓库中 — ecc2/ 内的 Rust 控制平面已可本地编译，并暴露 dashboard、start、sessions、status、stop、resume 和 daemon。
生态强化 — AgentShield、ECC Tools 成本控制、billing 门户工作以及网站更新继续围绕主插件交付。

v1.9.0 — 选择性安装与语言扩展（2026 年 3 月）¶

选择性安装架构 — 基于清单的安装流水线，使用 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 用于深度学习流程，documentation-lookup 用于 API 参考查询，bun-runtime 和 nextjs-turbopack 用于现代 JS 工具链，此外还有 8 个运维领域技能和 mcp-server-patterns。
会话与状态基础设施 — 带查询 CLI 的 SQLite 状态存储，用于结构化记录的会话适配器，以及面向可自我提升技能的技能演进基础。
编排审查 — Harness 审计评分变为确定性，强化编排状态和启动器兼容性，通过五层守卫防止 observer 循环。
observer 可靠性 — 通过限流和尾部采样修复内存爆炸问题，修复沙箱访问、惰性启动逻辑和重入守卫。
12 个语言生态系统 — 新增 Java、PHP、Perl、Kotlin/Android/KMP、C++ 和 Rust 规则，加入现有的 TypeScript、Python、Go 和通用规则。
社区贡献 — 韩语和中文翻译、biome 钩子优化、VideoDB 技能、Evos 运维技能、PowerShell 安装器、Antigravity IDE 支持。
强化 CI — 19 项测试失败修复、应用目录计数、安装清单验证以及完整测试套件全部通过。

v1.8.0 — Harness 性能系统（2026 年 3 月）¶

聚焦 harness 发布 — ECC 现在被明确定位为代理 harness 性能系统，而不仅仅是一个配置包。
钩子可靠性审查 — SessionStart 根回退、Stop 阶段的会话摘要，以及基于脚本的钩子替代脆弱的内联单行命令。
钩子运行时控制 — ECC_HOOK_PROFILE=minimal|standard|strict 和 ECC_DISABLED_HOOKS=... 用于在不编辑钩子文件的情况下进行运行时控制。
新的 harness 命令 — /harness-audit、/loop-start、/loop-status、/quality-gate、/model-route。
NanoClaw v2 — 模型路由、技能热加载、会话分支/搜索/导出/压缩/指标。
harness 间一致性 — 在 Claude Code、Cursor、OpenCode 和 Codex 应用/CLI 中统一行为。
997 个内部测试通过 — 在钩子/运行时重构和兼容性更新后，完整测试套件全部通过。

快速开始¶

在不到 2 分钟内开始：

步骤 1：安装插件¶

# Adicionar marketplace
/plugin marketplace add https://github.com/affaan-m/ECC

# Instalar plugin
/plugin install ecc@ecc

步骤 2：安装规则（必需）¶

警告：重要： Claude Code 插件无法自动分发 rules。请手动安装：

# Clone o repositório primeiro
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

# Instalar dependências (escolha seu gerenciador de pacotes)
npm install        # ou: pnpm install | yarn install | bun install

# macOS/Linux
./install.sh typescript    # ou python ou golang ou swift ou php
# ./install.sh typescript python golang swift php
# ./install.sh --target cursor typescript
# ./install.sh --target antigravity typescript

# Windows PowerShell
.\install.ps1 typescript   # ou python ou golang ou swift ou php
# .\install.ps1 typescript python golang swift php
# .\install.ps1 --target cursor typescript
# .\install.ps1 --target antigravity typescript

# O ponto de entrada do pacote npm publicado também funciona multiplataforma
npx ecc-universal install typescript

步骤 3：开始使用¶

# Experimente um comando (a instalação do plugin usa forma com namespace)
/ecc:plan "Adicionar autenticação de usuário"

# Instalação manual (Opção 2) usa a forma mais curta:
# /plan "Adicionar autenticação de usuário"

# Verificar comandos disponíveis
/plugin list ecc@ecc

完成！ 你现在可以访问 28 个代理、116 个技能和 59 个命令。

多平台支持¶

该插件现在完全支持 Windows、macOS 和 Linux，并与主流 IDE（Cursor、OpenCode、Antigravity）和 CLI harness 紧密集成。所有钩子和脚本均已用 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
回退：第一个可用包管理器（pnpm > bun > yarn > npm）

要设置你首选的包管理器：

# Via variável de ambiente
export CLAUDE_PACKAGE_MANAGER=pnpm

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

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

# Detectar configuração atual
node scripts/setup-package-manager.js --detect

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

钩子运行时控制¶

使用运行时标志来调整严格程度或临时禁用特定钩子：

# Perfil de rigor de hooks (padrão: standard)
export ECC_HOOK_PROFILE=standard

# IDs de hooks separados por vírgula para desabilitar
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

包含内容¶

everything-claude-code/
|-- agents/           # 28 subagentes especializados para delegação
|-- skills/           # Definições de fluxo de trabalho e conhecimento de domínio
|-- commands/         # Comandos slash para execução rápida
|-- rules/            # Diretrizes sempre seguidas (copiar para ~/.claude/rules/)
|-- hooks/            # Automações baseadas em gatilhos
|-- scripts/          # Scripts Node.js multiplataforma
|-- tests/            # Suíte de testes
|-- contexts/         # Contextos de injeção de prompt de sistema
|-- examples/         # Configurações e sessões de exemplo
|-- mcp-configs/      # Configurações de servidor MCP

生态系统工具¶

Skills 创建器¶

有两种方式可从仓库生成 Claude Code skills：

选项 A：本地分析（内置）¶

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

/skill-create                    # Analisar repositório atual
/skill-create --instincts        # Também gerar instincts para continuous-learning

选项 B：GitHub App（高级）¶

如需高级功能（10k+ 提交、自动 PR、团队共享）：

安装 GitHub App | ecc.tools

AgentShield — 安全审计器¶

在 Claude Code Hackathon（Cerebral Valley × Anthropic，2026 年 2 月）上构建。1282 项测试，98% 覆盖率，102 条静态分析规则。

# Verificação rápida (sem instalação necessária)
npx ecc-agentshield scan

# Corrigir automaticamente problemas seguros
npx ecc-agentshield scan --fix

# Análise profunda com três agentes Opus 4.6
npx ecc-agentshield scan --opus --stream

# Gerar configuração segura do zero
npx ecc-agentshield init

持续学习 v2¶

基于 instincts 的学习系统会自动学习你的模式：

/instinct-status        # Mostrar instincts aprendidos com confiança
/instinct-import <file> # Importar instincts de outros
/instinct-export        # Exportar seus instincts para compartilhar
/evolve                 # Agrupar instincts relacionados em skills

系统要求¶

Claude Code CLI 版本¶

最低版本：v2.1.0 或更高版本

检查你的版本：

claude --version

安装¶

选项 1：作为插件安装（推荐）¶

# Adicionar este repositório como marketplace
/plugin marketplace add https://github.com/affaan-m/ECC

# Instalar o plugin
/plugin install ecc@ecc

或者直接添加到你的 ~/.claude/settings.json：

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

注意： Claude Code 插件系统不支持通过插件分发 rules。你需要手动安装规则：

# Clone o repositório primeiro
git clone https://github.com/affaan-m/everything-claude-code.git

# Opção A: Regras no nível do usuário (aplica a todos os projetos)
mkdir -p ~/.claude/rules
cp -r everything-claude-code/rules/common ~/.claude/rules/common
cp -r everything-claude-code/rules/typescript ~/.claude/rules/typescript   # escolha sua stack

# Opção B: Regras no nível do projeto (aplica apenas ao projeto atual)
mkdir -p .claude/rules
cp -r everything-claude-code/rules/common .claude/rules/common

选项 2：手动安装¶

# Clonar o repositório
git clone https://github.com/affaan-m/everything-claude-code.git

# Copiar agentes para sua config Claude
cp everything-claude-code/agents/*.md ~/.claude/agents/

# Copiar regras (comuns + específicas da linguagem)
cp -r everything-claude-code/rules/common ~/.claude/rules/common
cp -r everything-claude-code/rules/typescript ~/.claude/rules/typescript

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

# Copiar skills (core vs nicho)
cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/

核心概念¶

智能体（Agents）¶

子智能体处理委派的任务，作用域有限。

Skills（技能）¶

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

Hooks（钩子）¶

Hooks 会在工具事件发生时触发。示例——提醒注意 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] Remova o console.log' >&2"
  }]
}

规则¶

规则是需要始终遵循的指导方针，组织在 common/（与语言无关）目录以及各语言专属目录中。

我应该使用哪个智能体？¶

我想……	使用此命令	使用的智能体
规划一个新功能	`/ecc:plan "Adicionar auth"`	planner
设计系统架构	`/ecc: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

常见工作流¶

开始一个新功能：

/ecc:plan "Adicionar autenticação de usuário com OAuth"
                                              → planner cria blueprint de implementação
/tdd                                          → tdd-guide aplica escrita de testes primeiro
/code-review                                  → code-reviewer verifica seu trabalho

修复 bug：

/tdd                                          → tdd-guide: escrever teste falhando que reproduz o bug
                                              → implementar a correção, verificar se o teste passa
/code-review                                  → code-reviewer: detectar regressões

准备生产环境：

/security-scan                                → security-reviewer: auditoria OWASP Top 10
/e2e                                          → e2e-runner: testes de fluxo crítico do usuário
/test-coverage                                → verificar cobertura 80%+

常见问题¶

如何查看已安装哪些代理/命令？

/plugin list ecc@ecc

我的 hooks 不工作 / 我看到 "Duplicate hooks file" 错误

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

我可以使用 ECC 配合 Cursor / OpenCode / Codex / Antigravity 吗？

可以。ECC 支持多平台： - Cursor：.cursor/ 中提供预翻译配置 - OpenCode：.opencode/ 中完整支持插件 - Codex：对 macOS 应用和 CLI 提供一等支持 - Antigravity：.agents/ 中内置配置 - Claude Code：原生支持——这是主要目标

如何贡献新的 skill 或代理？

参见 CONTRIBUTING.md。简而言之： 1. Fork 该仓库 2. 在 skills/seu-nome-de-skill/SKILL.md 中创建你的 skill（包含 YAML frontmatter） 3. 或在 agents/seu-agente.md 中创建一个代理 4. 提交一个 PR，清晰描述其功能和使用场景

运行测试¶

# Executar todos os testes
node tests/run-all.js

# Executar arquivos de teste individuais
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js

贡献¶

欢迎并鼓励贡献。

该仓库是面向社区的资源。如果你有： - 有用的代理或 skill - 智能 hooks - 更好的 MCP 配置 - 改进的规则

请贡献！参见 CONTRIBUTING.md 了解指南。

许可证¶

MIT — 请参阅 LICENSE 文件了解详情。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 ev/ECC