Everything Claude Code 深度学习笔记

学习时间：2026-04-23
项目地址：https://github.com/affaan-m/everything-claude-code
本地路径：./everything-claude-code/
核心定位：AI Agent 性能优化系统 / AI Agent Performance Optimization System

一、项目概述 / Project Overview

1.1 定位与核心理念 / Positioning & Philosophy

Everything Claude Code (ECC) 是一个 AI Agent 性能优化系统，它不仅仅是一堆配置文件，而是一个完整的开发体系：

  • Skills - 可复用工作流技能
  • Instincts - 本能模式学习系统
  • Memory Optimization - 记忆优化
  • Continuous Learning - 持续学习
  • Security Scanning - 安全扫描
  • Research-First Development - 研究优先开发
    • Anthropic Hackathon Winner | 140K+ Stars | 21K+ Forks | 170+ Contributors

    1.2 跨平台支持 / Cross-Platform Support

    Claude Code  |  Codex  |  Cursor  |  OpenCode  |  Gemini  |  Other AI Agent Harnesses

    1.3 项目结构 / Project Structure

    everything-claude-code/
├── agents/          # 48 个专业 Agent
├── skills/          # 183 个工作流技能
├── commands/        # 79 个斜杠命令
├── hooks/           # 触发式自动化
├── rules/           # 通用+语言特定规则
├── contexts/        # 上下文管理
├── mcp-configs/     # 14 个 MCP 服务器配置
├── scripts/         # 跨平台 Node.js 工具
├── tests/           # 测试套件
├── ecc2/            # ECC 2.0 Rust 控制平面 (Alpha)
└── docs/            # 多语言文档

    二、Commands 系统 / Commands System

    2.1 核心工作流命令 / Core Workflow Commands

    命令功能描述
    /plan实现计划重述需求、评估风险、编写步骤计划
    /tdd测试驱动开发脚手架接口 → 编写失败测试 → 实现 → 验证 80%+ 覆盖率
    /code-review代码审查全面审查代码质量、安全性、可维护性
    /build-fix构建修复自动检测语言并修复构建错误
    /verify验证循环构建 → Lint → 测试 → 类型检查
    /quality-gate质量门禁根据项目标准进行质量检查

    2.2 测试命令 / Testing Commands

    命令功能描述
    /tdd通用 TDD任何语言的 TDD 工作流
    /e2e端到端测试生成并运行 Playwright E2E 测试
    /test-coverage覆盖率报告测试覆盖率报告，识别缺口
    /go-testGo 测试Go 表格驱动测试 (80%+ 覆盖率)
    /kotlin-testKotlin 测试Kotest + Kover
    /rust-testRust 测试cargo test, 集成测试
    /cpp-testC++ 测试GoogleTest + gcov/lcov

    2.3 代码审查命令 / Code Review Commands

    命令功能描述
    /code-review通用审查全面代码审查
    /python-reviewPython 审查PEP 8、类型提示、安全、惯用模式
    /go-reviewGo 审查惯用模式、并发安全、错误处理
    /kotlin-reviewKotlin 审查空安全、协程安全、清洁架构
    /rust-reviewRust 审查所有权、生命周期、不安全使用
    /cpp-reviewC++ 审查内存安全、现代惯用语、并发

    2.4 构建修复命令 / Build Fix Commands

    命令功能描述
    /build-fix自动修复自动检测语言并修复构建错误
    /go-buildGo 构建修复 Go 构建错误和 go vet 警告
    /kotlin-buildKotlin 构建修复 Kotlin/Gradle 编译器错误
    /rust-buildRust 构建修复 Rust 构建 + 借用检查器问题
    /cpp-buildC++ 构建修复 C++ CMake 和链接器问题
    /gradle-buildGradle 构建修复 Android/KMP 的 Gradle 错误

    2.5 规划与架构命令 / Planning & Architecture Commands

    命令功能描述
    /plan实现计划带风险评估的实施计划
    /multi-plan多模型协作规划多模型协同规划
    /multi-workflow多模型协作开发多模型协作开发
    /multi-backend后端多模型开发后端专注的多模型开发
    /multi-frontend前端多模型开发前端专注的多模型开发
    /multi-execute多模型协作执行多模型协作执行
    /orchestrate编排指南tmux/worktree 多 Agent 编排
    /devfleetDevFleet 编排通过 DevFleet 编排并行 Claude Code Agent

    2.6 会话管理命令 / Session Management Commands

    命令功能描述
    /save-session保存会话保存当前会话状态
    /resume-session恢复会话加载并恢复最近保存的会话
    /sessions浏览会话浏览、搜索和管理会话历史
    /checkpoint检查点在当前会话中标记检查点
    /aside快速问答回答快速附带问题而不丢失当前任务上下文
    /context-budget上下文预算分析上下文窗口使用情况

    2.7 学习与改进命令 / Learning & Improvement Commands

    命令功能描述
    /learn提取模式从当前会话提取可复用模式
    /learn-eval评估提取提取模式 + 自我评估质量后再保存
    /evolve演化分析分析学习的本能，建议演化技能结构
    /promote提升范围将项目范围的本能提升到全局范围
    /instinct-status本能状态显示所有学习的本能（项目 + 全局）
    /instinct-export导出本能将本能导出到文件
    /instinct-import导入本能从文件或 URL 导入本能
    /skill-create创建技能分析本地 git 历史 → 生成可复用技能
    /skill-health技能健康技能组合健康仪表板
    /rules-distill提炼规则扫描技能，提取跨领域原则

    2.8 快速决策指南 / Quick Decision Guide

    开始新功能？                    → /plan 先规划，然后 /tdd
刚写完代码？                    → /code-review
构建失败？                      → /build-fix
需要实时文档？                  → /docs 
会话即将结束？                  → /save-session 或 /learn-eval
第二天继续？                    → /resume-session
上下文太重？                    → /context-budget 然后 /checkpoint
想提取学到的东西？              → /learn-eval 然后 /evolve
运行重复任务？                  → /loop-start

    三、Agents 系统 / Agents System

    3.1 Agent 概览 / Agent Overview

    ECC 提供 48 个专业 Agent，分为以下几类：

    通用开发 Agent

    Agent用途使用场景
    planner实现规划复杂功能、重构
    architect系统设计架构决策
    tdd-guide测试驱动开发新功能、Bug 修复
    code-reviewer代码质量审查编写/修改代码后
    security-reviewer漏洞检测提交前、敏感代码
    build-error-resolver修复构建错误构建失败时
    e2e-runnerPlaywright E2E 测试关键用户流程
    refactor-cleaner死代码清理代码维护
    doc-updater文档更新更新文档

    语言特定 Agent

    Agent语言功能
    typescript-reviewerTypeScript/JSTypeScript 代码审查
    python-reviewerPythonPython 代码审查
    go-reviewerGoGo 代码审查
    rust-reviewerRustRust 代码审查
    java-reviewerJava/Spring BootJava 代码审查
    kotlin-reviewerKotlin/AndroidKotlin 代码审查
    cpp-reviewerC/C++C/C++ 代码审查
    go-build-resolverGoGo 构建错误修复
    rust-build-resolverRustRust 构建错误修复
    java-build-resolverJavaJava 构建错误修复
    kotlin-build-resolverKotlinKotlin 构建错误修复
    cpp-build-resolverC++C++ 构建错误修复
    pytorch-build-resolverPyTorchPyTorch 运行时/CUDA 错误

    专业化 Agent

    Agent用途
    database-reviewerPostgreSQL/Supabase 专家
    loop-operator自主循环执行
    harness-optimizerHarness 配置调优
    docs-lookupContext7 文档查询

    3.2 Agent 编排 / Agent Orchestration

    主动使用 Agent（无需用户提示）： 
    复杂功能请求          →  planner
刚写/修改的代码        →  code-reviewer
Bug 修复或新功能       →  tdd-guide
架构决策              →  architect
安全敏感代码           →  security-reviewer
自主循环/循环监控       →  loop-operator
Harness 配置可靠性和成本 →  harness-optimizer
    并行执行：独立操作可并行启动多个 Agent。

    3.3 Agent 定义示例 / Agent Definition Example

    ---
name: planner
description: 复杂功能和重构的专家规划专家
tools: ["Read", "Grep", "Glob"]
model: opus

    


    You are an expert planning specialist focused on creating comprehensive, actionable implementation plans.

    3.4 Agent 配置 (agent.yaml)
    


    yaml
name: planner
description: Expert planning specialist for complex features and refactoring
tools: ["Read", "Grep", "Glob"]
model: opus

    


    四、Contexts 上下文管理 / Contexts System
    


    4.1 上下文文件结构 / Context File Structure
    


    
contexts/
├── dev.md      # 开发上下文
├── research.md # 研究上下文
└── review.md   # 审查上下文

    4.2 开发上下文示例 / Development Context Example
    


    markdown

    Development Context
    


    Mode: Active development
Focus: Implementation, coding, building features
    


    Behavior
    

  • Write code first, explain after
    • 

  • Prefer working solutions over perfect solutions
    • 

  • Run tests after changes
    • 

  • Keep commits atomic
    • 


    Priorities
    

  • Get it working
    • 

  • Get it right
    • 

  • Get it clean
    • 


    Tools to favor
    

  • Edit, Write for code changes
    • 

  • Bash for running tests/builds
    • 

  • Grep, Glob for finding code
    • 

    


    五、Skills 技能系统 / Skills System
    


    5.1 Skills 概览 / Skills Overview
    


    ECC 提供 183 个工作流技能，覆盖多个领域：
    


    5.2 主要技能分类 / Main Skill Categories
    


    前端技能
    


    

    技能功能
    


    frontend-design前端设计模式
    

    frontend-patterns前端开发模式
    

    frontend-slidesHTML 演示文稿构建
    

    nextjs-turbopackNext.js Turbopack 配置
    

    bun-runtimeBun 运行时
    

    

    后端技能
    


    

    技能功能
    


    backend-patterns后端架构模式
    

    api-designAPI 设计
    

    mcp-server-patternsMCP 服务器模式
    

    nestjs-patternsNestJS 开发模式
    

    

    质量与测试技能
    


    

    技能功能
    


    e2e-testingPlaywright E2E 测试
    

    eval-harness评估框架
    

    coding-standards编码标准
    

    agent-introspection-debuggingAgent 自调试
    

    

    内容与运营技能
    


    

    技能功能
    


    article-writing文章写作
    

    content-engine内容引擎
    

    brand-voice品牌声音系统
    

    market-research市场研究
    

    investor-materials投资者材料
    

    investor-outreach投资者外联
    

    

    特定领域技能
    


    

    技能功能
    


    pytorch-patterns深度学习工作流
    

    bun-runtime现代 JS 工具链
    

    documentation-lookupAPI 参考研究
    

    deep-research深度研究
    

    exa-search高级搜索
    

    

    5.3 Skill 定义示例 / Skill Definition Example
    


    markdown

    
name: backend-patterns
description: Backend architecture patterns, API design, database optimization
origin: ECC

    


    Backend Development Patterns
    


    Backend architecture patterns and best practices for scalable server-side applications.
    


    When to Activate
    


  • Designing REST or GraphQL API endpoints
    • 

  • Implementing repository, service, or controller layers
    • 

  • Optimizing database queries (N+1, indexing, connection pooling)
    • 

  • Adding caching (Redis, in-memory, HTTP cache headers)
    • 

  • Setting up background jobs or async processing
    • 

  • Structuring error handling and validation for APIs
    • 

  • Building middleware (auth, logging, rate limiting)
    • 


    API Design Patterns
    


    RESTful API Structure
    typescript // PASS: Resource-based URLs GET /api/markets # List resources GET /api/markets/:id # Get single resource POST /api/markets # Create resource PUT /api/markets/:id # Replace resource PATCH /api/markets/:id # Update resource DELETE /api/markets/:id # Delete resource 
    


    5.4 Skill 创建流程 / Skill Creation Workflow
    


    1. /skill-create - 分析本地 git 历史

  • 提取可复用模式
    • 

  • 生成 SKILL.md 文件
    • 

  • 包含 origin、description、触发条件
    • 

    


    


    六、最佳实践 / Best Practices
    


    6.1 核心原则 / Core Principles
    


    

    原则描述
    


    Agent-First将领域任务委托给专业 Agent
    

    Test-Driven先写测试，80%+ 覆盖率要求
    

    Security-First绝不妥协于安全，验证所有输入
    

    Immutability总是创建新对象，从不修改现有对象
    

    Plan Before Execute复杂功能先规划后执行
    

    

    6.2 安全准则 / Security Guidelines
    

提交前必须检查：


  • ❌ 无硬编码密钥（API 密钥、密码、令牌）
    • 

  • ✅ 所有用户输入验证
    • 

  • ✅ SQL 注入防护（参数化查询）
    • 

  • ✅ XSS 防护（HTML 净化）
    • 

  • ✅ CSRF 保护已启用
    • 

  • ✅ 认证/授权验证
    • 

  • ✅ 所有端点限流
    • 

  • ✅ 错误消息不泄露敏感数据
    • 

密钥管理： 绝不硬编码密钥。使用环境变量或密钥管理器。


    6.3 编码风格 / Coding Style
    

不可变性（关键）： 总是创建新对象，从不修改。返回带有更改的新副本。

文件组织：

  • 多小文件 > 少大文件
    • 

  • 典型 200-400 行，最多 800 行
    • 

  • 按特性/领域组织，非按类型
    • 

  • 高内聚，低耦合
    • 

错误处理： 每层都处理错误。UI 代码提供用户友好的消息。

输入验证： 在系统边界验证所有用户输入。使用基于模式的验证。


    6.4 测试要求 / Testing Requirements
    

最低覆盖率：80%


    

    测试类型覆盖范围
    


    单元测试独立函数、工具、组件
    

    集成测试API 端点、数据库操作
    

    E2E 测试关键用户流程
    

    
TDD 工作流（强制）：


    1. RED   - 先写测试，测试应该失败

  • GREEN - 写最小实现，测试应该通过
    • 

  • IMPROVE - 重构，验证覆盖率 80%+
    • 

    


    6.5 开发工作流 / Development Workflow
    


    1. 规划     → 使用 planner agent

  • TDD      → 使用 tdd-guide agent
    • 

  • 审查     → 使用 code-reviewer agent
    • 

  • 捕获知识 → 放在正确位置
    • 

  • 提交     → 传统提交格式
    • 

    


    


    七、使用示例 / Usage Examples
    


    7.1 安装 ECC / Install ECC
    


    添加 marketplace
    
/plugin marketplace add https://github.com/affaan-m/everything-claude-code


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

    7.2 使用 Agent / Using Agents
    


    markdown

    在对话中主动使用 Agent
    
/plan 实现用户认证系统


    代码审查
    
/code-review


    TDD 开发
    
/tdd 开发支付功能

    7.3 上下文预算 / Context Budget
    


    bash

    分析上下文使用情况
    
/context-budget


    优化后保存
    
/save-session


    下次恢复
    
/resume-session

    7.4 学习与进化 / Learning & Evolution
    


    bash

    从当前会话提取模式
    
/learn


    评估提取质量
    
/learn-eval


    分析并建议演化
    
/evolve


    提升到全局范围
    
/promote

    


    八、项目亮点 / Project Highlights
    


    8.1 版本历史 / Version History
    


    

    版本主要特性
    


    v1.10.0仪表板 GUI、Operator 工作流、ECC 2.0 Alpha
    

    v1.9.0选择性安装、6 个新 Agent、156 个技能
    

    v1.8.0Harness 性能系统、NanoClaw v2
    

    v1.7.0Codex 支持、前端幻灯片技能
    

    v1.6.0Codex CLI、AgentShield、市场
    

    v1.4.0多语言规则、安装向导、PM2
    

    v1.3.0OpenCode 支持
    

    

    8.2 统计数据 / Statistics
    


    
Stars:     140K+
Forks:     21K+
Contributors: 170+
Languages: 12+
Agents:    48
Skills:    183
Commands:  79

    


    


    九、学习总结 / Learning Summary
    


    9.1 核心突破 / Key Breakthroughs
    


  • 系统性方法 - 不只是配置，是完整的 AI 开发体系
    • 

  • 跨平台兼容 - 支持所有主流 AI Agent Harness
    • 

  • 自动化工作流 - Commands + Agents + Skills 无缝协作
    • 

  • 持续学习 - Instincts 系统让 AI 不断改进
    • 

  • 安全第一 - 内置安全扫描和防护
    • 


    9.2 应用价值 / Application Value
    


  • ✅ 提升开发效率
    • 

  • ✅ 标准化代码质量
    • 

  • ✅ 自动化重复任务
    • 

  • ✅ 跨团队知识共享
    • 

  • ✅ 持续性能优化
    • 


    9.3 未来展望 / Future Outlook
    


  • ECC 2.0 控制平面
    • 

  • 更多 Operator Skills
    • 

  • 自进化技能系统
    • 

  • 更强的安全防护
    • 


    


    学习完成日期：2026-04-23
    

    笔记版本：v1.0