The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
docs: Enhance README.zh-CN.md with badges and instructions (#1291)
Alexc7f68a74e33c
diff --git a/README.zh-CN.md b/README.zh-CN.mdindex e56b323f5..1c1d333e9 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -1,13 +1,22 @@# 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)+[](https://www.npmjs.com/package/ecc-universal)+[](https://www.npmjs.com/package/ecc-agentshield)+[](https://github.com/marketplace/ecc-tools)[](LICENSE)+++> **140K+ stars** | **21K+ forks** | **170+ 贡献者** | **12+ 语言系统** | **Anthropic黑客松获胜者**+---<div align="center">@@ -22,7 +31,10 @@**来自 Anthropic 黑客马拉松获胜者的完整 Claude Code 配置集合。**-生产级代理、技能、钩子、命令、规则和 MCP 配置,经过 10 多个月构建真实产品的密集日常使用而演化。+不止是配置文件,而是一整套完整系统:技能体系、本能行为、记忆优化、持续学习、安全扫描,以及研究优先的开发模式。+包含可直接用于生产环境的智能体、技能模块、钩子、规则、MCP 配置,以及兼容传统命令的适配层——所有内容均经过 10 个多月高强度日常使用与真实产品开发迭代打磨而成。++可在 **Claude Code**、**Codex**、**Cursor**、**OpenCode**、**Gemini** 及其他 AI 智能体框架中通用。---@@ -32,20 +44,26 @@<table><tr>-<td width="50%">+<td width="33%"><a href="https://x.com/affaanmustafa/status/2012378465664745795"><img src="https://github.com/user-attachments/assets/1a471488-59cc-425b-8345-5245c7efbcef" alt="The Shorthand Guide to Everything Claude Code" /></a></td>-<td width="50%">+<td width="33%"><a href="https://x.com/affaanmustafa/status/2014040193557471352"><img src="https://github.com/user-attachments/assets/c9ca43bc-b149-427f-b551-af6840c368f0" alt="The Longform Guide to Everything Claude Code" /></a></td>+<td width="33%">+<a href="https://x.com/affaanmustafa/status/2033263813387223421">+<img src="./assets/images/security/security-guide-header.png" alt="The Shorthand Guide to Everything Agentic Security" />+</a>+</td></tr><tr><td align="center"><b>精简指南</b><br/>设置、基础、理念。<b>先读这个。</b></td><td align="center"><b>详细指南</b><br/>Token 优化、内存持久化、评估、并行化。</td>+<td align="center"><b>安全指南</b><br/>攻击向量、沙箱技术、数据净化、CVE漏洞、Agent防护</td></tr></table>@@ -66,6 +84,8 @@### 第一步:安装插件+> 注意:插件安装方式较为便捷,但如果你的 Claude Code 版本无法正常解析自托管市场条目,建议使用下方的开源安装脚本,稳定性更高。+```bash# 添加市场/plugin marketplace add affaan-m/everything-claude-code@@ -81,17 +101,42 @@```bash# 首先克隆仓库git clone https://github.com/affaan-m/everything-claude-code.git+cd everything-claude-code-# 复制规则目录(通用 + 语言特定)-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/perl ~/.claude/rules/+# 安装依赖(选择你常用的包管理器)+npm install # 或:pnpm install | yarn install | bun install++# macOS/Linux 系统++# 推荐方式:完整安装(完整配置文件)+./install.sh --profile full++# 或仅为指定编程语言安装+./install.sh typescript # 也可安装 python、golang、swift、php+# ./install.sh typescript python golang swift php+# ./install.sh --target cursor typescript+# ./install.sh --target antigravity typescript+# ./install.sh --target gemini --profile full+```++```powershell+# Windows 系统(PowerShell)++# 推荐方式:完整安装(完整配置文件)+.\install.ps1 --profile full++# 或仅为指定编程语言安装+.\install.ps1 typescript # 也可安装 python、golang、swift、php+# .\install.ps1 typescript python golang swift php+# .\install.ps1 --target cursor typescript+# .\install.ps1 --target antigravity typescript+# .\install.ps1 --target gemini --profile full++# 通过 npm 安装的兼容入口,支持全平台使用+npx ecc-install typescript```-复制规则时,请复制整个目录(例如 `rules/common`、`rules/golang`),而不是复制目录内的文件;这样可以保留相对引用,并避免不同规则集中的同名文件互相覆盖。+如需手动安装说明,请查看 `rules/` 文件夹中的 README 文档。手动复制规则文件时,请直接复制**整个语言目录**(例如 `rules/common` 或 `rules/golang`),而非目录内的单个文件,以保证相对路径引用正常、文件名不会冲突。### 第三步:开始使用@@ -126,7 +171,7 @@ cp -r everything-claude-code/rules/perl ~/.claude/rules/## 跨平台支持-此插件现在完全支持 **Windows、macOS 和 Linux**。所有钩子和脚本都已用 Node.js 重写,以实现最大的兼容性。+该插件现已**全面支持 Windows、macOS 和 Linux**,并与主流 IDE(Cursor、OpenCode、Antigravity)及命令行工具深度集成。所有钩子与脚本均已使用 Node.js 重写,以实现最佳兼容性。### 包管理器检测@@ -157,6 +202,18 @@ node scripts/setup-package-manager.js --detect或在 Claude Code 中使用 `/setup-pm` 命令。+### 钩子运行时控制++使用运行时标记调整严格度或临时禁用特定钩子:++```bash+# 钩子严格度配置文件(默认值:standard)+export ECC_HOOK_PROFILE=standard++# 以英文逗号分隔的钩子 ID 列表,用于禁用指定钩子+export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"+```+---## 里面有什么@@ -165,113 +222,198 @@ node scripts/setup-package-manager.js --detect```everything-claude-code/-|-- .claude-plugin/ # 插件和市场清单-| |-- plugin.json # 插件元数据和组件路径-| |-- marketplace.json # /plugin marketplace add 的市场目录+|-- .claude-plugin/ # 插件与应用商店清单+| |-- plugin.json # 插件元数据与组件路径+| |-- marketplace.json # 用于 /plugin marketplace add 的自托管应用商店目录|-|-- agents/ # 用于委托的专业子代理+|-- agents/ # 36 个专用子智能体,用于任务委派| |-- planner.md # 功能实现规划-| |-- architect.md # 系统设计决策+| |-- architect.md # 系统架构设计决策| |-- tdd-guide.md # 测试驱动开发-| |-- code-reviewer.md # 质量和安全审查+| |-- 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 构建错误解决(新增)+| |-- build-error-resolver.md # 构建错误修复+| |-- e2e-runner.md # Playwright 端到端测试+| |-- refactor-cleaner.md # 无效代码清理+| |-- doc-updater.md # 文档同步更新+| |-- docs-lookup.md # 文档 / API 查阅+| |-- chief-of-staff.md # 沟通梳理与文稿起草+| |-- loop-operator.md # 自主循环执行+| |-- harness-optimizer.md # 执行框架配置调优+| |-- cpp-reviewer.md # C++ 代码审查+| |-- cpp-build-resolver.md # C++ 构建错误修复+| |-- go-reviewer.md # Go 代码审查+| |-- go-build-resolver.md # Go 构建错误修复+| |-- python-reviewer.md # Python 代码审查+| |-- database-reviewer.md # 数据库 / Supabase 审查+| |-- typescript-reviewer.md # TypeScript/JavaScript 代码审查+| |-- java-reviewer.md # Java/Spring Boot 代码审查+| |-- java-build-resolver.md # Java/Maven/Gradle 构建错误修复+| |-- kotlin-reviewer.md # Kotlin/Android/KMP 代码审查+| |-- kotlin-build-resolver.md # Kotlin/Gradle 构建错误修复+| |-- rust-reviewer.md # Rust 代码审查+| |-- rust-build-resolver.md # Rust 构建错误修复+| |-- pytorch-build-resolver.md # PyTorch/CUDA 训练错误修复|-|-- skills/ # 工作流定义和领域知识-| |-- coding-standards/ # 语言最佳实践-| |-- backend-patterns/ # API、数据库、缓存模式-| |-- frontend-patterns/ # React、Next.js 模式-| |-- continuous-learning/ # 从会话中自动提取模式(详细指南)-| |-- continuous-learning-v2/ # 基于直觉的学习与置信度评分-| |-- iterative-retrieval/ # 子代理的渐进式上下文细化-| |-- strategic-compact/ # 手动压缩建议(详细指南)-| |-- tdd-workflow/ # TDD 方法论+|-- 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/ # 融资路演 PPT、单页摘要、备忘录与财务模型(新增)+| |-- investor-outreach/ # 定制化融资触达与跟进(新增)+| |-- continuous-learning/ # 从会话中自动提取模式(长文本指南)+| |-- continuous-learning-v2/ # 基于本能的学习,附带置信度评分+| |-- iterative-retrieval/ # 为子智能体渐进式优化上下文+| |-- strategic-compact/ # 手动上下文精简建议(长文本指南)+| |-- tdd-workflow/ # 测试驱动开发方法论| |-- security-review/ # 安全检查清单-| |-- eval-harness/ # 验证循环评估(详细指南)-| |-- verification-loop/ # 持续验证(详细指南)-| |-- golang-patterns/ # Go 惯用语和最佳实践(新增)-| |-- golang-testing/ # Go 测试模式、TDD、基准测试(新增)-| |-- cpp-testing/ # C++ 测试模式、GoogleTest、CMake/CTest(新增)-| |-- perl-patterns/ # 现代 Perl 5.36+ 惯用语和最佳实践(新增)-| |-- perl-security/ # Perl 安全模式、污染模式、安全 I/O(新增)-| |-- perl-testing/ # 使用 Test2::V0、prove、Devel::Cover 的 Perl TDD(新增)+| |-- eval-harness/ # 验证循环评估(长文本指南)+| |-- verification-loop/ # 持续验证机制(长文本指南)+| |-- videodb/ # 音视频采集、检索、编辑、生成与推流(新增)+| |-- golang-patterns/ # Go 语言惯用写法与最佳实践+| |-- golang-testing/ # Go 测试模式、TDD 与基准测试+| |-- cpp-coding-standards/ # 遵循 C++ Core Guidelines 的编码规范(新增)+| |-- cpp-testing/ # 基于 GoogleTest、CMake/CTest 的 C++ 测试(新增)+| |-- django-patterns/ # Django 模式、模型与视图(新增)+| |-- django-security/ # Django 安全最佳实践(新增)+| |-- django-tdd/ # Django TDD 工作流(新增)+| |-- django-verification/ # Django 验证循环(新增)+| |-- laravel-patterns/ # Laravel 架构模式(新增)+| |-- laravel-security/ # Laravel 安全最佳实践(新增)+| |-- laravel-tdd/ # Laravel TDD 工作流(新增)+| |-- laravel-verification/ # Laravel 验证循环(新增)+| |-- python-patterns/ # Python 惯用写法与最佳实践(新增)+| |-- python-testing/ # 基于 pytest 的 Python 测试(新增)+| |-- springboot-patterns/ # Java Spring Boot 模式(新增)+| |-- springboot-security/ # Spring Boot 安全(新增)+| |-- springboot-tdd/ # Spring Boot TDD(新增)+| |-- springboot-verification/ # Spring Boot 验证(新增)+| |-- configure-ecc/ # 交互式安装向导(新增)+| |-- security-scan/ # 集成 AgentShield 安全审计(新增)+| |-- java-coding-standards/ # Java 编码规范(新增)+| |-- jpa-patterns/ # JPA/Hibernate 模式(新增)+| |-- postgres-patterns/ # PostgreSQL 优化模式(新增)+| |-- nutrient-document-processing/ # 基于 Nutrient API 的文档处理(新增)+| |-- docs/examples/project-guidelines-template.md # 项目专属技能模板+| |-- database-migrations/ # 数据库迁移模式(Prisma、Drizzle、Django、Go)(新增)+| |-- api-design/ # REST API 设计、分页、错误响应(新增)+| |-- deployment-patterns/ # CI/CD、Docker、健康检查、回滚(新增)+| |-- docker-patterns/ # Docker Compose、网络、数据卷、容器安全(新增)+| |-- e2e-testing/ # Playwright E2E 模式与页面对象模型(新增)+| |-- content-hash-cache-pattern/ # 用于文件处理的 SHA-256 内容哈希缓存(新增)+| |-- cost-aware-llm-pipeline/ # LLM 成本优化、模型路由、预算跟踪(新增)+| |-- regex-vs-llm-structured-text/ # 文本解析:正则与 LLM 选型决策框架(新增)+| |-- swift-actor-persistence/ # 基于 Actor 的 Swift 线程安全数据持久化(新增)+| |-- swift-protocol-di-testing/ # 基于协议的依赖注入,实现可测试 Swift 代码(新增)+| |-- search-first/ # 先调研再编码工作流(新增)+| |-- skill-stocktake/ # 技能与命令质量审计(新增)+| |-- liquid-glass-design/ # iOS 26 Liquid Glass 设计系统(新增)+| |-- foundation-models-on-device/ # 基于 Apple FoundationModels 的端侧大模型(新增)+| |-- swift-concurrency-6-2/ # Swift 6.2 简洁并发编程(新增)+| |-- perl-patterns/ # 现代 Perl 5.36+ 惯用写法与最佳实践(新增)+| |-- perl-security/ # Perl 安全模式、污点模式、安全 I/O(新增)+| |-- perl-testing/ # 基于 Test2::V0、prove、Devel::Cover 的 Perl TDD(新增)+| |-- autonomous-loops/ # 自主循环模式:顺序流水线、PR 循环、DAG 编排(新增)+| |-- plankton-code-quality/ # 基于 Plankton 钩子的实时代码质量管控(新增)|-|-- commands/ # 用于快速执行的斜杠命令+|-- commands/ # 传统斜杠命令兼容层;优先使用 skills/| |-- tdd.md # /tdd - 测试驱动开发| |-- plan.md # /plan - 实现规划-| |-- e2e.md # /e2e - E2E 测试生成-| |-- code-review.md # /code-review - 质量审查+| |-- e2e.md # /e2e - 生成端到端测试+| |-- code-review.md # /code-review - 代码质量审查| |-- build-fix.md # /build-fix - 修复构建错误-| |-- refactor-clean.md # /refactor-clean - 死代码移除-| |-- learn.md # /learn - 会话中提取模式(详细指南)-| |-- checkpoint.md # /checkpoint - 保存验证状态(详细指南)-| |-- verify.md # /verify - 运行验证循环(详细指南)+| |-- 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 - 将直觉聚类到技能中(新增)+| |-- skill-create.md # /skill-create - 从 Git 历史生成技能(新增)+| |-- instinct-status.md # /instinct-status - 查看已学习本能(新增)+| |-- instinct-import.md # /instinct-import - 导入本能(新增)+| |-- instinct-export.md # /instinct-export - 导出本能(新增)+| |-- evolve.md # /evolve - 将本能聚类为技能+| |-- prune.md # /prune - 删除过期待处理本能(新增)+| |-- pm2.md # /pm2 - PM2 服务生命周期管理(新增)+| |-- multi-plan.md # /multi-plan - 多智能体任务拆解(新增)+| |-- multi-execute.md # /multi-execute - 多智能体工作流编排(新增)+| |-- multi-backend.md # /multi-backend - 后端多服务编排(新增)+| |-- multi-frontend.md # /multi-frontend - 前端多服务编排(新增)+| |-- multi-workflow.md # /multi-workflow - 通用多服务工作流(新增)+| |-- orchestrate.md # /orchestrate - 多智能体协同调度+| |-- sessions.md # /sessions - 会话历史管理+| |-- eval.md # /eval - 按标准评估+| |-- test-coverage.md # /test-coverage - 测试覆盖率分析+| |-- update-docs.md # /update-docs - 更新文档+| |-- update-codemaps.md # /update-codemaps - 更新代码映射+| |-- python-review.md # /python-review - Python 代码审查(新增)|-|-- rules/ # 始终遵循的指南(复制到 ~/.claude/rules/)-| |-- README.md # 结构概述和安装指南-| |-- common/ # 与语言无关的原则-| | |-- coding-style.md # 不可变性、文件组织+|-- rules/ # 必须遵守的规范(复制到 ~/.claude/rules/)+| |-- README.md # 结构概览与安装指南+| |-- common/ # 与语言无关的通用原则+| | |-- coding-style.md # 不可变性、文件组织规范| | |-- git-workflow.md # 提交格式、PR 流程| | |-- testing.md # TDD、80% 覆盖率要求-| | |-- performance.md # 模型选择、上下文管理-| | |-- patterns.md # 设计模式、骨架项目+| | |-- performance.md # 模型选型、上下文管理+| | |-- patterns.md # 设计模式、项目骨架| | |-- hooks.md # 钩子架构、TodoWrite-| | |-- agents.md # 何时委托给子代理-| | |-- security.md # 强制性安全检查-| |-- typescript/ # TypeScript/JavaScript 特定-| |-- python/ # Python 特定-| |-- golang/ # Go 特定-| |-- perl/ # Perl 特定(新增)+| | |-- agents.md # 子智能体委派时机+| | |-- security.md # 强制安全检查+| |-- typescript/ # TypeScript/JavaScript 专属规范+| |-- python/ # Python 专属规范+| |-- golang/ # Go 专属规范+| |-- swift/ # Swift 专属规范+| |-- php/ # PHP 专属规范(新增)|-|-- hooks/ # 基于触发器的自动化-| |-- hooks.json # 所有钩子配置(PreToolUse、PostToolUse、Stop 等)-| |-- memory-persistence/ # 会话生命周期钩子(详细指南)-| |-- strategic-compact/ # 压缩建议(详细指南)+|-- hooks/ # 基于触发器的自动化逻辑+| |-- README.md # 钩子文档、使用示例与自定义指南+| |-- hooks.json # 全部钩子配置(PreToolUse、PostToolUse、Stop 等)+| |-- memory-persistence/ # 会话生命周期钩子(长文本指南)+| |-- strategic-compact/ # 上下文精简建议(长文本指南)||-- scripts/ # 跨平台 Node.js 脚本(新增)-| |-- lib/ # 共享工具-| | |-- utils.js # 跨平台文件/路径/系统工具-| | |-- package-manager.js # 包管理器检测和选择+| |-- lib/ # 通用工具库+| | |-- utils.js # 跨平台文件 / 路径 / 系统工具+| | |-- package-manager.js # 包管理器检测与选择| |-- hooks/ # 钩子实现-| | |-- session-start.js # 会话开始时加载上下文+| | |-- session-start.js # 会话启动时加载上下文| | |-- session-end.js # 会话结束时保存状态-| | |-- pre-compact.js # 压缩前状态保存-| | |-- suggest-compact.js # 战略性压缩建议+| | |-- pre-compact.js # 上下文精简前状态保存+| | |-- suggest-compact.js # 策略性精简建议| | |-- evaluate-session.js # 从会话中提取模式-| |-- setup-package-manager.js # 交互式 PM 设置+| |-- setup-package-manager.js # 交互式包管理器设置||-- tests/ # 测试套件(新增)-| |-- lib/ # 库测试+| |-- lib/ # 工具库测试| |-- hooks/ # 钩子测试-| |-- run-all.js # 运行所有测试+| |-- run-all.js # 运行全部测试|-|-- contexts/ # 动态系统提示注入上下文(详细指南)+|-- contexts/ # 动态注入的系统提示上下文(长文本指南)| |-- dev.md # 开发模式上下文| |-- review.md # 代码审查模式上下文-| |-- research.md # 研究/探索模式上下文+| |-- research.md # 研究 / 探索模式上下文|-|-- examples/ # 示例配置和会话-| |-- CLAUDE.md # 示例项目级配置-| |-- user-CLAUDE.md # 示例用户级配置+|-- examples/ # 配置与会话示例+| |-- CLAUDE.md # 项目级配置示例+| |-- user-CLAUDE.md # 用户级配置示例+| |-- saas-nextjs-CLAUDE.md # 真实 SaaS 项目(Next.js + Supabase + Stripe)+| |-- go-microservice-CLAUDE.md # 真实 Go 微服务(gRPC + PostgreSQL)+| |-- django-api-CLAUDE.md # 真实 Django REST API(DRF + Celery)+| |-- laravel-api-CLAUDE.md # 真实 Laravel API(PostgreSQL + Redis)(新增)+| |-- rust-api-CLAUDE.md # 真实 Rust API(Axum + SQLx + PostgreSQL)(新增)|-|-- mcp-configs/ # MCP 服务器配置-| |-- mcp-servers.json # GitHub、Supabase、Vercel、Railway 等+|-- mcp-configs/ # MCP 服务端配置+| |-- mcp-servers.json # GitHub、Supabase、Vercel、Railway 等配置|-|-- marketplace.json # 自托管市场配置(用于 /plugin marketplace add)+|-- marketplace.json # 自托管应用商店配置(用于 /plugin marketplace add)```---@@ -311,6 +453,36 @@ everything-claude-code/- **直觉集合** - 用于 continuous-learning-v2- **模式提取** - 从你的提交历史中学习+### AgentShield — 安全审计工具++> 于 Claude Code 黑客松(Cerebral Valley x Anthropic,2026 年 2 月)开发完成。包含 1282 项测试、98% 覆盖率、102 条静态分析规则。++扫描你的 Claude Code 配置,检测漏洞、错误配置与注入风险。++```bash+# 快速扫描(无需安装)+npx ecc-agentshield scan++# 自动修复安全问题+npx ecc-agentshield scan --fix++# 调用 3 个 Opus 4.6 智能体进行深度分析+npx ecc-agentshield scan --opus --stream++# 从零生成安全配置+npx ecc-agentshield init+```++**扫描范围:** CLAUDE.md、settings.json、MCP 配置、钩子、智能体定义与技能模块,覆盖 5 大类别 —— 密钥检测(14 种模式)、权限审计、钩子注入分析、MCP 服务风险评估、智能体配置审查。++**`--opus` 参数**:启动 3 个 Claude Opus 4.6 智能体组成红队/蓝队/审计管道。攻击者寻找利用链,防御者评估防护机制,审计者综合生成优先级风险报告。采用对抗推理,而非单纯模式匹配。++**输出格式:** 终端(彩色等级 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)+### 持续学习 v2基于直觉的学习系统自动学习你的模式:@@ -328,6 +500,30 @@ everything-claude-code/---+## 环境要求++### Claude Code 命令行版本+**最低版本:v2.1.0 或更高**++由于插件系统处理钩子的机制发生变更,本插件要求 Claude Code CLI 版本不低于 v2.1.0。++查看当前版本:+```bash+claude --version+```++### 重要提示:钩子自动加载机制+> 警告:**贡献者请注意**:请勿在 `.claude-plugin/plugin.json` 中添加 `"hooks"` 字段。回归测试已强制禁止该操作。++Claude Code v2.1+ 会**按照约定自动加载**已安装插件中的 `hooks/hooks.json`。若在 `plugin.json` 中显式声明该文件,会触发重复检测错误:+```+检测到重复的钩子文件:./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 Code 版本间行为变更导致混淆,现已添加回归测试,防止该问题再次出现。++---+## 安装### 选项 1:作为插件安装(推荐)@@ -368,60 +564,70 @@ everything-claude-code/> # 首先克隆仓库> git clone https://github.com/affaan-m/everything-claude-code.git>-> # 选项 A:用户级规则(应用于所有项目)+> # 方案 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/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/perl ~/.claude/rules/+> cp -r everything-claude-code/rules/php ~/.claude/rules/>-> # 选项 B:项目级规则(仅应用于当前项目)+> # 方案 B:项目级规则(仅对当前项目生效)> 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/perl .claude/rules/+> cp -r everything-claude-code/rules/typescript .claude/rules/ # 选择你使用的技术栈> ```---### 选项 2:手动安装-如果你希望对安装的内容进行手动控制:+如果你希望手动控制安装内容,可按以下步骤操作:```bash# 克隆仓库git clone https://github.com/affaan-m/everything-claude-code.git-# 将代理复制到你的 Claude 配置+# 将智能体文件复制到 Claude 配置目录cp everything-claude-code/agents/*.md ~/.claude/agents/-# 复制规则目录(通用 + 语言特定)+# 复制规则目录(通用规则 + 特定语言规则)mkdir -p ~/.claude/rulescp -r everything-claude-code/rules/common ~/.claude/rules/-cp -r everything-claude-code/rules/typescript ~/.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/perl ~/.claude/rules/+cp -r everything-claude-code/rules/php ~/.claude/rules/-# 复制命令-cp everything-claude-code/commands/*.md ~/.claude/commands/+# 优先复制技能模块(核心工作流)+# 新用户推荐:仅复制核心/通用技能+cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/+cp -r everything-claude-code/skills/search-first ~/.claude/skills/-# 复制技能-cp -r everything-claude-code/skills/* ~/.claude/skills/-```+# 可选:仅在需要时添加细分领域/框架专属技能+# for s in django-patterns django-tdd laravel-patterns springboot-patterns; do+# cp -r everything-claude-code/skills/$s ~/.claude/skills/+# done-#### 将钩子添加到 settings.json+# 可选:迁移期间保留传统斜杠命令兼容+mkdir -p ~/.claude/commands+cp everything-claude-code/commands/*.md ~/.claude/commands/+```-将 `hooks/hooks.json` 中的钩子复制到你的 `~/.claude/settings.json`。+#### 将钩子配置添加到 settings.json+将 `hooks/hooks.json` 中的钩子配置复制到你的 `~/.claude/settings.json` 文件中。-#### 配置 MCP+#### 配置 MCP 服务+从 `mcp-configs/mcp-servers.json` 中复制需要的 MCP 服务定义,粘贴到官方 Claude Code 配置文件 `~/.claude/settings.json` 中;+若需要仓库本地的 MCP 访问权限,可粘贴到项目级配置文件 `.mcp.json` 中。-将所需的 MCP 服务器从 `mcp-configs/mcp-servers.json` 复制到你的 `~/.claude.json`。+如果你已自行运行 ECC 捆绑的 MCP 服务,设置以下环境变量:+```bash+export ECC_DISABLED_MCPS="github,context7,exa,playwright,sequential-thinking,memory"+```+ECC 托管的安装程序和 Codex 同步流程将跳过或移除这些服务,避免重复添加。-**重要:** 将 `YOUR_*_HERE` 占位符替换为你的实际 API 密钥。+**重要提示**:将配置中的 `YOUR_*_HERE` 占位符替换为你真实的 API 密钥。---@@ -515,11 +721,11 @@ node tests/hooks/hooks.test.js### 贡献想法-- 特定语言的技能(Rust、C#、Kotlin、Java)- 现已包含 Go、Python、Perl、Swift 和 TypeScript!-- 特定框架的配置(Django、Rails、Laravel)-- DevOps 代理(Kubernetes、Terraform、AWS)-- 测试策略(不同框架)-- 特定领域的知识(ML、数据工程、移动)+- 特定语言技能(Rust、C#、Kotlin、Java)—— Go、Python、Perl、Swift 和 TypeScript 已内置+- 特定框架配置(Rails、FastAPI)—— Django、NestJS、Spring Boot 和 Laravel 已内置+- DevOps 智能体(Kubernetes、Terraform、AWS、Docker)+- 测试策略(多种测试框架、视觉回归测试)+- 领域专属知识库(机器学习、数据工程、移动端开发)---@@ -554,6 +760,26 @@ node tests/hooks/hooks.test.js---+## 社区项目++基于 Everything Claude Code 构建或受其启发的项目:++| 项目 | 介绍 |+|------|------|+| [EVC](https://github.com/SaigonXIII/evc) | 营销智能体工作区 — 包含 42 条命令,面向内容运营、品牌管控与多渠道发布。[可视化概览](https://saigonxiii.github.io/evc)。 |++如果你用 ECC 做了项目,欢迎提交 PR 添加到这里。++---++## 赞助者++本项目免费开源。赞助支持项目持续维护与功能迭代。++[成为赞助者](https://github.com/sponsors/affaan-m) | [赞助档位](SPONSORS.md) | [赞助计划](SPONSORING.md)++---+## Star 历史[](https://star-history.com/#affaan-m/everything-claude-code&Date)@@ -562,11 +788,10 @@ node tests/hooks/hooks.test.js## 链接-- **精简指南(从这里开始):** [The Shorthand Guide to Everything Claude Code](https://x.com/affaanmustafa/status/2012378465664745795)-- **详细指南(高级):** [The Longform Guide to Everything Claude Code](https://x.com/affaanmustafa/status/2014040193557471352)-- **关注:** [@affaanmustafa](https://x.com/affaanmustafa)-- **zenith.chat:** [zenith.chat](https://zenith.chat)-- **技能目录:** awesome-agent-skills(社区维护的智能体技能目录)+- **快速上手指南(入门首选):** [Everything Claude Code 简明指南](https://x.com/affaanmustafa/status/2012378465664745795)+- **长文指南(高阶进阶):** [Everything Claude Code 完整版深度指南](https://x.com/affaanmustafa/status/2014040193557471352)+- **安全指南:** [安全指南](./the-security-guide.md) | [推文详解](https://x.com/affaanmustafa/status/2033263813387223421)+- **关注作者:** [@affaanmustafa](https://x.com/affaanmustafa)---