affaan-m/everything-claude-code

**语言：** English | [繁體中文](docs/zh-TW/README.md) # Everything Claude Code 全指南 [](https://github.com/affaan-m/everything-claude-code/stargazers) [](https://github.com/affaan-m/everything-claude-code/network/members) [](https://github.com/affaan-m/everything-claude-code/graphs/contributors) [](LICENSE)       **AI Agent Harness 的性能优化系统。源自 Anthropic 黑客马拉松获奖作品。** 不仅仅是配置。这是一套完整系统：技能、直觉、内存优化、持续学习、安全扫描和研优先发。生产就绪的 Agent、Hook、命令、规则和 MCP 配置，历经 10 多个月的日常高强度使用和真实产品构建。 支持 **Claude Code**、**Codex**、**Cowork** 以及其他 AI Agent Harness。 ## 指南 本仓库仅包含原始代码。指南部分详解一切。

Shorthand Guide Setup, foundations, philosophy. Read this first.	Longform Guide Token optimization, memory persistence, evals, parallelization.

| 主题 | 你将学到什么 | |-------|-------------------| | Token 优化 | 模型选择、系统提示精简、后台进程 | | 内存持久化 | 跨会话自动保存/加载上下文的 Hook | | 持续学习 | 从会话中自动提取模式，转化为可复用技能 | | 验证循环 | 检查点 vs 持续评估、评分器类型、pass@k 指标 | | 并行化 | Git worktree、级联方法、何时扩展实例 | | 子 Agent 编排 | 上下文问题、迭代检索模式 | ## 更新日志 ### v1.7.0 — 跨平台扩展与演示构建器 (2026年2月) - **Codex app + CLI 支持** — 直接基于 `AGENTS.md` 的 Codex 支持、安装器定向和 Codex 文档 - **`frontend-slides` 技能** — 零依赖 HTML 演示构建器，附带 PPTX 转换指导和严格的视口适配规则 - **5 个新的通用商业/内容技能** — `article-writing`、`content-engine`、`market-research`、`investor-materials`、`investor-outreach` - **更广泛的工具覆盖** — Cursor、Codex 和 OpenCode 支持 tightened，同一仓库可在所有主流 Harness 中无缝运行 - **992 个内部测试** — 扩展了插件、Hook、技能和打包的验证与回归覆盖 ### v1.6.0 — Codex CLI、AgentShield 与市场 (2026年2月) - **Codex CLI 支持** — 新的 `/codex-setup` 命令生成 `codex.md` 以兼容 OpenAI Codex CLI - **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 App 已上线 [github.com/marketplace/ecc-tools](https://github.com/marketplace/ecc-tools)，提供免费/专业/企业版 - **合并了 30+ 社区 PR** — 来自 30 位贡献者，涵盖 6 种语言 - **978 个内部测试** — 扩展了 Agent、技能、命令、Hook 和规则的验证套件 ### v1.4.1 — Bug 修复 (2026年2月) - **修复直觉导入内容丢失** — `parse_instinct_file()` 在 `/instinct-import` 期间会静默丢弃 frontmatter 之后的所有内容（Action、Evidence、Examples 部分）。由社区贡献者 @ericcai0814 修复 ([#148](https://github.com/affaan-m/everything-claude-code/issues/148)、[#161](https://github.com/affaan-m/everything-claude-code/pull/161)) ### v1.4.0 — 多语言规则、安装向导与 PM2 (2026年2月) - **交互式安装向导** — 新的 `configure-ecc` 技能提供引导式安装，支持合并/覆盖检测 - **PM2 与多 Agent 编排** — 6 个新命令（`/pm2`、`/multi-plan`、`/multi-execute`、`/multi-backend`、`/multi-frontend`、`/multi-workflow`）用于管理复杂的多服务工作流 - **多语言规则架构** — 规则从扁平文件重构为 `common/` + `typescript/` + `python/` + `golang/` 目录结构。只安装你需要的语言 - **中文 (zh-CN) 翻译** — 完整翻译所有 Agent、命令、技能和规则（80+ 文件） - **GitHub Sponsors 支持** — 通过 GitHub Sponsors 赞助本项目 - **增强的 CONTRIBUTING.md** — 针对每种贡献类型的详细 PR 模板 ### v1.3.0 — OpenCode 插件支持 (2026年2月) - **完整的 OpenCode 集成** — 12 个 Agent、24 个命令、16 个技能，通过 OpenCode 的插件系统支持 Hook（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](https://github.com/affaan-m/everything-claude-code/releases)。 ## 🚀 快速开始 2 分钟内快速上手： ### 第 1 步：安装插件 ``` # 添加 marketplace /plugin marketplace add affaan-m/everything-claude-code # 安装插件 /plugin install everything-claude-code@everything-claude-code ``` ### 第 2 步：安装规则（必须） ``` # 首先 clone repo git clone https://github.com/affaan-m/everything-claude-code.git cd everything-claude-code # 推荐：使用 installer（安全处理 common + language rules） ./install.sh typescript # or python or golang # 你可以传递多种语言： # ./install.sh typescript python golang # 或针对 cursor： # ./install.sh --target cursor typescript ``` 手动安装说明请见 `rules/` 文件夹中的 README。 ### 第 3 步：开始使用 ``` # 尝试命令（plugin install 使用 namespaced 形式） /everything-claude-code:plan "Add user authentication" # 手动安装（选项 2）使用更短的形式： # /plan "Add user authentication" # 检查可用命令 /plugin list everything-claude-code@everything-claude-code ``` ✨ **就这样！** 你现在可以访问 13 个 Agent、56 个技能和 32 个命令。 ## 🌐 跨平台支持 本插件现已完全支持 **Windows、macOS 和 Linux**。所有 Hook 和脚本已用 Node.js 重写以实现最大兼容性。 ### 包管理器检测 插件会按以下优先级自动检测你的首选包管理器： 1. **环境变量**：`CLAUDE_PACKAGE_MANAGER` 2. **项目配置**：`.claude/package-manager.json` 3. **package.json**：`packageManager` 字段 4. **锁文件**：从 package-lock.json、yarn.lock、pnpm-lock.yaml 或 bun.lockb 检测 5. **全局配置**：`~/.claude/package-manager.json` 6. **回退**：第一个可用的包管理器 设置你的首选包管理器： ``` # 通过环境变量 export CLAUDE_PACKAGE_MANAGER=pnpm # 通过全局配置 node scripts/setup-package-manager.js --global pnpm # 通过项目配置 node scripts/setup-package-manager.js --project bun # 检测当前设置 node scripts/setup-package-manager.js --detect ``` 或在 Claude Code 中使用 `/setup-pm` 命令。 ## 📦 包含内容 本仓库是一个 **Claude Code 插件** — 直接安装或手动复制组件。 ``` everything-claude-code/ |-- .claude-plugin/ # Plugin and marketplace manifests | |-- plugin.json # Plugin metadata and component paths | |-- marketplace.json # Marketplace catalog for /plugin marketplace add | |-- agents/ # Specialized subagents for delegation | |-- planner.md # Feature implementation planning | |-- architect.md # System design decisions | |-- tdd-guide.md # Test-driven development | |-- code-reviewer.md # Quality and security review | |-- security-reviewer.md # Vulnerability analysis | |-- build-error-resolver.md | |-- e2e-runner.md # Playwright E2E testing | |-- refactor-cleaner.md # Dead code cleanup | |-- doc-updater.md # Documentation sync | |-- go-reviewer.md # Go code review | |-- go-build-resolver.md # Go build error resolution | |-- python-reviewer.md # Python code review (NEW) | |-- database-reviewer.md # Database/Supabase review (NEW) | |-- skills/ # Workflow definitions and domain knowledge | |-- coding-standards/ # Language best practices | |-- clickhouse-io/ # ClickHouse analytics, queries, data engineering | |-- backend-patterns/ # API, database, caching patterns | |-- frontend-patterns/ # React, Next.js patterns | |-- frontend-slides/ # HTML slide decks and PPTX-to-web presentation workflows (NEW) | |-- article-writing/ # Long-form writing in a supplied voice without generic AI tone (NEW) | |-- content-engine/ # Multi-platform social content and repurposing workflows (NEW) | |-- market-research/ # Source-attributed market, competitor, and investor research (NEW) | |-- investor-materials/ # Pitch decks, one-pagers, memos, and financial models (NEW) | |-- investor-outreach/ # Personalized fundraising outreach and follow-up (NEW) | |-- continuous-learning/ # Auto-extract patterns from sessions (Longform Guide) | |-- continuous-learning-v2/ # Instinct-based learning with confidence scoring | |-- iterative-retrieval/ # Progressive context refinement for subagents | |-- strategic-compact/ # Manual compaction suggestions (Longform Guide) | |-- tdd-workflow/ # TDD methodology | |-- security-review/ # Security checklist | |-- eval-harness/ # Verification loop evaluation (Longform Guide) | |-- verification-loop/ # Continuous verification (Longform Guide) | |-- golang-patterns/ # Go idioms and best practices | |-- golang-testing/ # Go testing patterns, TDD, benchmarks | |-- cpp-coding-standards/ # C++ coding standards from C++ Core Guidelines (NEW) | |-- cpp-testing/ # C++ testing with GoogleTest, CMake/CTest (NEW) | |-- django-patterns/ # Django patterns, models, views (NEW) | |-- django-security/ # Django security best practices (NEW) | |-- django-tdd/ # Django TDD workflow (NEW) | |-- django-verification/ # Django verification loops (NEW) | |-- python-patterns/ # Python idioms and best practices (NEW) | |-- python-testing/ # Python testing with pytest (NEW) | |-- springboot-patterns/ # Java Spring Boot patterns (NEW) | |-- springboot-security/ # Spring Boot security (NEW) | |-- springboot-tdd/ # Spring Boot TDD (NEW) | |-- springboot-verification/ # Spring Boot verification (NEW) | |-- configure-ecc/ # Interactive installation wizard (NEW) | |-- security-scan/ # AgentShield security auditor integration (NEW) | |-- java-coding-standards/ # Java coding standards (NEW) | |-- jpa-patterns/ # JPA/Hibernate patterns (NEW) | |-- postgres-patterns/ # PostgreSQL optimization patterns (NEW) | |-- nutrient-document-processing/ # Document processing with Nutrient API (NEW) | |-- project-guidelines-example/ # Template for project-specific skills | |-- database-migrations/ # Migration patterns (Prisma, Drizzle, Django, Go) (NEW) | |-- api-design/ # REST API design, pagination, error responses (NEW) | |-- deployment-patterns/ # CI/CD, Docker, health checks, rollbacks (NEW) | |-- docker-patterns/ # Docker Compose, networking, volumes, container security (NEW) | |-- e2e-testing/ # Playwright E2E patterns and Page Object Model (NEW) | |-- content-hash-cache-pattern/ # SHA-256 content hash caching for file processing (NEW) | |-- cost-aware-llm-pipeline/ # LLM cost optimization, model routing, budget tracking (NEW) | |-- regex-vs-llm-structured-text/ # Decision framework: regex vs LLM for text parsing (NEW) | |-- swift-actor-persistence/ # Thread-safe Swift data persistence with actors (NEW) | |-- swift-protocol-di-testing/ # Protocol-based DI for testable Swift code (NEW) | |-- search-first/ # Research-before-coding workflow (NEW) | |-- skill-stocktake/ # Audit skills and commands for quality (NEW) | |-- liquid-glass-design/ # iOS 26 Liquid Glass design system (NEW) | |-- foundation-models-on-device/ # Apple on-device LLM with FoundationModels (NEW) | |-- swift-concurrency-6-2/ # Swift 6.2 Approachable Concurrency (NEW) | |-- autonomous-loops/ # Autonomous loop patterns: sequential pipelines, PR loops, DAG orchestration (NEW) | |-- plankton-code-quality/ # Write-time code quality enforcement with Plankton hooks (NEW) | |-- commands/ # Slash commands for quick execution | |-- tdd.md # /tdd - Test-driven development | |-- plan.md # /plan - Implementation planning | |-- e2e.md # /e2e - E2E test generation | |-- code-review.md # /code-review - Quality review | |-- build-fix.md # /build-fix - Fix build errors | |-- refactor-clean.md # /refactor-clean - Dead code removal | |-- learn.md # /learn - Extract patterns mid-session (Longform Guide) | |-- learn-eval.md # /learn-eval - Extract, evaluate, and save patterns (NEW) | |-- checkpoint.md # /checkpoint - Save verification state (Longform Guide) | |-- verify.md # /verify - Run verification loop (Longform Guide) | |-- setup-pm.md # /setup-pm - Configure package manager | |-- go-review.md # /go-review - Go code review (NEW) | |-- go-test.md # /go-test - Go TDD workflow (NEW) | |-- go-build.md # /go-build - Fix Go build errors (NEW) | |-- skill-create.md # /skill-create - Generate skills from git history (NEW) | |-- instinct-status.md # /instinct-status - View learned instincts (NEW) | |-- instinct-import.md # /instinct-import - Import instincts (NEW) | |-- instinct-export.md # /instinct-export - Export instincts (NEW) | |-- evolve.md # /evolve - Cluster instincts into skills | |-- pm2.md # /pm2 - PM2 service lifecycle management (NEW) | |-- multi-plan.md # /multi-plan - Multi-agent task decomposition (NEW) | |-- multi-execute.md # /multi-execute - Orchestrated multi-agent workflows (NEW) | |-- multi-backend.md # /multi-backend - Backend multi-service orchestration (NEW) | |-- multi-frontend.md # /multi-frontend - Frontend multi-service orchestration (NEW) | |-- multi-workflow.md # /multi-workflow - General multi-service workflows (NEW) | |-- orchestrate.md # /orchestrate - Multi-agent coordination | |-- sessions.md # /sessions - Session history management | |-- eval.md # /eval - Evaluate against criteria | |-- test-coverage.md # /test-coverage - Test coverage analysis | |-- update-docs.md # /update-docs - Update documentation | |-- update-codemaps.md # /update-codemaps - Update codemaps | |-- python-review.md # /python-review - Python code review (NEW) | |-- rules/ # Always-follow guidelines (copy to ~/.claude/rules/) | |-- README.md # Structure overview and installation guide | |-- common/ # Language-agnostic principles | | |-- coding-style.md # Immutability, file organization | | |-- git-workflow.md # Commit format, PR process | | |-- testing.md # TDD, 80% coverage requirement | | |-- performance.md # Model selection, context management | | |-- patterns.md # Design patterns, skeleton projects | | |-- hooks.md # Hook architecture, TodoWrite | | |-- agents.md # When to delegate to subagents | | |-- security.md # Mandatory security checks | |-- typescript/ # TypeScript/JavaScript specific | |-- python/ # Python specific | |-- golang/ # Go specific | |-- hooks/ # Trigger-based automations | |-- README.md # Hook documentation, recipes, and customization guide | |-- hooks.json # All hooks config (PreToolUse, PostToolUse, Stop, etc.) | |-- memory-persistence/ # Session lifecycle hooks (Longform Guide) | |-- strategic-compact/ # Compaction suggestions (Longform Guide) | |-- scripts/ # Cross-platform Node.js scripts (NEW) | |-- lib/ # Shared utilities | | |-- utils.js # Cross-platform file/path/system utilities | | |-- package-manager.js # Package manager detection and selection | |-- hooks/ # Hook implementations | | |-- session-start.js # Load context on session start | | |-- session-end.js # Save state on session end | | |-- pre-compact.js # Pre-compaction state saving | | |-- suggest-compact.js # Strategic compaction suggestions | | |-- evaluate-session.js # Extract patterns from sessions | |-- setup-package-manager.js # Interactive PM setup | |-- tests/ # Test suite (NEW) | |-- lib/ # Library tests | |-- hooks/ # Hook tests | |-- run-all.js # Run all tests | |-- contexts/ # Dynamic system prompt injection contexts (Longform Guide) | |-- dev.md # Development mode context | |-- review.md # Code review mode context | |-- research.md # Research/exploration mode context | |-- examples/ # Example configurations and sessions | |-- CLAUDE.md # Example project-level config | |-- user-CLAUDE.md # Example user-level config | |-- saas-nextjs-CLAUDE.md # Real-world SaaS (Next.js + Supabase + Stripe) | |-- go-microservice-CLAUDE.md # Real-world Go microservice (gRPC + PostgreSQL) | |-- django-api-CLAUDE.md # Real-world Django REST API (DRF + Celery) | |-- rust-api-CLAUDE.md # Real-world Rust API (Axum + SQLx + PostgreSQL) (NEW) | |-- mcp-configs/ # MCP server configurations | |-- mcp-servers.json # GitHub, Supabase, Vercel, Railway, etc. | |-- marketplace.json # Self-hosted marketplace config (for /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 文件。 #### 选项 B：GitHub App（高级） 适用于高级功能（10k+ commits、自动 PR、团队共享）： [安装 GitHub App](https://github.com/apps/skill-creator) | [ecc.tools](https://ecc.tools) ``` # 对任何 issue 进行评论： /skill-creator analyze # 或在推送到 default branch 时自动触发 ``` 两种选项都会创建： - **SKILL.md 文件** — Claude Code 可直接使用的技能 - **直觉集合** — 用于 continuous-learning-v2 - **模式提取** — 从你的提交历史中学习 ### AgentShield — 安全审计器 扫描你的 Claude Code 配置中的漏洞、错误配置和注入风险。 ``` # 快速扫描（无需安装） npx ecc-agentshield scan # Auto-fix safe issues npx ecc-agentshield scan --fix # 使用三个 Opus 4.6 agents 进行深度分析 npx ecc-agentshield scan --opus --stream # 从头生成安全配置 npx ecc-agentshield init ``` **扫描内容：** CLAUDE.md、settings.json、MCP 配置、Hook、Agent 定义和技能，覆盖 5 大类别 — 密钥检测（14 种模式）、权限审计、Hook 注入分析、MCP 服务器风险画像和 Agent 配置审查。 **`--opus` 标志** 运行三个 Claude Opus 4.6 Agent 组成的红队/蓝队/审计器流水线。攻击者寻找利用链，防御者评估保护措施，审计器将两者综合成优先级排序的风险评估。对抗性推理，而非仅仅是模式匹配。 **输出格式：** 终端（A-F 彩色分级）、JSON（CI 流水线）、Markdown、HTML。发现严重问题时退出码为 2，用于构建门禁。 在 Claude Code 中使用 `/security-scan` 运行，或通过 [GitHub Action](https://github.com/affaan-m/agentshield) 集成到 CI。 [GitHub](https://github.com/affaan-m/agentshield) | [npm](https://www.npmjs.com/package/ecc-agentshield) ### 🔬 Plankton — 写时代码质量强制 Plankton（归功于 @alxfazio）是推荐的写时代码质量强制伴侣工具。它通过 PostToolUse Hook 在每次文件编辑时运行格式化器和 20+ 个 linter，然后生成 Claude 子进程（根据违规复杂度路由到 Haiku/Sonnet/Opus）来修复主 Agent 遗漏的问题。三阶段架构：静默自动格式化（解决 40-50% 的问题）、将剩余违规收集为结构化 JSON、将修复委托给子进程。包含配置保护 Hook，防止 Agent 修改 linter 配置来绕过检查而不是修复代码。支持 Python、TypeScript、Shell、YAML、JSON、TOML、Markdown 和 Dockerfile。与 AgentShield 配合使用以实现安全 + 质量覆盖。完整集成指南见 `skills/plankton-code-quality/`。 ### 🧠 持续学习 v2 基于直觉的学习系统会自动学习你的模式： ``` /instinct-status # Show learned instincts with confidence /instinct-import # 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 或更高** 由于插件系统处理 Hook 的方式变化，本插件需要 Claude Code CLI v2.1.0+。 检查你的版本： ``` claude --version ``` ### 重要：Hook 自动加载行为 Claude Code v2.1+ **自动加载** 已安装插件的 `hooks/hooks.json`。在 `plugin.json` 中显式声明会导致重复检测错误： ``` Duplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file ``` **历史：** 这曾导致本仓库多次修复/回滚循环 ([#29](https://github.com/affaan-m/everything-claude-code/issues/29)、[#52](https://github.com/affaan-m/everything-claude-code/issues/52)、[#103](https://github.com/affaan-m/everything-claude-code/issues/103))。该行为在 Claude Code 版本之间发生过变化，导致混淆。我们现在有回归测试来防止此问题再次出现。 ## 📥 安装 ### 选项 1：作为插件安装（推荐） 使用本仓库最简单的方式 — 作为 Claude Code 插件安装： ``` # 将此 repo 添加为 marketplace /plugin marketplace add affaan-m/everything-claude-code # 安装 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 } } ``` 这将让你即时访问所有命令、Agent、技能和 Hook。 ### 🔧 选项 2：手动安装 如果你希望手动控制安装内容： ``` # Clone repo git clone https://github.com/affaan-m/everything-claude-code.git # 复制 agents 到你的 Claude 配置 cp everything-claude-code/agents/*.md ~/.claude/agents/ # 复制 rules（common + 语言特定） 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/ # 复制 commands cp everything-claude-code/commands/*.md ~/.claude/commands/ # 复制 skills（核心 vs 小众） # 推荐（新用户）：仅限 core/general skills cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/ cp -r everything-claude-code/skills/search-first ~/.claude/skills/ # 可选：仅在需要时添加 niche/framework-specific skills # for s in django-patterns django-tdd springboot-patterns; do # cp -r everything-claude-code/skills/$s ~/.claude/skills/ # done ``` #### 将 Hook 添加到 settings.json 将 `hooks/hooks.json` 中的 Hook 复制到你的 `~/.claude/settings.json`。 #### 配置 MCP 将所需的 MCP 服务器从 `mcp-configs/mcp-servers.json` 复制到你的 `~/.claude.json`。 **重要：** 将 `YOUR_*_HERE` 占位符替换为你的实际 密钥。 ## 🎯 核心概念 ### Agent 子 Agent 处理有限范围的委托任务。示例： ``` --- name: code-reviewer description: Reviews code for quality, security, and maintainability tools: ["Read", "Grep", "Glob", "Bash"] model: opus --- You are a senior code reviewer... ``` ### 技能 技能是由命令或 Agent 调用的工作流定义： ``` # TDD Workflow 1. Define interfaces first 2. Write failing tests (RED) 3. Implement minimal code (GREEN) 4. Refactor (IMPROVE) 5. Verify 80%+ coverage ``` ### Hook Hook 在工具事件时触发。示例 — 警告 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 ``` 安装和结构详情见 [`rules/README.md`](rules/README.md)。 ## 🗺️ 我该使用哪个 Agent？ 不确定从哪里开始？使用此快速参考： | 我想... | 使用此命令 | 使用的 Agent | |--------------|-----------------|------------| | 规划新功能 | `/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 ``` **修复 Bug：** ``` /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 ``` ## ❓ 常见问题

如何检查已安装的 Agent/命令？

``` /plugin list everything-claude-code@everything-claude-code ``` 这将显示插件中所有可用的 Agent、命令和技能。

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

这是最常见的问题。**不要在 `.claude-plugin/plugin.json` 中添加 `"hooks"` 字段。** Claude Code v2.1+ 自动从已安装插件加载 `hooks/hooks.json`。显式声明会导致重复检测错误。见 [#29](https://github.com/affaan-m/everything-claude-code/issues/29)、[#52](https://github.com/affaan-m/everything-claude-code/issues/52)、[#103](https://github.com/affaan-m/everything-claude-code/issues/103)。

我的上下文窗口在缩小 / Claude 快用完上下文了

太多 MCP 服务器会消耗你的上下文。每个 MCP 工具描述都会从你的 200k 窗口中消耗 token，可能将其减少到约 70k。 **解决方法：** 按项目禁用未使用的 MCP： ``` // In your project's .claude/settings.json { "disabledMcpServers": ["supabase", "railway", "vercel"] } ``` 保持启用的 MCP 不超过 10 个，活跃工具不超过 80 个。

我可以只使用部分组件（如只用 Agent）吗？

可以。使用选项 2（手动安装）并只复制你需要的： ``` # 仅 agents cp everything-claude-code/agents/*.md ~/.claude/agents/ # 仅 rules cp -r everything-claude-code/rules/common/* ~/.claude/rules/ ``` 每个组件都是完全独立的。

这能在 Cursor / OpenCode / Codex 上工作吗？

可以。ECC 是跨平台的： - **Cursor**：`.cursor/` 中有预翻译配置。见 [Cursor IDE 支持](#cursor-ide-support)。 - **OpenCode**：`.opencode/` 中有完整插件支持。见 [OpenCode 支持](#-opencode-support)。 - **Codex**：一流支持，带有适配器漂移保护和 SessionStart 回退。见 PR [#257](https://github.com/affaan-m/everything-claude-code/pull/257)。 - **Claude Code**：原生 — 这是主要目标。

如何贡献新的技能或 Agent？

见 [CONTRIBUTING.md](CONTRIBUTING.md)。简短版本： 1. Fork 仓库 2. 在 `skills/your-skill-name/SKILL.md` 创建你的技能（带 YAML frontmatter） 3. 或在 `agents/your-agent.md` 创建 Agent 4. 提交 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 ``` ## 🤝 贡献 **欢迎并鼓励贡献。** 本仓库旨在成为社区资源。如果你有： - 有用的 Agent 或技能 - 巧妙的 Hook - 更好的 MCP 配置 - 改进的规则 请贡献！指南见 [CONTRIBUTING.md](CONTRIBUTING.md)。 ### 贡献想法 - 语言特定技能（Rust、C#、Swift、Kotlin）— 已包含 Go、Python、Java - 框架特定配置（Rails、Laravel、FastAPI、NestJS）— 已包含 Django、Spring Boot - DevOps Agent（Kubernetes、Terraform、AWS、Docker） - 测试策略（不同框架、视觉回归） - 领域特定知识（ML、数据工程、移动端） ## Cursor IDE 支持 ECC 提供 **完整的 Cursor IDE 支持**，包含适配 Cursor 原生格式的 Hook、规则、Agent、技能、命令和 MCP 配置。 ### 快速开始 ``` # 为你的语言安装 ./install.sh --target cursor typescript ./install.sh --target cursor python golang swift ``` ### 包含内容 | 组件 | 数量 | 详情 | |-----------|-------|---------| | Hook 事件 | 15 | sessionStart、beforeShellExecution、afterFileEdit、beforeMCPExecution、beforeSubmitPrompt 等 10+ 个 | | Hook 脚本 | 16 | 精简的 Node.js 脚本，通过共享适配器委托给 `scripts/hooks/` | | 规则 | 29 | 9 个通用 + 20 个语言特定 | | Agent | 共享 | 通过根目录 AGENTS.md（Cursor 原生读取） | | 技能 | 共享 + 内置 | 通过根目录 AGENTS.md 和 `.cursor/skills/` 翻译补充 | | 命令 | 共享 | `.cursor/commands/` 如已安装 | | MCP 配置 | 共享 | `.cursor/mcp.json` 如已安装 | ### Hook 架构（DRY 适配器模式） Cursor 比 Claude Code 有**更多的 Hook 事件**（20 vs 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) ``` 关键 Hook： - **beforeShellExecution** — 阻止 tmux 外的 dev server（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 coding style extending common rules" globs: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"] alwaysApply: false --- ``` ## Codex CLI 支持 ECC 为 Codex CLI 提供**一流支持**，包含参考配置、Codex 专用 AGENTS.md 补充和 16 个移植技能。 ### 快速开始 ``` # 复制参考配置到你的主目录 cp .codex/config.toml ~/.codex/config.toml # 在 repo 中运行 Codex — AGENTS.md 会被自动检测 codex ``` ### 包含内容 | 组件 | 数量 | 详情 | |-----------|-------|---------| | 配置 | 1 | `.codex/config.toml` — model、permissions、MCP servers、persistent instructions | | AGENTS.md | 2 | 根目录（通用）+ `.codex/AGENTS.md`（Codex 专用补充） | | 技能 | 16 | `.agents/skills/` — 每个技能的 SKILL.md + agents/openai.yaml | | MCP 服务器 | 4 | GitHub、Context7、Memory、Sequential Thinking（命令式） | | 配置文件 | 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 | Deck、备忘录、模型和单页 | | investor-outreach | 个性化外联、跟进和介绍简介 | | backend-patterns | API 设计、数据库、缓存 | | e2e-testing | Playwright E2E 测试 | | eval-harness | 评估驱动开发 | | strategic-compact | 上下文管理 | | api-design | REST API 设计模式 | | verification-loop | 构建、测试、lint、类型检查、安全 | ### 关键限制 Codex CLI **尚不支持 Hook**（OpenAI Codex Issue #2109，430+ 点赞）。安全强制通过 config.toml 中的 `persistent_instructions` 和沙箱权限系统基于指令实现。 ## 🔌 OpenCode 支持 ECC 提供 **完整的 OpenCode 支持**，包括插件和 Hook。 ### 快速开始 ``` # 安装 OpenCode npm install -g opencode # 在 repository root 运行 opencode ``` 配置从 `.opencode/opencode.json` 自动检测。 ### 功能对等 | 功能 | Claude Code | OpenCode | 状态 | |---------|-------------|----------|--------| | Agent | ✅ 13 个 | ✅ 12 个 | **Claude Code 领先** | | 命令 | ✅ 33 个 | ✅ 24 个 | **Claude Code 领先** | | 技能 | ✅ 50+ 个 | ✅ 37 个 | **Claude Code 领先** | | Hook | ✅ 8 种事件类型 | ✅ 11 种事件 | **OpenCode 更多！** | | 规则 | ✅ 29 条 | ✅ 13 条指令 | **Claude Code 领先** | | MCP 服务器 | ✅ 14 个 | ✅ 完整 | **完全对等** | | 自定义工具 | ✅ 通过 Hook | ✅ 6 个原生工具 | **OpenCode 更好** | ### 通过插件支持 Hook OpenCode 的插件系统比 Claude Code 更复杂，支持 20+ 种事件类型： | Claude Code Hook | 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` 等。 ### 可用命令（32 个） | 命令 | 描述 | |---------|-------------| | `/plan` | 创建实现计划 | | `/tdd` | 强制 TDD 工作流 | | `/code-review` | 审查代码变更 | | `/build-fix` | 修复构建错误 | | `/e2e` | 生成 E2E 测试 | | `/refactor-clean` | 删除死代码 | | `/orchestrate` | 多 Agent 工作流 | | `/learn` | 从会话提取模式 | | `/checkpoint` | 保存验证状态 | | `/verify` | 运行验证循环 | | `/eval` | 按标准评估 | | `/update-docs` | 更新文档 | | `/update-codemaps` | 更新 codemap | | `/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` | 配置包管理器 | ### 插件安装 **选项 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 编码工具的插件**。以下是各 Harness 的对比： | 功能 | Claude Code | Cursor IDE | Codex CLI | OpenCode | |---------|------------|------------|-----------|----------| | **Agent** | 13 | 共享 | 共享 | 12 | | **命令** | 33 | 共享 | 基于指令 | 24 | | **技能** | 50+ | 共享 | 10（原生格式） | 37 | | **Hook 事件** | 8 种 | 15 种 | 尚无 | 11 种 | | **Hook 脚本** | 9 个 | 16 个（DRY 适配器） | 不适用 | 插件 Hook | | **规则** | 29（通用 + 语言） | 29（YAML frontmatter） | 基于指令 | 13 条指令 | | **自定义工具** | 通过 Hook | 通过 Hook | 不适用 | 6 个原生工具 | | **MCP 服务器** | 14 | 共享 | 4（命令式） | 完整 | | **配置格式** | settings.json | hooks.json + rules/ | config.toml | opencode.json | | **上下文文件** | CLAUDE.md + AGENTS.md | AGENTS.md | AGENTS.md | AGENTS.md | | **密钥检测** | 基于 Hook | beforeSubmitPrompt Hook | 基于沙箱 | 基于 Hook | | **自动格式化** | PostToolUse Hook | afterFileEdit Hook | 不适用 | file.edited Hook | | **版本** | 插件 | 插件 | 参考配置 | 1.6.0 | **关键架构决策：** - 根目录的 **AGENTS.md** 是通用跨工具文件（4 种工具都可读取） - **DRY 适配器模式** 让 Cursor 复用 Claude Code 的 Hook 脚本而无需重复 - **技能格式**（带 YAML frontmatter 的 SKILL.md）可在 Claude Code、Codex 和 OpenCode 间通用 - Codex 缺少 Hook 的问题通过 `persistent_instructions` 和沙箱权限补偿 ## 📖 背景 我从实验性推出时就开始使用 Claude Code。在 2025 年 9 月的 Anthropic x Forum Ventures 黑客马拉松中与 [@DRodriguezFX](https://x.com/DRodriguezFX) 一起获奖，使用 Claude Code 完整构建了 [zenith.chat](https://zenith.chat)。 这些配置在多个生产应用中经过实战检验。 ## Token 优化 如果不管理 Token 消耗，使用 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` | 会话期间监控 Token 消耗 | ### 策略性压缩 `strategic-compact` 技能（本插件包含）建议在逻辑断点处使用 `/compact`，而不是依赖 95% 上下文时的自动压缩。完整决策指南见 `skills/strategic-compact/SKILL.md`。 **何时压缩：** - 研究/探索后，实现前 - 完成里程碑后，开始下一个前 - 调试后，继续功能开发前 - 失败尝试后，尝试新方法前 **何时不压缩：** - 实现中途（会丢失变量名、文件路径、部分状态） ### 上下文窗口管理 **关键：** 不要同时启用所有 MCP。每个 MCP 工具描述都会从你的 200k 窗口中消耗 Token，可能将其减少到约 70k。 - 每个项目启用的 MCP 不超过 10 个 - 活跃工具不超过 80 个 - 在项目配置中使用 `disabledMcpServers` 禁用未使用的 ### Agent 团队成本警告 Agent Teams 会生成多个上下文窗口。每个队友独立消耗 Token。仅用于并行性提供明确价值的任务（多模块工作、并行审查）。对于简单的顺序任务，子 Agent 更节省 Token。 ## ⚠️ 重要说明 ### Token 优化 达到每日限制？参阅 **[Token 优化指南](docs/token-optimization.md)** 获取推荐设置和工作流技巧。 快速见效： ``` // ~/.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. 添加你自己的模式 ## 💜 赞助者 本项目免费开源。赞助者帮助维护和成长。 [**成为赞助者**](https://github.com/sponsors/affaan-m) | [赞助等级](SPONSORS.md) ## 🌟 Star 历史 [](https://star-history.com/#affaan-m/everything-claude-code&Date) ## 🔗 链接 - **简明指南（从这里开始）：** [Everything Claude Code 简明指南](https://x.com/affaanmustafa/status/2012378465664745795) - **详尽指南（进阶）：** [Everything Claude Code 详尽指南](https://x.com/affaanmustafa/status/2014040193557471352) - **关注：** [@affaanmustafa](https://x.com/affaanmustafa) - **zenith.chat：** [zenith.chat](https://zenith.chat) - **技能目录：** awesome-agent-skills（社区维护的 Agent 技能目录） ## 📄 许可证 MIT — 自由使用，按需修改，如有可能请回馈。 **如果有帮助请给个 Star。阅读两份指南。构建伟大的产品。**

标签：AI 编程, Anthropic, CIS基准, Claude Code, Codex, Copilot, Cowork, Cutter, DLL 劫持, DNS解析, JS文件枚举, LLM, MCP, MITM代理, Model Context Protocol, Python, Shell, TypeScript, Unmanaged PE, 人工智能, 大语言模型, 安全扫描, 安全插件, 工具配置, 开发框架, 开源项目, 性能优化, 提示词工程, 无后门, 日志审计, 时序注入, 最佳实践, 检测绕过, 用户模式Hook绕过, 策略决策点, 自动化开发, 自定义脚本, 自定义脚本, 记忆系统, 逆向工具, 防御加固