配置 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 范围、启用状态和市场来源:
claude plugin list --json
claude plugin marketplace list --json
将单个现有的 ecc@ecc 安装视为重新配置。不要将 Claude 提供商拥有的“打开主页”控件解释为安装证据。如果遇到多个 ECC 作用域、旧版/手动安装、格式错误的设置或市场冲突,请停止并报告 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
显示一个包含计划操作、一个作用域、一个钩子模式、市场操作以及任何源到目标迁移的确认摘要。问一个 是/否 问题。不要通过环境 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 与所选值相等的 setup 结果。然后独立运行:
claude plugin list --json
仅当在所选作用域下存在恰好一个已启用的 ecc@ecc 条目时继续。当 $CLAUDE_PLUGIN_ROOT 可用时,将成功的 setup 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 市场缺失,请添加它。否则刷新其快照:
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;生命周期钩子 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 生命周期钩子。