一、项目简介

Everything Claude Code (ECC) 是一个为 OpenCode 提供增强功能的插件项目，包含：

• 31 个命令（如 /plan、/tdd、/code-review 等）
• 24 个代理（如 planner、architect、code-reviewer 等）
• 11 个 Skills（如 tdd-workflow、security-review 等）
• 7 个自定义工具（如 run-tests、check-coverage 等）
• Hooks 钩子系统（自动格式化、TypeScript 检查、安全检查等）

---

二、两种安装方式对比

方式一：npm 包安装

安装步骤

npm install ecc-universal

然后在你的 opencode.json 中添加：

{
  "plugin": ["ecc-universal"]
}

获得的功能

功能	是否获得	说明
Hooks（钩子）	✅	自动格式化、TypeScript 检查、console.log 警告、安全检查、桌面通知
Custom Tools（工具）	✅	run-tests、check-coverage、security-audit、format-code、lint-check、git-summary、changed-files
环境注入	✅	自动检测项目语言、包管理器，注入环境变量
31 个命令	❌	不包含
24 个代理	❌	不包含
Instructions 规则	❌	不包含
Skills 技能	❌	不包含

优点

1. 安装简单 - 一行命令 + 一行配置即可完成
2. 自动更新 - 通过 npm update 即可更新
3. 无冲突风险 - 不会覆盖你现有的配置
4. 轻量级 - 只加载必要的 hooks 和 tools

缺点

1. 功能不完整 - 没有命令、代理、规则文档
2. 需要手动引导 - 无法使用 /plan、/tdd 等快捷命令
3. 缺少上下文规则 - AI 不知道 TDD 工作流、安全规范等
4. 性价比低 - 只得到约 30% 的功能

使用示例

npm 安装后，hooks 会自动生效：

• 编辑 JS/TS 文件后自动运行 prettier 格式化
• 编辑后自动检查 TypeScript 类型错误
• 提交前自动检查 console.log 语句
• 自动检测项目语言和包管理器

---

方式二：克隆安装（完整功能）

安装步骤

步骤 1：下载项目

# 方式 A：git clone
git clone https://github.com/affaan-m/everything-claude-code.git

# 方式 B：下载 ZIP 解压
# 从 https://github.com/affaan-m/everything-claude-code/archive/refs/heads/main.zip 下载

步骤 2：修改配置文件

编辑 .opencode/opencode.json，添加你的模型配置：

{
  "$schema": "https://opencode.ai/config.json",
  
  // 添加你的 provider 配置
  "provider": {
    "1": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://your-api-url/v1",
        "apiKey": "your-api-key"
      },
      "models": {
        "your-model": { "name": "your-model" }
      }
    }
  },
  
  // 删除或注释掉原来的 model 配置
  // "model": "anthropic/claude-sonnet-4-5",
  // "small_model": "anthropic/claude-haiku-4-5",
  
  // 保留其他配置
  "instructions": [...],
  "plugin": ["./plugins"],
  "agent": {...},
  "command": {...}
}

步骤 3：在项目目录运行 OpenCode

cd everything-claude-code-main
opencode

获得的功能

功能	是否获得	说明
Hooks（钩子）	✅	完整的钩子系统
Custom Tools（工具）	✅	7 个自定义工具
环境注入	✅	自动检测环境
31 个命令	✅	/plan、/tdd、/code-review 等
24 个代理	✅	planner、architect、code-reviewer 等
Instructions 规则	✅	编码规范、安全指南等
Skills 技能	✅	11 个预配置技能

优点

1. 功能完整 - 获得 100% 的功能
2. 命令快捷 - 使用 /plan、/tdd 等命令快速执行工作流
3. 代理专业 - 24 个专业代理处理不同任务
4. 规则内置 - AI 自动遵循 TDD、安全规范等最佳实践
5. 可自定义 - 可以修改命令、代理、规则

缺点

1. 配置复杂 - 需要修改 opencode.json 添加自己的模型配置
2. 更新麻烦 - 需要手动 git pull 更新
3. 必须在项目目录运行 - 不能在任意目录使用
4. 可能覆盖配置 - 需要小心处理 model 配置，避免丢失自己的模型设置

使用示例

克隆安装后，可以使用所有命令：

/plan 用户登录功能        # 创建实现计划
/tdd                      # 执行 TDD 工作流
/code-review              # 代码审查
/security                 # 安全检查
/build-fix                # 修复构建错误
/e2e                      # 生成 E2E 测试
/refactor-clean           # 清理死代码

---

三、功能详解

3.1 命令列表（31 个）

命令	说明	对应代理
/plan	创建实现计划	planner
/tdd	TDD 工作流	tdd-guide
/code-review	代码审查	code-reviewer
/security	安全检查	security-reviewer
/build-fix	修复构建错误	build-error-resolver
/e2e	E2E 测试	e2e-runner
/refactor-clean	清理死代码	refactor-cleaner
/orchestrate	多代理协调	planner
/learn	提取模式	-
/checkpoint	保存进度	-
/verify	验证循环	-
/eval	评估	-
/update-docs	更新文档	doc-updater
/update-codemaps	更新代码地图	doc-updater
/test-coverage	测试覆盖率	tdd-guide
/setup-pm	配置包管理器	-
/go-review	Go 代码审查	go-reviewer
/go-test	Go TDD	tdd-guide
/go-build	Go 构建修复	go-build-resolver
/skill-create	生成技能	-
/instinct-status	查看学习内容	-
/instinct-import	导入学习内容	-
/instinct-export	导出学习内容	-
/evolve	聚合学习内容	-
/promote	提升项目学习内容	-
/projects	列出已知项目	-

3.2 代理列表（24 个）

代理	说明	模式
build	主编码代理	primary
planner	实现计划专家	subagent
architect	系统设计专家	subagent
code-reviewer	代码审查专家	subagent
security-reviewer	安全分析专家	subagent
tdd-guide	TDD 开发专家	subagent
build-error-resolver	构建错误修复专家	subagent
e2e-runner	E2E 测试专家	subagent
doc-updater	文档更新专家	subagent
refactor-cleaner	代码清理专家	subagent
go-reviewer	Go 代码审查专家	subagent
go-build-resolver	Go 构建修复专家	subagent
database-reviewer	数据库优化专家	subagent
cpp-reviewer	C++ 代码审查专家	subagent
cpp-build-resolver	C++ 构建修复专家	subagent
docs-lookup	文档查找专家	subagent
harness-optimizer	Harness 优化专家	subagent
java-reviewer	Java 代码审查专家	subagent
java-build-resolver	Java 构建修复专家	subagent
kotlin-reviewer	Kotlin 代码审查专家	subagent
kotlin-build-resolver	Kotlin 构建修复专家	subagent
loop-operator	循环操作专家	subagent
python-reviewer	Python 代码审查专家	subagent
rust-reviewer	Rust 代码审查专家	subagent
rust-build-resolver	Rust 构建修复专家	subagent

3.3 Hooks 钩子功能

Hook	触发事件	功能
Prettier 格式化	file.edited	编辑 JS/TS 文件后自动格式化
TypeScript 检查	tool.execute.after	编辑后检查类型错误
console.log 警告	file.edited	检测并警告 console.log 语句
桌面通知	session.idle	任务完成时发送通知
安全检查	tool.execute.before	提交前检查敏感信息
环境注入	shell.env	自动注入 PROJECT_ROOT 等环境变量

3.4 Skills 技能列表

Skill	说明
tdd-workflow	测试驱动开发工作流
security-review	安全审查规范
coding-standards	编码标准
frontend-patterns	前端模式
frontend-slides	前端幻灯片
backend-patterns	后端模式
e2e-testing	E2E 测试
verification-loop	验证循环
api-design	API 设计
strategic-compact	战略压缩
eval-harness	评估 Harness

---

四、实际使用场景对比

场景：实现一个新功能

npm 安装方式

用户: 帮我实现用户登录功能

AI: (需要手动引导)
   - 你需要我做什么？
   - 创建哪些文件？
   - 需要测试吗？
   
用户: 先写测试，再实现...

(整个过程需要大量手动引导)

克隆安装方式

用户: /plan 用户登录功能

AI: (自动执行)
   1. 分析需求
   2. 识别风险
   3. 创建实现计划
   4. 等待确认
   
用户: 确认

AI: /tdd (自动执行 TDD 工作流)
   - 写测试
   - 实现
   - 运行测试
   - 代码审查
   
用户: /security

AI: (自动安全审查)
   - 检查 SQL 注入
   - 检查 XSS
   - 检查认证

---

五、推荐选择

使用场景	推荐方式
只想要自动化 hooks	npm 安装
想要完整开发工作流	克隆安装
新手入门	npm 安装
专业开发团队	克隆安装
不想修改配置	npm 安装
需要命令和代理	克隆安装

---

六、常见问题

Q1: npm 安装后如何使用命令？

A: npm 安装不包含命令。如果需要命令，请使用克隆安装。

Q2: 克隆安装后模型不对怎么办？

A: 编辑 .opencode/opencode.json，删除 model 和 small_model 字段，添加你的 provider 配置。

Q3: 如何更新？

• npm 安装：npm update ecc-universal
• 克隆安装：git pull

Q4: 可以同时使用两种方式吗？

A: 不建议。选择一种即可。

Q5: 克隆安装后找不到 skills 文件？

A: 确保在 ECC 项目根目录运行 opencode，不要在子目录运行。

---

七、总结

方式	功能完整度	配置难度	推荐指数
npm 安装	30%	简单	⭐⭐⭐
克隆安装	100%	中等	⭐⭐⭐⭐⭐

最终建议：如果你是专业开发者，想要完整的开发工作流和最佳实践，强烈推荐克隆安装。
如果只是想体验一下 hooks 自动化功能，可以先尝试 npm 安装。