---

name: ecc-guide description: 通过在回答前读取实时仓库内容，引导用户了解 ECC 当前的代理、技能、命令、钩子、规则、安装配置和项目入门。 origin: community

ECC 指南

当用户需要帮助理解、导航、安装或选择 Everything Claude Code 的组件时使用此技能。

适用场景

当用户：

• 询问 ECC 包含什么
• 需要帮助查找技能、命令、代理、钩子、规则或安装配置
• 是仓库新手，需要引导路径
• 问"我如何用 ECC 做 X？"
• 问哪些 ECC 组件适合某个项目
• 需要轻量级解释命令、技能、代理、钩子和规则之间的关系
• 对安装路径、重复安装、重置/卸载或选择性安装选项感到困惑

核心原则

从当前文件回答，而非记忆。ECC 变化很快，硬编码的目录计数、功能列表和安装说明会过时。

当 ECC 仓库可用时，在给出具体答案之前检查相关文件：

node scripts/ci/catalog.js --json
find skills -maxdepth 2 -name SKILL.md | sort
find commands -maxdepth 1 -name '*.md' | sort
find agents -maxdepth 1 -name '*.md' | sort
node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --list-components --json

使用满足用户问题所需的最小读取集。

仓库地图

• README.md：安装路径、卸载/重置指导、公开定位、FAQ
• AGENTS.md：贡献者指导和项目结构
• agent.yaml：导出的 gitagent 接口和命令列表
• commands/：维护的斜杠命令兼容性垫片
• skills/*/SKILL.md：可复用的工作流和领域手册
• agents/*.md：委托的子代理角色提示
• rules/：语言和工具规则
• hooks/README.md、hooks/hooks.json、scripts/hooks/：钩子行为和安全门
• manifests/install-*.json：选择性安装模块、组件、配置和目标支持
• docs/：工具指南、架构笔记、翻译文档、发布文档

响应风格

先给答案，再给下一步操作。大多数用户不需要完整的目录转储。

良好的首次响应形式：

1. 使用什么
2. 为什么适合
3. 要检查的确切文件或命令
4. 一个下一步命令或问题

避免：

• 默认列出每个技能或命令
• 重复大段 README 内容
• 当存在技能优先路径时推荐已退役的命令垫片
• 未检查文件系统就声称组件存在
• 当托管安装器支持目标时用手动复制命令替代安装指导

常见任务

新用户入门

给出简短菜单：

• 安装或重置 ECC
• 为项目选择技能
• 理解命令与技能的区别
• 检查钩子和安全行为
• 运行工具审计
• 查找特定工作流

指向 README.md 获取安装/重置信息，/project-init 获取项目特定入门。

功能发现

对于"我应该用什么做 X？"：

1. 搜索 skills/、commands/ 和 agents/。
2. 优先使用技能作为主要工作流接口。
3. 仅当命令是维护的兼容性垫片或用户明确需要斜杠命令行为时使用命令。
4. 当委托有用时提及代理。

有用的搜索：

rg -n "<query>" skills commands agents docs
find skills -maxdepth 2 -name SKILL.md | sort

安装指导

使用托管安装路径：

node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --profile minimal --target claude --json
node scripts/install-apply.js --profile minimal --target claude --dry-run

对于特定技能安装：

node scripts/install-plan.js --skills <skill-id> --target claude --json
node scripts/install-apply.js --skills <skill-id> --target claude --dry-run

警告用户不要叠加插件安装和完整手动/配置安装，除非他们有意需要重复接口。

项目入门

当用户想要为目标仓库配置 ECC 时使用 /project-init。预期序列是：

1. 从项目文件检测技术栈
2. 解析试运行安装计划
3. 检查现有 CLAUDE.md 和设置文件
4. 应用更改前询问
5. 保持生成的指导最小化且仓库特定

故障排除

先询问目标工具和安装路径，然后检查：

• 插件安装元数据
• .claude/、.cursor/、.codex/、.gemini/ 等配置目录
• hooks/hooks.json
• 安装状态文件
• 相关命令/技能文件

对于仓库健康，建议：

npm run harness:audit -- --format text
npm run observability:ready
npm test