Everything Claude Code#


来自 Anthropic 黑客马拉松获胜者的完整 Claude Code 配置集合。

生产级代理、技能、钩子、命令、规则和 MCP 配置,经过 10 多个月构建真实产品的密集日常使用而演化。

https://github.com/affaan-m/everything-claude-code


指南#

这个仓库只包含原始代码。指南解释了一切。

The Shorthand Guide to Everything Claude CodeThe Longform Guide to Everything Claude Code
精简指南
设置、基础、理念。先读这个。
详细指南
Token 优化、内存持久化、评估、并行化。
主题你将学到什么
Token 优化模型选择、系统提示精简、后台进程
内存持久化自动跨会话保存/加载上下文的钩子
持续学习从会话中自动提取模式到可重用的技能
验证循环检查点 vs 持续评估、评分器类型、pass@k 指标
并行化Git worktrees、级联方法、何时扩展实例
子代理编排上下文问题、迭代检索模式

🚀 快速开始#

在 2 分钟内快速上手:

第一步:安装插件#

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

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

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

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

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

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

第三步:开始使用#

# 尝试一个命令
/plan "添加用户认证"

# 查看可用命令
/plugin list everything-claude-code@everything-claude-code

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


🌐 跨平台支持#

此插件现在完全支持 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. 回退: 第一个可用的包管理器

要设置你首选的包管理器:

# 通过环境变量
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.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)

🛠️ 生态系统工具#

技能创建器#

两种从你的仓库生成 Claude Code 技能的方法:

选项 A:本地分析(内置)#

使用 /skill-create 命令进行本地分析,无需外部服务:

/skill-create                    # 分析当前仓库
/skill-create --instincts        # 还为 continuous-learning 生成直觉

这在本地分析你的 git 历史并生成 SKILL.md 文件。

选项 B:GitHub 应用(高级)#

用于高级功能(10k+ 提交、自动 PR、团队共享):

安装 GitHub 应用 | ecc.tools

# 在任何问题上评论:
/skill-creator analyze

# 或在推送到默认分支时自动触发

两个选项都创建:

  • SKILL.md 文件 - 可直接用于 Claude Code 的技能
  • 直觉集合 - 用于 continuous-learning-v2
  • 模式提取 - 从你的提交历史中学习

🧠 持续学习 v2#

基于直觉的学习系统自动学习你的模式:

/instinct-status        # 显示带有置信度的学习直觉
/instinct-import <file> # 从他人导入直觉
/instinct-export        # 导出你的直觉以供分享
/evolve                 # 将相关直觉聚类到技能中

完整文档见 skills/continuous-learning-v2/


📥 安装#

选项 1:作为插件安装(推荐)#

使用此仓库的最简单方法 - 作为 Claude Code 插件安装:

# 将此仓库添加为市场
/plugin marketplace add affaan-m/everything-claude-code

# 安装插件
/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
  }
}

这让你可以立即访问所有命令、代理、技能和钩子。

注意: Claude Code 插件系统不支持通过插件分发 rules上游限制 )。你需要手动安装规则:

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

# 选项 A:用户级规则(应用于所有项目)
cp -r everything-claude-code/rules/* ~/.claude/rules/

# 选项 B:项目级规则(仅应用于当前项目)
mkdir -p .claude/rules
cp -r everything-claude-code/rules/* .claude/rules/

🔧 选项 2:手动安装#

如果你希望对安装的内容进行手动控制:

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

# 将代理复制到你的 Claude 配置
cp everything-claude-code/agents/*.md ~/.claude/agents/

# 复制规则
cp everything-claude-code/rules/*.md ~/.claude/rules/

# 复制命令
cp everything-claude-code/commands/*.md ~/.claude/commands/

# 复制技能
cp -r everything-claude-code/skills/* ~/.claude/skills/

将钩子添加到 settings.json#

hooks/hooks.json 中的钩子复制到你的 ~/.claude/settings.json

配置 MCP#

将所需的 MCP 服务器从 mcp-configs/mcp-servers.json 复制到你的 ~/.claude.json

重要:YOUR_*_HERE 占位符替换为你的实际 API 密钥。


🎯 关键概念#

代理#

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

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

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

技能#

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

# TDD 工作流

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

钩子#

钩子在工具事件时触发。示例 - 警告 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"
  }]
}

规则#

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

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

🧪 运行测试#

插件包含一个全面的测试套件:

# 运行所有测试
node tests/run-all.js

# 运行单个测试文件
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js

🤝 贡献#

欢迎并鼓励贡献。

这个仓库旨在成为社区资源。如果你有:

  • 有用的代理或技能
  • 聪明的钩子
  • 更好的 MCP 配置
  • 改进的规则

请贡献!请参阅 CONTRIBUTING.md 了解指南。

贡献想法#

  • 特定语言的技能(Python、Rust 模式)- 现已包含 Go!
  • 特定框架的配置(Django、Rails、Laravel)
  • DevOps 代理(Kubernetes、Terraform、AWS)
  • 测试策略(不同框架)
  • 特定领域的知识(ML、数据工程、移动)

📖 背景#

自实验性推出以来,我一直在使用 Claude Code。2025 年 9 月,与 @DRodriguezFX 一起使用 Claude Code 构建 zenith.chat ,赢得了 Anthropic x Forum Ventures 黑客马拉松。

这些配置在多个生产应用中经过了实战测试。


⚠️ 重要说明#

上下文窗口管理#

关键: 不要一次启用所有 MCP。如果启用了太多工具,你的 200k 上下文窗口可能会缩小到 70k。

经验法则:

  • 配置 20-30 个 MCP
  • 每个项目保持启用少于 10 个
  • 活动工具少于 80 个

在项目配置中使用 disabledMcpServers 来禁用未使用的。

定制化#

这些配置适用于我的工作流。你应该:

  1. 从适合你的开始
  2. 为你的技术栈进行修改
  3. 删除你不使用的
  4. 添加你自己的模式

🔗 链接#