mirror of
https://github.com/sweetwisdom/everything-claude-code-zh.git
synced 2026-03-21 22:10:09 +00:00
Everything Claude Code
来自 Anthropic 黑客松获胜者的 Claude Code 配置全集。
包含生产级的智能体（Agents）、技能（Skills）、钩子（Hooks）、命令（Commands）、规则（Rules）以及 MCP 配置。这些配置源自 10 个多月在构建真实产品过程中的高强度日常使用与演进。
指南文档
本仓库仅包含原始代码。以下指南将详细解释一切：
|
|
|
| 简明指南 (Shorthand Guide) 安装、基础、哲学。请先阅读此篇。 |
深度指南 (Longform Guide) Token 优化、记忆持久化、评测（Evals）、并行化。 |
| 主题 | 你将学到 |
|---|---|
| Token 优化 | 模型选择、系统提示词精简、后台进程 |
| 记忆持久化 | 跨会话自动保存/加载上下文的钩子（Hooks） |
| 持续学习 | 从会话中自动提取模式并转化为可重用的技能（Skills） |
| 验证循环 | 检查点（Checkpoint）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 "Add user authentication"
# 查看可用命令
/plugin list everything-claude-code@everything-claude-code
✨ 大功告成！ 你现在可以使用 15+ 个智能体、30+ 个技能和 20+ 个命令了。
🌐 跨平台支持
该插件现已全面支持 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/ # 用于任务委派的专业化子智能体（Subagents）
| |-- planner.md # 功能实现规划
| |-- architect.md # 系统设计决策
| |-- tdd-guide.md # 测试驱动开发（TDD）
| |-- 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/ # 基于“直觉（Instinct）”的学习，带有置信度评分
| |-- 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 # 交互式包管理器设置
|
|-- 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）
🛠️ 生态工具
技能创建器（Skill Creator）
有两种方式可以从你的仓库生成 Claude Code 技能：
选项 A：本地分析（内置）
使用 /skill-create 命令进行本地分析，无需外部服务：
/skill-create # 分析当前仓库
/skill-create --instincts # 同时为持续学习生成“直觉（Instincts）”
这会在本地分析你的 Git 历史并生成 SKILL.md 文件。
选项 B：GitHub App（高级版）
适用于高级功能（10k+ 提交、自动 PR、团队共享）：
# 在任何 Issue 下回复：
/skill-creator analyze
# 或在推送到默认分支时自动触发
两种选项都会创建：
- SKILL.md 文件 - 可直接用于 Claude Code 的技能
- 直觉集合 (Instinct collections) - 用于 continuous-learning-v2
- 模式提取 - 从你的提交历史中学习
🧠 持续学习 v2 (Continuous Learning v2)
基于“直觉（Instinct）”的学习系统会自动学习你的模式：
/instinct-status # 显示已学习的直觉及其置信度
/instinct-import <file> # 导入他人的直觉
/instinct-export # 导出你的直觉以便共享
/evolve # 将相关的直觉聚类为技能
详见 skills/continuous-learning-v2/ 完整文档。
📋 运行要求
Claude Code CLI 版本
最低版本：v2.1.0 或更高
由于插件系统处理钩子（Hooks）方式的变更，此插件需要 Claude Code CLI v2.1.0+。
检查你的版本：
claude --version
重要：钩子自动加载行为
⚠️ 致贡献者： 请勿在
.claude-plugin/plugin.json中添加"hooks"字段。这是通过回归测试强制执行的。
按照约定，Claude Code v2.1+ 会自动加载任何已安装插件中的 hooks/hooks.json。如果在 plugin.json 中显式声明，会导致重复检测错误：
Duplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file
历史背景： 此问题在本仓库中引发了多次修复/回滚循环（#29, #52, #103）。由于 Claude Code 版本间的行为变更导致了混淆，我们现在通过回归测试来防止此问题再次引入。
📥 安装
选项 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
# 将智能体（Agents）复制到你的 Claude 配置中
cp everything-claude-code/agents/*.md ~/.claude/agents/
# 复制规则（Rules）
cp everything-claude-code/rules/*.md ~/.claude/rules/
# 复制命令（Commands）
cp everything-claude-code/commands/*.md ~/.claude/commands/
# 复制技能（Skills）
cp -r everything-claude-code/skills/* ~/.claude/skills/
将钩子（Hooks）添加到 settings.json
将 hooks/hooks.json 中的钩子内容复制到你的 ~/.claude/settings.json。
配置 MCP
将 mcp-configs/mcp-servers.json 中所需的 MCP 服务器配置复制到你的 ~/.claude.json。
重要提示： 请将 YOUR_*_HERE 占位符替换为你真实的 API 密钥。
🎯 核心概念
智能体 (Agents)
子智能体（Subagents）负责处理具有特定范围的委派任务。示例：
---
name: code-reviewer
description: 审查代码的质量、安全性和可维护性
tools: ["Read", "Grep", "Glob", "Bash"]
model: opus
---
你是一名资深代码审查员...
技能 (Skills)
技能是可被命令或智能体调用的工作流定义：
# TDD 工作流
1. 首先定义接口
2. 编写失败的测试 (RED)
3. 实现最简代码 (GREEN)
4. 重构 (IMPROVE)
5. 验证 80%+ 的覆盖率
钩子 (Hooks)
钩子在工具事件发生时触发。示例 —— 警告 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] Remove console.log' >&2"
}]
}
规则 (Rules)
规则是必须始终遵循的指南。请保持其模块化：
~/.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）
- 测试策略（不同框架）
- 领域特定知识（机器学习、数据工程、移动端）
📖 项目背景
自 Claude Code 实验阶段起我就一直在使用它。2025 年 9 月，我与 @DRodriguezFX 凭借 zenith.chat 赢得了 Anthropic x Forum Ventures 黑客松 —— 该项目完全使用 Claude Code 构建。
这些配置在多个生产级应用中经过了实战测试。
⚠️ 重要说明
上下文窗口管理 (Context Window Management)
至关重要： 不要同时启用所有 MCP。过多的工具会导致 200k 的上下文窗口缩减至 70k。
经验法则：
- 配置 20-30 个 MCP
- 每个项目保持启用 10 个以下
- 活跃工具总数保持在 80 个以下
使用项目配置中的 disabledMcpServers 来禁用不常用的服务器。
自定义
这些配置适用于我的工作流。你应该：
- 从引起你共鸣的部分开始
- 根据你的技术栈进行修改
- 移除你不需要的部分
- 添加你自己的模式
🌟 Star 历史
🔗 相关链接
- 简明指南 (从这里开始)： Everything Claude Code 简明指南
- 深度指南 (进阶必读)： Everything Claude Code 深度指南
- 关注我： @affaanmustafa
- zenith.chat: zenith.chat
📄 开源协议
MIT - 自由使用、按需修改，如能回馈社区不胜感激。
如果此仓库对你有帮助，请点亮 Star。阅读两篇指南。去构建伟大的产品吧。