everything-claude-code 配置详解：构建规范化 AI 开发工作流

3. 典型工作流示例

下面用几个典型场景，展示这套配置的实际使用方法。

开发一个新功能

• 使用前：直接让 AI 写代码，AI 生成代码可能有遗漏，人工检查发现问题再改，没有测试，上线心里没底。
• 使用后：/plan 规划需求 → /tdd 测试驱动开发 → /code-review 代码审查 → /verify 完整验证。

第一步用 /plan 命令，把需求拆分成可执行的步骤，识别风险和依赖，生成实施计划。确认后再动手。 第二步用 /tdd 命令，先写测试再写代码，确保 80% 以上的测试覆盖率。 第三步用 /code-review 命令，检查代码质量、安全问题、风格规范。 第四步用 /verify 命令，运行完整验证流程，确保功能正常。

修复构建错误

/build-fix 命令可以自动修复 TypeScript 编译错误、依赖问题等。它会分析错误信息，定位问题根源，进行最小化修改，不会改变项目架构。

清理技术债

/refactor-clean 命令使用 knip、depcheck 等工具识别死代码、未使用的依赖、重复的代码。清理前会先分析风险，确保不会破坏功能。

添加 E2E 测试

/e2e 命令生成 Playwright 测试。它会分析页面结构和用户流程，生成完整的端到端测试用例，包括 Page Object 模式。

4. 9 大专业代理详解

代理（Agent）是专门化的 AI 助手，每个代理专注一个领域。使用专业代理可以让 AI 的回答更准确、更深入。

• planner - 功能规划专家：分析需求，拆分成可执行的步骤，识别风险和依赖关系，生成实施计划。
• architect - 系统架构设计：设计可扩展的系统架构，进行技术权衡分析，推荐设计模式，创建 ADR（架构决策记录）。
• tdd-guide - TDD 测试驱动开发：强制测试驱动开发流程，先写测试，再写实现，确保 80% 以上的测试覆盖率。
• code-reviewer - 代码质量审查：审查代码风格、规范、一致性，检查函数长度、文件大小、嵌套深度，标记 TODO/FIXME 注释。
• security-reviewer - 安全漏洞检测：检测 OWASP Top 10 漏洞，查找硬编码的密钥和密码，检查 SQL 注入、XSS、CSRF 等风险。
• build-error-resolver - 构建错误修复：分析错误信息，定位问题，进行最小化修复，不改变项目架构。
• e2e-runner - Playwright E2E 测试：生成 Playwright 测试用例，使用 Page Object 模式，处理不稳定测试。
• refactor-cleaner - 死代码清理：使用 knip、depcheck 识别死代码，安全删除未使用的依赖，消除重复代码。
• doc-updater - 文档和架构图更新：生成 codemaps（代码架构图），更新 README 文档，使用 ts-morph 分析 AST。

5. 11 个技能模块详解

技能（Skill）是领域知识和最佳实践的集合。AI 在执行任务时会参考这些技能，确保输出符合专业标准。

1. tdd-workflow：确保所有开发遵循 TDD 原则，有完整的测试覆盖（RED-GREEN-REFACTOR 循环）。
2. security-review：确保代码符合安全标准，不引入安全漏洞（10 大安全领域检查，密钥管理规范）。
3. continuous-learning：从开发会话中提取可复用的模式，沉淀为知识。
4. coding-standards：确保代码风格一致，符合专业编码规范（不可变性、KISS 原则、函数规范）。
5. frontend-patterns：提供现代前端开发的最佳实践（组件模式、自定义 Hooks、性能优化）。
6. backend-patterns：提供后端开发的最佳实践（架构模式、API 设计、数据库、缓存）。
7. verification-loop：在开发过程中持续验证代码质量。
8. eval-harness：评估 AI 生成代码的质量和效果。
9. strategic-compact：在长会话中建议手动压缩上下文。
10. clickhouse-io：提供 ClickHouse 数据库的查询和使用指南。
11. project-guidelines-example：展示如何为特定项目创建定制化指南。

6. 14 个斜杠命令详解

斜杠命令（Command）是预定义的工作流，通过输入 /命令名 触发。

• /tdd：启动 TDD 模式，先写测试再实现代码。
• /plan：创建实施计划，等待确认后执行。
• /e2e：生成 Playwright 端到端测试。
• /code-review：审查未提交变更的质量和安全。
• /build-fix：修复构建和类型错误。
• /refactor-clean：清理未使用的代码和依赖。
• /learn：从当前会话提取可复用模式。
• /checkpoint：保存当前验证状态。
• /verify：运行完整的验证流程。
• /test-coverage：检查测试覆盖率。
• /update-docs：更新项目文档。
• /update-codemaps：更新代码架构图。
• /orchestrate：协调多个代理完成复杂任务。
• /eval：运行评估测试。

7. 8 大强制规则

规则（Rule）是必须遵守的编码准则。违反规则会触发警告或阻止操作。

1. security.md：禁止硬编码密钥、密码、token；所有用户输入必须验证；使用参数化查询防止 SQL 注入。
2. testing.md：最低测试覆盖率 80%；必须包含单元测试、集成测试、E2E 测试；遵循 TDD 流程。
3. coding-style.md：强制不可变性；小文件原则（不超过 800 行）；小函数原则（不超过 50 行）；无深度嵌套。
4. git-workflow.md：使用约定式提交；功能开发使用功能分支；PR 必须有代码审查。
5. agents.md：明确不同场景下应使用的代理（如复杂架构用 architect，安全用 security-reviewer）。
6. performance.md：根据任务复杂度选择合适的模型；保留 20% 的上下文窗口用于缓冲区。
7. patterns.md：使用适当的模式解决问题，不要过度设计，代码自文档化。
8. hooks.md：了解各种钩子的触发时机，不要在钩子中执行耗时操作。

8. Hooks 自动化系统

Hooks 是自动化触发器，在特定时机自动执行预定义的操作。

PreToolUse Hooks（使用工具前触发）

• dev 服务器检查：阻止开发服务器在 tmux 外运行，确保可以访问日志。
• 长时间命令提醒：npm install、npm test 等长时间命令运行时，提醒使用 tmux。
• git push 前审查：git push 前暂停，等待用户确认。
• 禁止创建不必要文档：阻止创建非必要的.md 文件，保持文档简洁。

PostToolUse Hooks（使用工具后触发）

• PR 创建检测：创建 PR 后，记录 PR URL，提供审查命令。
• JS/TS 自动格式化：编辑 JS/TS 文件后，自动用 Prettier 格式化。
• TypeScript 类型检查：编辑 TS 文件后，运行 tsc 检查类型。
• console.log 警告：检测到 console.log 时提醒移除。

其他 Hook 阶段

• PreCompact Hooks：上下文压缩前，保存当前会话状态。
• SessionStart Hooks：新会话开始时，恢复之前保存的上下文。
• Stop Hooks：会话结束前，检查修改的文件中是否有 console.log，保存会话状态，评估当前会话提取模式。

9. 动态上下文系统与 MCP 服务器

动态上下文系统

上下文（Context）决定 AI 在当前会话中的行为模式。

• dev.md - 开发模式：行为是先写代码，后解释。优先级是快速实现 > 完美方案。适用于日常开发、功能实现。
• review.md - 审查模式：行为是专注质量、安全、可维护性。优先级是代码质量 > 开发速度。适用于代码审查、安全检查。
• research.md - 研究模式：行为是深入分析，可并行多代理。优先级是分析深度 > 速度。适用于技术调研、架构评估。

MCP 服务器集成

MCP（Model Context Protocol）服务器提供外部服务集成。

• 核心 MCP 服务器：github（GitHub 操作）、firecrawl（网页抓取）、supabase（数据库操作）、memory（跨会话持久化）、sequential-thinking（思维链推理）、vercel/railway（部署管理）。
• Cloudflare Workers 系列：cloudflare-docs、cloudflare-workers-builds、cloudflare-workers-bindings、cloudflare-observability。
• 其他 MCP 服务器：clickhouse、context7、magic、filesystem。

使用建议：根据需要启用 MCP，不用全部启用。注意 API 密钥的配置，保持启用数量在 10 个以内，避免消耗过多上下文。

10. 常见问题解答

Q1：这套配置适合什么水平的开发者？ 有一定编程基础即可使用。AI 代理会引导你完成流程，即使不熟悉 TDD 或某些最佳实践，也能按照指导正确操作。

Q2：和直接用 Claude Code 有什么区别？ 直接使用 Claude Code 也可以获得很好的结果，但这套配置提供了规范化的流程、自动化检查、持续学习能力。它不是限制 AI 的能力，而是让 AI 的输出更可靠、更一致。

Q3：一定要用全部功能吗？ 可以按需选用。从一个命令开始尝试，比如先使用 /plan 规划需求，熟悉后再逐步添加其他功能。

Q4：会影响 AI 的响应速度吗？ 影响很小。规则和钩子主要是引导 AI 的行为，不会显著增加响应时间。某些自动化检查会在后台运行，也不影响 AI 响应。

Q5：怎么保证代码安全？ 规则中包含了严格的安全检查，包括禁止硬编码密钥、输入验证、SQL 注入防护等。/code-review 和 /security-reviewer 命令会主动检查安全问题。

Q6：可以在团队中使用吗？ 当然。这套配置的核心价值之一就是统一团队的开发规范。把配置放到团队共享仓库中，成员安装后就能保持一致的开发体验。

11. 快速上手指南

安装步骤

1. 安装配置：将 everything-claude-code 的目录复制到 Claude Code 的配置目录。

   # 克隆或下载配置
   git clone https://github.com/affaan-m/everything-claude-code ~/.claude/
   

2. 配置环境：根据需要配置 MCP 服务器的 API 密钥。

   // ~/.claude/settings.json
   {
     "mcpServers": {
       "github": {
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
         }
       }
     }
   }
   

3. 验证安装：运行 /verify 命令，验证配置是否正常工作。

推荐采用路径

• 第一阶段：只用三个命令（1 周）

  • /plan - 规划新功能
  • /tdd - 开发新功能
  • /code-review - 审查代码 这三个命令覆盖了开发的主要环节，门槛最低。

• 第二阶段：增加自动化（2 周）

  • /build-fix - 修复构建错误
  • /test-coverage - 检查覆盖率
  • /verify - 完整验证

• 第三阶段：深入使用（持续）

  • /refactor-clean - 清理技术债
  • /e2e - 添加 E2E 测试
  • /learn - 提取团队模式

必备配置

• 必须配置：GitHub MCP（用于 PR 和 issue 操作）、安全规则（security.md）、测试规则（testing.md）。
• 推荐配置：代码风格规则（coding-style.md）、PreToolUse Hooks（开发体验提升）。
• 可选配置：其他 MCP 服务器（按需）、持续学习技能（continuous-learning）。

12. 移植到 OpenCode

everything-claude-code 的配置可以移植到 OpenCode 使用。OpenCode 是另一个 AI 编程工具，采用类似的配置机制。

移植步骤

1. 复制配置文件：

   cp -r ~/.claude/agents ~/.opencode/
   cp -r ~/.claude/commands ~/.opencode/
   cp -r ~/.claude/rules ~/.opencode/
   cp -r ~/.claude/skills ~/.opencode/
   

2. 调整目录结构：OpenCode 的默认配置目录结构略有不同，需确认 hooks 和 skills 的加载方式。
3. 修改配置兼容性：部分技能的加载机制可能需要调整，某些 hooks 的触发器语法可能需要修改。
4. 测试验证：逐一测试各模块是否正常工作，包括 agents、commands、rules、hooks。

注意事项

• OpenCode 的 hooks 语法与 Claude Code 有差异，需要调整。
• 部分技能的加载机制可能不兼容。
• 某些 MCP 服务器在 OpenCode 中可能没有对应的集成。
• 建议先移植核心功能（agents、commands、rules），逐步测试和调整。

13. 总结

everything-claude-code 是一套实用的 AI 编程配置方案。它不追求花哨的功能，而是解决实际问题：让 AI 辅助编程更规范、更高效、更可靠。

核心价值

• 规范化流程：从规划到开发，从审查到测试，每个环节都有明确的工具和方法。
• 自动化检查：代码风格、测试覆盖率、安全问题，都由自动化工具检查。节省时间又不会遗漏。
• 持续学习：从每次会话中提取模式，沉淀为团队知识。AI 会越来越了解项目特点，开发效率逐步提升。
• 灵活采用：可以全套使用，也可以只采用其中几个命令。从 /plan 开始，逐步扩展到完整的开发流程。

项目开源在 GitHub 上，可以直接克隆使用：https://github.com/affaan-m/everything-claude-code