Communitygithub.com

ECC 指南

引导用户了解Everything Claude Code (ECC),帮助理解、导航、安装或选择适合项目的组件。

ECC 指南 是什么?

ECC 指南(ecc-guide)是一项专门用于帮助用户熟悉Everything Claude Code (ECC) 生态系统的技能。当用户需要理解ECC包含哪些内容、寻找合适的技能、命令、代理、钩子或安装配置时,就可以使用此技能。该技能特别适合新用户,能够提供从安装到项目定制的完整引导路径。其核心原则是依靠当前文件而非记忆回答问题,因为ECC变化迅速,硬编码的信息很快就会过时。系统会通过`catalog.js`、`install-plan.js`等脚本动态获取最新目录和安装计划。技能支持的常见任务包括新用户引导、功能发现、安装指导、项目初始化和故障排查。响应风格强调“先给答案,再给下一步操作”,避免默认列出所有技能或命令。在平台支持方面,该技能适用于所有Claude Code编码助手(如Claude、Cursor、Codex等)的配置场景。总体而言,它是一个轻量级但结构化的引导助手,能够将用户引导至正确的文档、安装路径或初始化流程。

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

在你喜欢的 AI 中提问

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

文档

ECC 指南 是做什么的?

当用户需要帮助理解、导航、安装或选择 Everything Claude Code (ECC) 的组件时,使用此技能。

何时使用

当用户出现以下情况时使用此技能:

  • 询问 ECC 包含哪些内容
  • 需要帮助寻找技能、命令、代理、钩子、规则或安装配置
  • 是仓库的新用户,需要引导路径
  • 询问“如何在 ECC 中做 X?”
  • 询问哪些 ECC 组件适合某个项目
  • 需要轻量级的解释,了解命令、技能、代理、钩子和规则之间的关系
  • 对安装路径、重复安装、重置/卸载或选择性安装选项感到困惑

核心原则

根据当前文件而非记忆来回答。ECC 变化很快,硬编码的目录数量、功能列表和安装说明很快就会过时。

当 ECC 仓库可用时,请在给出具体答案前检查相关文件:

node scripts/ci/catalog.js --json
find skills -maxdepth 2 -name SKILL.md | sort
find commands -maxdepth 1 -name '*.md' | sort
find agents -maxdepth 1 -name '*.md' | sort
node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --list-components --json

使用满足用户问题所需的最小读取集合。

仓库地图

  • README.md:安装路径、卸载/重置指导、公开定位、常见问题解答
  • AGENTS.md:贡献者指导和项目结构
  • agent.yaml:导出的 gitagent 表面和命令列表
  • commands/:维护的斜杠命令兼容垫片
  • skills/*/SKILL.md:可重用工作流和领域指南
  • agents/*.md:委托的子代理角色提示
  • rules/:语言和 harness 规则
  • hooks/README.md、hooks/hooks.json、scripts/hooks/:钩子行为和安全性门控
  • manifests/install-*.json:选择性安装模块、组件、配置和支持目标
  • docs/:harness 指南、架构说明、翻译文档、发布文档

回复风格

先给出答案,再给出下一步操作。大多数用户不需要完整的目录转储。

良好的首次回复结构:

  1. 使用什么
  2. 为什么适合
  3. 要检查的具体文件或命令
  4. 一个下一步命令或问题

避免:

  • 默认列出所有技能或命令
  • 重复大段 README 内容
  • 在存在技能优先路径的情况下推荐已退役的命令垫片
  • 在未检查文件系统的情况下声称某个组件存在
  • 当托管安装程序支持该目标时,用手动复制命令替代安装指导

常见任务

新用户引导

给出一个简短菜单:

  • 安装或重置 ECC
  • 为项目挑选技能
  • 理解命令与技能的区别
  • 检查钩子和安全性行为
  • 运行 harness 审计
  • 查找特定工作流

指向 README.md 了解安装/重置,指向 /project-init 了解特定于项目的引导。

功能发现

对于“我应该用什么来做 X?”:

  1. 搜索 skills/、commands/ 和 agents/。
  2. 优先使用技能作为主要工作流界面。
  3. 仅当命令是维护的兼容垫片或用户明确希望使用斜杠命令行为时,才使用命令。
  4. 当委托有用时提及代理。

有用的搜索:

rg -n "<query>" skills commands agents docs
find skills -maxdepth 2 -name SKILL.md | sort

安装指导

使用托管安装路径:

node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --profile minimal --target claude --json
node scripts/install-apply.js --profile minimal --target claude --dry-run

对于特定技能的安装:

node scripts/install-plan.js --skills <skill-id> --target claude --json
node scripts/install-apply.js --skills <skill-id> --target claude --dry-run

警告用户不要叠加插件安装和完整的手动/配置文件安装,除非他们有意重复界面。

项目初始化

当用户希望为目标仓库配置 ECC 时,使用 /project-init。预期流程如下:

  1. 从项目文件检测技术栈
  2. 解析一个试运行的安装计划
  3. 检查现有的 CLAUDE.md 和设置文件
  4. 在应用更改前询问
  5. 保持生成的指导最小化且特定于仓库

故障排查

首先询问目标 harness 和安装路径,然后检查:

  • 插件安装元数据
  • .claude/、.cursor/、.codex/、.gemini/、.opencode/、.codebuddy/、.joycode/ 或 .qwen/
  • hooks/hooks.json
  • 安装状态文件
  • 相关的命令/技能文件

对于仓库健康检查,建议:

npm run harness:audit -- --format text
npm run observability:ready
npm test

输出模板

简短推荐

使用 <技能或命令>。它适合是因为 <原因>。

规范文件:<路径>
验证方式:<命令>
下一步:<一个具体操作>

搜索结果

最佳匹配:
- <路径>:<为什么重要>
- <路径>:<为什么重要>

推荐:<首先使用哪个以及为什么>

安装计划摘要

已检测:<技术栈证据>
目标:<harness>
计划:<配置文件/模块/技能>
试运行:<命令>
将更改:<路径>
应用前是否需要批准:<是/否>

相关界面

  • /project-init:针对目标仓库的栈感知引导计划
  • /harness-audit:确定性就绪度评分卡
  • /skill-health:技能质量审查
  • /skill-create:从本地 git 历史生成新技能
  • /security-scan:检查 Claude/OpenCode 配置安全性

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.

相关技能