mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-04-07 09:43:30 +08:00
docs: Enhance README.zh-CN.md with badges and instructions (#1291)
* docs: Enhance README.zh-CN.md with badges and instructions Updated README.zh-CN.md to include additional badges, improved descriptions, and added new sections for installation and usage instructions. * Update README.zh-CN.md Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com> * Update README.zh-CN.md Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com> * Update security guide link in README.zh-CN.md --------- Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
This commit is contained in:
Alex
463
README.zh-CN.md
463
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
|
||||
```
|
||||
|
||||
复制规则时，请复制整个目录（例如 `rules/common`、`rules/golang`），而不是复制目录内的文件；这样可以保留相对引用，并避免不同规则集中的同名文件互相覆盖。
|
||||
```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/` 文件夹中的 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/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/
|
||||
|
||||
# 复制命令
|
||||
# 优先复制技能模块（核心工作流）
|
||||
# 新用户推荐：仅复制核心/通用技能
|
||||
cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/
|
||||
cp -r everything-claude-code/skills/search-first ~/.claude/skills/
|
||||
|
||||
# 可选：仅在需要时添加细分领域/框架专属技能
|
||||
# for s in django-patterns django-tdd laravel-patterns springboot-patterns; do
|
||||
# cp -r everything-claude-code/skills/$s ~/.claude/skills/
|
||||
# done
|
||||
|
||||
# 可选：迁移期间保留传统斜杠命令兼容
|
||||
mkdir -p ~/.claude/commands
|
||||
cp everything-claude-code/commands/*.md ~/.claude/commands/
|
||||
|
||||
# 复制技能
|
||||
cp -r everything-claude-code/skills/* ~/.claude/skills/
|
||||
```
|
||||
|
||||
#### 将钩子添加到 settings.json
|
||||
#### 将钩子配置添加到 settings.json
|
||||
将 `hooks/hooks.json` 中的钩子配置复制到你的 `~/.claude/settings.json` 文件中。
|
||||
|
||||
将 `hooks/hooks.json` 中的钩子复制到你的 `~/.claude/settings.json`。
|
||||
#### 配置 MCP 服务
|
||||
从 `mcp-configs/mcp-servers.json` 中复制需要的 MCP 服务定义，粘贴到官方 Claude Code 配置文件 `~/.claude/settings.json` 中；
|
||||
若需要仓库本地的 MCP 访问权限，可粘贴到项目级配置文件 `.mcp.json` 中。
|
||||
|
||||
#### 配置 MCP
|
||||
如果你已自行运行 ECC 捆绑的 MCP 服务，设置以下环境变量：
|
||||
```bash
|
||||
export ECC_DISABLED_MCPS="github,context7,exa,playwright,sequential-thinking,memory"
|
||||
```
|
||||
ECC 托管的安装程序和 Codex 同步流程将跳过或移除这些服务，避免重复添加。
|
||||
|
||||
将所需的 MCP 服务器从 `mcp-configs/mcp-servers.json` 复制到你的 `~/.claude.json`。
|
||||
|
||||
**重要：** 将 `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)
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user