Communitygithub.com

配置 ECC

在 Claude Code、Codex 或 Kimi 内部引导 ECC 的安装、更新或重新配置,同时尊重各自的运行环境。

配置 ECC 是什么?

该技能是一个对话式向导,用于在当前 AI Agent 运行环境(Harness)中配置 ECC(Everything Claude Code)。它首先进行环境清查,收集用户仅针对当前环境支持的设置选项,提供预览并请求一次确认,然后以非交互方式应用更改,最后验证并仅成功后显示欢迎信息。它明确区分了 Claude Code、Codex 和 Kimi 三种环境:在 Claude Code 中,它会引导用户选择安装范围(用户/项目/本地)和钩子模式(关闭/最小/标准/严格);在 Codex 中,它利用 Codex 的本地插件生命周期,避免使用 Claude 特定的作用域或钩子配置文件;在 Kimi 中,它仅安装项目表面到 `./.kimi-code`,并明确指出钩子不受支持。该技能被视为安装后重新配置路径,不能拦截或替代各提供商内置的首次安装界面。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/affaan-m/ECC/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 范围、启用状态和市场来源:

claude plugin list --json
claude plugin marketplace list --json

将单个现有的 ecc@ecc 安装视为重新配置。不要将 Claude 提供商拥有的“打开主页”控件解释为安装证据。如果遇到多个 ECC 作用域、旧版/手动安装、格式错误的设置或市场冲突,请停止并报告 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

显示一个包含计划操作、一个作用域、一个钩子模式、市场操作以及任何源到目标迁移的确认摘要。问一个 是/否 问题。不要通过环境 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 生命周期钩子。

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/content-engine

Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.

affaan-m/ECC

Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.

affaan-m/fal-ai-media

Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.

affaan-m/manim-video

日本語翻訳:このファイルは manim-video 用の日本語翻訳が必要です

affaan-m/remotion-video-creation

Remotion のベストプラクティス - React で動画を作成する。3D、アニメーション、音声、字幕、チャート、トランジションなどをカバーするドメイン固有の29のルール。

affaan-m/video-editing

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

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.

agent-self-evaluation

Use after completing any non-trivial task. The agent self-rates its output on 5 axes — accuracy, completeness, clarity, actionability, conciseness — with concrete evidence per criterion. Produces a structured 1-5 scorecard with specific improvement suggestions.

agent-sort

Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.

ai-first-engineering

Engineering operating model for teams where AI agents generate a large share of implementation output. Use when setting team process, review gates, or ownership rules for a codebase largely written by agents.

ai-regression-testing

Regression testing strategies for AI-assisted development. Sandbox-mode API testing without database dependencies, automated bug-check workflows, and patterns to catch AI blind spots where the same model writes and reviews code. Use when adding regression coverage to AI-assisted code, or when the same model both wrote and reviewed a change.

android-clean-architecture

Clean Architecture patterns for Android and Kotlin Multiplatform projects — module structure, dependency rules, UseCases, Repositories, and data layer patterns. Use when structuring modules, layers, or data flow in an Android or KMP project.

angular-developer

Generates Angular code and provides architectural guidance. Trigger when creating projects, components, or services, or for best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling (component styles, Tailwind CSS), testing, or CLI tooling.

相关技能