ECC 指南¶

当用户需要帮助理解、浏览、安装或选择 Everything Claude Code（ECC）的组成部分时，使用本技能。

何时使用¶

使用本技能当用户：

• 询问 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：安装路径、卸载/重置指南、公开定位、常见问题
• 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. 解析一个 dry-run 安装计划
3. 检查现有的 CLAUDE.md 和设置文件
4. 在应用更改前先征求同意
5. 保持生成的指南精简且针对该仓库

故障排查¶

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

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

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

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

输出模板¶

简短推荐¶

Use <skill-or-command>. It fits because <reason>.

Canonical file: <path>
Verify with: <command>
Next: <one concrete action>

搜索结果¶

Best matches:
- <path>: <why it matters>
- <path>: <why it matters>

Recommendation: <which one to use first and why>

安装计划摘要¶

Detected: <stack evidence>
Target: <harness>
Plan: <profile/modules/skills>
Dry run: <command>
Would change: <paths>
Needs approval before apply: <yes/no>

相关界面¶

• /project-init：针对目标仓库的技术栈感知引导计划
• /harness-audit：确定性就绪度评分卡
• /skill-health：技能质量审查
• /skill-create：从本地 git 历史生成新技能
• /security-scan：检查 Claude/OpenCode 配置安全性