Everything Claude Code (ECC) 完整调研报告（二）

Everything Claude Code 是目前 AI 辅助开发工具链领域最完整的开源工程化方案之一。它的核心价值不在于单个组件的精巧，而在于将 Agent 编排、知识管理、质量保障、记忆持久化、持续学习、安全防护、成本追踪这些独立关注点，通过统一的 Hook 生命周期和 Handoff Document 机制串联成一个有机整体。

it_czz

543人浏览 · 2026-03-25 11:36:35

it_czz · 2026-03-25 11:36:35 发布

七、Commands 命令系统 — 深度解析

7.1 核心命令详解

/plan — 任务规划命令

/tdd — 测试驱动开发命令

完整 TDD 循环:

Scaffold — 定义类型和接口
RED — 编写失败测试
GREEN — 最小通过代码
REFACTOR — 改进代码质量
VERIFY — 覆盖率 ≥80%

覆盖率分级: 普通代码 80%+，金融计算/认证/安全/核心业务逻辑 100%。

与其他命令的集成: /plan (前置理解) → /tdd → /build-fix (构建错误) → /code-review (审查) → /test-coverage (验证)

/orchestrate — 多Agent编排命令

预定义工作流模板:

工作流	Agent 链
功能实现	planner → tdd-guide → code-reviewer → security-reviewer
Bug 修复	planner → tdd-guide → code-reviewer
重构	architect → code-reviewer → tdd-guide
安全审查	security-reviewer → code-reviewer → architect

Agent 间传递 Handoff Document 结构:

## Context
[已完成工作摘要]

## Findings
[关键发现]

## Modified Files
- src/auth.ts (新增)
- src/middleware/validate.ts (修改)

## Open Questions
[给下一个Agent的问题]

## Recommendations
[建议下一步]

最终报告包含: 一段摘要 + 各 Agent 输出 + 完整文件变更列表 + 测试结果 + 安全发现 + 建议 (SHIP / NEEDS WORK / BLOCKED)

/build-fix — 构建修复命令

关键原则: 一次修一个错误，偏好最小 diff 而非重构。

/learn — 模式学习命令

提取 4 类有价值模式:

错误解决 — 根因、修复方案、跨问题复用性
调试技巧 — 非显而易见的步骤和工具组合
变通方案 — 库缺陷、API限制、版本特定方案
项目模式 — 代码库惯例、架构决策、集成方法

输出: ~/.claude/skills/learned/[pattern-name].md，含 Problem、Solution、Example、触发条件。

质量过滤: 排除 typo/语法错误等琐碎修复和一次性问题（服务中断），只保留可复用的节省时间的模式。

完整 /learn 使用流程:

/quality-gate — 质量门禁命令

/quality-gate [path|.] [--fix] [--strict]

4步流水线: 识别语言工具 → 格式化检查 → Lint + 类型检查 → 生成修复列表。--fix 自动修复，--strict 警告也报失败。

完整 /quality-gate 使用流程:

关键要点: 整个 /quality-gate 流程确保代码符合项目的格式和质量标准。--fix 标志可以自动修复大部分格式和代码风格问题，而 --strict 标志确保即使是警告级别的问题也会导致失败，提高代码质量。

7.2 常用命令速查表

按使用频率排列:

命令与 Agent 映射:

命令	调用的 Agent	Agent 模型	核心功能
`/plan`	planner	Opus	创建多阶段实施计划，需用户批准后才执行
`/tdd`	tdd-guide	Sonnet	强制 RED → GREEN → REFACTOR 循环，≥80% 覆盖率
`/code-review`	code-reviewer	Sonnet	4级严重度审查 (CRITICAL/HIGH/MEDIUM/LOW)
`/build-fix`	build-error-resolver	—	逐个修复构建错误，一次修一个
`/e2e`	e2e-runner	Sonnet	生成并运行 E2E 测试，优先 Agent Browser
`/verify`	(内置)	—	最终验证通过率
`/learn`	(内置)	—	从会话中提取 4 类可复用模式
`/quality-gate`	(内置)	—	4步质量流水线: 检测 → 格式 → Lint → 报告
`/orchestrate`	多Agent链	多种	按模板串联 Agent，Handoff Doc 传递
`/harness-audit`	harness-optimizer	Sonnet	诊断工具链配置，输出基线评分
`/sessions`	(内置)	—	列出所有历史会话
`/save-session`	(内置)	—	手动保存当前会话
`/resume-session`	(内置)	—	恢复特定历史会话
`/checkpoint`	(内置)	—	创建进度检查点
`/setup-pm`	(内置)	—	配置包管理器偏好

八、Skills 系统 — 125+ 技能分类详解

8.1 技能全景分类

8.2 Skills vs Rules vs Commands vs Agents 四者关系

核心关系总结:

Commands 是用户操作 Agent 的入口（如 /tdd → tdd-guide）
Agents 是实际执行单元，执行时受 Rules 约束、参考 Skills 知识
Rules 在系统层自动注入，Agent 必须遵守（不可选）
Skills 按需加载，提供 Agent 完成特定任务所需的领域知识（可选参考）
Hooks 在 Agent 工具调用前后自动触发，不需要用户干预

九、记忆持久化与持续学习系统

9.1 完整会话生命周期

关键要点: SessionStart Hook 自动恢复上次会话的上下文，无需手动操作。每次响应后，系统自动触发 Session-End、Evaluate-Session 和 Cost-Tracker 三个 Hook，分别执行持久化、评估和成本追踪。这使得开发者可以跨会话继续工作，而不会丢失进度或上下文。

9.2 会话管理使用流程

关键要点: ECC 的会话管理完全自动化。即使不显式执行 /save-session，停止 Hook 也会在每次响应后异步保存会话状态。这意味着下次打开 Claude Code 时，SessionStart Hook 会自动恢复所有历史上下文，包括进行中的任务、依赖关系、甚至前一个会话的诊断信息。

9.3 上下文压缩策略

关键要点: 当上下文使用率超过建议阈值时（通常为 70-80%），suggest-compact Hook 会触发。开发者可以手动执行 /compact 来压缩上下文，或忽略建议继续工作。PreCompact Hook 确保在压缩前保存所有重要状态，防止数据丢失。

9.4 持续学习闭环

关键要点: 持续学习系统有四个环节：

观察 - 自动记录所有工具调用和结果
评估 - 自动分析可提取的有价值模式
提取 - 用户主动执行 /learn 来生成 Skill 文件
应用 - 新会话自动加载这些 Skill，提高解决问题的速度

这形成了一个闭环，每解决一个新问题都会增强系统的能力。

十、多Agent编排系统

10.1 Orchestrate 完整时序图

关键要点: /orchestrate 命令是 ECC 最强大的功能之一。它按顺序调用多个 Agent，每个 Agent 通过 Handoff Document 将工作成果传递给下一个 Agent。整个流程受质量门禁保护，最后输出 SHIP/NEEDS WORK/BLOCKED 的最终判定。

10.2 多Agent编排使用流程

10.3 Feature 编排完整时序

关键要点: 这个完整时序展示了 Handoff Document 如何在 Agent 间传递。每个 Agent 都可以看到前面 Agent 的工作成果和建议，这样可以避免重复工作并确保信息连贯。最终报告聚合了所有 Agent 的发现，提供了清晰的改进建议。

10.4 并行编排模式 (Git Worktree)

seedPaths 机制: 将选定的本地文件覆盖到 Worker 分支中，在保持隔离的同时暴露进行中的脚本和计划。

关键要点: 对于多语言项目，可以为不同语言创建独立的 Git Worktree，由不同的 Language Reviewer Agent 并行处理，最后合并结果。这大大提高了审查效率，尤其是在大型项目中。

十一、安全体系

11.1 多层安全防线

11.2 AgentShield 安全扫描

ECC 内置的安全扫描器，对齐 OWASP MCP Top 10 和 OWASP Agentic Applications Top 10：

npx ecc-agentshield scan

支持扫描: 插件代码、Hook 脚本、生命周期脚本、MCP 配置。

安全扫描触发机制: 当执行 /code-review 或 /orchestrate security 时，security-reviewer Agent 自动触发 AgentShield 扫描。同时，PreToolUse Hook 可以配置为在标准或严格 Profile 下自动运行安全检查。

十二、日常使用完整流程

12.1 新开发者的一天

关键要点: 每次打开 Claude Code，SessionStart Hook 都会自动恢复上次会话的完整上下文。这包括进行中的任务、当前分支、已安装的依赖版本等，使得开发者可以无缝继续工作。

12.2 新功能开发 — 完整 TDD 流程

关键要点: 整个流程中，/plan 阶段会阻塞直到用户明确说 ‘proceed’——这体现了 ECC "研究优先"的理念。任何阶段失败都会回退到相邻阶段（如审查失败回退到编码阶段）而非从头开始，最大化保护已完成的工作。

12.3 快速修复 Bug

关键要点: Bug 修复流程相比新功能开发更精简，强调快速验证。TDD 阶段首先编写复现测试，确保问题可被再现，然后才编写修复代码。

12.4 一图看懂 ECC 日常使用

十三、使用场景与实战

场景一: 全栈功能开发（完整流程）

场景二: 多语言项目并行审查

同时对 TypeScript 前端 + Python 后端 + Go 微服务进行代码审查，利用 Git Worktree 隔离，3 个语言审查 Agent 并行工作，最终合并报告。

场景三: 遗留系统安全加固

architect → 分析现有架构风险 → security-reviewer → OWASP 全量扫描 → build-fix → 逐个修复 → tdd-guide → 为安全修复补充回归测试 → /quality-gate --strict 最终验证。

场景四: AI Agent 工具链调优

/harness-audit → 诊断当前 Claude Code 配置瓶颈 → harness-optimizer → 建议最小调整 (Hook profile 升级 / 模型路由优化 / Token 预算设置) → 验证前后对比。

场景五: 团队知识持续积累

每位开发者在解决复杂问题后运行 /learn，自动提取模式到 ~/.claude/skills/learned/。新成员加入时，Agent 自动加载团队积累的知识库，实现组织记忆的持续增长。

场景六: 从零开始的新项目

场景七: 加入已有项目

十四、质量门禁与工具链优化

14.1 工具链审计与优化流程

关键要点: /harness-audit 不仅诊断问题，还由 harness-optimizer Agent 智能分析并提出改进建议。这些建议往往是最小化且可逆的，不涉及产品代码改动，而是优化工具链配置来提升 Agent 效能。

十五、故障排查

十六、项目文件结构（完整版）

everything-claude-code/
├── CLAUDE.md                    # Claude Code 入口配置（定义项目身份、测试命令、组件架构）
├── manifest.json                # 选择性安装清单
├── install.sh / install.ps1     # 跨平台安装入口
│
├── agents/                      # 28个 Agent 定义 (.md + YAML frontmatter)
│   ├── planner.md               #   Opus - 实施规划
│   ├── architect.md             #   架构设计
│   ├── chief-of-staff.md        #   Opus - 通信管理
│   ├── code-reviewer.md         #   Sonnet - 代码审查
│   ├── security-reviewer.md     #   安全漏洞检测
│   ├── tdd-guide.md             #   Sonnet - TDD 指导
│   ├── e2e-runner.md            #   Sonnet - E2E 测试
│   ├── build-error-resolver.md  #   通用构建修复
│   ├── refactor-cleaner.md      #   死代码清理
│   ├── doc-updater.md           #   Haiku - 文档同步
│   ├── harness-optimizer.md     #   Sonnet - 工具链优化
│   ├── loop-operator.md         #   Sonnet - 自主循环
│   ├── docs-lookup.md           #   文档检索
│   ├── typescript-reviewer.md   #   TS 审查
│   ├── python-reviewer.md       #   Python 审查
│   ├── go-reviewer.md           #   Go 审查
│   ├── java-reviewer.md         #   Java 审查
│   ├── kotlin-reviewer.md       #   Kotlin 审查
│   ├── rust-reviewer.md         #   Rust 审查
│   ├── cpp-reviewer.md          #   C++ 审查
│   ├── flutter-reviewer.md      #   Flutter 审查
│   ├── database-reviewer.md     #   数据库审查
│   ├── go-build-resolver.md     #   Go 构建修复
│   ├── java-build-resolver.md   #   Java 构建修复
│   ├── kotlin-build-resolver.md #   Kotlin 构建修复
│   ├── rust-build-resolver.md   #   Rust 构建修复
│   ├── cpp-build-resolver.md    #   C++ 构建修复
│   └── pytorch-build-resolver.md#   PyTorch 构建修复
│
├── commands/                    # 60+ 斜杠命令定义 (.md)
│   ├── plan.md                  #   /plan → planner
│   ├── tdd.md                   #   /tdd → tdd-guide
│   ├── code-review.md           #   /code-review → code-reviewer
│   ├── build-fix.md             #   /build-fix → build-error-resolver
│   ├── e2e.md                   #   /e2e → e2e-runner
│   ├── orchestrate.md           #   /orchestrate → 多Agent链
│   ├── learn.md                 #   /learn → 模式提取
│   ├── quality-gate.md          #   /quality-gate → 质量检查
│   ├── verify.md                #   /verify → 最终验证
│   ├── sessions.md              #   /sessions → 会话管理
│   └── ...                      #   还有50+命令
│
├── skills/                      # 125+ 技能知识库 (每个子目录一个技能)
│   ├── python-patterns/         ├── react-patterns/
│   ├── go-patterns/             ├── django/
│   ├── typescript-testing/      ├── spring-boot/
│   ├── docker/                  ├── agent-eval/
│   ├── autonomous-loops/        ├── continuous-learning-v2/
│   ├── market-research/         ├── video-editing/
│   └── ...                      #   还有100+技能
│
├── rules/                       # 规则系统
│   ├── common/                  #   8个通用规则
│   │   ├── coding-style.md      │   ├── git-workflow.md
│   │   ├── testing.md           │   ├── performance.md
│   │   ├── patterns.md          │   ├── security.md
│   │   ├── hooks.md             │   └── agents.md
│   ├── typescript/              ├── python/
│   ├── golang/                  ├── rust/
│   ├── java/                    ├── kotlin/
│   ├── cpp/                     ├── csharp/
│   ├── swift/                   ├── php/
│   ├── perl/                    └── dart/
│
├── hooks/
│   ├── hooks.json               # 完整 Hook 生命周期配置
│   └── README.md
│
├── scripts/                     # 26+ Node.js/Shell 脚本
│   ├── install-plan.js          #   安装规划
│   ├── install-apply.js         #   安装执行
│   ├── setup-package-manager.js #   包管理器检测
│   ├── doctor.js                #   系统诊断
│   ├── orchestrate-worktrees.js #   Worktree 编排
│   ├── orchestration-status.js  #   编排状态
│   ├── sessions-cli.js          #   会话 CLI
│   ├── session-inspect.js       #   会话检查
│   ├── skills-health.js         #   技能健康检查
│   ├── harness-audit.js         #   工具链审计
│   ├── repair.js                #   修复
│   └── hooks/                   #   Hook 脚本目录
│       ├── run-with-flags.js    #     Profile 过滤器
│       ├── session-start.js     #     会话启动
│       ├── session-end.js       #     会话持久化
│       ├── pre-compact.js       #     压缩前保存
│       ├── suggest-compact.js   #     压缩建议
│       ├── quality-gate.js      #     质量门禁
│       ├── cost-tracker.js      #     成本追踪
│       ├── evaluate-session.js  #     会话评估
│       ├── config-protection.js #     配置保护
│       └── ...
│
├── mcp-configs/                 # MCP 外部集成配置
├── tests/                       # 997+ 测试用例
│   ├── run-all.js
│   ├── utils.test.js
│   ├── package-manager.test.js
│   └── hooks.test.js
│
├── docs/
│   ├── ECC-2.0-REFERENCE-ARCHITECTURE.md
│   ├── token-optimization.md
│   ├── continuous-learning-v2-spec.md
│   ├── zh-CN/                   #   中文文档
│   └── ko-KR/                   #   韩文文档
│
└── SECURITY.md                  # 安全策略 (v1.8+ 支持, AgentShield)

十七、核心设计理念

理念	体现	关键机制
模块化	Agent/Skill/Rule/Hook 各自独立，按需组合	manifest.json 选择性安装
分层覆盖	通用规则 → 语言特定覆盖	`../common/xxx.md` 扩展
Token即资源	上下文窗口是稀缺资源	suggest-compact Hook + 模型路由
记忆持久化	打破会话隔离	session-start/end + .claude/memory/
持续学习	自动观察 → 评估 → 提取	observe.sh + evaluate-session + /learn
研究优先	先调研再编码	/plan 必须等用户批准后才写代码
可观测性	全程可观测	session-inspect + orchestration-status + cost-tracker
渐进增强	从 minimal 到 strict	ECC_HOOK_PROFILE 三级配置
安全纵深	多层防御	Hook拦截 → Agent审查 → 门禁 → AgentShield
并行优先	独立任务必须并行	Git Worktree + 多Agent并行

十八、总结

对于已在使用 Claude Code / Cursor / Codex 的团队，ECC 是一个值得认真评估的系统级效率放大器——它不只是让 AI 写代码更快，而是让 AI 开发流程更可控、更可积累、更安全。

从安装的那一刻起，ECC 就通过 Hook 和 SessionStart 自动恢复上下文，开发者可以跨会话继续工作。每个命令都经过精心设计，从 /plan 的规划阶段阻塞到 /orchestrate 的多 Agent 编排，再到 /learn 的知识沉淀，整个工作流形成一个完整的反馈闭环。随着时间的推移，团队的 Skills 库会越来越丰富，每个新问题的解决速度都会加快，这正是 ECC "持续学习"理念的体现。