1. 项目概述一个为AI编码助手打造的“操作系统”如果你和我一样每天都在用Claude Code、Cursor这类AI编码助手官方叫法叫“AI Agent Harness”来写代码那你肯定遇到过这些问题每次新开一个项目都得重新教它一遍你的代码规范处理复杂任务时上下文窗口很快就满了关键信息被挤掉想让它按照特定流程比如严格的TDD工作得反复提醒不同语言的项目需要切换不同的最佳实践提示。Everything Claude Code简称ECC就是为了解决这些问题而生的。你可以把它理解为一个运行在Claude Code以及Cursor、OpenCode等同类工具之上的“操作系统”或“性能优化套件”。它不是一个简单的提示词合集而是一个包含智能体、技能、规则、钩子、内存管理的完整系统。这个项目在Anthropic的黑客马拉松中获奖经过超过10个月的密集日常使用和迭代已经从一个实验性工具演变成一个能支撑真实产品开发的、生产就绪的框架。简单来说ECC的核心价值是让AI编码助手变得更聪明、更懂你、更高效、更可控。它通过一套精心设计的机制将零散的、一次性的交互转变为可积累、可复用、可优化的系统化工作流。1.1 核心问题与ECC的解决方案为什么我们需要ECC这得从AI编码助手的几个固有痛点说起失忆症与上下文管理AI没有长期记忆每次会话都是新的开始。ECC通过内存持久化钩子在会话结束时自动保存关键上下文如当前任务状态、决策逻辑、待办事项并在下次会话开始时智能加载实现“断点续传”。工作流碎片化复杂的开发任务如“实现用户认证系统”涉及规划、架构、编码、测试、审查多个环节。ECC提供了专业化智能体如planner,architect,tdd-guide,code-reviewer和对应的技能你可以通过类似/plan、/tdd的命令将任务委托给最专业的“子代理”去处理形成流水线。规范执行不严格你告诉AI“要写测试”但它可能忘记覆盖边界情况。ECC的规则系统是一套“永远生效”的准则被直接注入到AI的上下文中。例如rules/common/testing.md里硬性规定“测试覆盖率必须达到80%”AI在生成代码时会主动遵循。知识无法沉淀AI在一次会话中学会的关于你项目特有的模式比如“我们总是用Zod做表单验证”会话结束就消失了。ECC的持续学习V2系统能从成功的会话中自动提取“本能”经过评估和聚类最终演变成可复用的技能让AI越用越懂你的项目。多语言、多框架支持混乱前端、后端、Go、Python各有各的规矩。ECC将规则按语言TypeScript, Python, Go, Java等和公共区common分门别类安装时可按需选择确保AI在不同技术栈中都能应用正确的最佳实践。ECC通过将上述能力模块化、系统化把AI助手从一个“聪明的实习生”训练成了一个“熟悉你团队所有规范、拥有丰富领域知识、且工作流程高度可预测的资深工程师”。1.2 ECC的核心组件架构解析要理解ECC你需要先理清它的几个核心概念它们共同构成了这个“操作系统”的基石智能体位于agents/目录。你可以把它们看作是拥有特定专长的“专家顾问”。当遇到特定类型任务时你可以召唤对应的智能体。例如code-reviewer.md是一个专注于代码质量和安全审查的专家build-error-resolver.md则专门解决令人头疼的编译和构建错误。它们通过高度特化的系统提示词来工作。技能位于skills/目录。这是ECC的“应用程序”或“工作流定义”。一个技能封装了一个完整的、可重复的任务流程及其所需的领域知识。比如skills/tdd-workflow/定义了完整的测试驱动开发步骤skills/continuous-learning-v2/定义了如何从会话中学习。技能是用户与ECC交互的主要界面。规则位于rules/目录。这是系统的“宪法”或“公司规章制度”。它们定义了必须始终遵守的编码风格、Git工作流、测试要求、安全红线等。规则会被直接注入到AI的上下文窗口具有最高优先级确保输出的一致性。钩子位于hooks/和scripts/目录。这是系统的“后台守护进程”或“自动化脚本”。它们在特定事件如会话开始、结束、工具调用前/后触发自动执行任务。例如session-end.js钩子负责保存会话状态pre-compact.js钩子在上下文窗口快满时智能地建议哪些部分可以压缩。命令位于commands/目录。这是旧版ECC的交互方式本质上是调用特定技能或智能体的“快捷方式”。例如/plan命令会调用规划技能和规划智能体。ECC正在向以技能为中心的架构迁移但命令作为兼容层保留。这五个部分协同工作规则确保底线钩子自动化流程管理技能定义具体怎么做智能体提供专业判断命令提供快速入口。最终实现的效果是你只需要关注“要做什么”ECC系统会帮你解决“怎么做”和“如何做得更好”。2. 核心细节解析与实操要点2.1 规则系统如何让AI“牢记”你的规范规则是ECC的基石也是安装后最先需要配置的部分。它的设计哲学是“显式优于隐式”——把所有要求白纸黑字写下来避免AI猜测。规则的结构与优先级rules/ ├── common/ # 语言无关的通用规则最高优先级 │ ├── coding-style.md # 代码风格不可变性、文件组织、命名 │ ├── git-workflow.md # Git流程提交信息格式、PR模板 │ ├── testing.md # 测试TDD流程、80%覆盖率硬性要求 │ ├── performance.md # 性能模型选择、上下文管理策略 │ ├── patterns.md # 设计模式常用骨架项目结构 │ ├── hooks.md # 钩子架构如何与TodoWrite等工具集成 │ ├── agents.md # 智能体何时以及如何委托任务 │ └── security.md # 安全强制性的安全检查清单 ├── typescript/ # TypeScript/JavaScript专属规则 ├── python/ # Python专属规则 ├── golang/ # Go专属规则 ├── swift/ # Swift专属规则 └── php/ # PHP专属规则以及其他语言...安装时的关键决策点安装脚本./install.sh允许你进行选择性安装。这是为了性能和针对性考虑。如果你主要写TypeScript和Python就没必要把Go、Java的规则都装进去避免不必要的上下文占用。# 安装全部规则全量适合多语言项目或探索 ./install.sh --profile full # 仅安装TypeScript相关规则精准节省上下文 ./install.sh typescript # 安装多个指定语言的规则 ./install.sh typescript python golang实操心得规则冲突与覆盖我曾在一个全栈项目Next.js Go中同时安装了typescript和golang规则。发现当处理API边界如Go后端返回给TS前端的类型时两套规则有时会有细微冲突比如对null的处理。ECC的解决机制是common/下的规则具有最高优先级其次是当前项目检测到的主语言规则。我的经验是对于混合项目优先安装common和主语言规则次要语言的规则可以通过项目级的.claude/配置文件进行补充或微调而不是一股脑全装。规则文件的内容示例以rules/common/testing.md为例它不会只说“要写测试”而是会给出非常具体、可操作的要求## 测试覆盖率要求 - **最低要求**所有生产代码的测试覆盖率必须达到80%。 - **关键路径**用户认证、支付处理、数据持久化等核心逻辑必须达到95%以上。 - **测量工具**使用项目的标准工具如Jest for JS/TS, pytest for Python, go test -cover for Go。 - **TDD流程** 1. 先写一个失败的小测试。 2. 写最简单的代码让测试通过。 3. 重构代码保持测试通过。 4. 重复。 - **测试类型**单元测试隔离、集成测试服务间、E2E测试用户流程需明确区分。这样的规则让AI在生成代码时会主动计算测试覆盖率并遵循TDD的红-绿-重构循环。2.2 技能与智能体如何分工与协作技能和智能体是ECC的工作执行单元理解它们的关系和调用方式至关重要。技能封装的工作流技能更像是一个“剧本”或“标准作业程序”。它定义了完成某类任务的步骤、所需知识、以及可能用到的工具。例如skills/security-review/技能可能包含检查依赖漏洞的步骤运行npm audit或snyk test。常见的OWASP Top 10漏洞清单及代码审查要点。如何生成安全评估报告。你通过命令如/ecc:security-review或直接在对话中提及技能名来激活它。激活后ECC会将该技能对应的文档内容注入上下文指导AI按既定流程工作。智能体领域的专家智能体则是一个高度特化的“顾问”。它的系统提示词被设计得非常聚焦比如agents/code-reviewer.md的提示词可能开头就是“你是一个专注于代码质量、可维护性和安全性的高级审查员。你的任务是挑剔的请专注于发现潜在问题...” 当你将一段代码交给它审查时它会以这个专业身份来思考和反馈。协作模式典型的协作流程是“技能调用智能体”。例如当你运行/plan对应skills/planning/技能来规划一个功能时planning技能被激活提供了功能拆解的框架。该技能内部逻辑可能会建议“对于复杂的数据模型设计建议咨询architect智能体”。于是ECC系统会将你的需求和当前上下文传递给agents/architect.md智能体。architect智能体以其专业视角给出设计建议结果再返回给主会话。这种模式实现了关注点分离。主会话通常是Claude Code作为“总指挥”负责协调和集成而具体的专业判断则委托给更专业的“子团队”去完成。新趋势从命令到技能早期ECC严重依赖commands/目录下的命令。现在更鼓励直接使用技能。插件安装后命令被赋予了命名空间以避免冲突如/ecc:plan。但背后的趋势是技能是更一等公民因为它们更结构化、更易于组合和复用。2.3 钩子与内存持久化实现“永不遗忘”的会话这是ECC最强大的特性之一解决了AI助手的“失忆”根本问题。钩子的工作原理钩子是基于事件的。Claude Code等工具提供了事件触发器如SessionStart会话开始、SessionStop会话结束、PreToolUse使用工具前、PostToolUse使用工具后。ECC的钩子系统监听这些事件并执行对应的Node.js脚本。session-start.js在每次新会话开始时触发。它会检查是否存在上次会话保存的状态文件通常位于~/.claude/sessions/如果存在则将其中的关键信息如项目目标、当前任务、待办列表、重要决策作为系统提示的一部分加载进来实现“接着上次干”。session-end.js在会话结束时触发。它会分析整个会话记录提取出“任务状态”、“未完成的TODO”、“产生的关键决策和代码片段”并将其结构化地保存到状态文件中。suggest-compact.js在上下文窗口即将用完时触发PreCompact事件。它不会盲目压缩而是分析上下文智能地建议“哪些旧消息可以安全地总结或移除而不影响当前任务”。这比简单的“丢掉最早的消息”要有效得多。内存持久化的实际效果假设你昨天用Claude Code写了一个用户注册模块但没写完就下班了。今天打开Claude Code开始一个新会话。ECC的session-start钩子会自动运行将昨天保存的“实现用户注册模块已完成数据库模型和API路由待完成密码加密和邮件验证”这个状态加载进来。AI助手一上来就知道“哦我们正在做这个昨天做到这里了今天该做这两件事了。” 这极大地提升了连续工作的效率。注意事项钩子的性能与可控性钩子是后台脚本设计不当可能拖慢启动速度或产生意外行为。ECC v1.8.0引入了运行时控制机制非常实用# 设置钩子严格度配置文件 export ECC_HOOK_PROFILEminimal # 仅运行核心钩子如session-start/end # export ECC_HOOK_PROFILEstandard # 默认运行所有推荐钩子 # export ECC_HOOK_PROFILEstrict # 运行全部钩子包括实验性钩子 # 临时禁用特定钩子比如某个钩子有bug或正在调试 export ECC_DISABLED_HOOKSpre:bash:tmux-reminder,post:edit:typecheck这个设计给了用户充分的控制权。在性能敏感的机器上可以用minimal模式在需要深度集成时用strict模式。2.4 持续学习V2让AI从你的习惯中成长这是ECC从“工具”迈向“系统”的关键。持续学习V2系统能够从你成功的开发会话中自动提取可复用的模式称为“本能”并最终演化为“技能”。学习循环分为三个阶段提取当会话成功完成一个任务比如通过/learn命令或由session-end钩子触发系统会分析对话记录寻找重复出现的模式、决策逻辑或代码片段。例如它可能发现你每次创建React组件时都会先写一个interface定义Props然后导出一个named function组件。这个模式会被提取为一个“本能”草稿包含Action做什么、Evidence在哪些会话中出现过、Examples具体例子。评估提取出的本能不会直接生效。ECC会使用一个“评分器”可能是另一个AI调用或规则匹配来评估这个本能的质量、通用性和置信度。低置信度的本能会被标记为“待定”或丢弃。演化通过/evolve命令系统会将多个相似的高置信度“本能”聚类、去重、合并最终生成一个格式化的技能文件SKILL.md并存入skills/目录。之后这个技能就可以像内置技能一样被调用。举个例子你多次在会话中让AI“用Zod验证表单并生成对应的TypeScript类型”。持续学习系统捕捉到这个模式形成一个名为form-validation-with-zod的本能。经过评估和演化它最终变成一个正式的skills/frontend-patterns/form-validation-with-zod.md技能。以后任何前端表单验证任务你都可以直接调用这个技能AI会立刻应用这套你最习惯的最佳实践。这个机制使得ECC能够深度定制化。你的团队、你的项目特有的“方言”和“工作流”会逐渐沉淀到ECC系统中成为团队共享的资产。3. 实操过程与核心环节实现3.1 从零开始完整安装与配置指南虽然项目提供了多种安装方式但为了最稳定的体验我强烈推荐使用开源安装器而不是完全依赖可能不稳定的插件市场。步骤一克隆仓库并准备环境# 1. 克隆仓库 git clone https://github.com/affaan-m/everything-claude-code.git cd everything-claude-code # 2. 安装项目依赖ECC本身用Node.js编写了许多脚本 # 根据你的喜好选择包管理器ECC会自动检测 npm install # 或 pnpm install / yarn install / bun install # 3. 可选但推荐设置全局包管理器偏好 # 这能确保后续ECC脚本运行时使用你习惯的工具 node scripts/setup-package-manager.js --global pnpm这一步确保了ECC所需的脚本库就位。setup-package-manager.js脚本会创建一个~/.claude/package-manager.json配置文件告诉ECC你优先使用pnpm。步骤二选择并安装规则这是最关键的一步决定了你的AI助手将遵循哪些规范。# 查看所有可用的安装选项 ./install.sh --help # 方案A全量安装适合首次体验或管理多语言项目 ./install.sh --profile full # 这会安装 common/ 和所有语言规则功能最全但上下文占用最大。 # 方案B精准安装推荐针对你的主要技术栈 ./install.sh typescript python # 假设你主要做全栈TS前端 Python后端这就足够了。 # 方案C针对特定AI工具安装如你主要用Cursor ./install.sh --target cursor typescript python # --target 参数会调整一些钩子和配置的路径以适配Cursor而非Claude Code。安装脚本会做以下几件事将选中的rules/目录下的文件复制到你的AI助手配置目录通常是~/.claude/rules/。根据--target参数可能调整一些钩子脚本的路径指向。在~/.claude/下创建必要的目录结构如sessions/,contexts/。生成一个安装报告告诉你安装了哪些组件。踩坑记录规则安装路径冲突早期版本曾要求用户手动复制rules/下的文件。很多人错误地复制了文件内容而不是整个文件夹导致规则文件内的相对引用如../common/coding-style.md全部失效。现在的安装脚本自动处理了目录结构但如果你需要手动调整请记住总是复制整个语言文件夹。步骤三验证安装与基本命令安装完成后在你的AI编码助手Claude Code/Cursor中开启一个新会话。# 在AI助手的聊天框中尝试列出可用的ECC命令 /plugin list everything-claude-codeeverything-claude-code # 或者如果你只安装了规则未安装插件可能看到的是更基础的命令列表如 /plan, /tdd # 测试一个核心技能规划一个任务 /ecc:plan 为我的Next.js博客项目添加一个基于Lucide图标的暗色/亮色主题切换按钮 # 如果未安装插件命令可能是 /plan ...如果AI助手能够理解这个命令并调用规划智能体给出一个结构化的任务分解如1. 创建ThemeContext2. 添加切换按钮组件3. 集成Lucide图标4. 更新CSS变量...那么安装就成功了。步骤四高级配置内存持久化钩子为了让会话记忆功能生效你需要确保钩子被正确启用。钩子配置通常在~/.claude/hooks/hooks.json中。安装脚本通常会配置好。你可以检查该文件确认类似以下的条目存在{ hooks: [ { event: SessionStart, script: /绝对路径/to/everything-claude-code/scripts/hooks/session-start.js }, { event: SessionStop, script: /绝对路径/to/everything-claude-code/scripts/hooks/session-end.js } ] }如果不存在你可以参考项目根目录下的hooks/hooks.json.example文件进行手动配置。3.2 日常开发工作流以实现一个API端点为例让我们看一个完整的例子展示ECC如何融入日常开发。假设我们要在一个现有的Express.js API项目中添加一个GET /api/users/:id端点。第1步任务规划与分解我们不直接开始写代码而是先用/ecc:plan或/plan命令进行规划。用户/ecc:plan “在现有的Express.js项目中添加一个GET /api/users/:id端点需要从PostgreSQL数据库查询用户并处理找不到用户的情况。”ECC的规划技能和智能体会被激活。它可能会返回## 实施计划GET /api/users/:id 1. **分析现状**检查现有项目结构、数据库连接池如pg、模型层如User模型。 2. **路由创建**在routes/users.js或类似文件中添加新的路由处理器。 3. **控制器逻辑** - 从请求参数中提取id。 - 验证id格式如UUID或整数。 - 调用User.findById(id)从数据库查询。 - 如果用户不存在返回404状态码和JSON错误信息 { error: User not found }。 - 如果找到返回200状态码和用户JSON注意过滤密码等敏感字段。 4. **错误处理**添加try-catch块处理数据库错误返回500状态码。 5. **测试驱动开发** - 先写集成测试模拟请求断言成功和404情况。 - 再写单元测试测试控制器逻辑如果可分离。 6. **安全审查**确保没有SQL注入风险使用参数化查询没有敏感信息泄露。 7. **文档更新**更新API文档如Swagger/OpenAPI文件。这个计划立刻将模糊的需求变成了可执行的具体步骤。第2步遵循TDD流程编写代码接下来我们切换到TDD模式。使用/ecc:tdd或/tdd命令并引用刚才的计划。用户/ecc:tdd “根据上面的计划从第5步开始为GET /api/users/:id端点编写测试。”TDD技能和智能体会引导我们红先在test/users.test.js里写一个调用/api/users/123的测试预期返回404因为用户123不存在。运行测试它应该失败。绿然后我们去实现最简单的路由直接硬编码返回404。测试通过。重构接着我们让测试查询一个真实存在的用户。这迫使我们去实现数据库查询逻辑。我们一步步重构添加参数验证、数据库调用、错误处理。循环重复这个过程增加更多测试用例如无效ID格式、数据库错误等并完善实现。在整个过程中rules/common/testing.md和rules/typescript/或rules/javascript/中的规则在持续起作用确保我们写的测试和代码符合规范。第3步代码审查与安全扫描代码写完后不要急着提交。运行/ecc:code-review或/code-review命令让专门的代码审查智能体检查一遍。用户/ecc:code-review “请审查我刚实现的routes/users.js中的GET /api/users/:id端点。”审查智能体会基于rules/common/security.md和代码质量规则提出诸如“是否使用了参数化查询防止SQL注入”、“返回的用户对象是否排除了password_hash字段”、“错误响应是否遵循统一的JSON格式”等问题。对于安全要求高的项目还可以运行/security-scan命令如果安装了AgentShield集成进行更深度的自动化安全漏洞扫描。第4步会话结束与知识沉淀一天工作结束你关闭了Claude Code。session-end.js钩子自动触发它会分析整个会话关于“实现用户端点”的讨论。提取关键决策比如“我们决定用pg库的参数化查询”、“错误格式统一为{ error: message }”。保存当前任务状态“API端点已实现并通过测试待完成更新Swagger文档”。如果这个模式Express.js PostgreSQL的CRUD端点在多次会话中出现持续学习系统可能会将其标记为一个潜在的“本能”。第5步次日继续与技能进化第二天你打开Claude Code继续工作。session-start.js钩子加载了昨天的状态AI助手开场白可能就是“早上好我们昨天完成了GET /api/users/:id端点的核心实现和测试。根据记录接下来需要更新Swagger文档。我们从这里开始吗”几周后当你和团队多次成功实现类似的RESTful端点后持续学习系统可能会生成一个名为express-postgres-crud-endpoint的技能。以后新成员要加端点直接调用这个技能AI就能立刻套用你们团队验证过的最佳实践模板。3.3 多智能体协同与复杂工作流对于更复杂的任务比如“重构一个单体应用为微服务”ECC的多智能体协同能力就派上用场了。你可以使用/multi-plan命令来启动一个复杂的、多步骤的规划。用户/multi-plan “将现有的Monolith Node.js应用拆分为用户服务、订单服务和商品服务三个微服务。需要考虑API网关、服务间通信、数据拆分和部署。”/multi-plan会调用多个智能体planner,architect,database-reviewer等进行“会诊”产出一个包含并行和串行任务的详细计划。然后你可以使用/multi-execute命令让ECC尝试按照这个计划协调不同的智能体分步执行任务。重要警告multi-*命令的依赖/multi-plan,/multi-execute,/multi-backend等命令功能强大但它们不包含在基础规则安装中。它们依赖于一个名为ccg-workflow的外部运行时环境。如果你直接使用这些命令可能会报错。解决方案在使用任何multi-*命令前必须先初始化这个运行时npx ccg-workflowlatest init这个命令会安装必要的包装脚本和提示词模板到~/.claude/.ccg/目录下。没有这个环境多智能体工作流引擎无法启动。4. 常见问题与排查技巧实录即使设计得再完善在实际使用中总会遇到各种问题。以下是我在长期使用ECC过程中总结的常见“坑”及其解决方法。4.1 安装与启动问题问题1安装脚本执行失败提示权限错误或命令未找到。场景在运行./install.sh或.\install.ps1时系统报错。排查检查执行权限Linux/macOSchmod x install.sh。检查Shell确保你在正确的Shell中如bash、zsh。对于PowerShell有时需要修改执行策略Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser仅限Windows。检查Node.js确保Node.js已安装且版本较新16。运行node --version和npm --version确认。检查克隆完整性有时网络问题导致仓库克隆不完整。尝试删除重克隆rm -rf everything-claude-code git clone ...。问题2规则安装后在Claude Code中不生效。场景已经运行了安装脚本但AI助手似乎没有遵循新的编码规范。排查确认安装路径安装脚本默认将规则复制到~/.claude/rules/。去这个目录下看看是否有了common/,typescript/等子文件夹。重启AI助手Claude Code/Cursor通常在启动时加载规则。安装新规则后需要完全退出并重新启动你的AI编码助手软件而不仅仅是刷新页面或重启会话。检查规则冲突如果你之前手动创建过~/.claude/rules/下的文件可能会与ECC安装的文件重名冲突。可以临时移走旧文件进行测试。查看AI助手日志有些AI工具如Cursor的开发者模式会有日志输出可以看到加载了哪些规则文件。检查是否有错误信息。问题3钩子如会话记忆没有工作。场景关闭会话后重新打开AI不记得之前的内容。排查检查钩子配置查看~/.claude/hooks/hooks.json确认SessionStart和SessionStop事件指向了正确的ECC脚本路径。路径必须是绝对路径。检查脚本可执行性确保scripts/hooks/目录下的.js文件有可执行权限并且Node可以运行它们。检查环境变量某些钩子脚本依赖环境变量如ECC_HOOK_PROFILE。确保没有设置ECC_DISABLED_HOOKS禁用了相关钩子。手动测试钩子你可以尝试手动运行钩子脚本看是否有错误输出。例如node /path/to/everything-claude-code/scripts/hooks/session-end.js --test。4.2 使用过程中的问题问题4AI助手变得“迟钝”或响应奇怪上下文窗口似乎被无关内容占满。场景在长时间、多任务的会话后AI的回复开始偏离主题或者忘记之前的约定。原因与解决这是典型的上下文污染问题。ECC的上下文窗口里塞满了历史消息、多个技能/规则的内容。使用/compact命令Claude Code等工具通常有内置的上下文压缩命令。直接输入/compactAI会尝试总结和清理旧消息。利用ECC的智能压缩钩子ECC的suggest-compact.js钩子会在上下文将满时自动触发给出更智能的压缩建议。确保该钩子已启用。开启新会话对于全新的、不相关的任务最干脆的方法是开启一个新会话。利用session-end钩子保存旧会话状态即可不必把所有事都挤在一个会话里。审查安装的规则如果你安装了--profile full但只写JavaScript那么多余的Python、Go规则会白白占用上下文。用./install.sh只安装你需要的语言。问题5/multi-*系列命令报错提示找不到codeagent-wrapper等。场景使用/multi-plan或/multi-execute时失败。解决正如前面强调的这是缺少运行时依赖。运行npx ccg-workflowlatest init来安装必要的运行时组件。初始化后再次尝试命令。如果还不行检查~/.claude/.ccg/目录是否存在且包含prompts/等子目录。问题6自定义技能或规则不生效。场景我根据项目需要在skills/或rules/目录下创建了自定义文件但AI似乎没用到。排查文件位置自定义技能最好放在项目根目录的.claude/skills/下而不是ECC的安装目录里。这样不会被ECC更新覆盖。文件格式技能文件必须是.md格式并且有清晰的结构。可以参考ECC内置技能的格式。显式调用自定义技能通常没有对应的快捷命令。你需要在对话中明确提及技能文件名例如“请应用我们在.claude/skills/my-project-guidelines.md中定义的代码规范。”规则优先级项目级规则./.claude/rules/的优先级高于用户级规则~/.claude/rules/。确保你的自定义规则放在了正确的位置。4.3 高级调试与维护问题7如何升级ECCECC项目迭代很快。升级时建议备份你的配置特别是~/.claude/rules/中你修改过的文件以及项目下的.claude/目录。拉取最新代码cd everything-claude-code git pull origin main。重新安装规则运行./install.sh并指定你需要的语言profile。安装脚本通常设计为增量更新会合并新规则但为了保险最好先备份。检查更新日志查看README.md顶部的What‘s New和GitHub Releases了解新版本是否有不兼容的改动特别是钩子接口或命令的变化。问题8ECC与其它插件或自定义配置冲突。场景安装了ECC后其它插件功能异常或者你自己的.claude/config.json设置被覆盖。解决隔离测试禁用ECC可以暂时重命名~/.claude/rules/ecc目录或修改hooks.json看问题是否消失以确认冲突源。查看加载顺序有些AI工具按字母顺序加载规则。如果冲突不可避免可以通过重命名文件如z-my-rule.md来调整加载顺序。合并配置ECC的配置通常是叠加而非覆盖。检查你的个人配置和ECC生成的配置手动合并冲突项。ECC的脚本和钩子通常设计得比较谨慎会避免覆盖用户自定义配置。问题9性能问题感觉AI响应变慢。可能原因规则太多安装了全量规则--profile full。解决方案重新安装只选需要的语言。钩子脚本复杂某些钩子如实时分析代码的钩子可能计算量大。解决方案设置ECC_HOOK_PROFILEminimal禁用非核心钩子。会话历史过长即使有压缩超长历史也会影响性能。解决方案定期开启新会话利用session-end保存状态。AI工具本身问题有时是Claude Code/Cursor服务端或模型的问题与ECC无关。可以关闭所有插件进行对比测试。最后一个最有效的万能排查命令是ECC自带的ecc doctor如果你通过npm安装了ecc-universal包或运行项目内的诊断脚本。它能检查安装完整性、配置正确性、钩子状态等并给出修复建议。当遇到任何疑难杂症时首先运行诊断工具往往能快速定位问题方向。