ecc-guide

ECC Guide

当用户需要了解、探索、安装或选择 Everything Claude Code (ECC) 的各个组件时，请使用本 Skill。

适用场景

当用户遇到以下情况时使用本 Skill：

• 询问 ECC 包含哪些内容
• 需要帮助查找特定的 Skill、Command、Agent、Hook、Rule 或 Install Profile
• 刚接触本仓库，需要系统性的入门引导
• 询问“如何用 ECC 实现某功能/场景？”
• 询问哪些 ECC 组件适合其当前项目
• 需要简单直观地了解 Command、Skill、Agent、Hook 和 Rule 之间的关系与区别
• 对安装路径、重复安装、重置/卸载或按需选择安装选项感到困惑

核心原则

务必基于实时读取的文件回答，切忌依赖记忆。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 暴露层与 Command 列表
• commands/：维护中的斜杠命令（slash-command）兼容垫片（shim）
• skills/*/SKILL.md：可复用的工作流与领域 Playbook
• agents/*.md：子 Agent 委派角色提示词
• rules/：语言规范与 Harness 规则
• hooks/README.md、hooks/hooks.json、scripts/hooks/：Hook 行为与安全拦截门（safety gates）
• manifests/install-*.json：按需安装模块、组件、Profile 及目标 Harness 支持配置
• docs/：Harness 指南、架构说明、多语言文档与版本发布文档

回答风格

直奔主题给出答案，然后再提供下一步操作建议。大多数用户不需要你一次性倾倒整个功能目录。

良好的首次回答结构：

1. 建议使用什么
2. 为什么适合该场景
3. 需要查看的具体文件或命令
4. 一个明确的下一步命令或提问

避免：

• 默认列出所有 Skill 或 Command
• 大段重复 README 内容
• 在已有 Skill 优先路径时，仍推荐已废弃的 Command 垫片
• 未经文件系统验证就断言某个组件存在
• 在官方安装器已支持目标 Harness 时，用手动复制命令替代安装引导

常见任务

新用户接入

提供简短的操作菜单：

• 安装或重置 ECC
• 为项目挑选合适 Skill
• 理解 Command 与 Skill 的区别
• 检查 Hook 和安全机制
• 运行 Harness 审计
• 查找特定的工作流

引导用户查看 README.md 获取安装/重置说明，或使用 /project-init 获取针对具体项目的接入指导。

功能探索

针对“实现某功能我应该用什么？”这类问题：

1. 检索 skills/、commands/ 和 agents/。
2. 优先将 Skill 作为主要工作流入口。
3. 仅当 Command 为仍在维护的兼容垫片、或用户明确要求使用斜杠命令时才推荐。
4. 当涉及任务委派时提及 Agent。

常用检索命令：

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

针对特定 Skill 的安装：

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

提醒用户：除非明确需要重复的入口，否则不要叠加插件安装与完整的手动/Profile安装。

项目接入

当用户希望针对目标仓库配置 ECC 时，使用 /project-init。预期步骤：

1. 从项目文件中检测技术栈
2. 解析 Dry-run 安装计划
3. 检查现有的 CLAUDE.md 及配置文件
4. 在应用变更前询问用户确认
5. 保持生成的引导内容精炼且特定于该仓库

排障与诊断

先询问目标 Harness 及安装路径，然后检查：

• 插件安装元数据
• .claude/、.cursor/、.codex/、.gemini/、.opencode/、.codebuddy/、.joycode/ 或 .qwen/
• hooks/hooks.json
• 安装状态文件
• 相关的 Command/Skill 文件

对于仓库健康度检查，建议运行：

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

输出模板

简短推荐

建议使用 <skill-or-command>。推荐原因：<reason>。

规范文件：<path>
验证命令：<command>
下一步：<one concrete action>

搜索结果

最佳匹配项：
- <path>: <why it matters>
- <path>: <why it matters>

推荐方案：<which one to use first and why>

安装计划摘要

已识别技术栈：<stack evidence>
目标 Harness：<harness>
安装计划：<profile/modules/skills>
演练命令（Dry run）：<command>
修改路径：<paths>
应用前需确认：<yes/no>

关联入口

• /project-init：感知技术栈的目标仓库接入计划
• /harness-audit：确定性的准备度评估卡
• /skill-health：Skill 质量审查
• /skill-create：基于本地 git 历史生成新 Skill
• /security-scan：检查 Claude/OpenCode 配置安全性