everything-claude-code – 来自 Anthropic 黑客马拉松获胜者的完整 Claude Code 配置
来自 Anthropic 黑客马拉松获胜者的完整 Claude Code 配置集合。
生产级代理、技能、钩子、命令、规则和 MCP 配置，经过 10 多个月构建真实产品的密集日常使用而演化。
这个仓库只包含原始代码。指南解释了一切。
主题
你将学到什么：
- 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
# 复制规则目录（通用 + 语言特定）
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/复制规则时，请复制整个目录（例如 rules/common、rules/golang），而不是复制目录内的文件；这样可以保留相对引用，并避免不同规则集中的同名文件互相覆盖。
# 尝试一个命令（插件安装使用命名空间形式）
/everything-claude-code:plan "添加用户认证"
# 手动安装（选项2）使用简短形式：
# /plan "添加用户认证"
# 查看可用命令
/plugin list everything-claude-code@everything-claude-code✨ 完成！ 你现在可以使用 13 个代理、43 个技能和 31 个命令。
多命令支持
⚠️ 上面的基础插件 / rules 安装不包含 multi-* 命令所需的运行时。
如果要使用 /multi-plan、/multi-execute、/multi-backend、/multi-frontend 和 /multi-workflow，还需要额外安装 ccg-workflow 运行时。
可通过 npx ccg-workflow 完成初始化安装。
该运行时会提供这些命令依赖的关键组件，包括：
~/.claude/bin/codeagent-wrapper~/.claude/.ccg/prompts/*
未安装 ccg-workflow 时，这些 multi-* 命令将无法正常运行。
平台兼容性
此插件现在完全支持 Windows、macOS 和 Linux。所有钩子和脚本都已用 Node.js 重写，以实现最大的兼容性。
包管理器自动检测
插件自动检测你首选的包管理器（npm、pnpm、yarn 或 bun），优先级如下：
- 环境变量:
CLAUDE_PACKAGE_MANAGER - 项目配置:
.claude/package-manager.json - package.json:
packageManager字段 - 锁文件: 从
package-lock.json、yarn.lock、pnpm-lock.yaml或bun.lockb检测 - 全局配置:
~/.claude/package-manager.json - 回退: 第一个可用的包管理器
要设置你首选的包管理器：
# 通过环境变量
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、基准测试（新增）
│ ├── 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（新增）
│
├── 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/）
│ ├── README.md # 结构概述和安装指南
│ ├── common/ # 与语言无关的原则
│ │ ├── coding-style.md # 不可变性、文件组织
│ │ ├── git-workflow.md # 提交格式、PR 流程
│ │ ├── testing.md # TDD、80% 覆盖率要求
│ │ ├── performance.md # 模型选择、上下文管理
│ │ ├── patterns.md # 设计模式、骨架项目
│ │ ├── hooks.md # 钩子架构、TodoWrite
│ │ ├── agents.md # 何时委托给子代理
│ │ └── security.md # 强制性安全检查
│ ├── typescript/ # TypeScript/JavaScript 特定
│ ├── python/ # Python 特定
│ ├── golang/ # Go 特定
│ └── perl/ # Perl 特定（新增）
│
├── 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 技能的方法：
方式1：本地分析（无需外部服务）
使用 /skill-create 命令进行本地分析：
/skill-create # 分析当前仓库
/skill-create --instincts # 还为 continuous-learning 生成直觉这在本地分析你的 git 历史并生成 SKILL.md 文件。
方式2：高级功能（10k+ 提交）
用于高级功能（10k+ 提交、自动 PR、团队共享）：
# 在任何问题上评论：
/skill-creator analyze
# 或在推送到默认分支时自动触发两个选项都创建：
- SKILL.md 文件 – 可直接用于 Claude Code 的技能
- 直觉集合 – 用于 continuous-learning-v2
- 模式提取 – 从你的提交历史中学习
基于直觉的学习系统
基于直觉的学习系统自动学习你的模式：
# 查看学习的直觉
/instinct-status # 显示带有置信度的学习直觉
# 导入/导出直觉
/instinct-import <file> # 从他人导入直觉
/instinct-export # 导出你的直觉以供分享
# 进化直觉
/evolve # 将相关直觉聚类到技能中
/promote # 将项目级直觉提升为全局直觉
/projects # 查看已识别项目与直觉统计完整文档见 skills/continuous-learning-v2/。
安装方法
方法1：作为 Claude Code 插件安装（推荐）
使用此仓库的最简单方法 – 作为 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
}
}这让你可以立即访问所有命令、代理、技能和钩子。
方法2：手动安装
⚠️ 注意： Claude Code 插件系统不支持通过插件分发 rules（上游限制）。你需要手动安装规则：
# 首先克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git
# 选项 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/python ~/.claude/rules/
cp -r everything-claude-code/rules/golang ~/.claude/rules/
cp -r everything-claude-code/rules/perl ~/.claude/rules/
# 选项 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/方法3：完全手动控制
如果你希望对安装的内容进行手动控制：
# 克隆仓库
git clone https://github.com/affaan-m/everything-claude-code.git
# 将代理复制到你的 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/python ~/.claude/rules/
cp -r everything-claude-code/rules/golang ~/.claude/rules/
cp -r everything-claude-code/rules/perl ~/.claude/rules/
# 复制命令
cp everything-claude-code/commands/*.md ~/.claude/commands/
# 复制技能
cp -r everything-claude-code/skills/* ~/.claude/skills/将 hooks/hooks.json 中的钩子复制到你的 ~/.claude/settings.json。
将所需的 MCP 服务器从 mcp-configs/mcp-servers.json 复制到你的 ~/.claude.json。
重要： 将
YOUR_*_HERE占位符替换为你的实际 API 密钥。
组件说明
子代理
子代理以有限范围处理委托的任务。
示例：
---
name: code-reviewer
description: 审查代码的质量、安全性和可维护性
tools: ["Read", "Grep", "Glob", "Bash"]
model: opus
---
你是一名高级代码审查员...技能
技能是由命令或代理调用的工作流定义。
示例 – TDD 工作流：
- 首先定义接口
- 编写失败的测试（RED）
- 实现最少的代码（GREEN）
- 重构（IMPROVE）
- 验证 80%+ 的覆盖率
钩子
钩子在工具事件时触发。
示例 – 警告 console.log：
{
"matcher": "tool == "Edit" && tool_input.file_path matches "\.(ts|tsx|js|jsx)$"",
"hooks": [{
"type": "command",
"command": "#!/bin/bashngrep -n 'console\.log' "$file_path" && echo '[Hook] 移除 console.log' >&2"
}]
}规则
规则是始终遵循的指南，分为 common/（通用）+ 语言特定目录：
~/.claude/rules/
├── common/ # 通用原则（必装）
├── typescript/ # TS/JS 特定模式和工具
├── python/ # Python 特定模式和工具
├── golang/ # Go 特定模式和工具
└── perl/ # Perl 特定模式和工具测试套件
插件包含一个全面的测试套件：
# 运行所有测试
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 了解指南。
欢迎贡献的领域：
- 特定语言的技能（Rust、C#、Kotlin、Java）- 现已包含 Go、Python、Perl、Swift 和 TypeScript！
- 特定框架的配置（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 来禁用未使用的。
这些配置适用于我的工作流。你应该：
- 从适合你的开始
- 为你的技术栈进行修改
- 删除你不使用的
- 添加你自己的模式
相关资源
- 精简指南（从这里开始）： The Shorthand Guide to Everything Claude Code
- 详细指南（高级）： The Longform Guide to Everything Claude Code
- 关注： @affaanmustafa
- zenith.chat： zenith.chat
- 技能目录： awesome-agent-skills（社区维护的智能体技能目录）
许可证
MIT – 自由使用，根据需要修改，如果可以请回馈。
如果这个仓库有帮助，请给它一个 Star。阅读两个指南。构建一些很棒的东西。
原文来源：https://github.com/affaan-m/everything-claude-code/blob/main/README.zh-CN.md
© 版权声明
文章版权归作者所有，未经允许请勿转载。
THE END
暂无评论内容