AB
AiBoss站
教程

Claude Code

教程

用 Everything Claude Code 为 Claude Code 搭建规则、技能与钩子工作流

Everything Claude Code(ECC)把开发规则、作业流程、专业角色和事件钩子整理成可复用的配置,供 Claude Code 使用。本文说明它的目录结构、插件安装方式、Rules 的放置方法、Agents 与 Skills 的分工、Hooks 的写法与 MCP 的取舍,并用一个「给库存列表加搜索」的完整例子串起计划、实现与评审三步。

在 Claude Code 里推进开发时,很多要求需要反复交代:改动前先看既有实现、修缺陷要留下能复现的测试、评审时别漏掉认证与权限控制。把这些要求整理成随时可查的形式,就是 Everything Claude Code(ECC)要解决的问题。它是一套面向编码代理的开源配置集合,包含专业代理、作为作业流程的技能、开发规则、按事件触发的钩子以及 MCP 配置示例。你可以把它当成交给新同事的开发手册:规则说明「必须遵守的基准」,技能说明「事情怎么做」,代理说明「把活交给谁」,钩子说明「什么事件发生时自动跑什么」。本文面向已经在用 Claude Code、希望把团队约定沉淀下来的开发者,按安装、配置、分工、实战的顺序讲清楚。想先了解这个工具的基本定位,可以看 Claude Code 的工具页。

准备工作

开始之前,确认本机具备以下条件:

  • 可用的 Claude Code 环境,能在会话界面里执行斜杠命令。
  • Git,用于克隆配置仓库。
  • Node.js,用于运行钩子脚本示例。
  • 一个准备试点的项目,最好规模不大、有现成的 lint、类型检查与测试命令。

另外要理解一个前提:ECC 的当前版本以 Skills 作为主要工作流入口。较早的介绍文章里出现的命令名,不一定还能直接使用,导入后应以实际安装环境里的技能与命令清单为准。插件标识为 ecc@ecc,仓库名为 ECC。

操作步骤

第一步:先弄清目录各自负责什么

在动手安装前,先建立整体印象,后面挑选内容时不容易迷路。

目录主要作用
agents/计划、设计、评审等专业代理
skills/作业流程与分领域知识
commands/仍在维护的斜杠命令入口
legacy-command-shims/旧命令名的兼容文件
rules/代码规范、测试、Git 运用等指针
hooks/按事件触发的自动处理配置
contexts/开发、调查、评审用的上下文示例
mcp-configs/连接外部工具的 MCP 配置示例
examples/CLAUDE.md 等配置示例
.claude-plugin/插件分发用的元数据

记忆方法很简单:Rules 是基准,Skills 是步骤,Agents 是角色,Hooks 是事件处理。

第二步:通过插件市场安装

在 Claude Code 的会话界面里依次执行两条命令:

/plugin marketplace add
/plugin install ecc@ecc

安装完成后检查状态:

/plugin list ecc@ecc

这里有一条容易踩的坑:如果已经通过插件安装了 ECC,就不要再对同一个 Claude Code 环境做一次完整的手动安装。两套技能和钩子同时存在会互相重复,行为难以预测。

第三步:把需要的 Rules 放到正确位置

Rules 与插件是分开部署的。下面是在 macOS、Linux、WSL 等 Bash 环境下,把通用规则和 TypeScript 规则放到用户级目录的例子:

git clone <ECC 仓库地址>
cd ECC
mkdir -p "$HOME/.claude/rules/ecc"
cp -R rules/common "$HOME/.claude/rules/ecc/"
cp -R rules/typescript "$HOME/.claude/rules/ecc/"

如果项目用 Python,按需再复制 rules/python。注意必须整目录复制:通用规则与语言规则里存在同名文件,如果把文件摊平到同一个目录,会出现覆盖和相对引用失效的问题。

只想让某个项目生效时,把规则放到该项目的 .claude/rules/ecc/ 下。用户级放通用内容、项目级放专属内容,长期维护会轻松很多。

第四步:按角色调用 Agents

代理是针对某类工作集中注意力的角色定义。ECC 提供的角色包括:

代理主要职责
planner查看需求与既有代码,产出实现计划
architect考虑系统结构与设计方针
tdd-guide协助推进测试驱动开发
code-reviewer检查代码质量与改动中的问题
security-reviewer检查认证、输入校验、密钥等
build-error-resolver排查构建错误的原因
e2e-runner处理端到端测试
refactor-cleaner清理无用代码、辅助重构
doc-updater让文档跟上实现

Claude Code 的子代理各自拥有独立上下文,把调查和评审拆出去,主对话里需要处理的信息会清爽不少。

代理定义文件的写法如下,这是一个以读取为主的评审角色示例:

---
name: project-reviewer
description: 检查改动内容,并附带依据报告问题点
tools: Read, Grep, Glob
model: inherit
---
请检查改动内容与相关实现。
每条指出都要附上位置与理由。

name 是识别名,description 说明角色与适用场景,tools 用来收窄可用工具,model 指定所用模型,示例中的 inherit 表示沿用父对话的模型。划分角色时,把「查什么、返回什么结果」写具体,委托的边界才清楚。

第五步:用 Skills 与 Commands 固化重复作业

Skills 存放某类工作的推进步骤和参考知识。在 Claude Code 中,SKILL.md 写概要和步骤,详细资料与脚本可以作为独立文件附带。常规会话只读取技能说明,真正使用时才加载正文。

通过插件调用实现计划时,使用带命名空间的形式:

/ecc:plan "想在库存列表里增加按商品名和 JAN 码搜索"

命令名要以实际安装的版本为准。当前命令参考中,旧的 /tdd 对应到 tdd-workflow 技能,旧的 /e2e 对应到 e2e-testing。旧名兼容文件只在确有需要时启用。参考别人的文章或配置示例时,务必对照本机已安装的技能与命令清单。

以 tdd-workflow 为例,它覆盖的流程是:

  1. RED:把期望行为写成测试,确认它失败。
  2. GREEN:实现到测试通过。
  3. REFACTOR:在测试保持通过的前提下改善结构。

该技能还包含覆盖率 80% 以上的目标,以及保留失败与成功证据的步骤。这个数字是 ECC 给出的开发方针之一,引入项目时要自行确定采用的测试基准,并同步到测试运行器和 CI 中。除了覆盖率,也要确认关键业务条件和异常路径是否被覆盖。

第六步:用 Rules 把项目基准写下来

Rules 汇总代码写法、错误处理、测试、Git 运用等指针,由通用规则与语言规则组合而成。这里要分清一件事:用文字交代的规则,和机器判定的配置,职责不同。Claude Code 会把 CLAUDE.md 这类指示当作上下文读取;真正要限制操作,靠权限设置;要判定代码,靠 Lint、类型检查与测试。

所以写「改动后要跑测试」时,最好把跑什么也写清楚。下面是一个 Next.js 加 TypeScript 项目的 CLAUDE.md 示例,命令需按目标项目的 package.json 调整:

# 项目概要
会员管理用的 Web 应用。
使用 TypeScript 与 Next.js。

## 开发方针
- 改动前先确认相关的既有实现与测试。
- 认证与权限控制复用既有的公共处理。
- 修缺陷时留下复现条件与回归测试。
- 源码中不得包含 API 密钥等秘密信息。

## 改动后的确认
- npm run lint
- npm run typecheck
- npm test
报告执行过的命令与结果。
无法执行的检查要附上原因。

比起「写出干净的代码」这类抽象说法,写成能核对作业内容与结果的指示,评审基准也更容易统一。

第七步:用 Hooks 在事件发生时自动处理

Hooks 让 Claude Code 在特定事件发生时执行处理。常见事件如下:

事件触发时机
PreToolUse工具执行前
PostToolUse工具正常执行后
SessionStart会话开始时
PreCompact上下文压缩前
StopClaude 准备结束响应时
SessionEnd会话结束时

Stop 与 SessionEnd 是两个不同事件,选哪个取决于处理目的。插件管理的 ECC 钩子会随安装途径自动加载;插件安装后再把同一份 hooks.json 复制进配置,会造成处理重复。

下面是一个项目自有钩子的示例:文件被编辑后检查其中是否残留 console.log。当前格式下,用 matcher 指定目标工具,文件路径从钩子收到的 JSON 中获取。如果项目已有 .claude/settings.json,要保留原内容再合并 hooks 配置。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "node \"$CLAUDE_PROJECT_DIR/scripts/check-console.cjs\""
          }
        ]
      }
    ]
  }
}

然后在项目里创建 scripts/check-console.cjs,只使用 Node.js 标准模块:

const fs = require("node:fs");

let input = "";
process.stdin.setEncoding("utf8");
process.stdin.on("data", (chunk) => {
  input += chunk;
});

process.stdin.on("end", () => {
  const event = JSON.parse(input);
  const filePath = event.tool_input?.file_path;
  if (!filePath || !/\.(js|jsx|ts|tsx)$/.test(filePath)) return;

  const source = fs.readFileSync(filePath, "utf8");
  if (source.includes("console.log")) {
    process.stdout.write(
      JSON.stringify({
        hookSpecificOutput: {
          hookEventName: "PostToolUse",
          additionalContext:
            "被编辑的文件里存在 console.log。请确认其用途。",
        },
      })
    );
  }
});

目标文件里出现 console.log 时,脚本会向 Claude 返回一段用于确认的上下文。这只是字符串检测的小例子,注释里的写法同样会被命中;真正判定代码规范,还是配合项目在用的 Lint 更合适。

第八步:按需接入 MCP

MCP 是 Claude Code 连接外部工具与数据的机制,mcp-configs/ 里提供了 GitHub、数据库等集成的配置示例。各服务的认证和工具启用要按实际环境处理。

接入原则是从工作真正需要的连接开始:要处理 Issue 和 PR 就接 GitHub,要核对数据就接对应数据库。工具定义占用的上下文量,取决于工具数量、定义大小以及 Tool Search 之类的加载方式,不要只凭固定的服务器数或 token 数下判断,用 /mcp 查看实际使用状态。认证信息从环境变量等位置读取,共享配置与秘密信息分开管理。

第九步:了解 Contexts、Examples 与持续学习

contexts/ 提供开发、调查、评审等按目的划分的上下文示例,在需要的场景作为指示加载:调查侧重加深理解,评审侧重找出改动中的问题。examples/ 里的 CLAUDE.md 等文件,可以在整理项目说明与开发方针时参考。

持续学习机制会记录用户修正、错误解决、重复出现的作业等模式并复用。continuous-learning-v2 把细小的行为模式当作「instinct」处理,并附带依据与适用范围。项目特有的约定就限定在该项目内保留,同时想清楚这份知识要在哪里复用。

一个完整示例

挑一个小功能,把计划、实现、确认串一遍,最容易看清各部分的职责。以「给库存列表加搜索」为例。

1. 先做计划

/ecc:plan "想在库存列表里增加商品名部分匹配搜索和 JAN 码完全匹配搜索"

读计划时重点看几处:输入为空时怎么处理、结果为 0 条时显示什么、与现有分页如何配合。

2. 推进测试与实现

接着用自然语言说明作业步骤和希望确认的内容:

使用 tdd-workflow,按已确认的计划实现。请用测试覆盖商品名部分匹配、JAN 码完全匹配、搜索结果 0 条这三种情况。改动后执行项目定义的 Lint、类型检查与测试,并报告执行内容与结果。

3. 评审改动

/ecc:code-review

看评审结果时,除了每条指出的依据,还要确认计划里定下的条件是否真的落到了实现和测试里。

走完这一轮,可以回头对照:Rules 传达了哪些基准,Skills 支撑了哪些步骤,Agents 承担了哪些角色。这比逐个功能读文档更容易形成直觉。

注意事项

  • 不要重复安装:插件安装与完整手动安装不要叠加在同一环境,技能和钩子会重复。
  • 不要重复复制钩子配置:插件已管理的 hooks.json 再复制进设置,会导致处理重复执行。
  • 规则整目录复制:通用规则与语言规则有同名文件,摊平会互相覆盖或破坏相对引用。
  • 命令名以实际安装为准:旧命令名可能已映射到新技能,参考旧文章前先查本机清单。
  • 文字规则不等于强制约束:需要硬性限制时用权限设置,需要代码判定时用 Lint、类型检查与测试。
  • 覆盖率目标是方针不是保证:80% 是 ECC 提供的开发方针之一,采用前先定好项目自己的测试基准并落到 CI。
  • MCP 上下文开销因配置而异:工具数量与定义大小都会影响占用,用 /mcp 查看实际状态,不要凭固定数字估算。
  • 钩子示例是字符串检测:注释内容也会命中,正式规范判定应交给 Lint 等工具。
  • 易变信息以官网为准:插件标识、命令名、技能清单、配额与价格等可能随版本变化,使用前请核对官网当前信息。