Communitygithub.com

配置 ECC

在 Claude Code、Codex 或 Kimi 环境中,指导 ECC 的安装、更新或重新配置,同时尊重各工具的运行机制。

配置 ECC 是什么?

该技能为 ECC 在 Claude Code、Codex 和 Kimi 等主流 AI 开发工具(称为“harness”)中的配置场景提供了详细的指导。它设计为一个对话式向导,核心流程包括:首先对当前环境进行清单盘点(不会修改任何设置),然后精确收集用户对安装范围(如 user/project/local)和钩子模式(如 off/minimal/standard/strict)的选择,接着预览变更并请求用户一次确认,最后以非交互方式应用配置并验证结果。技能严格区分不同工具的特性:在 Claude Code 中采用完整的范围选择和钩子配置;在 Codex 中则利用其原生插件生命周期,避免引入 Claude 特有的概念;在 Kimi 中仅安装项目级表面代码,明确说明不支持钩子。该技能确保用户始终通过显式的命令行参数而非交互式命令进行配置,并且只有在步骤全部成功验证后才会展示欢迎界面,从而保证配置过程的可靠性和可预测性。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/configure-ecc

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

配置 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 | local
  • user 对该用户是全局的。
  • project 通过仓库设置共享。
  • local 对当前项目是私有的。

仅视觉上将所选范围标记为已选择或正在安装。如果用户从单个现有安装选择了不同的范围,请将其描述为范围迁移,并在以下命令中包含 --move-scope。

询问恰好一个钩子模式问题,并要求选择一个值:

  • off | minimal | standard | strict
  • off 保留技能和命令,但禁用 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 生命周期钩子。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

相关技能