configure-ecc

配置 Everything Claude Code (ECC)

Everything Claude Code 项目的交互式分步安装向导。使用 AskUserQuestion 引导用户选择性安装技能和规则，然后验证正确性并提供优化选项。

何时激活

• 用户说“配置 ecc”、“安装 ecc”、“设置 everything claude code”或类似内容
• 用户想要从此项目选择性安装技能或规则
• 用户想要验证或修复现有的 ECC 安装
• 用户想要针对其项目优化已安装的技能或规则

前置条件

此技能必须在激活前对 Claude Code 可访问。两种引导方式：

1. 通过插件：/plugin install ecc@ecc——插件会自动加载此技能
2. 手动：仅将此技能复制到 ~/.claude/skills/configure-ecc/SKILL.md，然后通过说“配置 ecc”激活

---

第 0 步：克隆 ECC 仓库

在任何安装之前，将最新的 ECC 源码克隆到 /tmp：

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 作为所有后续复制操作的源目录。

如果克隆失败（网络问题等），使用 AskUserQuestion 询问用户提供现有 ECC 克隆的本地路径。

---

第 1 步：选择安装级别

使用 AskUserQuestion 询问用户安装位置：

问题：“ECC 组件应安装在哪里？”
选项：
  - “用户级 (~/.claude/)” — “适用于您的所有 Claude Code 项目”
  - “项目级 (.claude/)” — “仅适用于当前项目”
  - “两者” — “公共/共享项安装到用户级，项目特定项安装到项目级”

将选择存储为 INSTALL_LEVEL。设置目标目录：

• 用户级：TARGET=~/.claude
• 项目级：TARGET=.claude（相对于当前项目根目录）
• 两者：TARGET_USER=~/.claude，TARGET_PROJECT=.claude

如果目标目录不存在，则创建它们：

mkdir -p $TARGET/skills $TARGET/rules

---

第 2 步：选择并安装技能

2a：选择范围（核心 vs 细分）

默认选择核心（推荐新用户使用）——复制 .agents/skills/* 以及 skills/search-first/ 用于研究优先的工作流。此捆绑包涵盖工程、评估、验证、安全、战略精简、前端设计和 Anthropic 跨职能技能（文章写作、内容引擎、市场研究、前端幻灯片）。

使用 AskUserQuestion（单选）：

问题：“仅安装核心技能，还是包含细分/框架包？”
选项：
  - “仅核心（推荐）” — “tdd、e2e、评估、验证、研究优先、安全、前端模式、精简、跨职能 Anthropic 技能”
  - “核心 + 选定的细分” — “在核心之后添加框架/领域特定技能”
  - “仅细分” — “跳过核心，安装特定的框架/领域技能”
默认：仅核心

如果用户选择细分或核心+细分，则继续下面的类别选择，并仅包含他们选择的那些细分技能。

2b：选择技能类别

以下有 7 个可选的类别组。下面详细的确认列表涵盖了 8 个类别中的 45 个技能，外加 1 个独立模板。使用带有 multiSelect: true 的 AskUserQuestion：

问题：“您想安装哪些技能类别？”
选项：
  - “框架与语言” — “Django、Laravel、Spring Boot、Quarkus、Go、Python、Java、前端、后端模式”
  - “数据库” — “PostgreSQL、ClickHouse、JPA/Hibernate 模式”
  - “工作流与质量” — “TDD、验证、学习、安全审查、精简”
  - “研究与 API” — “深度研究、Exa 搜索、Claude API 模式”
  - “社交与内容分发” — “X/Twitter API、跨平台发布与内容引擎”
  - “媒体生成” — “fal.ai 图像/视频/音频与 VideoDB”
  - “编排” — “dmux 多智能体工作流”
  - “所有技能” — “安装所有可用技能”

2c：确认单个技能

对于每个选定的类别，打印下面的完整技能列表，并询问用户确认或取消选择特定技能。如果列表超过 4 项，则将列表打印为文本，并使用带有“安装所有列出的”选项以及“其他”供用户粘贴特定名称的 AskUserQuestion。

类别：框架与语言（25 个技能）

技能	描述
backend-patterns	后端架构、API 设计、Node.js/Express/Next.js 的服务器端最佳实践
coding-standards	TypeScript、JavaScript、React、Node.js 的通用编码标准
django-patterns	Django 架构、使用 DRF 的 REST API、ORM、缓存、信号、中间件
django-security	Django 安全：认证、CSRF、SQL 注入、XSS 防护
django-tdd	使用 pytest-django、factory_boy、模拟、覆盖率的 Django 测试
django-verification	Django 验证循环：迁移、代码检查、测试、安全扫描
laravel-patterns	Laravel 架构模式：路由、控制器、Eloquent、队列、缓存
laravel-security	Laravel 安全：认证、策略、CSRF、批量赋值、速率限制
laravel-tdd	使用 PHPUnit 和 Pest、工厂、伪造、覆盖率的 Laravel 测试
laravel-verification	Laravel 验证：代码检查、静态分析、测试、安全扫描
frontend-patterns	React、Next.js、状态管理、性能、UI 模式
frontend-slides	零依赖 HTML 演示文稿、样式预览和 PPTX 到 Web 的转换
golang-patterns	地道的 Go 模式、健壮 Go 应用程序的约定
golang-testing	Go 测试：表驱动测试、子测试、基准测试、模糊测试
java-coding-standards	Spring Boot 和 Quarkus 的 Java 编码标准：命名、不可变性、Optional、流、CDI
python-patterns	Python 惯用写法、PEP 8、类型提示、最佳实践
python-testing	使用 pytest、TDD、fixture、模拟、参数化的 Python 测试
quarkus-patterns	Quarkus 架构、Camel 消息传递、CDI 服务、Panache 数据访问
quarkus-security	Quarkus 安全：JWT/OIDC、RBAC、输入验证、密钥管理
quarkus-tdd	使用 JUnit 5、Mockito、REST Assured、Camel 测试的 Quarkus TDD
quarkus-verification	Quarkus 验证：构建、静态分析、测试、原生编译
springboot-patterns	Spring Boot 架构、REST API、分层服务、缓存、异步
springboot-security	Spring Security：认证/授权、验证、CSRF、密钥、速率限制
springboot-tdd	使用 JUnit 5、Mockito、MockMvc、Testcontainers 的 Spring Boot TDD
springboot-verification	Spring Boot 验证：构建、静态分析、测试、安全扫描

类别：数据库（3 个技能）

技能	描述
clickhouse-io	ClickHouse 模式、查询优化、分析、数据工程
jpa-patterns	JPA/Hibernate 实体设计、关系、查询优化、事务
postgres-patterns	PostgreSQL 查询优化、模式设计、索引、安全

类别：工作流与质量（8 个技能）

技能	描述
continuous-learning	旧版 v1 停止钩子会话模式提取；新安装推荐使用 continuous-learning-v2
continuous-learning-v2	基于本能的学习，带有置信度评分，演变为技能、智能体和可选的旧版命令垫片
eval-harness	用于评估驱动开发 (EDD) 的正式评估框架
iterative-retrieval	针对子智能体上下文问题的渐进式上下文优化
security-review	安全检查清单：认证、输入、密钥、API、支付功能
strategic-compact	建议在逻辑间隔处进行手动上下文精简
tdd-workflow	强制执行 TDD，覆盖率 80% 以上：单元、集成、端到端
verification-loop	验证与质量循环模式

类别：业务与内容（5 个技能）

技能	描述
article-writing	使用提供的语气，基于笔记、示例或源文档进行长文写作
content-engine	多平台社交内容、脚本和重新利用工作流
market-research	带有来源归属的市场、竞争对手、基金和技术研究
investor-materials	融资演讲稿、一页纸、投资者备忘录和财务模型
investor-outreach	个性化的投资者冷邮件、温暖介绍和后续跟进

类别：研究与 API（2 个技能）

技能	描述
deep-research	使用 firecrawl 和 exa MCP 的多源深度研究，附带引用报告
exa-search	通过 Exa MCP 进行神经搜索，用于网络、代码、公司和人员研究

claude-api 是 Anthropic 的规范技能。当您想要官方 Claude API 工作流而不是 ECC 捆绑的副本时，从 anthropics/skills 安装它。

类别：社交与内容分发（2 个技能）

技能	描述
x-api	X/Twitter API 集成，用于发布、线程、搜索和分析
crosspost	多平台内容分发，带有平台原生适配

类别：媒体生成（2 个技能）

技能	描述
fal-ai-media	通过 fal.ai MCP 的统一 AI 媒体生成（图像、视频、音频）
video-editing	AI 辅助视频编辑，用于剪辑、结构和增强真实素材

类别：编排（1 个技能）

技能	描述
dmux-workflows	使用 dmux 进行多智能体编排，用于并行智能体会话

独立项

技能	描述
docs/examples/project-guidelines-template.md	用于创建项目特定技能的模板

2d：执行安装

对于每个选定的技能，从正确的源根目录复制整个技能目录：

# 核心技能位于 .agents/skills/ 下
cp -R "$ECC_ROOT/.agents/skills/<skill-name>" "$TARGET/skills/"

# 细分技能位于 skills/ 下
cp -R "$ECC_ROOT/skills/<skill-name>" "$TARGET/skills/"

在遍历通配符源目录时，切勿将带尾随斜杠的源直接传递给 cp。显式使用目录路径作为目标名称：

cp -R "${src%/}" "$TARGET/skills/$(basename "${src%/}")"

注意：continuous-learning 和 continuous-learning-v2 有额外文件（config.json、钩子、脚本）——确保复制整个目录，而不仅仅是 SKILL.md。

---

第 3 步：选择并安装规则

使用带有 multiSelect: true 的 AskUserQuestion：

问题：“您想安装哪些规则集？”
选项：
  - “通用规则（推荐）” — “与语言无关的原则：编码风格、Git 工作流、测试、安全等（8 个文件）”
  - “TypeScript/JavaScript” — “TS/JS 模式、钩子、使用 Playwright 的测试（5 个文件）”
  - “Python” — “Python 模式、pytest、black/ruff 格式化（5 个文件）”
  - “Go” — “Go 模式、表驱动测试、gofmt/staticcheck（5 个文件）”

执行安装：

# 通用规则
cp -r $ECC_ROOT/rules/common $TARGET/rules/common

# 语言特定规则（保留每种语言的目录）
cp -r $ECC_ROOT/rules/typescript $TARGET/rules/typescript   # 如果选中
cp -r $ECC_ROOT/rules/python $TARGET/rules/python            # 如果选中
cp -r $ECC_ROOT/rules/golang $TARGET/rules/golang            # 如果选中

重要：如果用户选择了任何语言特定规则但未选择通用规则，请警告他们：

“语言特定规则扩展了通用规则。不安装通用规则可能导致覆盖不完整。是否也安装通用规则？”

---

第 4 步：安装后验证

安装后，执行以下自动检查：

4a：验证文件存在

列出所有已安装的文件并确认它们存在于目标位置：

ls -la $TARGET/skills/
ls -la $TARGET/rules/

4b：检查路径引用

扫描所有已安装的 .md 文件中的路径引用：

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：检查技能之间的交叉引用

某些技能引用其他技能。验证这些依赖关系：

• django-tdd 可能引用 django-patterns
• laravel-tdd 可能引用 laravel-patterns
• quarkus-tdd 可能引用 quarkus-patterns
• springboot-tdd 可能引用 springboot-patterns
• continuous-learning-v2 引用 ~/.claude/homunculus/ 目录
• python-testing 可能引用 python-patterns
• golang-testing 可能引用 golang-patterns
• crosspost 引用 content-engine 和 x-api
• deep-research 引用 exa-search（互补的 MCP 工具）
• fal-ai-media 引用 videodb（互补的媒体技能）
• x-api 引用 content-engine 和 crosspost
• 语言特定规则引用 common/ 对应项

4d：报告问题

对于发现的每个问题，报告：

1. 文件：包含问题引用的文件
2. 行：行号
3. 问题：出了什么问题（例如，“引用了 ~/.claude/skills/python-patterns 但 python-patterns 未安装”）
4. 建议修复：该怎么做（例如，“安装 python-patterns 技能”或“将路径更新为 .claude/skills/”）

---

第 5 步：优化已安装的文件（可选）

使用 AskUserQuestion：

问题：“您是否希望针对您的项目优化已安装的文件？”
选项：
  - “优化技能” — “删除不相关的部分，调整路径，根据您的技术栈定制”
  - “优化规则” — “调整覆盖率目标，添加项目特定模式，自定义工具配置”
  - “优化两者” — “对所有已安装文件进行全面优化”
  - “跳过” — “保持原样”

如果优化技能：

1. 读取每个已安装的 SKILL.md
2. 询问用户项目的技术栈（如果尚不知道）
3. 对于每个技能，建议删除不相关的部分
4. 在安装目标处就地编辑 SKILL.md 文件（而不是源仓库）
5. 修复第 4 步中发现的任何路径问题

如果优化规则：

1. 读取每个已安装的规则 .md 文件
2. 询问用户的偏好：
   • 测试覆盖率目标（默认 80%）
   • 首选的格式化工具
   • Git 工作流约定
   • 安全要求
3. 在安装目标处就地编辑规则文件

关键：仅修改安装目标（$TARGET/）中的文件，切勿修改 ECC 源仓库（$ECC_ROOT/）中的文件。

---

第 6 步：安装摘要

从 /tmp 清理克隆的仓库：

rm -rf /tmp/everything-claude-code

然后打印摘要报告：

## ECC 安装完成

### 安装目标
- 级别：[用户级 / 项目级 / 两者]
- 路径：[目标路径]

### 已安装的技能（[数量]）
- skill-1, skill-2, skill-3, ...

### 已安装的规则（[数量]）
- common（8 个文件）
- typescript（5 个文件）
- ...

### 验证结果
- 发现 [数量] 个问题，已修复 [数量] 个
- [列出任何剩余问题]

### 应用的优化
- [列出所做的更改，或“无”]

---

故障排除

“技能未被 Claude Code 识别”

• 验证技能目录包含 SKILL.md 文件（不仅仅是零散的 .md 文件）
• 对于用户级：检查 ~/.claude/skills/<skill-name>/SKILL.md 是否存在
• 对于项目级：检查 .claude/skills/<skill-name>/SKILL.md 是否存在

“规则不生效”

• 规则是平面文件，不在子目录中：$TARGET/rules/coding-style.md（正确）vs $TARGET/rules/common/coding-style.md（对于平面安装不正确）
• 安装规则后重启 Claude Code

“项目级安装后路径引用错误”

• 某些技能假定 ~/.claude/ 路径。运行第 4 步验证以查找并修复这些问题。
• 对于 continuous-learning-v2，~/.claude/homunculus/ 目录始终是用户级的——这是预期的，不是错误。