ECC v2.0.0-rc.1 快速入门¶

此路径面向希望在进行功能开发前验证发布面的新贡献者。

克隆¶

git clone https://github.com/affaan-m/ECC.git
cd ECC

从干净的检出开始。不要将私有操作员状态、原始工作区导出、tokens 或本地 Hermes 文件复制到仓库中。

安装¶

npm ci

这会安装公共发布面所使用的基于 Node 的验证和打包工具链。

如果要从 npm 安装 rc.1 包，而不是从检出工作：

npm install ecc-universal@next

next 当前解析为 ecc-universal@2.0.0-rc.1；在发布候选窗口期间，latest 仍保持为 1.10.0。

验证¶

node tests/run-all.js

预期结果：所有测试通过，零失败。对于发布相关的偏差，运行聚焦检查：

node tests/docs/ecc2-release-surface.test.js

然后检查本地可观测性面：

npm run observability:ready

这会运行 可观测性就绪门禁 用于循环状态、会话跟踪、harness 审计和 ECC2 工具风险日志。

第一个技能¶

首先阅读 skills/hermes-imports/SKILL.md。

它展示了预期的 ECC 2.0 模式：

• 获取一个重复的操作员工作流
• 移除凭据、私有路径、原始工作区导出和个人记忆
• 保留持久的工作流形态
• 将清理后的结果发布为可复用的 SKILL.md

不要一开始就整体导入私有的 Hermes 工作流。应从提炼一个可复用技能开始。

切换 harness¶

在不同 harness 之间使用相同的技能源：

• Claude Code 通过 Claude 插件和原生钩子使用 ECC。
• Codex 通过 AGENTS.md、.codex-plugin/plugin.json 和 MCP 引用配置使用 ECC。
• OpenCode 通过 OpenCode 包/插件面使用 ECC。

可移植单元仍然是 skills/*/SKILL.md。特定 harness 的文件应加载或适配该源，而不是重新定义工作流。

后续文档¶

• Hermes 设置
• 跨 harness 架构
• 发布说明