ECC 规则体系Rules实战指南分层结构、安装部署与语言扩展机制【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC本文是 ECCAgent Harness 性能优化系统规则体系的中文实操指南。规则体系rules/通过通用层 语言特定层的分层设计为 Claude Code、Codex、Opencode、Cursor 等 Agent 场景提供统一的编码规范、测试标准、安全底线与工作流约束。读完本文你将掌握规则目录的完整结构、两种安装方式脚本安装与手动安装、规则与技能的分工边界以及如何为全新语言扩展一套规则集。规则体系的设计骨架common 层 语言特定层规则目录采用双层结构组织核心思想是通用原则与语言特定实践分离rules/ ├── common/ # 语言无关的通用原则所有项目必装 │ ├── coding-style.md # 编码风格不可变性、文件构成、错误处理 │ ├── git-workflow.md # Git 工作流规范 │ ├── testing.md # 测试标准 │ ├── performance.md # 性能准则 │ ├── patterns.md # 设计模式 │ ├── hooks.md # Hooks 系统PreToolUse/PostToolUse/Stop │ ├── agents.md # Agent 编排 │ └── security.md # 安全底线 ├── typescript/ # TypeScript / JavaScript 特定 ├── angular/ # Angular 特定 ├── python/ # Python 特定 ├── golang/ # Go 特定 └── ...这一结构有两层含义common/ 层只包含普适原则不含任何语言特定代码示例。例如 rules/common/coding-style.md 中的不可变性原则用伪代码表达永远创建新对象而不是就地修改理由是不变数据能防止隐藏副作用、简化调试并支持安全的并发。语言目录用框架特定模式、工具和代码示例扩展 common 规则且每个文件都会引用其对应的 common 文件作为上位原则。从当前仓库的实际目录看语言/领域层已经覆盖了typescript、python、golang、java、kotlin、rust、cpp、csharp、swift、fsharp、php、ruby、dart、perl、vue、nuxt、react、react-native、angular、arkts、web等二十余个目录足以支撑多技术栈项目的并行治理。日语本地化目录 docs/ja-JP/rules 与根目录 rules 保持同构且 common 层还额外包含code-review.md与development-workflow.md说明规则集可以按团队语言习惯进行完整翻译维护。语言特定文件的扩展声明每个语言特定文件必须以引用形式声明其上位规则。以 docs/ja-JP/rules/golang/testing.md 为例文件开头即声明 このファイルは [common/testing.md](https://link.gitcode.com/i/d8dbf9038e080082b894cab3c21b776d) を Go 固有のコンテンツで拡張します。本文件以 Go 特定内容扩展 common/testing.md随后给出 Go 的测试约定使用标准go test与表驱动测试、必须带-race竞态检测运行、用go test -cover ./...统计覆盖率并指向golang-testing技能获取更深层的测试模式。这正是规则说做什么、技能说怎么做的典型体现。规则安装脚本安装与手动安装方式一安装脚本推荐ECC 提供 install.sh 统一安装入口支持一次安装 common 一个或多个语言规则集# 安装 common 单语言规则集 ./install.sh typescript ./install.sh python ./install.sh golang # 一次安装多个语言 ./install.sh typescript python脚本方式的优势是自动处理目录层级、命名空间与依赖关系避免手工复制时的路径陷阱。方式二手动安装手动安装必须遵守一条铁律整目录复制严禁用/*扁平化。重要请整目录复制。common 与语言特定目录中存在同名文件例如两边都有coding-style.md、testing.md。若将它们扁平化到同一目录语言特定文件会覆盖 common 规则同时破坏语言文件内部引用的相对路径../common/。# 安装 common 规则所有项目必须 cp -r rules/common ~/.claude/rules/common # 按项目技术栈安装语言特定规则 cp -r rules/typescript ~/.claude/rules/typescript cp -r rules/python ~/.claude/rules/python cp -r rules/golang ~/.claude/rules/golang # 注意请按实际项目需求调整以上仅为参考示例。更规范的实践是使用 ECC 专属命名空间避免与项目内其他规则包冲突mkdir -p ~/.claude/rules/ecc cp -r rules/common ~/.claude/rules/ecc/ cp -r rules/golang ~/.claude/rules/ecc/若需要项目级规则则在项目根目录下创建.claude/rules/ecc并按相同方式复制即可。规则 vs 技能各司其职的分工边界规则与技能是两套互补的机制理解其边界能避免误用维度规则Rules技能Skills定位广泛适用的标准、约定、检查清单特定任务的深度可操作参考资料示例80% 测试覆盖率、禁止硬编码密钥python-patterns、golang-testing回答的问题做什么what怎么做how语言特定规则文件会按需引用相关技能规则给出约束与底线技能提供具体的实现手法与模板。二者配合才能既守住质量红线又保证执行效率。规则优先级语言特定规则覆盖通用规则当语言特定规则与 common 规则冲突时语言特定规则优先特例覆盖通则。这与 CSS 特异性或.gitignore优先级的层次化覆盖模型一致rules/common/定义适用于所有项目的通用默认值rules/golang/、rules/python/、rules/swift/等按语言惯例覆盖这些默认值。例如common/coding-style.md默认推荐不可变性原则而golang/coding-style.md可以声明覆盖惯用 Go 对结构体变更使用指针接收者——通用原则见 common/coding-style.md但此处优先采用 Go 惯用风格。需要被覆盖的 common 规则会以如下标注形式提示语言注记本规则可能被语言特定规则覆盖在该模式不符合该语言惯例的语言中。这套优先级契约保证了规则体系既能跨语言保持统一底线又不会扼杀各语言自身的惯用写法。为新技术栈扩展规则集当需要为新语言例如rust/增加支持时按以下四步进行创建目录新建rules/rust/目录添加扩展文件每个文件针对 common 对应主题进行语言化扩展coding-style.md— 格式化工具、惯用写法、错误处理模式testing.md— 测试框架、覆盖率工具、测试组织方式patterns.md— 语言特定设计模式hooks.md— 针对格式化器、链接器、类型检查器的 PostToolUse 钩子security.md— 密钥管理、安全扫描工具声明扩展关系每个文件以 このファイルは common/xxx.md を 言語 固有のコンテンツで拡張します。开头标明其扩展自哪个 common 文件关联技能引用skills/下已有的相关技能若不存在则在 skills 下创建新技能。对于web/这类非语言领域只要积累的领域特定指导足够独立成册同样遵循上述分层模式进行扩展。规则在 Agent 工作流中的实际落地规则并非孤立文档它与 ECC 的 Hooks 系统、Agent 编排深度耦合构成可执行的工程约束Hooks 系统见 rules/common/hooks.md定义了PreToolUse工具执行前校验/参数修改、PostToolUse执行后自动格式化与检查、Stop会话结束时最终校验三类钩子语言目录中的hooks.md文件正是把格式化器、链接器等工具挂接到这些时机的依据Agent 编排见 rules/common/agents.md明确了复杂功能用planner、代码评审用code-reviewer、缺陷修复用tdd-guide、架构决策用architect等分工并强调独立操作必须并行执行、委托任务必须等待结果集成最终消息即交付物禁止 fire-and-forget 式委托导致子任务结果丢失。换言之规则层定义标准是什么Hooks 层负责自动执行标准Agent 层负责按标准分工协作三者共同把静态规范转化为可观测、可校验的工程行为。小结ECC 规则体系用common 通用层 语言/领域特定层的分层模型解决了多技术栈 Agent 工程中统一标准与语言惯例之间的矛盾通过整目录复制的安装约定规避了同名文件覆盖问题通过语言特定规则优先的优先级契约保证了覆盖行为的确定性通过规则 vs 技能的边界划分让约束what与执行how各归其位。无论是单语言项目还是二十余种语言并存的大型仓库这套规则体系都能以最小心智负担提供可维护、可扩展、可自动执行的工程红线。【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ECC 规则体系（Rules）实战指南：分层结构、安装部署与语言扩展机制
ECC 规则体系Rules实战指南分层结构、安装部署与语言扩展机制【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC本文是 ECCAgent Harness 性能优化系统规则体系的中文实操指南。规则体系rules/通过通用层 语言特定层的分层设计为 Claude Code、Codex、Opencode、Cursor 等 Agent 场景提供统一的编码规范、测试标准、安全底线与工作流约束。读完本文你将掌握规则目录的完整结构、两种安装方式脚本安装与手动安装、规则与技能的分工边界以及如何为全新语言扩展一套规则集。规则体系的设计骨架common 层 语言特定层规则目录采用双层结构组织核心思想是通用原则与语言特定实践分离rules/ ├── common/ # 语言无关的通用原则所有项目必装 │ ├── coding-style.md # 编码风格不可变性、文件构成、错误处理 │ ├── git-workflow.md # Git 工作流规范 │ ├── testing.md # 测试标准 │ ├── performance.md # 性能准则 │ ├── patterns.md # 设计模式 │ ├── hooks.md # Hooks 系统PreToolUse/PostToolUse/Stop │ ├── agents.md # Agent 编排 │ └── security.md # 安全底线 ├── typescript/ # TypeScript / JavaScript 特定 ├── angular/ # Angular 特定 ├── python/ # Python 特定 ├── golang/ # Go 特定 └── ...这一结构有两层含义common/ 层只包含普适原则不含任何语言特定代码示例。例如 rules/common/coding-style.md 中的不可变性原则用伪代码表达永远创建新对象而不是就地修改理由是不变数据能防止隐藏副作用、简化调试并支持安全的并发。语言目录用框架特定模式、工具和代码示例扩展 common 规则且每个文件都会引用其对应的 common 文件作为上位原则。从当前仓库的实际目录看语言/领域层已经覆盖了typescript、python、golang、java、kotlin、rust、cpp、csharp、swift、fsharp、php、ruby、dart、perl、vue、nuxt、react、react-native、angular、arkts、web等二十余个目录足以支撑多技术栈项目的并行治理。日语本地化目录 docs/ja-JP/rules 与根目录 rules 保持同构且 common 层还额外包含code-review.md与development-workflow.md说明规则集可以按团队语言习惯进行完整翻译维护。语言特定文件的扩展声明每个语言特定文件必须以引用形式声明其上位规则。以 docs/ja-JP/rules/golang/testing.md 为例文件开头即声明 このファイルは [common/testing.md](https://link.gitcode.com/i/d8dbf9038e080082b894cab3c21b776d) を Go 固有のコンテンツで拡張します。本文件以 Go 特定内容扩展 common/testing.md随后给出 Go 的测试约定使用标准go test与表驱动测试、必须带-race竞态检测运行、用go test -cover ./...统计覆盖率并指向golang-testing技能获取更深层的测试模式。这正是规则说做什么、技能说怎么做的典型体现。规则安装脚本安装与手动安装方式一安装脚本推荐ECC 提供 install.sh 统一安装入口支持一次安装 common 一个或多个语言规则集# 安装 common 单语言规则集 ./install.sh typescript ./install.sh python ./install.sh golang # 一次安装多个语言 ./install.sh typescript python脚本方式的优势是自动处理目录层级、命名空间与依赖关系避免手工复制时的路径陷阱。方式二手动安装手动安装必须遵守一条铁律整目录复制严禁用/*扁平化。重要请整目录复制。common 与语言特定目录中存在同名文件例如两边都有coding-style.md、testing.md。若将它们扁平化到同一目录语言特定文件会覆盖 common 规则同时破坏语言文件内部引用的相对路径../common/。# 安装 common 规则所有项目必须 cp -r rules/common ~/.claude/rules/common # 按项目技术栈安装语言特定规则 cp -r rules/typescript ~/.claude/rules/typescript cp -r rules/python ~/.claude/rules/python cp -r rules/golang ~/.claude/rules/golang # 注意请按实际项目需求调整以上仅为参考示例。更规范的实践是使用 ECC 专属命名空间避免与项目内其他规则包冲突mkdir -p ~/.claude/rules/ecc cp -r rules/common ~/.claude/rules/ecc/ cp -r rules/golang ~/.claude/rules/ecc/若需要项目级规则则在项目根目录下创建.claude/rules/ecc并按相同方式复制即可。规则 vs 技能各司其职的分工边界规则与技能是两套互补的机制理解其边界能避免误用维度规则Rules技能Skills定位广泛适用的标准、约定、检查清单特定任务的深度可操作参考资料示例80% 测试覆盖率、禁止硬编码密钥python-patterns、golang-testing回答的问题做什么what怎么做how语言特定规则文件会按需引用相关技能规则给出约束与底线技能提供具体的实现手法与模板。二者配合才能既守住质量红线又保证执行效率。规则优先级语言特定规则覆盖通用规则当语言特定规则与 common 规则冲突时语言特定规则优先特例覆盖通则。这与 CSS 特异性或.gitignore优先级的层次化覆盖模型一致rules/common/定义适用于所有项目的通用默认值rules/golang/、rules/python/、rules/swift/等按语言惯例覆盖这些默认值。例如common/coding-style.md默认推荐不可变性原则而golang/coding-style.md可以声明覆盖惯用 Go 对结构体变更使用指针接收者——通用原则见 common/coding-style.md但此处优先采用 Go 惯用风格。需要被覆盖的 common 规则会以如下标注形式提示语言注记本规则可能被语言特定规则覆盖在该模式不符合该语言惯例的语言中。这套优先级契约保证了规则体系既能跨语言保持统一底线又不会扼杀各语言自身的惯用写法。为新技术栈扩展规则集当需要为新语言例如rust/增加支持时按以下四步进行创建目录新建rules/rust/目录添加扩展文件每个文件针对 common 对应主题进行语言化扩展coding-style.md— 格式化工具、惯用写法、错误处理模式testing.md— 测试框架、覆盖率工具、测试组织方式patterns.md— 语言特定设计模式hooks.md— 针对格式化器、链接器、类型检查器的 PostToolUse 钩子security.md— 密钥管理、安全扫描工具声明扩展关系每个文件以 このファイルは common/xxx.md を 言語 固有のコンテンツで拡張します。开头标明其扩展自哪个 common 文件关联技能引用skills/下已有的相关技能若不存在则在 skills 下创建新技能。对于web/这类非语言领域只要积累的领域特定指导足够独立成册同样遵循上述分层模式进行扩展。规则在 Agent 工作流中的实际落地规则并非孤立文档它与 ECC 的 Hooks 系统、Agent 编排深度耦合构成可执行的工程约束Hooks 系统见 rules/common/hooks.md定义了PreToolUse工具执行前校验/参数修改、PostToolUse执行后自动格式化与检查、Stop会话结束时最终校验三类钩子语言目录中的hooks.md文件正是把格式化器、链接器等工具挂接到这些时机的依据Agent 编排见 rules/common/agents.md明确了复杂功能用planner、代码评审用code-reviewer、缺陷修复用tdd-guide、架构决策用architect等分工并强调独立操作必须并行执行、委托任务必须等待结果集成最终消息即交付物禁止 fire-and-forget 式委托导致子任务结果丢失。换言之规则层定义标准是什么Hooks 层负责自动执行标准Agent 层负责按标准分工协作三者共同把静态规范转化为可观测、可校验的工程行为。小结ECC 规则体系用common 通用层 语言/领域特定层的分层模型解决了多技术栈 Agent 工程中统一标准与语言惯例之间的矛盾通过整目录复制的安装约定规避了同名文件覆盖问题通过语言特定规则优先的优先级契约保证了覆盖行为的确定性通过规则 vs 技能的边界划分让约束what与执行how各归其位。无论是单语言项目还是二十余种语言并存的大型仓库这套规则体系都能以最小心智负担提供可维护、可扩展、可自动执行的工程红线。【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考