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

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

7.1 核心命令详解

/plan --- 任务规划命令

Planner Agent /plan 用户 Planner Agent /plan 用户 ⚠️ 关键约束: 不写任何代码直到用户明确说 "proceed" alt [批准] [修改] [换方案] /plan 实现用户认证功能激活 Planner Agent (Opus) 1. 需求重述 --- 明确构建目标 2. 风险识别 --- 潜在问题和阻塞 3. 阶段拆解 --- 可执行步骤输出计划 (等待批准) "yes" / "proceed" "modify: 先做阶段3" 调整计划更新后的计划 "different approach: 用JWT而非Session" 重新规划

/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 结构:

markdown 复制代码

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

## Findings
[关键发现]

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

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

## Recommendations
[建议下一步]

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

/build-fix --- 构建修复命令

修复引入更多问题
同一错误失败3次
需要架构变更
修复成功
否
是
单错误修复循环
读取受影响文件 + 上下文
诊断根因
应用最小修复
重新构建验证
/build-fix
检测构建系统

package.json / tsconfig / Cargo.toml

pom.xml / build.gradle / go.mod
执行构建命令
解析错误输出

按文件路径分组

按依赖序排优先级
护栏检查
输出摘要报告
⚠️ 停止，咨询用户
还有错误?

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

/learn --- 模式学习命令

提取 4 类有价值模式:

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

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

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

完整 /learn 使用流程:
🔄 未来自动应用
📁 输出
🧠 自动分析当前会话
琐碎
有价值
📝 4类可提取模式
错误解决模式

根因 + 修复方案 + 复用性
调试技巧

非显而易见的步骤 + 工具组合
变通方案

库缺陷 + API限制 + 版本方案
项目模式

架构决策 + 集成方法
解决了一个复杂技术问题

例如: 修复了 Webpack 5 的 Module Federation

在 SSR 下的内存泄露
/learn
扫描会话中的所有交互
是否值得提取?
❌ 跳过: typo修复、一次性问题
✅ 提取有价值模式
~/.claude/skills/learned/

webpack-ssr-memory-leak.md

Problem

Module Federation + SSR 导致内存泄露

Solution

在 dispose handler 中清理共享模块缓存

Example

```js

module.hot.dispose(() => ...

```

Triggers

SSR + Module Federation + 内存增长
下次会话遇到类似问题
Agent 自动加载 learned/ 技能
更快解决问题

/quality-gate --- 质量门禁命令

bash 复制代码

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

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

完整 /quality-gate 使用流程:
通过
可自动修复
需手动修复
⚡ 4步质量流水线
Step 1: 识别语言工具

检测 Biome/Prettier + ESLint + tsc
Step 2: 格式化检查

npx biome check 或 npx prettier --check
Step 3: Lint + 类型检查

npx eslint . && npx tsc --noEmit
Step 4: 生成报告
/quality-gate . --strict
结果
✅ 全部通过
/quality-gate . --fix

自动修复可修复项
❌ 需手动修复的问题列表

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

7.2 常用命令速查表

按使用频率排列:
🔹 低频 --- 按需使用
/orchestrate feature '描述'

多Agent编排
/harness-audit

工具链审计
/sessions

查看历史会话
/setup-pm

配置包管理器
🔸 中频 --- 每周使用
/e2e

E2E 测试
/verify

最终验证
/learn

提取模式
/quality-gate

质量门禁
⭐ 高频 --- 每天使用
/plan '描述'

规划任何功能
/tdd

TDD 开发
/code-review

代码审查
/build-fix

构建修复

命令与 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 技能全景分类

125+ Skills
编程语言
Python 模式/测试/安全
TypeScript 模式/测试
Go 模式/测试/安全
Java 模式/测试
Kotlin 模式
Rust 模式/安全
C++ 模式
Perl 模式
Swift 模式
Dart/Flutter
框架
Django
Laravel
Spring Boot
Ktor
React / Next.js
Nuxt
Android / Compose
iOS / SwiftUI
基础设施
Docker
数据库迁移
部署模式
CI/CD
ClickHouse
Agent工程
agent-eval 评估
agent-harness-construction 构建
agentic-engineering 工程
autonomous-loops 自主循环
continuous-agent-loop 持续循环
enterprise-agent-ops 企业运维
continuous-learning-v2 持续学习
业务领域
市场调研
投资材料
内容引擎
文章写作
视频处理
能源采购
海关合规
物流管理
代码质量
代码质量强制
编码标准
设计模式

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

显式调用
映射到
约束
知识注入
前后自动触发
执行结果
自动触发
可调用
用户操作
Commands (入口)

用户显式调用

如 /tdd, /plan
Agents (执行者)

承接命令/自动触发

如 planner, tdd-guide
Rules (约束)

始终生效的强制规范

如 '函数≤50行'
Skills (知识)

按需加载的参考手册

如 'React最佳实践'
Hooks (自动化)

事件触发的脚本

如 'commit前安全检查'

核心关系总结:

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

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

9.1 完整会话生命周期

Learn System Cost-Tracker Hook Evaluate-Session Hook Session-End Hook Suggest-Compact Hook Observe Hook (每次工具调用) 开发工作 SessionStart Hook 文件系统 .claude/memory/ Learn System Cost-Tracker Hook Evaluate-Session Hook Session-End Hook Suggest-Compact Hook Observe Hook (每次工具调用) 开发工作 SessionStart Hook 文件系统 .claude/memory/ loop [每次工具调用] 加载上次会话上下文历史状态 + 包管理器配置注入历史上下文 PreToolUse: 记录工具使用观察执行工具 PostToolUse: 记录工具结果 Edit/Write 时触发建议: "建议压缩上下文" 用户主动执行 /learn 分析当前会话提取有价值模式保存到 ~/.claude/skills/learned/ Stop Hook 触发 (每次响应后) 持久化当前会话状态 (async) Stop Hook 触发 (每次响应后) 评估可提取模式 (async) Stop Hook 触发 (每次响应后) 记录 Token 和成本指标 (async)

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

9.2 会话管理使用流程

♻️ 恢复会话
新开 Claude Code 会话
SessionStart Hook

自动加载上次上下文
/sessions

查看所有历史会话
/resume-session

手动恢复特定会话
💾 保存会话
正在开发中...
/save-session

或 /checkpoint
状态已保存到

~/.claude/memory/
自动保存

(Stop Hook 每次响应后自动触发)

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

9.3 上下文压缩策略

会话状态 suggest-compact Hook ECC 开发者会话状态 suggest-compact Hook ECC 开发者长时间开发，上下文窗口逐渐消耗 alt [接近上下文窗口上限] [上下文充足] loop [每次 Edit/Write 操作] 触发 suggest-compact 计算当前上下文使用率 💡 建议: "当前上下文接近上限，建议运行 /compact" /compact PreCompact Hook → 保存当前状态压缩上下文 (保留关键信息) ✅ 上下文已压缩，可继续工作 (静默，不打扰)

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

9.4 持续学习闭环

🔄 应用 (自动)
📝 提取 (用户触发)
🧠 评估 (自动)
👁️ 观察 (自动)
~/.claude/skills/learned/
影响后续开发
observe.sh

PreToolUse: 记录工具调用
observe.sh

PostToolUse: 记录结果
evaluate-session.js

Stop Hook: 评估可提取模式
/learn 命令
分析会话，识别4类模式
过滤琐碎/一次性问题
生成 Skill 文件
下次会话 SessionStart
Agent 按需加载 learned/ 技能

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

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

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

十、多Agent编排系统

10.1 Orchestrate 完整时序图

Quality Gate Security Reviewer Agent Code Reviewer Agent TDD Guide Agent Planner Agent orchestrate-worktrees.js /orchestrate 用户 Quality Gate Security Reviewer Agent Code Reviewer Agent TDD Guide Agent Planner Agent orchestrate-worktrees.js /orchestrate 用户 Phase 1: 规划 Phase 2: TDD Phase 3: 代码审查 Phase 4: 安全审查分布式模式: 可使用 tmux pane workers + 独立 Git Worktrees 通过 seedPaths 配置覆盖文件到 Worker 分支 /orchestrate "实现JWT认证" 选择工作流: Feature Implementation 调用 Planner + 用户需求上下文分析需求，生成实施计划 Handoff Doc 1 {context, findings, files, questions} 调用 TDD Guide + Handoff Doc 1 编写测试 → 实现代码 → 验证覆盖率 Handoff Doc 2 {context, modified_files, test_results} 调用 Code Reviewer + Handoff Doc 2 4级严重度审查 Handoff Doc 3 {findings, severity, recommendations} 调用 Security Reviewer + Handoff Doc 3 OWASP Top 10 逐项验证 Handoff Doc 4 {vulnerabilities, fixes, risk_level} 聚合所有结果 → 最终质量检查 SHIP / NEEDS WORK / BLOCKED 最终编排报告

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

10.2 多Agent编排使用流程

🎭 /orchestrate 四种模板
/orchestrate feature '描述'

planner → tdd-guide → code-reviewer → security-reviewer
/orchestrate bugfix '描述'

planner → tdd-guide → code-reviewer
/orchestrate refactor '描述'

architect → code-reviewer → tdd-guide
/orchestrate security '描述'

security-reviewer → code-reviewer → architect
/orchestrate custom 'architect,tdd-guide,code-reviewer' '描述'

自定义Agent链

10.3 Feature 编排完整时序

Security Reviewer Code Reviewer (Sonnet) TDD Guide (Sonnet) Planner (Opus) /orchestrate 用户 Security Reviewer Code Reviewer (Sonnet) TDD Guide (Sonnet) Planner (Opus) /orchestrate 用户 🔵 Agent 1: Planner context: "支付集成需要3个阶段" findings: "现有 OrderService 需扩展" files: ["src/services/payment.ts"] questions: ["使用Stripe还是PayPal?"] recommendations: ["先集成Stripe"] 🟢 Agent 2: TDD Guide context: "完成12个测试用例" modified_files: ["src/services/payment.ts", "tests/payment.test.ts"] test_results: "12/12 pass, 94% coverage" 🟠 Agent 3: Code Reviewer findings: [{severity: "HIGH", issue: "缺少金额溢出检查"}] verdict: "WARNING" 🔴 Agent 4: Security Reviewer vulnerabilities: [{ type: "A03 敏感数据暴露", issue: "API key 未加密存储"}] risk_level: "MEDIUM" /orchestrate feature "实现支付集成" 任务描述 + 项目上下文分析需求、审查架构、拆解步骤 📄 Handoff Doc 1 Handoff Doc 1 + 测试要求 RED → GREEN → REFACTOR 📄 Handoff Doc 2 Handoff Doc 2 + 变更 diff 4级严重度审查 📄 Handoff Doc 3 Handoff Doc 3 + 安全上下文 OWASP Top 10 逐项检查 📄 Handoff Doc 4 聚合所有 Handoff Doc 📊 最终报告建议: NEEDS WORK (1 HIGH + 1 MEDIUM 安全问题) 根据报告修复后重新 /orchestrate

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

10.4 并行编排模式 (Git Worktree)

结果合并
每个Worktree独立运行Agent
orchestrate-worktrees.js
git worktree add
git worktree add
git worktree add
main 分支
worktree-1

分支: ecc/ts-review
worktree-2

分支: ecc/py-review
worktree-3

分支: ecc/go-review
TypeScript Reviewer
Python Reviewer
Go Reviewer
合并报告
orchestration-status.js

控制面板快照

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

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

十一、安全体系

11.1 多层安全防线

第4层: 外部工具
AgentShield

npx ecc-agentshield scan
npm audit
eslint-plugin-security
第3层: 质量门禁
quality-gate Hook

自动质量检查
/quality-gate 命令

手动质量检查
第2层: Agent 审查
security-reviewer

OWASP Top 10
code-reviewer

CRITICAL级安全检查
第1层: PreToolUse 拦截
block-no-verify

阻止绕过Git Hook
insaits-security

AI安全扫描
config-protection

配置文件保护

11.2 AgentShield 安全扫描

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

bash 复制代码

npx ecc-agentshield scan

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

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

十二、日常使用完整流程

12.1 新开发者的一天

~/.claude/memory/ SessionStart Hook ECC (Claude Code) 开发者 ~/.claude/memory/ SessionStart Hook ECC (Claude Code) 开发者这一切自动发生，无需手动操作打开 Claude Code 自动触发 SessionStart 加载上次会话上下文历史状态 + 进行中任务检测包管理器 (npm/pnpm/yarn/bun) ✅ 上下文已恢复就绪 (上次进度已加载)

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

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

阶段6: 最终验证与学习
阶段5: E2E 测试
阶段4: 代码审查
阶段3: 构建与修复
阶段2: TDD 开发
阶段1: 规划
批准
修改
≥80%
<80%
成功
失败
APPROVE
CRITICAL/HIGH
通过
失败
📋 需求: 实现用户注册功能
/plan '实现用户注册功能,包括邮箱验证和密码加密'
Planner Agent (Opus) 输出:

• 3阶段实施计划

• 受影响文件列表

• 风险评估
等待用户审批
用户回复: 'proceed'
用户回复: 'modify: 先做邮箱验证'
/tdd
🔴 RED: 编写失败测试

• register() 基本功能

• 邮箱格式校验

• 密码强度检查

• 重复注册拒绝
🟢 GREEN: 最小通过代码

• UserService.register()

• EmailValidator

• PasswordHasher
🔵 REFACTOR: 改进代码

• 提取常量

• 优化错误消息

• 添加类型标注
覆盖率 ≥80%?
/build-fix
执行构建命令
构建是否成功?
Build Resolver 自动修复

• 解析错误输出

• 逐个修复

• 重新构建验证
/code-review
Code Reviewer 审查

• CRITICAL: 安全检查

• HIGH: 质量检查

• MEDIUM: 性能检查

• LOW: 实践检查
审查结果?
/e2e
E2E Runner 生成并执行

• 注册成功流程

• 邮箱验证流程

• 错误输入拒绝
通过率 >95%?
/verify
/learn
会话自动保存

(Stop Hook)
✅ 功能完成

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

12.3 快速修复 Bug

🐛 发现 Bug
/plan 'Fix: 登录超时不返回错误信息'
/tdd

先写复现测试
编写修复代码
/build-fix
/code-review
✅ 提交

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

12.4 一图看懂 ECC 日常使用

新功能
修 Bug
重构
安全审查
优化工具链
清理代码
🖥️ 打开 Claude Code

(SessionStart 自动恢复上下文)
今天要做什么?
/plan → /tdd → /build-fix → /code-review → /e2e
/plan → /tdd (先写复现测试) → /build-fix → /code-review
/orchestrate refactor '描述'
/orchestrate security '描述'
/harness-audit
refactor-cleaner Agent (npx knip)
/learn

提取今天的经验
关闭会话

(Stop Hook 自动保存状态 + 追踪成本)
明天打开时

SessionStart 自动恢复一切

十三、使用场景与实战

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

proceed
modify
失败
成功
CRITICAL/HIGH
APPROVE
漏洞
通过
失败
通过
产品需求: 实现JWT认证
/plan

Planner Agent 生成

3阶段实施计划
用户审批?
/tdd

TDD Guide 编写

认证测试套件
编写实现代码

AuthService + Middleware
/build-fix

Build Resolver 修复

TypeScript编译错误
/code-review

Code Reviewer 审查

4级严重度检查
Security Reviewer

OWASP验证

密钥管理检查
/e2e

E2E Runner 生成

提取JWT集成模式

保存到Skills库

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

同时对 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 自动加载团队积累的知识库，实现组织记忆的持续增长。

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

每个功能
5️⃣ 知识沉淀
/learn

提取项目特有模式
团队成员共享

~/.claude/skills/learned/
4️⃣ 集成测试
/e2e
/quality-gate --strict
3️⃣ 功能迭代 (重复)
/plan '实现功能X'
/tdd
/build-fix
/code-review
2️⃣ 架构规划
/plan '搭建 Next.js + Prisma + NextAuth 项目骨架'
Planner Agent 输出分阶段计划
用户批准计划
1️⃣ 安装配置 (5分钟)
/plugin marketplace add affaan-m/everything-claude-code

/plugin install everything-claude-code@everything-claude-code
git clone && ./install.sh typescript
export ECC_HOOK_PROFILE=standard
创建新项目

场景七: 加入已有项目

加入一个已有项目
安装 ECC + 项目对应语言规则
打开 Claude Code
SessionStart 自动加载团队积累的 learned/ 技能
'帮我理解这个项目的架构'
docs-lookup Agent 检索项目文档
doc-updater Agent 生成 Codemap
/plan '修复 Issue #42'
/tdd → 编写复现测试 → 修复
/code-review → 确认修复符合项目规范
/learn → 提取首个项目模式

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

14.1 工具链审计与优化流程

/harness-audit
输出基线评分

hooks: 7/10

evals: 4/10

routing: 8/10

context: 5/10

safety: 9/10
Harness Optimizer Agent 分析
定位 Top 3 杠杆点:

evals 缺少基线 → 建议添加
context 管理低效 → 建议调整 compact 策略
模型路由可优化 → 建议 Haiku 处理简单任务
应用建议的配置调整
重新 /harness-audit 验证
前后对比报告

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

十五、故障排查

安装失败
运行太慢/太贵
Hook 报错
Skill 不工作
Skill 加载问题
node scripts/skills-health.js

技能健康检查
node scripts/session-inspect.js

会话状态检查
Hook 报错
ECC_DISABLED_HOOKS='问题hook'
检查 Node.js 版本 ≥18
查看 Hook 脚本错误输出
性能/成本问题
/harness-audit

工具链审计
检查 cost-tracker 输出
降级 ECC_HOOK_PROFILE=minimal
安装问题
node scripts/doctor.js

运行系统诊断
node scripts/repair.js

自动修复
node scripts/list-installed.js

检查已安装组件
遇到问题
什么类型的问题?

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

复制代码

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并行

十八、总结

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

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

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