1. 引言

🚀 本文整理自 Anthropic 黑客马拉松获胜者的完整 Claude Code 配置合集


源码地址:https://github.com/affaan-m/everything-claude-code

博主之前整理过ClaudeCode相关的笔记,有兴趣的同学可以阅读:

之前写的内容缺少实战,而 everything-claude-code 是一个在 真实生产环境中持续打磨 10+ 个月的 Claude Code 插件仓库,值得我们去参考,该仓库涵盖了:

  • 生产级 Agent 设计
  • 高复用 Skill 工作流
  • 自动化 Hook(钩子)
  • 常用 Slash Command
  • 强约束 Rules(规则)
  • 以及完整的 MCP Server 配置

本仓库只包含原始配置和代码,但官方指南几乎解释了一切,非常适合进阶 Claude Code 用户参考和直接上手,阅读该仓库,可以学习到:

模块 核心内容
Token 优化 模型选择、系统提示压缩、后台任务拆分
内存持久化 自动跨会话保存 / 加载上下文
持续学习 从对话中自动抽取可复用模式
验证循环 checkpoint、持续评估、pass@k
并行化 Git worktrees、级联 Agent
子代理编排 上下文拆解、迭代检索

2. 快速开始

在 2 分钟内快速上手:

第一步:安装插件

# 添加市场
/plugin marketplace add affaan-m/everything-claude-code

# 安装插件
/plugin install everything-claude-code@everything-claude-code

安装成功提示如下:
在这里插入图片描述

注意:需要重新启动 claude

第二步:安装规则(必需)

⚠️ 重要提示: Claude Code 插件无法自动分发 rules,需要手动安装:

# 首先克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git

# 创建rule目录
mkdir -p ~/.claude/rules/

# 复制规则(应用于所有项目)
cp -r everything-claude-code/rules/* ~/.claude/rules/

第三步:开始使用

# 查看是否安装marketplace
/plugin

在这里插入图片描述

完成! 现在可以使用 15+ 代理、30+ 技能和 20+ 命令。


3. 仓库分析

此仓库现在完全支持 Windows、macOS 和 Linux,所有钩子和脚本都已用 Node.js 重写,以实现最大的兼容性,会自动检测首选的包管理器(npm、pnpm、yarn 或 bun),优先级如下:

  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. 回退: 第一个可用的包管理器

3.1 仓库包含的内容

在这里插入图片描述

everything-claude-code 仓库是一个 Claude Code 插件 - 直接安装或手动复制组件,以下是仓库的目录结构内容:

everything-claude-code/
|-- .claude-plugin/   # 插件和市场清单
|   |-- plugin.json         # 插件元数据和组件路径
|   |-- marketplace.json    # /plugin marketplace add 的市场目录
|
|-- agents/           # 用于委托的专业子代理
|   |-- planner.md           # 功能实现规划
|   |-- architect.md         # 系统设计决策
|   |-- tdd-guide.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 构建错误解决(新增)
|
|-- skills/           # 工作流定义和领域知识
|   |-- coding-standards/           # 语言最佳实践
|   |-- backend-patterns/           # API、数据库、缓存模式
|   |-- frontend-patterns/          # React、Next.js 模式
|   |-- continuous-learning/        # 从会话中自动提取模式(详细指南)
|   |-- continuous-learning-v2/     # 基于直觉的学习与置信度评分
|   |-- iterative-retrieval/        # 子代理的渐进式上下文细化
|   |-- strategic-compact/          # 手动压缩建议(详细指南)
|   |-- tdd-workflow/               # TDD 方法论
|   |-- security-review/            # 安全检查清单
|   |-- eval-harness/               # 验证循环评估(详细指南)
|   |-- verification-loop/          # 持续验证(详细指南)
|   |-- golang-patterns/            # Go 惯用语和最佳实践(新增)
|   |-- golang-testing/             # Go 测试模式、TDD、基准测试(新增)
|
|-- commands/         # 用于快速执行的斜杠命令
|   |-- tdd.md              # /tdd - 测试驱动开发
|   |-- plan.md             # /plan - 实现规划
|   |-- e2e.md              # /e2e - 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 - 运行验证循环(详细指南)
|   |-- 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 - 将直觉聚类到技能中(新增)
|
|-- rules/            # 始终遵循的指南(复制到 ~/.claude/rules/)
|   |-- security.md         # 强制性安全检查
|   |-- coding-style.md     # 不可变性、文件组织
|   |-- testing.md          # TDD、80% 覆盖率要求
|   |-- git-workflow.md     # 提交格式、PR 流程
|   |-- agents.md           # 何时委托给子代理
|   |-- performance.md      # 模型选择、上下文管理
|
|-- hooks/            # 基于触发器的自动化
|   |-- hooks.json                # 所有钩子配置(PreToolUse、PostToolUse、Stop 等)
|   |-- memory-persistence/       # 会话生命周期钩子(详细指南)
|   |-- strategic-compact/        # 压缩建议(详细指南)
|
|-- scripts/          # 跨平台 Node.js 脚本(新增)
|   |-- lib/                     # 共享工具
|   |   |-- utils.js             # 跨平台文件/路径/系统工具
|   |   |-- package-manager.js   # 包管理器检测和选择
|   |-- hooks/                   # 钩子实现
|   |   |-- session-start.js     # 会话开始时加载上下文
|   |   |-- session-end.js       # 会话结束时保存状态
|   |   |-- pre-compact.js       # 压缩前状态保存
|   |   |-- suggest-compact.js   # 战略性压缩建议
|   |   |-- evaluate-session.js  # 从会话中提取模式
|   |-- setup-package-manager.js # 交互式 PM 设置
|
|-- tests/            # 测试套件(新增)
|   |-- lib/                     # 库测试
|   |-- hooks/                   # 钩子测试
|   |-- run-all.js               # 运行所有测试
|
|-- contexts/         # 动态系统提示注入上下文(详细指南)
|   |-- dev.md              # 开发模式上下文
|   |-- review.md           # 代码审查模式上下文
|   |-- research.md         # 研究/探索模式上下文
|
|-- examples/         # 示例配置和会话
|   |-- CLAUDE.md           # 示例项目级配置
|   |-- user-CLAUDE.md      # 示例用户级配置
|
|-- mcp-configs/      # MCP 服务器配置
|   |-- mcp-servers.json    # GitHub、Supabase、Vercel、Railway 等
|
|-- marketplace.json  # 自托管市场配置(用于 /plugin marketplace add)

3.2 关键概念

3.3 代理

子代理以有限范围处理委托的任务。示例:

---
name: code-reviewer
description: 审查代码的质量、安全性和可维护性
tools: ["Read", "Grep", "Glob", "Bash"]
model: opus
---

你是一名高级代码审查员...

3.4 技能

技能是由命令或代理调用的工作流定义:

# TDD 工作流

1. 首先定义接口
2. 编写失败的测试(RED)
3. 实现最少的代码(GREEN)
4. 重构(IMPROVE)
5. 验证 80%+ 的覆盖率

3.5 钩子

钩子在工具事件时触发。示例 - 警告 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] 移除 console.log' >&2"
  }]
}

3.6 规则

规则是始终遵循的指南。保持模块化:

~/.claude/rules/
  security.md      # 无硬编码秘密
  coding-style.md  # 不可变性、文件限制
  testing.md       # TDD、覆盖率要求

5.文末

Everything Claude Code 并不是一个即装即用的工具集,而是一套经过长期真实项目验证的 Claude Code 工程化方法论模板。 建议先阅读精简与长文指南建立整体认知,再结合自身项目按需裁剪 Agent、Rules 和 Workflow,哪怕只吸收其中一小部分,也能显著提升 Claude 在真实开发场景中的稳定性、可控性与复用价值。后续博主会对每一个模块进行中文解析,以便大家去理解。

附相关指南:

Logo

助力广东及东莞地区开发者,代码托管、在线学习与竞赛、技术交流与分享、资源共享、职业发展,成为松山湖开发者首选的工作与学习平台

更多推荐