配置 Everything Claude Code
在当前工具环境内运行一个对话式向导。首先盘点环境,仅收集受支持的选项,预览,一次确认,以非交互方式应用,验证,并在成功后显示欢迎信息。切勿将 ECC 克隆到临时目录或手动复制插件组件。
对于人工操作的终端,规范入口点是 ecc setup 和 npx ecc-universal setup。在工具环境内部,请改用下面明确的非交互式命令。
根据当前工具环境路由
- 在 Claude Code 中,使用下面的完整范围和钩子向导。
- 在 Codex 中,使用 Codex 的原生插件生命周期。不要提供 Claude 的范围或把 ECC 的四个 Claude 钩子配置文件映射到 Codex。
- 在 Kimi 中,将项目表面代码安装在
./.kimi-code下。Kimi 不提供 ECC 的 Claude 生命周期钩子配置文件。 - 如果无法确定当前工具环境,请说明检测到的证据,并在运行更改命令之前询问要配置哪个环境。
本技能是安装后的重新配置路径。它无法拦截或替代提供商内置的首次安装用户界面。
Claude Code:运行完整的对话式向导
1. 盘点而不做任何更改
运行以下两个命令并总结已安装的 ECC 范围、启用状态和 marketplace 来源:
claude plugin list --json
claude plugin marketplace list --json
将单个现有的 ecc@ecc 安装视为重新配置。不要将 Claude 提供商拥有的“Open home page”控件视为安装证据。如果出现多个 ECC 范围、旧版/手动安装、设置错误或 marketplace 冲突,请停止并报告 setup 返回的恢复信息;切勿猜测要删除哪个状态。
2. 收集恰好两个选择
询问恰好一个范围问题,并要求选择一个值:
user | project | localuser对该用户是全局的。project通过仓库设置共享。local对当前项目是私有的。
仅视觉上将所选范围标记为已选择或正在安装。如果用户从单个现有安装选择了不同的范围,请将其描述为范围迁移,并在以下命令中包含 --move-scope。
询问恰好一个钩子模式问题,并要求选择一个值:
off | minimal | standard | strictoff保留技能和命令,但禁用 ECC 钩子自动化。minimal启用最轻量级的生命周期和安全自动化。standard平衡质量和安全自动化。strict启用最强的检查和提醒。
钩子偏好是个人 Claude 插件配置;它不跟随所选安装范围。
3. 预览并确认一次
优先使用插件捆绑的设置脚本。替换两个选定的值,并仅在范围迁移时包含 --move-scope:
node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
--scope <scope> --hooks <hooks> [--move-scope] --dry-run --json
如果 $CLAUDE_PLUGIN_ROOT 不可用,请使用已发布的 npm 包:
npx --yes --package ecc-universal ecc setup --mode claude-plugin \
--scope <scope> --hooks <hooks> [--move-scope] --dry-run --json
显示一个包含计划操作、一个范围、一个钩子模式、marketplace 操作以及任何源到目标迁移的确认摘要。问一个是否的问题。不要通过工具环境 shell 工具运行裸露的交互式 ecc setup,因为该 shell 通常是非 TTY 的。
4. 应用显式选择
确认后,不带 --dry-run 重新运行相同的路径。保持每个选择都是显式的,并请求 JSON 以便确定性地检查是否成功:
node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
--scope <scope> --hooks <hooks> [--move-scope] --yes --json
回退:
npx --yes --package ecc-universal ecc setup --mode claude-plugin \
--scope <scope> --hooks <hooks> [--move-scope] --yes --json
5. 验证,然后渲染欢迎界面
要求退出状态为零,并且设置结果的 scope 和 hooks 等于所选值。然后独立运行:
claude plugin list --json
仅当在所选范围下恰好存在一个已启用的 ecc@ecc 条目时才继续。当 $CLAUDE_PLUGIN_ROOT 可用时,将成功的设置 action(installed、updated、migrated、resumed 或 already-migrated)传递给捆绑的渲染器:
在调用它之前,要求提供商报告的版本与 scripts/lib/terminal-welcome.js 中的 ECC_VERSION_PATTERN 匹配。拒绝意外的版本文本,而不是将其插入到 shell 命令中。
node -e 'const { renderTerminalWelcome } = require(process.env.CLAUDE_PLUGIN_ROOT + "/scripts/lib/terminal-welcome"); process.stdout.write(renderTerminalWelcome({ action: process.argv[1], version: process.argv[2], color: process.stdout.isTTY }));' "<action>" "<installed-version>"
仅渲染一次欢迎界面。在失败、试运行、取消、范围或钩子不匹配或状态无法验证的情况下,不要渲染它;而是报告错误和恢复方法。在验证更改后,告诉用户运行 /reload-plugins 或重启 Claude Code。
Codex:使用原生插件生命周期
使用 codex plugin marketplace list --json 和 codex plugin list --available --json 进行盘点。Codex 的原生插件命令没有 Claude 风格的 user | project | local 选择器。Codex 原生插件确实支持提供者特定的钩子,但 Codex 需要显式信任它们。让 Codex 显示该信任决策;不要问 Claude 的四配置文件钩子问题,也不要声称这些配置文件映射到 Codex。
如果 ECC marketplace 缺失,请添加它。否则刷新其快照:
codex plugin marketplace add affaan-m/ECC
codex plugin marketplace upgrade ecc --json
请求一次确认,然后安装或幂等地刷新已安装的缓存并验证它:
codex plugin add ecc@ecc --json
codex plugin list --json
仅当 JSON 报告 ECC 已安装并提供其 installedPath 时才继续。然后渲染已验证捆绑包的欢迎界面:
仅使用 Codex JSON 返回的精确绝对 installedPath。拒绝控制字符,并要求已安装版本与 ECC_VERSION_PATTERN 匹配。直接使用以下参数数组调用 node;这是一个工具 API 调用,而不是 shell 命令:
["<installedPath>/scripts/welcome.js", "--action", "configured", "--version", "<installed-version>"]
如果当前工具环境无法使用单独的参数数组调用可执行文件,则跳过欢迎界面。切勿从 Codex JSON 值构造 shell 命令。
切勿声称 Claude 的 off | minimal | standard | strict 配置文件已应用于 Codex。
Kimi:安装项目表面
在确认前说明能力摘要:目标 ./.kimi-code;ECC 生命周期钩子的 hooks=unsupported。不要问 Claude 范围或钩子模式问题。首先预览:
npx --yes --package ecc-universal ecc install --profile core --target kimi --dry-run
显示一个针对该项目目标的确认,然后应用不带 --dry-run 的相同命令。验证:
npx --yes --package ecc-universal ecc doctor --target kimi
仅在 doctor 成功且安装的指令和技能保留在 ./.kimi-code 内之后,渲染:
npx --yes --package ecc-universal ecc welcome --action configured
不要声称 Kimi 安装或配置了 ECC 生命周期钩子。