ecc-guide

ECC Guide

当用户需要帮助理解、浏览、安装或挑选 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/：语言与 harness 规则
hooks/README.md、hooks/hooks.json、scripts/hooks/：钩子行为与安全检查门
manifests/install-*.json：选择性安装模块、组件、配置与目标支持
docs/：harness 指南、架构说明、翻译文档、发布文档

回答风格

先给结论，再给下一步动作。大多数用户并不需要一份完整的目录转储。

良好的首次回答形态：

用什么
为什么合适
需要检查的确切文件或命令
一个下一步命令或问题

避免：

默认罗列每一个技能或命令
重复大段 README 章节
在存在技能优先路径时推荐已弃用的命令垫片
在未检查文件系统的情况下断言某个组件存在
当受管安装器支持该目标时，用手动复制命令替代安装指南

常见任务

新用户入门

给出一个简短菜单：

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

安装/重置请指向 README.md，项目专属入门请指向 /project-init。

功能发现

针对“X 该用什么？”：

搜索 skills/、commands/ 和 agents/。
优先将技能作为主要工作流表面。
仅当命令是维护中的兼容垫片，或用户明确想要斜杠命令行为时，才使用命令。
当委托有用时提及智能体。

有用的搜索：

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。预期顺序是：

从项目文件检测技术栈
解析一个 dry-run 安装计划
检查现有的 CLAUDE.md 与 settings 文件
应用变更前先询问
保持生成的指南最小化且针对仓库

故障排查

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

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

针对仓库健康，建议：

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>
计划：<profile/modules/skills>
Dry run：<command>
将变更：<paths>
应用前需要批准：<yes/no>

技能介绍