diff --git a/docs/comparison/cli-vs-ide-agents.md b/docs/comparison/cli-vs-ide-agents.md index e88fdf72..63be8782 100644 --- a/docs/comparison/cli-vs-ide-agents.md +++ b/docs/comparison/cli-vs-ide-agents.md @@ -10,7 +10,7 @@ Claude Code 在 2026 年已经不只是写代码的工具： Claude Code（Everything Code Agent） │ ├── 编码能力（传统） - │ └── Read/Edit/Bash/Grep/Glob + 79 命令 + 14 编辑格式 + │ └── Read/Edit/MultiEdit/Bash/Grep/Glob + ~79 命令 + 20+ 内置工具 │ ├── 外部世界连接（MCP 驱动） │ ├── 数据库查询（@modelcontextprotocol/server-postgres） @@ -20,9 +20,9 @@ Claude Code（Everything Code Agent） │ └── 任何 API（自定义 MCP 服务器） │ ├── 自动化（内置） - │ ├── /loop — 定时轮询（每 5 分钟检查部署状态） + │ ├── /loop — 定时轮询（默认间隔 10 分钟） │ ├── /schedule — Cron 定时（每天 9 点审查 PR） - │ └── Channels — 外部消息推送（Telegram/Discord） + │ └── Channels — 外部消息推送（Telegram/Discord，研究预览） │ └── 团队协作 ├── Teammates — AI-AI 多代理分工协作 @@ -37,7 +37,7 @@ Claude Code（Everything Code Agent） | 维度 | Everything Code Agent（终端原生） | IDE Agent（编辑器内嵌） | 混合型 | |------|-------------------------------|----------------------|--------| -| **代表** | Claude Code、Codex CLI、Gemini CLI、Qwen Code、Aider、Copilot CLI、Kimi CLI | Cursor、Cline、Continue | Warp（终端替代）、Qoder CLI（ACP） | +| **代表** | Claude Code、Codex CLI、Gemini CLI、Qwen Code、Aider、Copilot CLI、Kimi CLI | Cursor、Cline、Continue | Warp（Agentic Dev Env）、Qoder CLI（ACP） | | **核心定位** | **万能终端 Agent**（编码 + MCP 万物连接） | **编辑器增强**（补全 + 内联 + diff） | 终端 + IDE 桥接 | | **运行环境** | 终端进程 | IDE 扩展/内嵌 | 终端 + IDE | | **交互模式** | 对话式（prompt → 自主完成） | 内联式（补全 + diff 预览 + 侧边栏） | 混合 | @@ -45,7 +45,9 @@ Claude Code（Everything Code Agent） | **自主性** | **高**（长链多步自主操作） | 中（需用户确认每步） | 高 | | **外部集成** | **MCP 协议**（连接任何外部系统） | 有限（IDE 内扩展） | 部分 | | **CI/CD** | **原生支持** | 通常不支持 | 部分 | -| **启动速度** | 50ms~1.5s | 3~10s（Electron） | 亚秒级 | +| **启动速度** | ~50ms（原生 Rust）~ ~1.5s（Node.js/Python） | 3~10s（Electron） | 亚秒级~数秒 | + +> **免责声明**：启动速度为本机实测数据（2026-03-26，`time --version`，3 次取中位数，Linux x86-64）。Claude Code v2.1.84、Codex CLI v0.116.0、Gemini CLI v0.34.0、Qwen Code v0.13.0。 --- @@ -152,27 +154,27 @@ Cursor 的交互方式： | Agent | 语言 | 启动 | 自主链长度 | CI 支持 | 独特能力 | |-------|------|------|----------|---------|---------| -| **Claude Code** | Rust | **50ms** | 长（maxTurns 可配） | **`--bare` + stream-json** | 24 Hook + Prompt Hook + Channels | +| **Claude Code** | Rust | **~50ms** | 长（maxTurns + --max-budget-usd） | **`--bare` + stream-json** | 24 Hook + Prompt Hook + Channels | | **Aider** | Python | ~1s | 3 次反射 | `--message` | 14 编辑格式 + Git 自动提交 | -| **Codex CLI** | Rust | 76ms | 可配置 | 5 级审批 + Cloud | 三平台 OS 沙箱 | -| **Gemini CLI** | TS | 1.5s | 100 轮 | TTY 自动检测 | 8 策略模型路由 | -| **Qwen Code** | TS | 608ms | 100 轮 | `--non-interactive` | Arena 多模型竞争 | -| **Copilot CLI** | Shell | 72ms | 可配置 | `-p` + Autopilot | 67 GitHub 工具 | -| **Kimi CLI** | Python | ~1s | 100 步 | — | Wire 协议 + D-Mail | +| **Codex CLI** | Rust | ~76ms | 4~5 级审批模式 | Cloud 远程执行（实验性） | 三平台 OS 沙箱（Windows 实验性） | +| **Gemini CLI** | TS | ~1.5s | 100 轮 | TTY 自动检测 | 8 策略类（7 用户可见）模型路由 | +| **Qwen Code** | TS | ~608ms | 100 轮（MAX_TURNS） | `--non-interactive` | Arena 多模型竞争 | +| **Copilot CLI** | TS (Node.js SEA) | ~72ms | 可配置 | `-p` + Autopilot | 67 工具（12 核心 + 21 浏览器 + 48 平台） | +| **Kimi CLI** | Python | ~1s | 100 步 | — | Wire 协议 + D-Mail（实验性，okabe 代理） | ### IDE Agent | Agent | 平台 | 代码补全 | 内联编辑 | 多文件编排 | 后台执行 | 独特能力 | |-------|------|---------|---------|-----------|---------|---------| | **Cursor** | VS Code 深度分叉 | **Tab**（最强） | **Cmd+K** | Composer | **Background Agent（云端）** | Rules(.mdc) + @ 引用 | -| **Cline** | VS Code 扩展 | ✗ | WebView UI | ✓（subagent） | ✗ | **Git Checkpoint** + 24+ 工具 | -| **Continue** | VS Code + JetBrains | **Tab** | ✗ | ✓ | ✗ | **PR Checks**（CI 审查规则） | +| **Cline** | VS Code 扩展 | ✗ | WebView UI | ✓（只读子代理） | ✗ | **Git Checkpoint** + 26 工具 | +| **Continue** | VS Code + JetBrains + CLI | **Tab** | ✗ | ✓ | ✗ | **PR Checks**（CI 审查规则） | ### 混合型 | Agent | 类型 | 终端能力 | IDE 集成 | 独特定位 | |-------|------|---------|---------|---------| -| **Warp** | 终端替代品 | GPU 渲染 + 块结构 | — | Oz Agent + Warp Drive 团队协作 | +| **Warp** | Agentic Development Environment | GPU 渲染 + 块结构 | — | Oz Agent + Warp Drive 团队协作（Warp 2.0 四合一：Code/Agents/Terminal/Drive） | | **Qoder CLI** | CLI + ACP | Go 原生 43MB | **ACP 协议**（Zed/VS Code/JetBrains） | Quest 模式 + Experts 团队 | --- @@ -187,7 +189,7 @@ Cursor 的交互方式： | **审批流程** | Claude 24 Hook + Gemini TOML + Codex 沙箱 | 弹窗确认 | | **企业管控** | managed-settings 远程下发 | Cursor Business 管理面板 | -> Everything Agent 的安全模型显著更成熟——沙箱隔离、28 BLOCK 规则、策略引擎是 IDE Agent 没有的。 +> Everything Agent 的安全模型显著更成熟——沙箱隔离、28 BLOCK 规则（Claude Code）、TOML 策略引擎（Gemini CLI）是 IDE Agent 没有的。 --- @@ -198,7 +200,7 @@ Cursor 的交互方式： | **自动提交** | Aider（每次编辑自动 commit） | ✗（需手动） | | **检查点回退** | Claude Code（Esc）、Gemini CLI（/rewind 三选项） | Cline（Git Checkpoint 每步快照） | | **Worktree 隔离** | Claude Code Teammates（独立 worktree） | Cursor Background Agent（云端隔离） | -| **归因系统** | Aider（Co-authored-by 三标志） | ✗ | +| **归因系统** | Aider（Co-authored-by + 3 种归因选项） | ✗ | | **Git 命令** | Aider（/commit /undo /diff /git） | IDE Git 面板 | --- @@ -260,7 +262,7 @@ Cursor 的交互方式： ## 八、未来趋势 1. **Everything Agent 扩展边界**：Claude Code 从编码→MCP 万物连接→Channels 消息推送→Schedule 定时→Teammates 多代理——终端成为**通用 AI 操作中心** -2. **IDE Agent 追赶自主性**：Cursor Background Agent（云端异步）和 Cline subagent（并行子代理）试图弥补自主性差距 +2. **IDE Agent 追赶自主性**：Cursor Background Agent（云端异步）和 Cline subagent（并行只读子代理）试图弥补自主性差距 3. **ACP/MCP 协议融合**：Qoder CLI 的 ACP 试图标准化 CLI↔IDE 通信，MCP 已成为外部工具集成的事实标准 4. **Agent 脱离本机**：Cursor Background Agent（云端 PR）、Claude Code Channels（Telegram 远程触发）、Codex Cloud（远程执行）——Agent 越来越不需要在本机运行 5. **一个终端 = 一个 AI 团队**：Claude Code Teammates 让一个终端窗口同时运行多个 AI 代理协作，这是 IDE 范式难以复制的 @@ -273,10 +275,14 @@ Cursor 的交互方式： | Agent | 来源 | 获取方式 | |------|------|---------| | Claude Code | 二进制分析 v2.1.84 + `claude --help` | 本地二进制 | -| Cursor | docs/tools/cursor-cli.md（476 行） | 官方文档 | -| Cline | docs/tools/cline.md（151 行） | 开源 | -| Continue | docs/tools/continue.md（190 行） | 开源 | -| Warp | docs/tools/warp.md（382 行） | 官方文档 | +| Cursor | docs/tools/cursor-cli.md | 官方文档 | +| Cline | docs/tools/cline.md | 开源 | +| Continue | docs/tools/continue.md | 开源 | +| Warp | docs/tools/warp.md | 官方文档 | | Qoder CLI | docs/tools/qoder-cli/01-overview.md | Go 二进制分析 | | Aider | docs/tools/aider/ | 开源 | -| Qwen Code | cli.js 二进制 strings v0.13.0 | npm 包分析 | +| Qwen Code | docs/tools/qwen-code/ | 源码分析（Gemini CLI 分叉） | +| Codex CLI | docs/tools/codex-cli/ | Rust 二进制分析 | +| Gemini CLI | docs/tools/gemini-cli/ | 源码分析 | +| Copilot CLI | docs/tools/copilot-cli/ | SEA 反编译 | +| Kimi CLI | docs/tools/kimi-cli/ | 源码分析 | diff --git a/docs/comparison/features.md b/docs/comparison/features.md index 6c5353b6..18c16c41 100644 --- a/docs/comparison/features.md +++ b/docs/comparison/features.md @@ -42,7 +42,7 @@ |------|----------|--------------|-------------------| | Claude Code | Rust | 原生 CLI | 代理式编程工具 | | Aider | Python | Git 原生 | 结对编程 | -| Copilot CLI | Shell | 独立二进制 | 终端原生代理，GitHub 集成 | +| Copilot CLI | TypeScript (Node.js SEA) | 独立二进制 | 终端原生代理，GitHub 集成 | | Cursor | TypeScript | IDE (VS Code) | AI 原生编辑器 | | SWE-agent | Python | Agent-Computer Interface | 基准性能 | | Cline | TypeScript | IDE 扩展 | 自主编码 | diff --git a/docs/tools/README.md b/docs/tools/README.md index 51736461..db73a8bb 100644 --- a/docs/tools/README.md +++ b/docs/tools/README.md @@ -49,3 +49,9 @@ | Agent | 文件 | 行数 | 特色 | |------|------|------|------| | [Qoder CLI](./qoder-cli/) | 单文件 | 179 | Go 原生，Quest 模式，Claude Code 兼容，信用制 | + +## 增强系统 + +| 项目 | 文件 | 特色 | +|------|------|------| +| [Everything Claude Code](./everything-claude-code.md) | 单文件 | 28 Agent + 125 Skill + 60 命令，跨 Claude Code/Cursor/Codex/OpenCode | diff --git a/docs/tools/everything-claude-code.md b/docs/tools/everything-claude-code.md new file mode 100644 index 00000000..79372a3f --- /dev/null +++ b/docs/tools/everything-claude-code.md @@ -0,0 +1,311 @@ +# Everything Claude Code（ECC）—— AI Agent 增强系统 + +**仓库：** [github.com/affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) +**许可证：** MIT +**网站：** [ecc.tools](https://ecc.tools) +**版本：** v1.9.0（2026-03-21） +**最后更新：** 2026-03 + +## 概述 + +Everything Claude Code（简称 ECC）是一个面向 AI Agent 的**性能优化与增强系统**，通过 28 个专用 Agent、125+ 个 Skill、60 个斜杠命令、34 条规则和 Hook 自动化，将 Claude Code 等工具从编码助手提升为具备持续学习、记忆持久化、安全扫描和研究驱动开发的综合开发平台。 + +ECC 由 affaanmustafa（Anthropic Hackathon 获胜者，2025 年 9 月）创建，经过 10+ 个月的日常生产使用迭代。截至 2026 年 3 月，GitHub 仓库拥有 ~112k Stars、~14.6k Forks、113 位贡献者、816 次提交和 11 个 Release。 + +**核心定位：** ECC 不是一个独立的 Agent 工具，而是一套**增强层**——安装到现有 Agent 上，为其提供额外的 Agent、Skill、Command、Rule 和 Hook。 + +## 支持的 Agent 工具 + +ECC 是首个跨主流 AI 编码工具的增强插件： + +| 工具 | Agent 数 | 命令数 | Skill 数 | Hook 事件 | Rule 数 | +|------|---------|--------|---------|----------|--------| +| **Claude Code** | 28 | 60 | 125+ | 8 种事件类型 | 34 | +| **Cursor IDE** | 共享（AGENTS.md） | 共享 | 共享 | 15 种事件类型 | 34 | +| **Codex CLI/App** | 共享 | 指令式 | 16 | — | 指令式 | +| **OpenCode** | 12 | 31 | 37 | 11 种事件类型 | 13 | + +跨工具架构的核心设计： +- **AGENTS.md** 作为通用跨工具文件，所有工具均可读取 +- **DRY Adapter 模式**：Cursor 的 stdin JSON 通过 `adapter.js` 转换后，复用 Claude Code 的 Hook 脚本 +- **SKILL.md 格式**：跨工具通用的 Skill 定义格式 + +## 系统要求 + +- Claude Code CLI v2.1.0+ +- Node.js（用于 Hook 脚本运行时） + +--- + +## 核心组件 + +### 1. 28 个专用 Agent + +ECC 的 Agent 是带有 YAML frontmatter 的 Markdown 文件，定义了 `name`、`description`、`tools`（可用工具列表）和 `model`（推荐模型）。Agent 处理委派任务，具有受限的作用域和工具访问权限。 + +| 类别 | Agent | 说明 | +|------|-------|------| +| **规划** | planner | 创建实现蓝图 | +| **架构** | architect | 系统架构设计 | +| **测试** | tdd-guide, e2e-runner | TDD 工作流引导、E2E 测试 | +| **审查** | code-reviewer, security-reviewer, cpp-reviewer, go-reviewer, python-reviewer, typescript-reviewer, java-reviewer, kotlin-reviewer, rust-reviewer, database-reviewer | 按语言/领域分的代码审查 | +| **构建修复** | build-error-resolver, cpp-build-resolver, go-build-resolver, java-build-resolver, kotlin-build-resolver, rust-build-resolver, pytorch-build-resolver | 按生态分的构建错误解决 | +| **运维** | refactor-cleaner, doc-updater, docs-lookup, chief-of-staff, loop-operator, harness-optimizer | 重构、文档、循环操作、性能优化 | + +Agent 文件格式示例： + +```markdown +--- +name: code-reviewer +description: Reviews code for quality, security, and maintainability +tools: ["Read", "Grep", "Glob", "Bash"] +model: opus +--- +You are a senior code reviewer... +``` + +### 2. 125+ 个 Skill + +Skill 是工作流定义和领域知识库，以 SKILL.md 格式存储，通过命令或 Agent 调用。覆盖以下类别： + +| 类别 | Skill 示例 | +|------|-----------| +| **编码标准** | TypeScript、Python、Go、C++、Java、Swift、Perl、Rust、PHP 编码规范 | +| **框架模式** | Django、Spring Boot、Laravel、Next.js、PyTorch 最佳实践 | +| **测试** | TDD 工作流、Playwright E2E、验证循环、Eval Harness | +| **安全** | AgentShield 集成、安全审查 | +| **DevOps** | Docker、部署、数据库迁移、API 设计 | +| **AI/ML** | 成本感知 LLM 管道、regex-vs-LLM 决策、端侧基础模型 | +| **运营** | continuous-learning v2、autonomous-loops、strategic-compact | +| **商业/内容** | 文章写作、市场研究、投资人材料、内容引擎 | + +### 3. 60 个斜杠命令 + +| 类别 | 命令 | +|------|------| +| **开发流程** | `/plan`、`/tdd`、`/code-review`、`/build-fix`、`/e2e`、`/refactor-clean` | +| **安全与质量** | `/security-scan`、`/verify`、`/eval`、`/quality-gate` | +| **学习与记忆** | `/learn`、`/checkpoint`、`/instinct-import`、`/instinct-export`、`/instinct-status`、`/evolve`、`/prune`、`/skill-create` | +| **编排** | `/orchestrate`、`/sessions`、`/multi-plan`、`/multi-execute`、`/model-route` | +| **运维** | `/harness-audit`、`/loop-start`、`/pm2`、`/setup-pm` | + +### 4. 34 条规则（Rules） + +规则是**始终生效的指导原则**，加载到系统提示中，分为： + +- `common/`：语言无关规则（始终安装）—— 编码风格、Git 工作流、测试、性能、模式、安全 +- 语言特定目录：`typescript/`、`python/`、`golang/`、`swift/`、`php/`、`java/`、`rust/`、`cpp/`、`kotlin/`、`perl/` + +安装位置：用户级 `~/.claude/rules/` 或项目级 `.claude/rules/`。 + +### 5. Hook 自动化 + +Hook 基于 Claude Code 的 24 种事件类型触发自动化操作： + +| Hook 事件 | 用途 | +|----------|------| +| PreToolUse | 工具调用前拦截（如阻止敏感操作） | +| PostToolUse | 工具调用后处理（如 Edit 后自动检查 `console.log`） | +| Stop | 会话结束时保存状态 | +| SessionStart | 会话开始时加载上下文 | +| SessionEnd | 会话结束时保存上下文 | + +运行时控制： + +```bash +export ECC_HOOK_PROFILE=standard # minimal | standard | strict +export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck" +``` + +--- + +## 持续学习系统（Instincts v2） + +ECC 的 Instinct 系统是核心差异化能力，能够**自动从会话中学习用户模式**： + +``` +会话中产生的模式 + → /learn 提取模式 → Instinct（带置信度评分） + → /evolve 聚类相关 Instinct → Skill + → /skill-create 从 Git 历史生成 Skill +``` + +| 命令 | 功能 | +|------|------| +| `/instinct-status` | 显示已学 Instinct 及其置信度 | +| `/instinct-import` | 导入他人的 Instinct | +| `/instinct-export` | 导出 Instinct 用于团队共享 | +| `/evolve` | 将相关 Instinct 聚类为可复用 Skill | +| `/prune` | 删除过期的 pending Instinct（30 天 TTL） | +| `/learn` | 会话中提取模式 | +| `/learn-eval` | 提取、评估并保存模式 | + +每个 Instinct 包含置信度评分，支持导入/导出以实现团队间共享。 + +--- + +## 记忆持久化 + +通过会话生命周期 Hook 实现跨会话记忆持久化： + +| Hook 脚本 | 功能 | +|----------|------| +| `session-start.js` | 会话开始时加载上下文 | +| `session-end.js` | 会话结束时保存状态 | +| `pre-compact.js` | 压缩前保存状态 | +| `suggest-compact.js` | 战略性压缩建议 | +| `evaluate-session.js` | 从会话中提取模式 | + +**战略性压缩**（strategic-compact）：在逻辑断点处建议 `/compact`，而非等到 95% 上下文自动压缩。 + +压缩最佳实践： +- 在研究/探索完成后、里程碑达成后、调试完成后压缩 +- **不要**在实现中途压缩（会丢失变量名、文件路径、中间状态） +- 推荐设置：`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE: 50`（更早压缩以保持质量） + +--- + +## 安装 + +### 方式一：Plugin 安装（推荐） + +```bash +# 从 Plugin Marketplace 安装 +/plugin marketplace add affaan-m/everything-claude-code +/plugin install everything-claude-code@everything-claude-code +``` + +> **注意**：Rules 需手动安装（Plugin 系统的限制），安装到 `~/.claude/rules/` 或 `.claude/rules/`。 + +### 方式二：手动安装 + +```bash +git clone https://github.com/affaan-m/everything-claude-code.git +cd everything-claude-code +npm install + +# 选择语言生态安装 +./install.sh typescript # macOS/Linux +.\install.ps1 typescript # Windows +# 或 +npx ecc-install typescript +``` + +v1.9.0 支持基于 manifest 的选择性安装——可以只安装所需的组件。 + +### Token 优化建议 + +```json +{ + "model": "sonnet", + "env": { + "MAX_THINKING_TOKENS": "10000", + "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50", + "CLAUDE_CODE_SUBAGENT_MODEL": "haiku" + } +} +``` + +| 设置 | 默认值 | 推荐值 | 效果 | +|------|--------|--------|------| +| `model` | opus | sonnet | ~60% 成本降低 | +| `MAX_THINKING_TOKENS` | 31,999 | 10,000 | ~70% thinking 成本降低 | +| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 95 | 50 | 更早压缩，保持质量 | + +--- + +## 工作流示例 + +### TDD 开发流程 + +``` +/everything-claude-code:plan "Add user authentication with OAuth" + → planner agent 创建实现蓝图 + +/tdd + → tdd-guide agent 强制先写测试 + +/code-review + → code-reviewer agent 审查代码质量 +``` + +### 典型交互模式 + +``` +用户命令 → 命令触发 Agent（受限工具+模型） + → Agent 引用 Skill（领域知识） + → Hook 在工具事件时自动触发 + → Rules 始终生效作为背景指导 +``` + +--- + +## 生态工具 + +### AgentShield + +安全审计工具，用于扫描 Claude Code 配置中的安全隐患。 + +```bash +npx ecc-agentshield scan +``` + +- 1,282 个测试 +- 102 条静态分析规则 +- 5 个扫描类别 + +### Skill Creator + +`/skill-create` 命令支持本地分析，也可通过 GitHub App 获取高级功能。 + +### ECC Tools GitHub App + +Marketplace 应用，提供 free/pro/enterprise 三个层级。 + +--- + +## 版本历史 + +| 版本 | 日期 | 亮点 | +|------|------|------| +| **v1.9.0** | 2026-03 | Manifest 选择性安装、6 个新 Agent（TS/Java/Kotlin/PyTorch）、SQLite 状态存储、12 语言生态规则 | +| **v1.8.0** | 2026-03 | "Harness Performance System" 重新定位、Hook 可靠性重构、`ECC_HOOK_PROFILE` 运行时控制、997 测试 | +| **v1.7.0** | 2026-02 | Codex App + CLI 支持、5 个商业/内容 Skill、992 测试 | +| **v1.6.0** | 2026-02 | Codex CLI 支持、AgentShield 集成（1,282 测试/102 规则）、GitHub Marketplace App | +| **v1.4.0** | 2026-02 | 交互式安装向导、PM2 & 多 Agent 编排、多语言规则架构、中文翻译 | +| **v1.3.0** | 2026-02 | OpenCode 完整集成（12 Agent/24 命令/16 Skill/3 原生工具） | +| **v1.2.0** | 2026-02 | Python/Django + Java Spring Boot 支持、会话管理、Continuous Learning v2 | + +--- + +## 项目统计 + +| 指标 | 数值 | +|------|------| +| Stars | ~112k | +| Forks | ~14.6k | +| 贡献者 | 113 | +| 提交数 | 816 | +| Release | 11 | +| 内部测试 | 997+ | +| 支持语言 | 7（English、Portuguese、简体中文、繁体中文、日语、韩语、Turkish） | +| 代码构成 | JavaScript 81.5%、Python 6.3%、Rust 5.8%、Shell 4.6%、TypeScript 1.8% | + +> **免责声明**：以上数据基于 2026 年 3 月 GitHub 仓库快照，可能已过时。 + +## 局限性 + +- **依赖宿主工具**：ECC 不是一个独立的 Agent，必须安装在 Claude Code/Cursor/Codex/OpenCode 等工具上 +- **Token 开销**：125+ Skill、34 Rule 和 28 Agent 会增加系统提示的 Token 消耗——建议配合 Token 优化设置使用 +- **MCP 管理**：建议保持 MCP 服务器 < 10 个、工具 < 80 个，每个 MCP 工具描述都会消耗 Token +- **Plugin 限制**：Rules 需手动安装，Plugin 系统尚不支持自动分发 Rules + +## 证据来源 + +| 数据 | 来源 | +|------|------| +| 项目结构、组件数量 | GitHub README + 仓库目录结构 | +| 版本历史 | CHANGELOG.md + Release 页面 | +| 安装方式 | README.md 安装章节 | +| 跨工具架构 | README.md "Cross-Harness Support" 章节 | +| AgentShield | README.md "Ecosystem Tools" 章节 |