configure-ecc
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseConfigure Everything Claude Code (ECC)
配置 Everything Claude Code (ECC)
An interactive, step-by-step installation wizard for the Everything Claude Code project. Uses to guide users through selective installation of skills and rules, then verifies correctness and offers optimization.
AskUserQuestion这是Everything Claude Code项目的交互式分步安装向导。通过引导用户选择性安装技能和规则,随后验证正确性并提供优化选项。
AskUserQuestionWhen to Activate
激活场景
- User says "configure ecc", "install ecc", "setup everything claude code", or similar
- User wants to selectively install skills or rules from this project
- User wants to verify or fix an existing ECC installation
- User wants to optimize installed skills or rules for their project
- 用户说出"configure ecc"、"install ecc"、"setup everything claude code"或类似指令时
- 用户想要选择性安装本项目中的技能或规则时
- 用户想要验证或修复现有ECC安装时
- 用户想要为其项目优化已安装的技能或规则时
Prerequisites
前置条件
This skill must be accessible to Claude Code before activation. Two ways to bootstrap:
- Via Plugin: — the plugin loads this skill automatically
/plugin install everything-claude-code - Manual: Copy only this skill to , then activate by saying "configure ecc"
~/.claude/skills/configure-ecc/SKILL.md
激活前,Claude Code必须能访问此技能。有两种引导方式:
- 通过插件:—— 插件会自动加载此技能
/plugin install everything-claude-code - 手动方式:仅将此技能复制到,然后说出"configure ecc"激活
~/.claude/skills/configure-ecc/SKILL.md
Step 0: Clone ECC Repository
步骤0:克隆ECC仓库
Before any installation, clone the latest ECC source to :
/tmpbash
rm -rf /tmp/everything-claude-code
git clone https://github.com/affaan-m/everything-claude-code.git /tmp/everything-claude-codeSet as the source for all subsequent copy operations.
ECC_ROOT=/tmp/everything-claude-codeIf the clone fails (network issues, etc.), use to ask the user to provide a local path to an existing ECC clone.
AskUserQuestion在进行任何安装前,将最新的ECC源码克隆到目录:
/tmpbash
rm -rf /tmp/everything-claude-code
git clone https://github.com/affaan-m/everything-claude-code.git /tmp/everything-claude-code设置作为后续所有复制操作的源目录。
ECC_ROOT=/tmp/everything-claude-code如果克隆失败(如网络问题等),使用询问用户提供现有ECC克隆的本地路径。
AskUserQuestionStep 1: Choose Installation Level
步骤1:选择安装级别
Use to ask the user where to install:
AskUserQuestionQuestion: "Where should ECC components be installed?"
Options:
- "User-level (~/.claude/)" — "Applies to all your Claude Code projects"
- "Project-level (.claude/)" — "Applies only to the current project"
- "Both" — "Common/shared items user-level, project-specific items project-level"Store the choice as . Set the target directory:
INSTALL_LEVEL- User-level:
TARGET=~/.claude - Project-level: (relative to current project root)
TARGET=.claude - Both: ,
TARGET_USER=~/.claudeTARGET_PROJECT=.claude
Create the target directories if they don't exist:
bash
mkdir -p $TARGET/skills $TARGET/rules使用询问用户安装位置:
AskUserQuestion问题:"ECC组件应安装到哪里?"
选项:
- "用户级 (~/.claude/)" —— "适用于您所有的Claude Code项目"
- "项目级 (.claude/)" —— "仅适用于当前项目"
- "两者都装" —— "通用/共享项安装到用户级,项目特定项安装到项目级"将选择结果存储为。设置目标目录:
INSTALL_LEVEL- 用户级:
TARGET=~/.claude - 项目级:(相对于当前项目根目录)
TARGET=.claude - 两者都装:,
TARGET_USER=~/.claudeTARGET_PROJECT=.claude
如果目标目录不存在则创建:
bash
mkdir -p $TARGET/skills $TARGET/rulesStep 2: Select & Install Skills
步骤2:选择并安装技能
2a: Choose Skill Categories
2a:选择技能类别
There are 27 skills organized into 4 categories. Use with :
AskUserQuestionmultiSelect: trueQuestion: "Which skill categories do you want to install?"
Options:
- "Framework & Language" — "Django, Spring Boot, Go, Python, Java, Frontend, Backend patterns"
- "Database" — "PostgreSQL, ClickHouse, JPA/Hibernate patterns"
- "Workflow & Quality" — "TDD, verification, learning, security review, compaction"
- "All skills" — "Install every available skill"现有27个技能,分为4个类别。使用支持的:
multiSelect: trueAskUserQuestion问题:"您想要安装哪些技能类别?"
选项:
- "框架与语言" —— "Django、Spring Boot、Go、Python、Java、前端、后端模式"
- "数据库" —— "PostgreSQL、ClickHouse、JPA/Hibernate模式"
- "工作流与质量" —— "TDD、验证、学习、安全审查、压缩"
- "所有技能" —— "安装所有可用技能"2b: Confirm Individual Skills
2b:确认单个技能
For each selected category, print the full list of skills below and ask the user to confirm or deselect specific ones. If the list exceeds 4 items, print the list as text and use with an "Install all listed" option plus "Other" for the user to paste specific names.
AskUserQuestionCategory: Framework & Language (16 skills)
| Skill | Description |
|---|---|
| Backend architecture, API design, server-side best practices for Node.js/Express/Next.js |
| Universal coding standards for TypeScript, JavaScript, React, Node.js |
| Django architecture, REST API with DRF, ORM, caching, signals, middleware |
| Django security: auth, CSRF, SQL injection, XSS prevention |
| Django testing with pytest-django, factory_boy, mocking, coverage |
| Django verification loop: migrations, linting, tests, security scans |
| React, Next.js, state management, performance, UI patterns |
| Idiomatic Go patterns, conventions for robust Go applications |
| Go testing: table-driven tests, subtests, benchmarks, fuzzing |
| Java coding standards for Spring Boot: naming, immutability, Optional, streams |
| Pythonic idioms, PEP 8, type hints, best practices |
| Python testing with pytest, TDD, fixtures, mocking, parametrization |
| Spring Boot architecture, REST API, layered services, caching, async |
| Spring Security: authn/authz, validation, CSRF, secrets, rate limiting |
| Spring Boot TDD with JUnit 5, Mockito, MockMvc, Testcontainers |
| Spring Boot verification: build, static analysis, tests, security scans |
Category: Database (3 skills)
| Skill | Description |
|---|---|
| ClickHouse patterns, query optimization, analytics, data engineering |
| JPA/Hibernate entity design, relationships, query optimization, transactions |
| PostgreSQL query optimization, schema design, indexing, security |
Category: Workflow & Quality (8 skills)
| Skill | Description |
|---|---|
| Auto-extract reusable patterns from sessions as learned skills |
| Instinct-based learning with confidence scoring, evolves into skills/commands/agents |
| Formal evaluation framework for eval-driven development (EDD) |
| Progressive context refinement for subagent context problem |
| Security checklist: auth, input, secrets, API, payment features |
| Suggests manual context compaction at logical intervals |
| Enforces TDD with 80%+ coverage: unit, integration, E2E |
| Verification and quality loop patterns |
Standalone
| Skill | Description |
|---|---|
| Template for creating project-specific skills |
对于每个选中的类别,打印下方完整技能列表,询问用户确认或取消选择特定技能。如果列表超过4项,将列表以文本形式打印,并使用提供“安装所有列出技能”选项,以及“其他”选项供用户粘贴特定技能名称。
AskUserQuestion类别:框架与语言(16个技能)
| 技能 | 描述 |
|---|---|
| 后端架构、API设计、Node.js/Express/Next.js服务端最佳实践 |
| TypeScript、JavaScript、React、Node.js通用编码规范 |
| Django架构、DRF REST API、ORM、缓存、信号、中间件 |
| Django安全:认证、CSRF、SQL注入、XSS防护 |
| 使用pytest-django、factory_boy、Mocking、覆盖率工具进行Django测试 |
| Django验证循环:迁移、代码检查、测试、安全扫描 |
| React、Next.js、状态管理、性能、UI模式 |
| 地道的Go模式、健壮Go应用的约定 |
| Go测试:表驱动测试、子测试、基准测试、模糊测试 |
| Spring Boot Java编码规范:命名、不可变性、Optional、流 |
| Python化 idiom、PEP 8、类型提示、最佳实践 |
| 使用pytest、TDD、fixtures、Mocking、参数化进行Python测试 |
| Spring Boot架构、REST API、分层服务、缓存、异步 |
| Spring Security:认证/授权、验证、CSRF、密钥、速率限制 |
| 使用JUnit 5、Mockito、MockMvc、Testcontainers进行Spring Boot TDD |
| Spring Boot验证:构建、静态分析、测试、安全扫描 |
类别:数据库(3个技能)
| 技能 | 描述 |
|---|---|
| ClickHouse模式、查询优化、分析、数据工程 |
| JPA/Hibernate实体设计、关系、查询优化、事务 |
| PostgreSQL查询优化、 schema设计、索引、安全 |
类别:工作流与质量(8个技能)
| 技能 | 描述 |
|---|---|
| 从会话中自动提取可复用模式作为习得技能 |
| 基于直觉的学习,带置信度评分,可演变为技能/命令/代理 |
| 用于评估驱动开发(EDD)的正式评估框架 |
| 针对子代理上下文问题的渐进式上下文优化 |
| 安全检查清单:认证、输入、密钥、API、支付功能 |
| 建议在逻辑间隔处手动压缩上下文 |
| 强制执行覆盖率80%+的TDD:单元测试、集成测试、端到端测试 |
| 验证与质量循环模式 |
独立技能
| 技能 | 描述 |
|---|---|
| 创建项目特定技能的模板 |
2c: Execute Installation
2c:执行安装
For each selected skill, copy the entire skill directory:
bash
cp -r $ECC_ROOT/skills/<skill-name> $TARGET/skills/Note: and have extra files (config.json, hooks, scripts) — ensure the entire directory is copied, not just SKILL.md.
continuous-learningcontinuous-learning-v2对于每个选中的技能,复制整个技能目录:
bash
cp -r $ECC_ROOT/skills/<skill-name> $TARGET/skills/注意:和包含额外文件(config.json、hooks、scripts)——确保复制整个目录,而不仅仅是SKILL.md。
continuous-learningcontinuous-learning-v2Step 3: Select & Install Rules
步骤3:选择并安装规则
Use with :
AskUserQuestionmultiSelect: trueQuestion: "Which rule sets do you want to install?"
Options:
- "Common rules (Recommended)" — "Language-agnostic principles: coding style, git workflow, testing, security, etc. (8 files)"
- "TypeScript/JavaScript" — "TS/JS patterns, hooks, testing with Playwright (5 files)"
- "Python" — "Python patterns, pytest, black/ruff formatting (5 files)"
- "Go" — "Go patterns, table-driven tests, gofmt/staticcheck (5 files)"Execute installation:
bash
undefined使用支持的:
multiSelect: trueAskUserQuestion问题:"您想要安装哪些规则集?"
选项:
- "通用规则(推荐)" —— "与语言无关的原则:编码风格、Git工作流、测试、安全等(8个文件)"
- "TypeScript/JavaScript" —— "TS/JS模式、钩子、使用Playwright测试(5个文件)"
- "Python" —— "Python模式、pytest、black/ruff格式化(5个文件)"
- "Go" —— "Go模式、表驱动测试、gofmt/staticcheck(5个文件)"执行安装:
bash
undefinedCommon rules (flat copy into rules/)
通用规则(直接复制到rules/目录)
cp -r $ECC_ROOT/rules/common/* $TARGET/rules/
cp -r $ECC_ROOT/rules/common/* $TARGET/rules/
Language-specific rules (flat copy into rules/)
特定语言规则(直接复制到rules/目录)
cp -r $ECC_ROOT/rules/typescript/* $TARGET/rules/ # if selected
cp -r $ECC_ROOT/rules/python/* $TARGET/rules/ # if selected
cp -r $ECC_ROOT/rules/golang/* $TARGET/rules/ # if selected
**Important**: If the user selects any language-specific rules but NOT common rules, warn them:
> "Language-specific rules extend the common rules. Installing without common rules may result in incomplete coverage. Install common rules too?"
---cp -r $ECC_ROOT/rules/typescript/* $TARGET/rules/ # 如果选中
cp -r $ECC_ROOT/rules/python/* $TARGET/rules/ # 如果选中
cp -r $ECC_ROOT/rules/golang/* $TARGET/rules/ # 如果选中
**重要提示**:如果用户选择了任何特定语言规则但未选择通用规则,需发出警告:
> "特定语言规则是对通用规则的扩展。不安装通用规则可能导致覆盖不完整。是否也要安装通用规则?"
---Step 4: Post-Installation Verification
步骤4:安装后验证
After installation, perform these automated checks:
安装完成后,执行以下自动检查:
4a: Verify File Existence
4a:验证文件存在性
List all installed files and confirm they exist at the target location:
bash
ls -la $TARGET/skills/
ls -la $TARGET/rules/列出所有已安装文件,确认它们存在于目标位置:
bash
ls -la $TARGET/skills/
ls -la $TARGET/rules/4b: Check Path References
4b:检查路径引用
Scan all installed files for path references:
.mdbash
grep -rn "~/.claude/" $TARGET/skills/ $TARGET/rules/
grep -rn "../common/" $TARGET/rules/
grep -rn "skills/" $TARGET/skills/For project-level installs, flag any references to paths:
~/.claude/- If a skill references — this is usually fine (settings are always user-level)
~/.claude/settings.json - If a skill references or
~/.claude/skills/— this may be broken if installed only at project level~/.claude/rules/ - If a skill references another skill by name — check that the referenced skill was also installed
扫描所有已安装的文件中的路径引用:
.mdbash
grep -rn "~/.claude/" $TARGET/skills/ $TARGET/rules/
grep -rn "../common/" $TARGET/rules/
grep -rn "skills/" $TARGET/skills/对于项目级安装,标记所有指向路径的引用:
~/.claude/- 如果技能引用—— 通常没问题(设置始终是用户级的)
~/.claude/settings.json - 如果技能引用或
~/.claude/skills/—— 如果仅安装在项目级,这可能会失效~/.claude/rules/ - 如果技能按名称引用其他技能 —— 检查被引用的技能是否也已安装
4c: Check Cross-References Between Skills
4c:检查技能间的交叉引用
Some skills reference others. Verify these dependencies:
- may reference
django-tdddjango-patterns - may reference
springboot-tddspringboot-patterns - references
continuous-learning-v2directory~/.claude/homunculus/ - may reference
python-testingpython-patterns - may reference
golang-testinggolang-patterns - Language-specific rules reference counterparts
common/
部分技能会引用其他技能。验证这些依赖关系:
- 可能引用
django-tdddjango-patterns - 可能引用
springboot-tddspringboot-patterns - 引用
continuous-learning-v2目录~/.claude/homunculus/ - 可能引用
python-testingpython-patterns - 可能引用
golang-testinggolang-patterns - 特定语言规则引用对应的规则
common/
4d: Report Issues
4d:报告问题
For each issue found, report:
- File: The file containing the problematic reference
- Line: The line number
- Issue: What's wrong (e.g., "references ~/.claude/skills/python-patterns but python-patterns was not installed")
- Suggested fix: What to do (e.g., "install python-patterns skill" or "update path to .claude/skills/")
对于发现的每个问题,报告:
- 文件:包含问题引用的文件
- 行号:问题所在行号
- 问题:具体问题(例如:"引用~/.claude/skills/python-patterns但python-patterns未安装")
- 建议修复方案:解决方法(例如:"安装python-patterns技能"或"将路径更新为.claude/skills/")
Step 5: Optimize Installed Files (Optional)
步骤5:优化已安装文件(可选)
Use :
AskUserQuestionQuestion: "Would you like to optimize the installed files for your project?"
Options:
- "Optimize skills" — "Remove irrelevant sections, adjust paths, tailor to your tech stack"
- "Optimize rules" — "Adjust coverage targets, add project-specific patterns, customize tool configs"
- "Optimize both" — "Full optimization of all installed files"
- "Skip" — "Keep everything as-is"使用:
AskUserQuestion问题:"您想要为项目优化已安装的文件吗?"
选项:
- "优化技能" —— "移除无关章节、调整路径、适配您的技术栈"
- "优化规则" —— "调整覆盖率目标、添加项目特定模式、自定义工具配置"
- "两者都优化" —— "全面优化所有已安装文件"
- "跳过" —— "保持原样"If optimizing skills:
如果优化技能:
- Read each installed SKILL.md
- Ask the user what their project's tech stack is (if not already known)
- For each skill, suggest removals of irrelevant sections
- Edit the SKILL.md files in-place at the installation target (NOT the source repo)
- Fix any path issues found in Step 4
- 读取每个已安装的SKILL.md
- 询问用户其项目的技术栈(如果未知)
- 针对每个技能,建议移除无关章节
- 在安装目标位置(而非源仓库)直接编辑SKILL.md文件
- 修复步骤4中发现的路径问题
If optimizing rules:
如果优化规则:
- Read each installed rule .md file
- Ask the user about their preferences:
- Test coverage target (default 80%)
- Preferred formatting tools
- Git workflow conventions
- Security requirements
- Edit the rule files in-place at the installation target
Critical: Only modify files in the installation target (), NEVER modify files in the source ECC repository ().
$TARGET/$ECC_ROOT/- 读取每个已安装的规则.md文件
- 询问用户偏好:
- 测试覆盖率目标(默认80%)
- 首选格式化工具
- Git工作流约定
- 安全要求
- 在安装目标位置直接编辑规则文件
关键注意事项:仅修改安装目标目录()中的文件,绝不要修改源ECC仓库()中的文件。
$TARGET/$ECC_ROOT/Step 6: Installation Summary
步骤6:安装总结
Clean up the cloned repository from :
/tmpbash
rm -rf /tmp/everything-claude-codeThen print a summary report:
undefined清理目录中的克隆仓库:
/tmpbash
rm -rf /tmp/everything-claude-code然后打印总结报告:
undefinedECC Installation Complete
ECC安装完成
Installation Target
安装目标
- Level: [user-level / project-level / both]
- Path: [target path]
- 级别:[用户级 / 项目级 / 两者都装]
- 路径:[目标路径]
Skills Installed ([count])
已安装技能([数量]个)
- skill-1, skill-2, skill-3, ...
- skill-1, skill-2, skill-3, ...
Rules Installed ([count])
已安装规则([数量]个)
- common (8 files)
- typescript (5 files)
- ...
- common(8个文件)
- typescript(5个文件)
- ...
Verification Results
验证结果
- [count] issues found, [count] fixed
- [list any remaining issues]
- 发现[数量]个问题,已修复[数量]个
- [列出所有剩余问题]
Optimizations Applied
已应用优化
- [list changes made, or "None"]
---- [列出所做更改,或“无”]
---Troubleshooting
故障排除
"Skills not being picked up by Claude Code"
"Claude Code未识别到技能"
- Verify the skill directory contains a file (not just loose .md files)
SKILL.md - For user-level: check exists
~/.claude/skills/<skill-name>/SKILL.md - For project-level: check exists
.claude/skills/<skill-name>/SKILL.md
- 验证技能目录包含文件(不能是零散的.md文件)
SKILL.md - 对于用户级:检查是否存在
~/.claude/skills/<skill-name>/SKILL.md - 对于项目级:检查是否存在
.claude/skills/<skill-name>/SKILL.md
"Rules not working"
"规则不生效"
- Rules are flat files, not in subdirectories: (correct) vs
$TARGET/rules/coding-style.md(incorrect for flat install)$TARGET/rules/common/coding-style.md - Restart Claude Code after installing rules
- 规则是扁平文件,不能放在子目录中:(正确) vs
$TARGET/rules/coding-style.md(扁平安装时错误)$TARGET/rules/common/coding-style.md - 安装规则后重启Claude Code
"Path reference errors after project-level install"
"项目级安装后出现路径引用错误"
- Some skills assume paths. Run Step 4 verification to find and fix these.
~/.claude/ - For , the
continuous-learning-v2directory is always user-level — this is expected and not an error.~/.claude/homunculus/
- 部分技能假设使用路径。运行步骤4的验证来查找并修复这些问题。
~/.claude/ - 对于,
continuous-learning-v2目录始终是用户级的——这是预期行为,并非错误。~/.claude/homunculus/