Ecc Guide

ECC 指南

当用户需要帮助来理解、浏览、安装 ECC 或在其中做选择时，使用此技能。

何时使用

当用户出现以下情况时使用此技能：

• 询问 ECC 包含哪些内容
• 需要帮助查找某个 skill、命令、agent、hook、规则或安装配置档案
• 刚接触本仓库，需要一条引导路径
• 询问"如何用 ECC 做 X？"
• 询问哪些 ECC 组件适合某个项目
• 需要简单了解命令、skills、agents、hooks 和规则之间的关系
• 对安装路径、重复安装、重置/卸载或选择性安装选项感到困惑

核心原则

依据当前文件回答，而不是凭记忆。ECC 变化很快，硬编码的目录数量、功能列表和安装说明都会过时。

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

node scripts/ci/catalog.js --jsonfind skills -maxdepth 2 -name SKILL.md | sortfind commands -maxdepth 1 -name '*.md' | sortfind agents -maxdepth 1 -name '*.md' | sortnode scripts/install-plan.js --list-profilesnode 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/：hook 行为和安全门控
• manifests/install-*.json：选择性安装的模块、组件、配置档案和目标支持
• docs/：运行环境指南、架构笔记、翻译文档、发布文档

回复风格

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

良好的首次回复结构：

1. 用什么
2. 为什么合适
3. 要查看的确切文件或命令
4. 一个后续命令或问题

避免：

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

常见任务

新用户入门

给出一份简短菜单：

• 安装或重置 ECC
• 为项目挑选 skills
• 理解命令与 skills 的区别
• 检查 hooks 和安全行为
• 运行一次运行环境审计
• 查找某个特定工作流

安装/重置指向 README.md，项目级接入指向 /project-init。

功能发现

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

1. 搜索 skills/、commands/ 和 agents/。
2. 优先把 skills 作为主要工作流入口。
3. 仅当命令是持续维护的兼容垫片、或用户明确想要斜杠命令行为时才使用命令。
4. 当委派有价值时提及 agents。

有用的搜索：

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

安装指引

使用托管安装路径：

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

针对特定 skill 的安装：

node scripts/install-plan.js --skills <skill-id> --target claude --jsonnode 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
• 安装状态文件
• 相关的命令/skill 文件

针对仓库健康度，建议：

npm run harness:audit -- --format textnpm run observability:readynpm 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 质量审查
• /skill-create：从本地 git 历史生成新 skill
• /security-scan：检查 Claude/OpenCode 配置安全性