AI Coding工程化架构ECC设计与 Agent-First 理念AICoding工程化之ECC 是什么 ECC (

一、概述

1.1 ECC 是什么

ECC (Everything Claude Code) 是一个为 Claude Code 提供完整生态系统的增强插件项目，其定位是 AI 代理性能优化系统。

ECC 的核心价值是让 Claude Code 从"单一工具"变成"智能开发团队"。

维度	说明
定义	一套分层的 AI 能力增强框架
目的	提升 AI 代理的专业性、可靠性和可维护性
价值	从"单一工具"变成"智能开发团队"
规模	38 个代理、156 个技能、72 个命令、90+ 规则、20+ 钩子

1.2 架构目标

目标	说明
专业性	通过领域专家代理提供专业能力
一致性	通过规则层强制执行开发标准
自动化	通过钩子层实现事件驱动的自动化
可扩展	通过技能层持续积累领域知识

二、ECC 核心概念

2.1 核心价值主张

单一代理工具  →  ECC 增强  →  智能协作团队
     │                           │
     ├─ 通用能力                  ├─ 专业领域专家
     ├─ 被动响应                  ├─ 主动智能触发
     └─ 单一视角                  └─ 多代理协作

2.2 设计哲学

原则	说明
分层解耦	各层职责明确，相互独立又协同工作
规则优先	标准和约束始终生效，不可跳过
代理驱动	专业代理主动执行任务，减少用户负担
知识积累	技能层持续沉淀可复用的领域知识
自动化增强	钩子层在关键时机自动执行增强操作

三、Agent-First 设计理念

3.1 什么是 Agent-First

Agent-First（代理优先） 是 ECC 的核心设计原则：

遇到任务时，优先委派给专业子代理处理，而非由主代理直接处理。

3.2 传统模式 vs Agent-First 模式

架构对比图

graph TB
    subgraph 传统模式
        U1[用户请求] --> AI1[单一 AI]
        AI1 --> R1[直接输出结果]
    end
    
    subgraph Agent-First模式
        U2[用户请求] --> Main[主代理]
        Main --> P[规划代理]
        Main --> T[测试代理]
        Main --> R[审查代理]
        Main --> S[安全代理]
        P --> OUT[协作输出]
        T --> OUT
        R --> OUT
        S --> OUT
    end

对比分析

维度	传统模式	Agent-First 模式
处理方式	单一 AI 直接处理	委派给专业子代理
专业性	通用能力	领域专家
主动性	被动响应	主动触发相关代理
质量保证	依赖单一判断	多代理协作审查
一致性	可能遗漏检查点	强制流程保证

3.3 Agent-First 的优势

优势	说明
领域专精	每个代理专注于特定领域，提供专业能力
主动服务	无需用户明确请求，系统自动识别并调用
质量保障	多代理协作形成交叉验证
可扩展性	易于添加新的专业代理
知识隔离	各代理的知识域相互独立，便于维护

3.4 触发模式分类

触发模式	含义	触发条件
主动触发 (PROACTIVELY)	系统自动识别场景并调用	检测到相关上下文
必须触发 (MUST BE USED)	特定条件下必须调用，不可跳过	满足预设条件规则
按需触发	用户明确请求时调用	用户命令或请求

3.5 Agent-First 具体实施实例

以下通过一个完整的用户认证功能开发场景，展示 Agent-First 原则中主动触发特性的具体运作方式。

说明： 本节聚焦于 Agent-First 的核心特性——主代理自动识别场景并委派。关于用户通过 Commands 入口触发的完整开发流程，详见第六章。

场景背景

用户请求： "帮我实现一个用户登录功能，支持 JWT 认证"

实施流程

sequenceDiagram
    autonumber
    participant U as 用户
    participant Main as 主代理
    participant Plan as planner<br/>规划代理
    participant TDD as tdd-guide<br/>测试代理
    participant Sec as security-reviewer<br/>安全代理
    participant Rev as code-reviewer<br/>审查代理
    participant Hook as Hooks
    
    Note over U,Hook: 阶段1: 主代理接收并委派
    U->>Main: 实现用户登录功能
    Main->>Main: 识别: 复杂功能请求
    Main->>Plan: PROACTIVELY 委派规划
    Plan->>Plan: 分析需求、评估风险
    Plan-->>U: 输出实现计划
    
    Note over U,Hook: 阶段2: TDD 代理引导测试
    U->>Main: 开始实现
    Main->>TDD: PROACTIVELY 委派测试引导
    TDD-->>U: 引导编写登录测试用例
    
    Note over U,Hook: 阶段3: 用户编写代码
    U->>Hook: 编写登录实现代码
    Hook->>Hook: PostToolUse 格式化
    
    Note over U,Hook: 阶段4: 安全代理自动触发
    Note over Sec: 检测到认证相关代码
    Sec->>Sec: MUST BE USED: 安全审查
    Sec-->>U: 安全检查报告<br/>⚠️ 发现: 密码未加密
    U->>Hook: 修复安全问题
    
    Note over U,Hook: 阶段5: 代码审查自动触发
    Note over Rev: 代码修改完成
    Rev->>Rev: PROACTIVELY: 代码质量审查
    Rev-->>U: 审查报告<br/>⚠️ 建议: 添加错误处理
    U->>Hook: 优化代码
    
    Note over U,Hook: 阶段6: 提交前检查
    U->>Hook: git commit
    Hook->>Hook: PreCommit Hook 触发
    Hook-->>U: ✅ 所有检查通过，提交成功

代理委派详解

阶段	触发时机	委派的代理	触发模式	代理职责
规划	识别到复杂功能请求	planner	主动触发	创建实现计划、识别依赖、评估风险
测试引导	用户开始实现	tdd-guide	主动触发	引导 RED-GREEN-REFACTOR 循环
安全审查	检测到认证代码	security-reviewer	必须触发	检查密码加密、Token 安全、输入验证
代码审查	代码修改完成	code-reviewer	主动触发	检查代码质量、可维护性、命名规范

与传统模式对比

对比维度	传统模式	Agent-First 模式
规划阶段	用户自行规划或 AI 简单建议	planner 代理输出详细实现计划
测试阶段	实现后可能忘记测试	tdd-guide 强制测试先行
安全检查	可能遗漏或事后补救	security-reviewer 自动检测敏感代码
代码审查	依赖人工或跳过	code-reviewer 自动审查
最终质量	不确定，依赖开发者经验	系统化保证，强制流程执行

关键体现

无需用户明确请求：用户只说"实现登录功能"，系统自动识别并委派给专业代理
多代理协作：规划、测试、安全、审查四个代理各司其职，形成完整工作流
强制流程保证：安全敏感代码触发 MUST BE USED 模式，不可跳过
质量内建：问题在开发过程中被发现和修复，而非事后补救

四、五层架构详解

4.1 架构总览

graph TB
    subgraph 五层架构
        L1[第1层: Rules<br/>规则层]
        L2[第2层: Skills<br/>知识层]
        L3[第3层: Agents<br/>执行层]
        L4[第4层: Commands<br/>入口层]
        L5[第5层: Hooks<br/>触发层]
    end
    
    L1 -->|约束| L3
    L2 -->|参考| L3
    L4 -->|路由| L3
    L5 -->|增强| L3
    
    style L1 fill:#e1f5fe
    style L2 fill:#e8f5e9
    style L3 fill:#fff3e0
    style L4 fill:#fce4ec
    style L5 fill:#f3e5f5

4.2 各层职责矩阵

层级	组件	定位	核心职责	触发方式	主动性
第1层	Rules	规则引擎	定义标准、约束行为、始终生效	始终生效	被动
第2层	Skills	知识库	提供深度知识、代码示例、最佳实践	需要时参考	被动
第3层	Agents	执行者	执行任务、调用工具、输出结果	主动/强制/按需	主动
第4层	Commands	快捷入口	用户入口、参数解析、路由调用	用户触发	手动
第5层	Hooks	自动化触发器	事件驱动、时机自动执行脚本	事件触发	自动

4.3 第1层：Rules（规则层）

功能定位

Rules 是架构的"宪法层"，定义必须遵守的标准。

维度	说明
核心职责	定义开发标准、约束行为、提供检查清单
触发机制	始终生效，不可跳过
存在形式	声明性规则、条件约束、验收标准

规则类型

规则类型	说明	示例
编码规范	代码风格、命名约定、文件组织	不可变性原则、最大行数限制
测试要求	覆盖率阈值、测试类型要求	最低 80% 覆盖率、TDD 强制
安全标准	安全检查清单、密钥管理	无硬编码密钥、输入验证
审查标准	审查触发条件、严重程度分级	提交前必须审查、问题分级

规则优先级

graph LR
    A[通用规则] -->|基础| B[领域规则]
    B -->|扩展| C[语言特定规则]
    C -->|覆盖| D[项目规则]
    
    style A fill:#e3f2fd
    style B fill:#e8f5e9
    style C fill:#fff8e1
    style D fill:#fce4ec

优先级原则： 语言特定规则 > 通用规则 (common/)。当语言特定规则与通用规则冲突时，语言特定规则优先。类似 CSS 特异性或 .gitignore 优先级模式。

4.4 第2层：Skills（知识层）

功能定位

Skills 是架构的"教科书层"，提供如何执行的指南。

维度	说明
核心职责	提供深度知识、代码示例、最佳实践
触发机制	需要时参考，不强制执行
存在形式	详细文档、模式库、参考指南

技能分类

分类	说明	示例
架构设计	系统设计模式、架构最佳实践	API 设计、后端模式、前端模式
编程语言	语言特定惯用法和模式	Python 模式、Go 惯用法
测试质量	测试策略、质量保证方法	TDD 工作流、E2E 测试
安全领域	安全审查清单、防护模式	安全审查、漏洞防护
工具集成	工具使用指南、配置方法	运行时配置、部署模式

Skills vs Rules 区别

对比维度	Rules	Skills
本质	约束条件	参考文档
作用	告诉你做什么	告诉你怎么做
强制性	必须遵守，始终生效，不可跳过	建议参考，按需使用
粒度	原则性声明、检查清单	详细指南、代码示例
示例	"80%测试覆盖率"、"无硬编码密钥"	python-patterns 详细指南

4.5 第3层：Agents（执行层）

功能定位

Agents 是架构的"执行层"，是实际干活的专家。

维度	说明
核心职责	执行任务、调用工具、输出结果
触发机制	主动触发、强制触发、按需触发
存在形式	专业领域代理、工作流编排器

代理分类

分类	职责	典型代理
架构规划类	任务规划、架构设计	planner、architect
测试质量类	测试驱动、质量保证	tdd-guide、e2e-runner、database-reviewer
安全类	漏洞检测	security-reviewer
代码审查类	代码审查（通用+语言特定）	code-reviewer、typescript-reviewer、python-reviewer、go-reviewer、rust-reviewer、java-reviewer、kotlin-reviewer、cpp-reviewer、flutter-reviewer、healthcare-reviewer
构建错误解决类	构建修复、错误解决	build-error-resolver、cpp-build-resolver、go-build-resolver、java-build-resolver、kotlin-build-resolver、rust-build-resolver、pytorch-build-resolver
文档知识类	文档维护、知识管理	doc-updater、docs-lookup
自动化循环类	循环执行、配置调优	loop-operator、harness-optimizer
开源流水线类	开源分支、打包、清理	opensource-forker、opensource-packager、opensource-sanitizer
特殊领域类	GAN、性能优化、代码清理	gan-planner、gan-generator、gan-evaluator、performance-optimizer、refactor-cleaner

代理触发矩阵

触发场景	触发模式	调用的代理
复杂功能请求	主动触发 (PROACTIVELY)	planner
代码刚写完/修改	主动触发 (PROACTIVELY)	code-reviewer
Bug 修复或新功能	主动触发 (PROACTIVELY)	tdd-guide
架构决策	主动触发 (PROACTIVELY)	architect
安全敏感代码	主动触发 (PROACTIVELY)	security-reviewer
自主循环/循环监控	主动触发 (PROACTIVELY)	loop-operator
Harness 配置调优	主动触发 (PROACTIVELY)	harness-optimizer
特定语言项目	必须触发 (MUST BE USED)	语言特定审查代理
用户明确请求	按需触发	对应功能代理

4.6 第4层：Commands（入口层）

功能定位

Commands 是架构的"入口层"，提供用户快捷调用方式。

维度	说明
核心职责	用户入口、参数解析、路由调用
触发机制	用户手动触发
存在形式	斜杠命令、快捷入口

命令分类

分类	说明	示例命令
审查类	触发代码审查流程	/code-review, /security-scan
构建类	触发构建修复流程	/build-fix
测试类	触发测试流程	/tdd, /test-coverage
规划类	触发规划流程	/plan
管理类	会话和项目管理	/save-session, /projects

命令路由机制

graph LR
    U[用户输入命令] --> P[参数解析]
    P --> R[路由判断]
    R -->|审查| A1[审查代理]
    R -->|测试| A2[测试代理]
    R -->|构建| A3[构建代理]
    R -->|规划| A4[规划代理]
    
    style U fill:#e8eaf6
    style P fill:#e3f2fd
    style R fill:#e8f5e9

4.7 第5层：Hooks（触发层）

功能定位

Hooks 是架构的"触发层"，实现事件驱动的自动化。

维度	说明
核心职责	事件响应、自动化增强、质量保证
触发机制	事件驱动，自动触发
存在形式	钩子脚本、自动化规则

钩子类型

钩子类型	触发时机	用途	能否阻止
PreToolUse	工具调用前	验证参数、阻止危险操作	能 (exit 2)
PostToolUse	工具调用后	格式化、自动修复、审计	不能
Stop	每次 Claude 响应后	会话总结、批量处理	不能
SessionStart	会话开始时	加载上下文、环境检测	不能
SessionEnd	会话结束时	清理、保存状态	不能
PreCompact	上下文压缩前	保存状态	不能

注意： PreCommit 类型的 Hook 实际上是 PreToolUse Hook 的一种特殊应用，在 git commit 操作前触发，用于代码检查和测试运行。

钩子执行流程

sequenceDiagram
    participant User as 用户
    participant Hook as 钩子系统
    participant Tool as 工具
    participant PostHook as 后置钩子
    
    User->>Hook: 请求执行操作
    Hook->>Hook: PreToolUse 检查
    alt 验证通过
        Hook->>Tool: 执行工具
        Tool-->>Hook: 返回结果
        Hook->>PostHook: PostToolUse 处理
        PostHook-->>User: 返回增强结果
    else 验证失败
        Hook-->>User: 阻止操作并提示
    end

五、组件协作机制

5.1 层间依赖关系

graph TB
    subgraph 用户层
        C[Commands]
    end
    
    subgraph 核心层
        R[Rules] -->|约束| A[Agents]
        S[Skills] -->|参考| A
        C -->|路由| A
    end
    
    subgraph 增强层
        H[Hooks] -->|增强| A
    end
    
    A -->|输出| Result[执行结果]
    
    style R fill:#e1f5fe
    style S fill:#e8f5e9
    style A fill:#fff3e0
    style C fill:#fce4ec
    style H fill:#f3e5f5

5.2 协作流程

flowchart TD
    Start([开始]) --> Check{用户操作类型?}
    
    Check -->|输入命令| Cmd[Commands 入口]
    Check -->|修改代码| Auto[自动触发]
    
    Cmd --> Parse[参数解析]
    Parse --> Route[路由到 Agent]
    
    Auto --> Detect[场景检测]
    Detect --> Trigger[触发 Agent]
    
    Route --> Agent[Agent 执行]
    Trigger --> Agent
    
    Agent -->|参考| Skill[Skills 知识]
    Agent -->|遵守| Rule[Rules 规则]
    
    Agent --> Hook[Hooks 增强]
    Hook --> Output([输出结果])
    
    style Start fill:#c8e6c9
    style Output fill:#c8e6c9
    style Agent fill:#fff3e0
    style Rule fill:#e1f5fe
    style Skill fill:#e8f5e9

5.3 组件交互矩阵

场景	Rules	Skills	Agents	Commands	Hooks
编写新功能	✅ 约束	✅ 参考	✅ 规划/测试/审查	-	✅ 格式化
代码审查	✅ 标准	✅ 指南	✅ 执行	✅ 入口	-
修复 Bug	✅ 约束	✅ 参考	✅ 测试/修复	-	✅ 检查
提交代码	✅ 标准	-	✅ 安全检查	-	✅ PreCommit
查阅文档	-	✅ 知识	✅ 查询	✅ 入口	-

六、时序图与流程分析

本章展示用户通过 Commands 入口触发的完整开发流程，与第三章的 Agent-First 主动触发场景形成互补：第三章侧重自动识别与委派，本章侧重用户触发与组件协作。

6.1 完整开发流程时序图

sequenceDiagram
    autonumber
    participant U as 用户
    participant C as Commands
    participant A as Agents
    participant S as Skills
    participant R as Rules
    participant H as Hooks
    
    Note over U,H: 阶段1: 规划
    U->>C: /plan 实现登录功能
    C->>A: 路由到规划代理
    A->>R: 检查规划规则
    R-->>A: 规则约束
    A->>S: 参考架构模式
    S-->>A: 模式指南
    A-->>U: 输出实现计划
    
    Note over U,H: 阶段2: TDD
    U->>C: /tdd
    C->>A: 路由到 TDD 代理
    A->>R: 检查测试规则(80%覆盖)
    R-->>A: 测试要求
    A->>S: 参考测试模式
    S-->>A: 测试指南
    loop RED-GREEN-REFACTOR
        A-->>U: 引导写测试
        U->>A: 编写测试代码
        A->>H: PostToolUse 触发
        H->>H: 格式化+检查
    end
    A-->>U: 测试完成
    
    Note over U,H: 阶段3: 实现
    U->>A: 编写实现代码
    A->>H: PostToolUse 触发
    H->>H: 格式化+类型检查
    H-->>A: 增强结果
    
    Note over U,H: 阶段4: 自动审查
    A->>A: 自动触发审查代理
    A->>R: 检查审查标准
    R-->>A: 审查规则
    A->>S: 参考审查清单
    S-->>A: 审查指南
    A-->>U: 审查报告
    
    Note over U,H: 阶段5: 提交
    U->>H: git commit
    H->>H: PreCommit 检查
    H->>A: 触发安全代理
    A->>R: 检查安全规则
    R-->>A: 安全标准
    A-->>H: 安全检查结果
    alt 通过检查
        H-->>U: 提交成功
    else 检查失败
        H-->>U: 阻止提交并提示问题
    end

6.2 Agent 触发决策流程

flowchart TD
    Start([场景检测]) --> Check1{是否是主动<br/>触发场景?}
    
    Check1 -->|是| Auto[自动触发 Agent]
    Check1 -->|否| Check2{是否满足<br/>强制触发条件?}
    
    Check2 -->|是| Force[强制触发 Agent]
    Check2 -->|否| Check3{用户是否<br/>明确请求?}
    
    Check3 -->|是| OnDemand[按需触发 Agent]
    Check3 -->|否| NoAgent[不触发 Agent]
    
    Auto --> Execute[执行 Agent 任务]
    Force --> Execute
    OnDemand --> Execute
    
    Execute --> Report[输出结果/报告]
    NoAgent --> Continue([继续当前流程])
    
    style Start fill:#e3f2fd
    style Execute fill:#fff3e0
    style Report fill:#c8e6c9

6.3 Hook 执行时序图

sequenceDiagram
    autonumber
    participant User as 用户
    participant System as 系统
    participant PreHook as PreToolUse
    participant Tool as 工具
    participant PostHook as PostToolUse
    
    User->>System: 请求执行操作
    
    rect rgb(255, 243, 224)
        Note over System,PreHook: PreToolUse 阶段
        System->>PreHook: 触发前置钩子
        PreHook->>PreHook: 执行验证逻辑
        
        alt 验证失败
            PreHook-->>User: 阻止操作(exit 2)
        end
    end
    
    rect rgb(232, 245, 233)
        Note over System,Tool: 工具执行阶段
        PreHook->>Tool: 允许执行
        Tool->>Tool: 执行操作
        Tool-->>System: 返回结果
    end
    
    rect rgb(243, 229, 245)
        Note over System,PostHook: PostToolUse 阶段
        System->>PostHook: 触发后置钩子
        PostHook->>PostHook: 格式化/检查/记录
        PostHook-->>User: 返回增强结果
    end

6.4 Rules 生效机制流程

flowchart LR
    subgraph 规则加载
        A[规则文件] --> B[规则解析]
        B --> C[规则注册]
    end
    
    subgraph 规则应用
        C --> D{规则类型?}
        D -->|编码规范| E[代码检查]
        D -->|测试要求| F[测试验证]
        D -->|安全标准| G[安全扫描]
        D -->|审查标准| H[审查触发]
    end
    
    subgraph 结果处理
        E --> I{是否通过?}
        F --> I
        G --> I
        H --> I
        
        I -->|是| J[允许继续]
        I -->|否| K[阻止并提示]
    end
    
    style A fill:#e1f5fe
    style J fill:#c8e6c9
    style K fill:#ffcdd2

七、补充应用场景

注：完整的新功能开发流程已在第六章详细展示，本章补充其他典型场景。

7.1 场景一：Bug 修复

sequenceDiagram
    autonumber
    participant U as 开发者
    participant Build as 构建代理
    participant TDD as TDD代理
    participant Rev as 审查代理
    participant Hook as Hooks
    
    Note over Build: 检测到构建失败
    Build-->>U: 构建错误分析
    
    U->>TDD: 修复 Bug
    TDD-->>U: 引导先写失败测试
    
    U->>Hook: 编写修复代码
    Hook->>Hook: 格式化+检查
    
    Note over Rev: 自动触发审查
    Rev-->>U: 审查报告
    
    U->>Hook: git commit
    Hook->>Hook: PreCommit 检查
    Hook-->>U: 提交成功

协作分析：

阶段	触发的组件	触发模式	说明
错误分析	构建代理	必须触发	构建失败时自动触发
测试引导	TDD代理	按需触发	用户请求测试引导
代码修复	Hooks	自动触发	PostToolUse 自动格式化
代码审查	审查代理	主动触发	代码修改后自动审查
提交检查	Hooks	事件触发	PreCommit Hook 自动检查

7.2 场景二：代码重构

sequenceDiagram
    autonumber
    participant U as 开发者
    participant Refactor as 重构代理
    participant Test as 测试代理
    participant Rev as 审查代理
    participant Hook as Hooks
    
    U->>Refactor: 请求重构模块
    Refactor->>Test: 确保测试覆盖
    Test-->>Refactor: 测试覆盖报告
    
    Refactor->>U: 执行重构
    
    U->>Hook: 修改代码
    Hook->>Hook: 格式化
    
    Note over Rev: 自动触发审查
    Rev-->>U: 审查报告
    
    U->>Test: 运行全部测试
    Test-->>U: 测试通过确认

协作分析：

阶段	触发的组件	触发模式	说明
重构请求	重构代理	按需触发	用户主动请求重构
测试验证	测试代理	按需触发	确保重构前测试覆盖
代码修改	Hooks	自动触发	PostToolUse 自动格式化
代码审查	审查代理	主动触发	代码修改后自动审查
测试确认	测试代理	按需触发	重构后运行全量测试

八、最佳实践

8.1 架构实施原则

原则	说明	实施方式
规则先行	先定义 Rules，再实施其他层	从编码规范和安全标准开始
代理优先	优先委派而非直接处理	识别可委派的场景
知识沉淀	持续积累 Skills	从成功案例提取模式
自动化增强	在关键节点添加 Hooks	识别可自动化的操作

8.2 触发模式选择指南

flowchart TD
    Start([需要触发代理]) --> Q1{触发条件是?}
    
    Q1 -->|系统自动识别| Q2{是否必须执行?}
    Q1 -->|用户明确请求| OnDemand[使用按需触发]
    
    Q2 -->|是| Force[使用强制触发]
    Q2 -->|否| Proactive[使用主动触发]
    
    Force --> Example1[示例: 语言特定审查]
    Proactive --> Example2[示例: 代码修改后审查]
    OnDemand --> Example3[示例: 用户运行测试]
    
    style Start fill:#e3f2fd
    style Force fill:#ffcdd2
    style Proactive fill:#fff9c4
    style OnDemand fill:#c8e6c9

8.3 Hooks 使用建议

钩子类型	使用场景	注意事项
PreToolUse	验证输入、阻止危险操作	避免过度阻塞，提供清晰错误信息
PostToolUse	格式化、自动修复、审计	保持快速，避免影响用户体验
PreCommit	提交前检查、测试运行	控制执行时间，提供跳过选项
Stop	会话总结、批量处理	使用异步执行避免阻塞

8.4 常见问题与解决方案

问题	原因	解决方案
Agent 未触发	未满足触发条件	检查触发规则和场景匹配
Hook 执行缓慢	Hook 逻辑过重	使用异步执行或优化逻辑
Rules 冲突	多层规则覆盖	检查规则优先级，明确覆盖关系
Skills 未生效	Agent 未参考	确保 Agent 正确引用相关 Skill

8.5 架构演进建议

graph LR
    A[基础阶段] --> B[增强阶段]
    B --> C[成熟阶段]
    
    A -->|实现| A1[Rules + 基础Agents]
    B -->|添加| B1[Skills + Commands]
    C -->|完善| C1[Hooks + 高级Agents]
    
    style A fill:#e3f2fd
    style B fill:#e8f5e9
    style C fill:#fff3e0

附录

A. 核心概念速查表

概念	定义	一句话
ECC	Everything Claude Code	AI 代理性能优化系统
Agent-First	代理优先设计原则	专业的事交给专业的代理
Rules	规则层	定义必须做什么
Skills	知识层	告诉你怎么做
Agents	执行层	实际干活的专家
Commands	入口层	用户快捷调用入口
Hooks	触发层	事件驱动的自动化

B. 架构记忆口诀

组件	类比	记忆方式
Rules	宪法	规定必须遵守的原则
Skills	教科书	提供详细知识和指南
Agents	专家	执行具体领域的任务
Commands	快捷键	用户快速调用功能
Hooks	机器人	事件发生时自动干活

C. 五层架构速记

第1层 Rules    → 宪法层  → 定义标准、约束行为
第2层 Skills   → 知识层  → 提供知识、最佳实践
第3层 Agents   → 执行层  → 执行任务、输出结果
第4层 Commands → 入口层  → 用户入口、路由调用
第5层 Hooks    → 触发层  → 事件驱动、自动化增强