附录：源码地图、常用检查与术语
源码地图
| 想研究什么 | 先读哪里 |
|---|---|
| 项目定位与安装 | README.md、VERSION、package.json |
| 根级行为约束 | AGENTS.md、CLAUDE.md、RULES.md |
| Agent 委派 | agents/、agent.yaml |
| Skill catalog | skills/*/SKILL.md、skills/ecc-guide |
| Slash command | commands/、legacy-command-shims/ |
| 生命周期 | hooks/hooks.json、hooks/README.md、scripts/hooks/ |
| 选择性安装 | manifests/、scripts/install-plan.js、scripts/install-apply.js |
| 目标适配 | .claude*、.codex*、.cursor/、.opencode/、scaffolds/ |
| 记忆与学习 | scripts/memory.js、scripts/lib/memory-*、skills/continuous-learning-v2 |
| 安全 | rules/、skills/security-*、scripts/ci/、schemas/ |
| ECC2 控制面 | scripts/status.js、scripts/sessions-cli.js、scripts/work-items.js、ecc2/ |
推荐的只读检查
# 实时发现入口
find agents -maxdepth 1 -name '*.md' | sort
find skills -maxdepth 2 -name SKILL.md | sort
find commands -maxdepth 1 -name '*.md' | sort
# 安装选择器
node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --list-modules
node scripts/install-plan.js --list-components --json
node scripts/install-plan.js --profile developer --target claude --json
# 运行环境
node scripts/ecc.js list-installed --json
node scripts/ecc.js doctor --target claude
node scripts/ecc.js status --json
node scripts/ecc.js sessions
术语表
| 术语 | 含义 |
|---|---|
| harness | 承载模型、工具、上下文和生命周期的宿主，例如 Claude Code 或 Codex |
| agent | 带角色、工具和模型约束的委派单元 |
| skill | 可按需发现/加载的工作流与领域知识包 |
| command | slash command 兼容入口，逐步让位给 skills-first surface |
| rule | 始终加载或按语言选择的约束文本 |
| hook | 在工具或会话事件边界运行的脚本 |
| module | installer 的真实安装单元，声明依赖和 target |
| component | 面向用户的安装选择项，可映射到多个 module |
| profile | 预设 module 组合 |
| target adapter | 把 module 投影到某个 harness 的路径、合并和构建策略 |
| install-state | ecc.install.v1 状态记录，用于 doctor/repair/uninstall |
| instinct | continuous learning v2 的原子、带置信度的行为知识 |
结语
读 ECC 不需要一次读完 281 个 skill。先顺着“安装计划 → 目标投影 → 会话 hook → 验证/记忆”的主链路走，再进入你关心的角色或领域。只要抓住 canonical surface、运行时边界和状态记录这三件事，ECC 的大目录就会从“文件海洋”变成一套可以推理的系统。