荣耀文档
80.56M · 2026-04-14
这是「一天一个开源项目」系列的第 72 篇文章。今天介绍的项目是 everything-claude-code(GitHub)。
如果说 Claude Code 是一台性能强劲的赛车,那大多数开发者只开到了 30% 的油门。everything-claude-code(简称 ECC)是 AI 工程师 Affaan Mustafa 历经 10 个月高强度使用后,将全部实践精华开源的成果——一套由 181 个 Skill、47 个子代理、34 条规则、8 类生命周期钩子构成的 Claude Code 生产级增强系统。
从跨会话记忆持久化到并行 Git Worktree 工作流,从 MCP 工具数量阈值到零宽度字符注入防御,这个项目把 Claude Code 社区中最不广为人知却最有价值的实战技巧,全部系统化地整理成了可直接安装使用的工具包。
150k+ Stars,GitHub Trending 霸榜,社区誉为"正在分裂开发者社区的项目"——这是目前规模最大、最系统化的 Claude Code 增强框架。
/fork + Git Worktrees 同时推进多个任务everything-claude-code 源于 Affaan Mustafa 在 Anthropic 官方黑客马拉松上的获奖作品,经过 10 个月的打磨和社区共建,演变为目前最全面的 Claude Code 增强系统。
它不是一个独立运行的应用,而是叠加在 Claude Code 之上的增强层——安装后,Claude Code 自动获得额外的 Skill、代理、规则和钩子能力,整体工作效率和代码质量得到系统性提升。
同时,ECC 也支持 Cursor、Codex、OpenCode、Gemini CLI 等其他 AI 代码工具,是目前覆盖 AI 代码工具最广的统一增强框架。
1. Skills(技能库)— 181 个
覆盖范围之广令人印象深刻:
| 分类 | 示例技能 |
|---|---|
| 后端开发 | Django、Laravel、Spring Boot、NestJS 框架规范 |
| 前端开发 | React 组件模式、CSS 架构、响应式设计 |
| CI/CD | GitHub Actions 工作流、Docker 构建优化 |
| 多语言规范 | Python、TypeScript、Go、Java、Kotlin、Rust、C++、Swift |
| 内容创作 | 投资人材料、市场研究报告 |
| 媒体处理 | 视频处理流水线 |
2. Agents(子代理)— 47 个
功能最全的 Sub-Agent 体系之一:
3. Rules(规则)— 34 条
包含通用规则和语言专项规则,强制在 Claude 工作过程中执行最佳实践,覆盖:TypeScript、Python、Go、Swift、PHP、Perl、Java、Kotlin、C++、Rust。
4. Hooks(钩子)— 8 类生命周期事件
| 钩子类型 | 触发时机 | 典型用途 |
|---|---|---|
PreToolUse | 工具调用前 | 安全检查、权限验证 |
PostToolUse | 工具调用后 | 结果日志、质量检查 |
UserPromptSubmit | 用户提交消息时 | 输入净化、注入检测 |
Stop | 会话结束时 | 保存记忆、输出摘要 |
PreCompact | 上下文压缩前 | 提取关键信息保存 |
Notification | 任务完成通知 | 外部系统集成 |
SessionStart | 新会话开始时 | 加载历史记忆 |
5. Commands(命令)— 79 个遗留命令
向后兼容的斜杠命令层,逐步向 Skills 迁移,保持现有工作流不中断。
6. MCP 配置
开箱支持主流 MCP 服务器:
# 方式一:脚本安装(推荐)
curl -fsSL | bash
# 选择 profile:
# minimal — 核心规则 + 基础 Hooks
# standard — + Skills + Agents(推荐)
# full — 全量安装(含所有实验性功能)
# 方式二:插件市场(Claude Code 内)
# 在 Claude Code 中搜索 "everything-claude-code"
# 方式三:手动安装(完全控制)
git clone
# 按需复制 .claude/ 目录和各模块
ECC 中最被低估的技术亮点是 PreCompact + Stop + SessionStart 三个钩子的协同设计,实现了 Claude Code 官方文档几乎未涉及的跨会话持久记忆:
会话 A:
用户工作中...
↓
[PreCompact 钩子] 上下文即将压缩
→ 提取并保存关键决策、代码模式、偏好设置到 memory.md
↓
[Stop 钩子] 会话结束
→ 输出会话摘要,追加到长期记忆文件
会话 B(次日):
[SessionStart 钩子] 新会话开始
→ 加载 memory.md,用 --system-prompt 注入
→ Claude 自动"记得"上次的决策和上下文
技术实现关键:
# 在 Claude Code 中动态注入记忆
claude --system-prompt "$(cat ~/.claude/memory.md)" "继续昨天的任务"
# 系统提示的优先级高于用户消息,高于工具结果
# 这是实现持久记忆的核心机制
三个钩子的分工:
ECC 的子代理设计遵循一个关键原则:编排器必须评估子代理返回值并最多循环 3 次追问,而非直接接受汇总结果。
编排器(Lead Agent)
│
├─ 向 Researcher 子代理发出请求
│ ↓
│ [第1轮] 子代理返回初步结果
│ ↓
├─ 评估:结果是否完整、是否有缺口?
│ → 不完整:追加具体问题再次请求
│ ↓
│ [第2轮] 子代理返回补充结果
│ ↓
├─ 再次评估(最多3轮)
│ ↓
└─ 汇总最终结果
这个设计解决了子代理缺乏完整语义上下文时返回浅层结果的问题——3 轮上限防止无限循环,足够的迭代次数保证结果质量。
ECC 提供了一套经过实战验证的模型使用分级策略:
默认使用 Sonnet(相比 Opus 节省 60% 成本)
│
├─ 升级到 Opus 的条件:
│ ├── 任务失败后重试
│ ├── 跨越 5+ 个文件的复杂任务
│ └── 安全关键的代码审查
│
└─ 保持 Sonnet 的场景:
├── 单文件编辑
├── 代码解释和文档
└── 常规问答
关键环境变量配置:
# 限制思考 token 数(平衡质量与成本)
export MAX_THINKING_TOKENS=10000
# 上下文自动压缩阈值(50% 时触发)
export CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=50
MCP 工具数量警告(作者通过大量实验得出的量化阈值):
# 检查当前激活的工具数量
claude mcp list | wc -l
ECC 提供两种并行工作方式,突破"单线程 AI 对话"的瓶颈:
方法一:/fork 命令分支对话
# 当前对话中有两个互不依赖的任务时
/fork "处理 API 接口重构" # 在新分支对话中处理
# 继续在当前对话处理另一个任务
方法二:Git Worktrees 多实例并行
# 为不同功能创建独立 worktree
git worktree add ../feature-auth feature/auth
git worktree add ../feature-ui feature/ui
# 在不同终端中分别启动 Claude Code
# 两个实例同时工作,互不干扰
cd ../feature-auth && claude
cd ../feature-ui && claude
"级联法"任务管理:
←──────────── 扫描完成情况 ────────────→
←── 开始新任务(向右)
[任务A: 完成] [任务B: 进行中] [任务C: 进行中] [任务D: 待开始]
原则:同时维持 3-4 个活跃任务
AgentShield 是 ECC 内置的 AI 代理配置安全扫描工具,包含 1282 个测试用例、102 条静态分析规则:
# 安装独立版本(也可通过 ECC 使用)
pip install agentshield
# 扫描当前 Claude Code 配置
agentshield scan --path .claude/
# 扫描报告示例输出
# 无明文 API 密钥
# [HIGH] Hook 脚本存在命令注入风险(hook-name.sh:23)
# [MEDIUM] MCP 服务器权限过宽(github MCP: 读写所有仓库)
# 无零宽度字符注入
AgentShield 能检测的安全风险:
项目明确收录了真实 CVE 案例:
Claude Code 快捷键(许多开发者不知道):
| 快捷键 | 功能 |
|---|---|
Ctrl+U | 删除整行输入 |
Tab | 切换思维链(CoT)显示 |
Esc Esc | 中断当前任务 / 恢复暂停 |
/rewind | 恢复到前一个状态 |
/checkpoints | 文件级撤销点管理 |
/fork | 分支当前对话 |
token 节省技巧:
# 用 mgrep 替代 grep,减少约 50% token 消耗
# (mgrep 返回更精准的上下文,不会附带大量无关行)
alias grep="mgrep"
the-shortform-guide.md(速查)the-longform-guide.md(深度)the-security-guide.md(安全专项)/fork + Git Worktrees 让 Claude Code 从单线程对话变成多任务并发工厂欢迎来我的个人主页找到更多有用的知识和有趣的产品