框架适配器合规矩阵¶

本矩阵是为希望跨多个编码框架使用 ECC 的团队提供的公开入口。它将跨框架架构转化为一份实用记分卡：当前哪些可用、哪些仅靠指令支持、哪些需要适配器，以及操作人员在信任某个配置之前应收集哪些证据。

ECC 的持久单元保留在共享源中：

skills/*/SKILL.md
rules/
commands/
hooks/hooks.json
scripts/hooks/
MCP 参考配置
会话与可观测性契约

框架特定文件只应适配加载方式、事件形状、命令名称或平台限制。

合规状态¶

状态	含义
原生	ECC 可以直接为该框架安装或验证该表面。
适配器支持	ECC 具有一个薄适配器、插件或包表面，但各框架之间的对等性存在差异。
指令支持	ECC 可以提供指导和文件，但该框架未暴露 ECC 强制执行所需的运行时钩子/会话表面。
仅参考	该工具可作为设计压力或外部运行时使用，但 ECC 尚未为其提供直接安装器或适配器。

矩阵¶

下方矩阵由 scripts/lib/harness-adapter-compliance.js 渲染，并通过 npm run harness:adapters -- --check 验证。

框架或运行时	状态	支持的资产	不支持或存在差异的表面	安装或入口	验证命令	风险说明
Claude Code	原生	Claude 插件资产；技能；命令；钩子；MCP 配置；本地规则；面向状态栏的工作流	Claude 原生钩子并不意味着其他框架具有对等性	`./install.sh --profile minimal --target claude`；Claude 插件安装	`npm run harness:audit -- --format json`；`node scripts/session-inspect.js --list-adapters`	避免默认加载所有技能；保持钩子可选且可检查。
Codex	指令支持	`AGENTS.md`；Codex 插件元数据；技能；MCP 参考配置；命令模式	原生钩子强制执行和 Claude 斜杠命令语义并不等价	`./install.sh --profile minimal --target codex`；仓库本地 `AGENTS.md` 审查	`npm run harness:audit -- --format json`	除非存在原生 Codex 钩子表面，否则将钩子视为策略文本。
OpenCode	适配器支持	OpenCode 包/插件元数据；共享技能；MCP 配置；事件适配器模式	事件名称、插件打包和命令分发与 Claude Code 不同	来自本仓库的 OpenCode 包或插件表面	`node tests/scripts/build-opencode.test.js`；`npm run harness:audit -- --format json`	将钩子逻辑保留在共享脚本中，只在边缘适配事件形状。
Pi	适配器支持	Pi 包清单；规范 ECC 技能（skills/）；作为提示模板的规范 ECC 命令（commands/）；注入系统提示的规范 ECC 工程规则（rules/common/）；会话生命周期钩子适配器；/ecc-doctor 诊断命令	子代理、链、审批提示和持久待办事项需要配套的 Pi 包，不属于此适配器；Pi 核心没有 MCP 表面，尽管 ECC MCP 配置可通过社区 pi-mcp-adapter 包逐字加载，而 ECC 既不安装也不依赖该包	`pi install git:github.com/affaan-m/ECC`；从本地检出运行 `pi install /path/to/ECC`	`node tests/pi/pi-package-manifest.test.js`；`node tests/pi/pi-extension-adapter.test.js`；`npm run harness:adapters -- --check`	Pi 扩展以完整用户权限运行，钩子在无 shell 的情况下运行，并从已安装的包而非用户项目解析；保持规范技能和命令作为唯一事实来源，切勿在 .pi/ 下生成副本
Cursor	适配器支持	Cursor 规则；项目本地技能；钩子适配器；共享脚本	Cursor 钩子事件和规则加载与 Claude Code 不同	`./install.sh --profile minimal --target cursor`	`node tests/lib/install-targets.test.js`；`npm run harness:audit -- --format json`	Cursor 适配器必须保留现有项目规则，并避免静默覆盖。
Gemini	指令支持	Gemini 项目本地指令；共享技能；规则；兼容性文档	没有完整的 ECC 钩子对等性；生态移植必须记录与上游 ECC 的漂移	`./install.sh --profile minimal --target gemini`	`node tests/lib/install-targets.test.js`	在 Gemini CLI 内端到端验证之前，将 Gemini 移植视为生态适配器。
Zed	适配器支持	Zed 项目设置；扁平化项目规则；共享技能；命令；代理	Zed 外部代理和原生 Agent Panel 权限不是 Claude 钩子	`./install.sh --profile minimal --target zed`	`node tests/lib/install-targets.test.js`；`npm run harness:audit -- --format json`	保持项目设置保守，不要将 BYOK/OpenRouter 密钥复制到 `.zed/`。
dmux	适配器支持	会话快照；tmux/worktree 编排状态；交接导出	dmux 是编排运行时，不是技能/规则的安装目标	`node scripts/session-inspect.js --list-adapters`；dmux 会话目标检查	`node tests/lib/session-adapters.test.js`	将 dmux 事件视为会话/运行时信号，而不是仓库验证的替代。
Orca	仅参考	worktree 生命周期；审查状态；通知；提供者身份设计压力	当前没有 ECC 安装器或直接适配器	将其用作 worktree/会话状态需求的比较目标	`npm run observability:ready`	不要导入产品特定假设；将经验转化为 ECC 事件字段。
Superset	仅参考	工作区预设；并行代理审查循环；worktree 隔离设计压力	当前没有 ECC 安装器或直接适配器	将其用作工作区预设分类法的比较目标	`npm run observability:ready`	保持 ECC 可移植；不要要求桌面工作区才能获得基本价值。

Harness 或运行时	状态	支持的资产	不支持或不同的表面	安装或入门	验证命令	风险说明
Ghast	仅参考	终端原生窗格分组；cwd 分组；搜索；通知	目前没有 ECC 安装器或直接适配器	将其用作终端优先会话分组的比较目标	`node scripts/session-inspect.js --list-adapters`	在添加可视化 UI 假设之前，保留终端操作体验。
仅终端	原生	技能；规则；命令；脚本；harness 审计；可观测性就绪；交接	无外部 UI；除非显式运行脚本，否则没有自动会话控制	克隆仓库；直接运行命令；项目安装时使用最小配置	`npm run harness:audit -- --format json`; `npm run observability:ready`	这是回退契约；每个更高层级的适配器都应降级到它。

记分卡入门¶

在要求 ECC 使团队或仓库配置更加自主之前，按以下顺序执行：

npm run harness:adapters -- --check
npm run harness:audit -- --format json
npm run observability:ready
node scripts/session-inspect.js --list-adapters
node scripts/loop-status.js --json --write-dir .ecc/loop-status

将结果视为配置记分卡，而不是产品徽章：

harness:adapters -- --check 证明此公开矩阵仍与适配器源数据和必需证据字段匹配。
harness:audit 对工具覆盖、上下文效率、质量门禁、内存持久性、评估覆盖、安全护栏和成本效率进行评分。
observability:ready 证明仓库仍暴露本地状态、会话、工具活动、风险台账和发布入门信号。
session-inspect --list-adapters 显示当前环境中哪些会话表面实际可检查。
loop-status --json 为更长的自主运行创建机器可读的交接/状态负载。

数据支持的记分卡契约¶

每个适配器记录公开：

id
state
supported_assets
unsupported_surfaces
install_or_onramp
verification_commands
risk_notes
last_verified_at
owner
source_docs

如果公开适配器声明缺少安装路径、验证命令、风险说明、负责人、源文档或验证日期，验证器将失败。

运行规则¶

优先选择小型、增量式适配器，而不是同一工作流的 harness 特定分支。
在适配器拥有安装路径和验证命令之前，不要将 harness 称为原生。
当执行由指令支持而非运行时支持时，保持 Codex、Gemini 和 Zed 表面的表述准确。
在 ECC 拥有直接适配器之前，将仅参考工具视为设计压力。
保持仅终端路径健康；它是可移植性下限。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 ev/ECC