前言：在这个 AI 编程工具狂飙突进的年代，如果你还在用“裸奔”的 AI 写代码，那你可能正在错过一场生产力的核聚变。今天，莫潇羽@无忆研习社 要带大家深入拆解一个刚刚开源就火遍全球的 GitHub 项目——everything-claude-code。这不是一个简单的配置文件，它是一套完整的“AI 研发军团”架构。它能让你的 Claude 从一个只会写 Hello World 的实习生，瞬间进化成拥有架构师、安全专家、测试工程师等多重身份的资深研发团队。
很多人问我：“莫站长，为什么我的 AI 写出来的代码总是没法用？”答案很简单：你把法拉利当拖拉机开了。今天，无忆研习社 将剥离所有营销话术，用最硬核的技术视角，手把手教你如何部署和驾驭这套神级配置。
🧐 第一章：为什么你的 AI 像个实习生？—— 揭秘 Context 与 Configuration 的魔力
在 无忆研习社 (www.wuyi.wiki) 的技术社群里，每天都有几百条关于 AI 编程的讨论。我发现了一个非常有趣的现象：两极分化严重。
一部分人惊呼“AI 已经取代了我 80% 的工作”，而另一部分人则在抱怨“改 AI 的 Bug 比我自己写还累”。
为什么会有这么大的差距？
经过深入研究，莫潇羽 发现，问题的核心不在于你用的是 GPT-5 还是 Claude 4.5 Sonnet，而在于你是否给 AI 构建了一个“全知全能的上下文环境” (Omniscient Context)。
1.1 “裸奔”的代价
大多数人使用 Claude Code 或 Cursor 时，都是“开箱即用”。这就像你招了一个哈佛毕业的天才（Claude 4.5 Sonnet），却把他扔在一个没有电脑、没有文档、没有流程规范的空房间里。
- 他不知道你的项目是用 React 16 还是 18。
- 他不知道你的数据库密码是存在
.env还是config.js。 - 他不知道你的团队禁止使用
var，必须用const。
在缺乏这些“隐性知识”的情况下，他虽然聪明，但只能凭空猜测。于是，你得到了一堆：
- 幻觉代码：引用了不存在的库。
- 风格冲突：你用 Tab 缩进，他用空格。
- 安全漏洞：直接把 API Key 写死在代码里。
1.2 Everything Claude Code：给天才配上顶级办公室
而 everything-claude-code 这个项目（来自一位 Anthropic 黑客松获奖者 affaan-m），就是给这位天才配备了一间顶级的办公室。它不仅仅是几个 Prompt，它是一套精密的工程化体系。
它提供了：
- 角色分工 (Role Specialization)：不再是一个通用的“助手”，而是 9 个专才。
- 记忆外挂 (External Memory)：通过文件系统持久化存储对话上下文。
- 肌肉记忆 (Skill Library)：预设了 20+ 种标准动作，如 TDD、Code Review。
- 条件反射 (Hooks)：自动拦截危险操作，自动触发必要检查。
接下来，莫潇羽 将带你一层层剥开这个项目的核心原理，看看它是如何把 AI 武装到牙齿的。
🛠️ 第二章：核心架构拆解 —— 不仅仅是 Prompt
everything-claude-code 的核心价值在于它重新定义了 AI 与 IDE 的交互方式。它不仅仅是一堆 Prompt 的集合，而是一个基于 MCP (Model Context Protocol) 和 Claude Code Plugin System 的微型操作系统。
2.1 项目结构透视
当你把这个项目克隆下来（或者通过插件安装）后，你会看到这样一个结构。每一个文件夹都代表了 AI 的一种“超能力”。建议大家在阅读时，对照自己的文件目录看一看。
everything-claude-code/
├── .claude-plugin/ # 插件元数据，定义了它如何接入 Claude
├── agents/ # 【大脑皮层】9 个专业分工的子智能体
│ ├── architect.md # 架构师：负责系统设计
│ ├── code-reviewer.md # 审查官：负责质量把关
│ ├── security-reviewer.md # 安全员：负责漏洞挖掘
│ ├── planner.md # 规划师：负责拆解需求
│ ├── tdd-guide.md # 测试导师：负责 TDD 流程
│ └── ...
├── skills/ # 【肌肉记忆】可复用的工作流
│ ├── tdd-workflow/ # 测试驱动开发流程
│ ├── security-review/ # 安全检查清单
│ ├── coding-standards/ # 代码规范库
│ └── ...
├── commands/ # 【快捷指令】一键调用的技能
│ ├── /plan # 自动生成实施计划
│ ├── /code-review # 自动发起代码审查
│ ├── /learn # 学习当前会话模式
│ └── ...
├── rules/ # 【行为准则】AI 必须遵守的铁律
│ ├── security.md # 安全红线
│ ├── agents.md # 什么时候该叫哪个 Agent
│ └── coding-style.md # 代码风格规范
├── hooks/ # 【神经反射】自动触发的动作
│ └── hooks.json # 例如：git push 前自动运行测试
└── scripts/ # 【肢体工具】跨平台的 Node.js 脚本这套结构的设计非常精妙。它把“怎么写代码”这件事，拆解成了角色 (Agents)、能力 (Skills)、指令 (Commands) 和 约束 (Rules) 四个维度。
2.2 运行机制：Agent 是如何接管工作的？
当你在 Claude Code 的对话框里输入 /plan 时，背后发生了一连串复杂的化学反应：
- 指令解析：系统识别出
/plan指令，映射到commands/plan.md。 - 上下文加载：系统自动加载
agents/planner.md中的 Prompt，将当前 AI 的人格切换为“规划师”。 - 工具调用：Planner Agent 开始调用
ls(列出文件)、grep(搜索代码) 等工具来感知项目现状。 - 记忆读取：如果之前有过类似的规划，它会从 Memory Bank 中读取历史经验。
- 输出结果：最终生成一份 Markdown 格式的实施文档。
这就是 无忆研习社 一直强调的“Agentic Workflow”（智能体工作流）。
🤖 第三章：九大 Agent 深度解析 —— 打造你的私人研发军团
这个项目最震撼的地方，在于它预设了 9 个高度专业化的 Agent。当你输入指令时，Claude 不再是一个人在战斗，而是会自动根据任务类型，切换不同的“人格面具”和工具集。
为了让大家真正理解这些 Agent 的强大，莫潇羽 决定花大篇幅，逐一剖析它们的人设原理、工作方式以及实战案例。
3.1 The Planner (规划师) 🧠 —— 谋定而后动
【角色定位】
Planner 是整个团队的大脑。在写任何一行代码之前，它必须先介入。它的存在就是为了解决 AI “走一步看一步”的坏毛病。
【Prompt 核心逻辑】
在 agents/planner.md 中，作者赋予了它极高的权限和视野。它被禁止直接修改代码，它的唯一产出就是文档。
"You are a Senior Technical Product Manager and Architect. Your goal is to break down complex requirements into small, actionable steps. DO NOT write code. DO write plans."
【实战演示】
假设你要给一个老旧的博客系统增加“付费阅读”功能。
- 用户输入：
/plan 增加文章付费墙功能，只有 VIP 用户能看全文。 - Planner 思考过程：
- 搜索：先看数据库 Schema，发现
users表里没有is_vip字段。 - 搜索：看
posts表，需要增加is_paid字段。 - 分析：前端展示逻辑在哪里？找到了
PostDetail.js。 - 风险：直接修改 API 可能会破坏移动端的兼容性。
- Planner 输出：
它会生成一个 implementation_plan.md，包含：
- Phase 1: 数据库迁移 (添加字段 SQL)
- Phase 2: 后端 API 改造 (增加权限校验中间件)
- Phase 3: 前端 UI 调整 (增加未支付时的遮罩层)
- Rollback Plan: 如果上线失败，如何回滚。
【莫潇羽点评】
很多新手觉得这一步浪费时间。但信我，磨刀不误砍柴工。有了这份 Plan，后面的 Coder Agent 就像拿着施工图纸的工人，效率会提升 10 倍，而且不会跑偏。
3.2 The Architect (架构师) 🏛️ —— 系统的灵魂设计师
【角色定位】
如果说 Planner 决定“做什么”，Architect 就决定“怎么做”。它是技术选型的决策者，也是代码结构的守护者。
【能力图谱】
- Design Patterns：熟练运用单例、工厂、观察者、策略等 23 种设计模式。
- System Design：微服务拆分、消息队列设计、缓存策略。
- Tech Stack Decision：它知道 Next.js 14 的 Server Actions 优缺点，知道什么时候该用 MongoDB 什么时候该用 PostgreSQL。
【实战演示】
你问：/architect 我们现在的图片上传太慢了，怎么优化？
Architect 不会直接给你写个压缩函数，它会：
- 分析现在的上传流程（是直传服务器还是 OSS？）。
- 提出三个方案：
- 方案 A：前端压缩 + 懒加载（成本低，见效快）。
- 方案 B：引入 CDN + OSS 直传（标准做法）。
- 方案 C：搭建专门的图片处理微服务（适合超大规模）。
- 它会列出每个方案的 Pros & Cons，让你做选择。
【无忆研习社建议】
当你的项目文件超过 50 个时，请务必在每次大改动前咨询 Architect。它能帮你避免代码变成“屎山”。
3.3 The Code Reviewer (审查官) 🧐 —— 铁面无私的判官
【角色定位】
它是代码质量的守门员。它不写代码，只挑刺。作者给它的设定是“Google/Meta L6 级别的资深工程师”，性格严厉，眼里容不得沙子。
【审查维度】
它会严格按照 rules/coding-style.md 进行检查：
- 🔴 Critical: 安全漏洞（SQL 注入、XSS）、逻辑死循环、敏感信息泄露。
- 🟡 Warning: 性能隐患（N+1 查询、大对象深拷贝）、代码重复率高。
- 🟢 Suggestion: 变量命名不够语义化、注释缺失、函数过长。
【实战演示】
你写完了一个登录功能，输入 /code-review。
Reviewer 会立刻扫描 git diff，然后大骂（模拟）：
"❌ BLOCKING: 你在UserService.ts第 45 行把password明文打印到了日志里！这是绝对禁止的！
"⚠️ WARNING:checkToken函数里有一个await在循环里，建议改用Promise.all并行处理。
"ℹ️ NIT: 变量u建议改名为user。"
【莫潇羽点评】
这个 Agent 是我最喜欢的。它不仅能帮你改 Bug，还能通过它的建议教你写出更好的代码。这才是真正的“AI 结对编程”。
3.4 The Security Reviewer (安全专家) 🛡️ —— 黑客的克星
【角色定位】
专门挖掘安全漏洞的 Agent。它不仅懂代码，还懂渗透测试。
【核心能力】
- OWASP Top 10: 熟知常见的 Web 漏洞。
- Dependency Scan: 它会检查
package.json里的依赖版本，对比 CVE 数据库，看是否有已知漏洞。 - Permission Check: 检查文件上传接口是否限制了后缀名，检查 API 是否有鉴权。
【实战演示】
输入 /security-scan。
它会遍历你的路由文件，模拟黑客思维：
"在 /api/upload 接口中，你直接使用了用户上传的文件名作为保存路径。这可能导致 Path Traversal (路径遍历) 攻击。建议使用 UUID 重命名文件。"
3.5 The TDD Guide (测试驱动导师) 🧪 —— 质量的布道者
【角色定位】
强制执行“红-绿-重构”流程的监督者。
【工作流】
- Red: 它会先逼你写一个失败的测试用例。如果你直接写业务代码，它会阻止你（通过 Hook）。
- Green: 允许你写出刚好能通过测试的代码。
- Refactor: 提醒你重构代码，优化结构。
【实战演示】
/tdd 实现一个斐波那契数列函数。
它不会直接给你代码，而是先生成 test_fib.py：
def test_fib():
assert fib(0) == 0
assert fib(1) == 1
assert fib(5) == 5然后问你：“测试已生成，运行失败（Red）。现在请你实现 fib 函数。”
3.6 The Build Error Resolver (构建修复师) 🔧 —— 报错终结者
【角色定位】
专门解决 Webpack, Vite, Docker 等复杂的构建报错。
【实战演示】
当你遇到一堆看不懂的 Module not found 或者 Segmentation fault 时，直接呼叫它。它会分析堆栈，甚至去搜索 GitHub Issues，找到解决方案。
3.7 The E2E Runner (端到端测试员) 🎭 —— 仿真用户
【角色定位】
编写和运行 Playwright/Cypress 脚本。它能模拟真实用户点击按钮、输入文字，验证整个业务流程是否通畅。
3.8 The Refactor Cleaner (代码洁癖) 🧹 —— 垃圾回收站
【角色定位】
定期清理项目中的僵尸代码。扫描那些 import 了但没用的包，定义了但没用的函数，并安全地删除它们。
3.9 The Doc Updater (文档同步员) 📝 —— 最后的拼图
【角色定位】
确保文档永远是最新的。它会监控 Git 变更，如果发现 API 变了，会自动更新 README.md 或 Swagger 文档。
⚡ 第四章：20+ 技能库 (Skills) —— AI 的武功秘籍
除了 Agent，everything-claude-code 还定义了一系列 Skills。你可以把 Skills 理解为 Agent 可以在工作中调用的“招式”或“函数库”。
这里挑选几个 无忆研习社 认为最实用的 Skill 进行深度解析。
4.1 Continuous Learning (持续学习) —— 越用越聪明
这是一个非常科幻的功能。
- 原理：每次对话结束时，系统会自动分析这次会话中出现的“新知识”或“用户偏好”。
- 效果：比如你这次告诉它“我不喜欢用
axios，我喜欢用fetch”。下一次，它就会自动记住这个偏好，不需要你再重复一遍。 - 实现：它会把这些偏好提取出来，存到一个全局的记忆文件（Memory Bank）中。这就像给 AI 装了一个海马体。
4.2 Memory Persistence (记忆持久化) —— 拒绝失忆
你是否遇到过这种情况：跟 AI 聊了一整天，第二天打开电脑，它又忘了你是谁。
- Hook 机制：利用
hooks/memory-persistence/下的脚本，在会话开始前加载记忆，在会话结束后保存记忆。 - 存储格式：它通常会把关键信息存储为 JSON 或 Markdown，放在
.claude/memory/目录下。 - 价值：让 AI 拥有了“长期记忆”。哪怕你关掉电脑，下周再打开，它依然记得上周五你们讨论的技术方案，甚至记得你承诺过要请它（如果不给它充电的话）喝咖啡。
4.3 Strategic Compact (战略压缩) —— 节省 Token 的艺术
- 问题：Claude 的上下文窗口虽然大（200k），但也是有限的。如果塞满了一堆无用的 log，不仅浪费钱，还会让 AI 变笨（大海捞针效应）。
- 方案：这个 Skill 会定期分析上下文，把那些不重要的对话（比如闲聊、试错过程）压缩成一句话摘要，从而释放 Token 空间。
- 触发时机：当 Token 使用量达到 80% 时自动触发。
4.4 Git Workflow Automation —— 自动化的 Git 流
- 功能：不仅仅是 commit。它可以自动生成符合 Conventional Commits 规范的提交信息（例如
feat: add user login）。 - 进阶：它甚至可以帮你自动解决简单的 Merge Conflicts。
💻 第五章：部署指南 —— 全平台保姆级教程
考虑到 无忆研习社 的读者遍布 Windows, macOS 和 Linux 平台，莫潇羽 特意整理了全平台的详细安装步骤。
5.1 Windows 用户安装指南
- 安装 Node.js：
确保你的电脑上安装了 Node.js (v18+)。
打开 PowerShell 输入 node -v 检查。
没有安装？去 Node.js 官网下载 LTS 版本。安装时记得勾选 "Add to PATH"。
- 安装 Claude Code：
npm install -g @anthropic-ai/claude-code安装完成后，运行 claude login 进行登录。
- 安装 Everything Claude Code 插件：
打开 PowerShell，依次输入：
claude plugin marketplace add affaan-m/everything-claude-code
claude plugin install everything-claude-code@everything-claude-code5.2 macOS / Linux 用户安装指南
对于 Mac 用户（特别是 M1/M2/M3 芯片），安装过程略有不同。
- 使用 Homebrew 安装 Node.js (推荐)：
brew install node- 配置权限：
在 macOS 上，你可能需要给 Claude Code 授予“完全磁盘访问权限”，否则它无法读取你的 Documents 文件夹。
前往 System Settings -> Privacy & Security -> Full Disk Access，添加 Terminal 或 iTerm。
- 安装插件：
claude plugin marketplace add affaan-m/everything-claude-code
claude plugin install everything-claude-code@everything-claude-code5.3 Docker 容器化部署 (最安全)
如果你担心 AI 会误删你的文件（虽然有 Hook 拦截），最安全的做法是在 Docker 里运行。
莫潇羽 为大家准备了一个 Dockerfile：
FROM node:18-slim
# 安装 git 和基础工具
RUN apt-get update && apt-get install -y git curl
# 安装 Claude Code
RUN npm install -g @anthropic-ai/claude-code
# 创建工作目录
WORKDIR /app
# 暴露端口 (如果有 Web 服务)
EXPOSE 3000
# 启动命令
CMD ["claude"]构建并运行：
docker build -t claude-code .
docker run -it -v $(pwd):/app -e ANTHROPIC_API_KEY=your_key claude-code这样，AI 就被困在了容器里，无论它怎么折腾，都不会影响你的宿主机系统。
🎮 第六章：全流程实战案例 —— 从零开发一个 Todo List (沉浸式体验)
为了让大家真正感受到这套配置的“降维打击”，莫潇羽 决定不只是重构，而是从零开始开发一个完整的 Todo List 应用。
我们将全程只动嘴，不动手，让 9 大 Agent 轮番上阵。
6.1 第一阶段：需求与规划 (The Planner)
我的指令：
/plan 开发一个 React+Vite 的 Todo List，支持本地存储，支持拖拽排序，界面要像 iOS Reminders 那样简洁。Planner Agent 介入：
它没有立刻生成文件，而是先生成了一份《产品规格说明书》(PRD)。
- 技术栈确认：React 18 + Vite + Tailwind CSS + dnd-kit (拖拽库)。
- 数据结构设计：
interface Todo {
id: string;
content: string;
isCompleted: boolean;
order: number;
}- 实施步骤：
- Step 1: 初始化项目脚手架。
- Step 2: 实现基础 CRUD。
- Step 3: 集成 dnd-kit 实现拖拽。
- Step 4: 美化 UI。
莫潇羽点评：注意，Planner 甚至帮我选好了 dnd-kit 这个库，因为它知道这是目前 React 生态中最现代的拖拽库。这就是“经验”。
6.2 第二阶段：测试先行 (The TDD Guide)
我的指令：
/tdd 开始 Step 2，实现基础 CRUD。TDD Agent 介入：
它阻止了直接写代码。
"Hold on! We need tests first."
它生成了 src/components/TodoList.test.tsx：
- 测试：输入文本，点击添加，列表中应出现该项。
- 测试：点击删除，列表项应消失。
- 测试：刷新页面，数据应从 LocalStorage 恢复。
运行结果：❌ RED (测试失败，因为组件还没写)。
6.3 第三阶段：核心编码 (The Coder)
我的指令：
Implement the TodoList component to pass the tests.Coder Agent 介入：
它开始疯狂输出代码。它读取了 TDD Agent 生成的测试用例，以此为目标编写代码。
它使用了 useLocalStorage 自定义 Hook，完美实现了持久化。
运行结果：✅ GREEN (测试通过)。
6.4 第四阶段：代码审查 (The Code Reviewer)
我的指令：
/code-reviewReviewer Agent 介入：
⚠️ Warning: 你在TodoItem组件中使用了内联函数onClick={() => delete(id)}，这会在每次渲染时创建新函数。建议使用useCallback优化。
🟢 Suggestion: 你的 CSS 类名写得太长了，建议使用class-variance-authority(CVA) 来管理样式变体。
我的指令：
Fix the warning.Coder Agent 再次介入，乖乖地加上了 useCallback。
6.5 第五阶段：安全检查 (The Security Reviewer)
我的指令：
/security-scanSecurity Agent 介入：
它扫描了代码，发现了一个潜在问题：
"在渲染 Todo 内容时，你直接使用了<div>{content}</div>。虽然 React 默认转义了 XSS，但如果你未来打算支持 Markdown (使用dangerouslySetInnerHTML)，请务必使用dompurify进行清洗。"
6.6 第六阶段：收尾 (The Doc Updater)
我的指令：
/update-docsDoc Updater Agent 介入：
它生成了 README.md，不仅包含了如何启动项目，还自动生成了项目目录结构树，甚至把刚才 Planner 生成的功能列表也同步进去了。
💡 第七章：无忆研习社独家技巧 —— 如何防呆与防错
在使用这套配置时，莫潇羽 发现了一些很有意思的 Hooks（钩子）配置，这里分享给大家，防止踩坑。
7.1 🚫 禁止创建垃圾文件
在 hooks/hooks.json 中，有一条规则专门用来拦截 AI 创建无用的文档。
{
"matcher": "tool == \"Write\" && tool_input.file_path matches \"\\\\.(md|txt)$\" && !(tool_input.file_path matches \"README\\\\.md|CLAUDE\\\\.md\")",
"command": "node scripts/block-trash-files.js"
}原理：当 AI 试图创建一个名为 temp_notes.txt 或 plan_v1.md 的文件时，Hook 会自动触发并拦截。
目的：强制 AI 把所有文档都整合到 README.md 或标准文档库中，保持项目根目录的整洁。这简直是强迫症开发者的福音！
7.2 🔒 Git Push 前的安全检查
你可以配置一个 Pre-Push Hook。
原理：当你执行 git push 时，自动唤醒 Security Reviewer Agent。如果它发现代码里有 AWS Key 或者数据库密码，它会直接中止 Push 操作，并大声（在终端里）警告你。
