Affaan Mustafa ECC 指南
当用户需要帮助来理解、浏览、安装 Everything Claude Code 或在其中做选择时，使用此技能。
何时使用
当用户出现以下情况时使用此技能：
- 询问 ECC 包含哪些内容
- 需要帮助查找某个 skill、命令、agent、hook、规则或安装配置档案
- 刚接触本仓库，需要一条引导路径
- 询问"如何用 ECC 做 X？"
- 询问哪些 ECC 组件适合某个项目
- 需要简单了解命令、skills、agents、hooks 和规则之间的关系
- 对安装路径、重复安装、重置/卸载或选择性安装选项感到困惑
核心原则
依据当前文件回答，而不是凭记忆。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/：hook 行为和安全门控manifests/install-*.json：选择性安装的模块、组件、配置档案和目标支持docs/：运行环境指南、架构笔记、翻译文档、发布文档
回复风格
先给答案，再给下一步动作。大多数用户不需要完整的目录倾倒。
良好的首次回复结构：
- 用什么
- 为什么合适
- 要查看的确切文件或命令
- 一个后续命令或问题
避免：
- 默认列出所有 skill 或命令
- 重复 README 的大段内容
- 在已有 skill 优先路径时仍推荐已退役的命令垫片
- 未检查文件系统就声称某个组件存在
- 在托管安装器支持目标环境时，用手动复制命令代替安装指引
常见任务
新用户入门
给出一份简短菜单：
- 安装或重置 ECC
- 为项目挑选 skills
- 理解命令与 skills 的区别
- 检查 hooks 和安全行为
- 运行一次运行环境审计
- 查找某个特定工作流
安装/重置指向 README.md，项目级接入指向 /project-init。
功能发现
对于"我该用什么来做 X？"：
- 搜索
skills/、commands/和agents/。 - 优先把 skills 作为主要工作流入口。
- 仅当命令是持续维护的兼容垫片、或用户明确想要斜杠命令行为时才使用命令。
- 当委派有价值时提及 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
针对特定 skill 的安装：
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和设置文件 - 在应用更改前先询问
- 保持生成的指引精简且针对该仓库
故障排查
先询问目标运行环境和安装路径，然后检查：
- 插件安装元数据
.claude/、.cursor/、.codex/、.gemini/、.opencode/、.codebuddy/、.joycode/或.qwen/hooks/hooks.json- 安装状态文件
- 相关的命令/skill 文件
针对仓库健康度，建议：
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 质量审查/skill-create：从本地 git 历史生成新 skill/security-scan：检查 Claude/OpenCode 配置安全性