企业官网建设流程全解析

语言支持

支持的语言包括：英语 | 葡萄牙语（巴西） | 简体中文 | 繁体中文 | 日语 | 韩语 | 土耳其语 | 俄语 | 越南语 | 泰语 | 德语

项目概况

ECC 拥有超过 182K 的星星、28K 的分支和 170 多位贡献者，涵盖 12 种语言生态系统，是由 Anthropic 黑客松获胜者开发的用于代理工作的原生操作符系统。它不仅仅是配置文件，而是一个完整的系统，具备技能、本能、内存优化、持续学习、安全扫描和以研究为导向的开发等功能。经过 10 多个月的实际产品构建和日常密集使用，它已发展出适用于生产环境的代理、技能、钩子、规则、MCP 配置和旧命令垫片。该系统可在 Claude Code、Codex、Cursor、OpenCode、Gemini、Zed、GitHub Copilot 等多种 AI 代理框架上运行。

版本更新

v2.0.0 - rc.1（2026 年 4 月）：界面刷新，推出基于 Tkinter 的新桌面应用程序 `ecc_dashboard.py` 或通过 `npm run dashboard` 启动，支持暗/亮主题切换、字体自定义，在标题栏和任务栏显示项目徽标；公共界面同步，元数据、目录计数、插件清单和安装文档与实际的开源项目界面保持一致，包含 61 个代理、246 项技能和 76 个旧命令垫片；操作符和出站工作流扩展，新增品牌语音、社交图排名器、连接优化器、客户计费操作、ecc 工具成本审计、谷歌工作区操作、项目流程操作和工作区界面审计等功能；媒体和发布工具，增加 manim 视频、Remotion 视频创建和升级的社交发布界面，使技术说明和发布内容融入同一系统；框架和产品界面增长，引入 nestjs 模式、更丰富的 Codex/OpenCode 安装界面和扩展的跨框架打包，使项目不仅适用于 Claude Code；Itô 预测市场技能包，添加 ito 市场情报、ito 篮子比较、ito 交易计划器、ito 数据图谱代理、预测市场预言机研究和预测市场风险审查等功能，同时将实时 Itô API 访问与 ECC 工具计费分开；优化技能包，包括并行执行优化器、基准优化循环、数据吞吐量加速器、低延迟关键系统和递归决策分类账，将重复的速度/递归提示转化为有界的基准、吞吐量和决策分类账工作流；ECC 2.0 测试版，ecc2/ 中的 Rust 控制平面原型可在本地构建，并提供仪表盘、启动、会话、状态、停止、恢复和守护进程命令，目前为测试版，尚未正式发布；操作符状态快照，使用 `ecc status --markdown --write status.md` 可将本地状态存储转换为可移植的交接文件，涵盖就绪状态、活动会话、技能运行状况、安装状况、待处理的治理事件和来自 Linear/GitHub/交接的关联工作项。可使用 `ecc work - items upsert ...` 手动输入，`ecc work - items sync - github --repo owner/repo` 同步 PR/问题队列状态，`ecc status --exit - code` 在就绪状态需要关注时使自动化失败；生态系统强化，持续围绕核心插件推出 AgentShield、ECC 工具成本控制、计费门户工作和网站更新，避免功能分散。

v1.9.0（2026 年 3 月）：选择性安装架构，采用清单驱动的安装管道，通过 `install - plan.js` 和 `install - apply.js` 实现目标组件的安装，状态存储可跟踪已安装内容并支持增量更新；新增 6 个代理，包括 typescript - reviewer、pytorch - build - resolver、java - build - resolver、java - reviewer、kotlin - reviewer 和 kotlin - build - resolver，将语言覆盖范围扩展到 10 种；新增技能，如用于深度学习工作流的 pytorch - patterns、用于 API 参考研究的 documentation - lookup、用于现代 JS 工具链的 bun - runtime 和 nextjs - turbopack，以及 8 个操作领域技能和 mcp - server - patterns；会话和状态基础设施，采用 SQLite 状态存储和查询 CLI，提供会话适配器用于结构化记录，为自我改进技能奠定基础；编排系统改进，使框架审计评分具有确定性，强化编排状态和启动器兼容性，通过 5 层防护防止观察者循环；观察者可靠性提升，通过节流和尾部采样修复内存爆炸问题，修复沙箱访问问题，添加懒启动逻辑和重入防护；12 种语言生态系统，为 Java、PHP、Perl、Kotlin/Android/KMP、C++ 和 Rust 新增规则，与现有的 TypeScript、Python、Go 和通用规则相结合；社区贡献，包括韩语和中文翻译、biome 钩子优化、视频处理技能、操作技能、PowerShell 安装程序和 Antigravity IDE 支持；CI 强化，修复 19 个测试失败问题，强制检查目录计数，验证安装清单，确保完整测试套件通过。

v1.8.0（2026 年 3 月）：框架优先发布，明确将 ECC 定位为代理框架性能系统，而非仅仅是配置包；钩子可靠性改进，增加 SessionStart 根回退、停止阶段会话摘要，用基于脚本的钩子取代脆弱的内联单行代码；钩子运行时控制，通过 `ECC_HOOK_PROFILE = minimal|standard|strict` 和 `ECC_DISABLED_HOOKS = ...` 实现运行时控制，无需编辑钩子文件；新增框架命令，包括 `/harness - audit`、`/loop - start`、`/loop - status`、`/quality - gate` 和 `/model - route`；NanoClaw v2，支持模型路由、技能热加载、会话分支/搜索/导出/压缩/指标；跨框架一致性，在 Claude Code、Cursor、OpenCode 和 Codex 应用/CLI 之间实现行为一致；内部测试通过，经过钩子/运行时重构和兼容性更新后，997 个内部测试全部通过。

v1.7.0（2026 年 2 月）：Codex 应用和 CLI 支持，直接基于 `AGENTS.md` 支持 Codex，提供安装目标和 Codex 文档前端幻灯片技能；HTML 演示文稿构建器，零依赖的 HTML 演示文稿构建器，支持 PPTX 转换指导和严格的视口适配规则；新增 5 个通用业务/内容技能，包括文章写作、内容引擎、市场研究、投资者材料和投资者外联；更广泛的工具覆盖，加强对 Cursor、Codex 和 OpenCode 的支持，确保同一项目在所有主要框架上顺利运行；内部测试，扩展插件、钩子、技能和打包的验证和回归测试覆盖范围，992 个内部测试通过。

v1.6.0（2026 年 2 月）：Codex CLI 支持，新增 `/codex - setup` 命令，生成 `codex.md` 以实现与 OpenAI Codex CLI 的兼容性；新增 7 个技能，包括 search - first、swift - actor - persistence、swift - protocol - di - testing、regex - vs - llm - structured - text、content - hash - cache - pattern、cost - aware - llm - pipeline 和 skill - stocktake；AgentShield 集成，`/security - scan` 技能可直接从 Claude Code 运行 AgentShield，包含 1282 个测试和 102 条规则；GitHub 市场，ECC 工具 GitHub 应用在 `github.com/marketplace/ecc - tools` 上线，提供免费/专业/企业版；社区贡献，合并 30 多个社区 PR，来自 6 种语言的 30 位贡献者参与；内部测试，扩展代理、技能、命令、钩子和规则的验证套件，978 个内部测试通过。

v1.4.1（2026 年 2 月）：修复本能导入内容丢失问题：`parse_instinct_file()` 在 `/instinct - import` 过程中会无声地丢弃前置元数据（动作、证据、示例部分）之后的所有内容（问题编号 #148、#161）。

v1.4.0（2026 年 2 月）：交互式安装向导，新增 `configure - ecc` 技能，提供引导式设置，支持合并/覆盖检测；PM2 和多代理编排，新增 6 个命令（`/pm2`、`/multi - plan`、`/multi - execute`、`/multi - backend`、`/multi - frontend`、`/multi - workflow`），用于管理复杂的多服务工作流；多语言规则架构，将规则从扁平文件重构为 `common/`、`typescript/`、`python/` 和 `golang/` 目录，可按需安装所需语言；中文（zh - CN）翻译，完成所有代理、命令、技能和规则的完整翻译（80 多个文件）；GitHub 赞助支持，可通过 GitHub 赞助支持该项目；增强的 `CONTRIBUTING.md`，为每种贡献类型提供详细的 PR 模板。

v1.3.0（2026 年 2 月）：OpenCode 插件支持，通过 OpenCode 的插件系统（20 多种事件类型）实现 12 个代理、24 个命令和 16 个技能的完整集成，支持钩子；3 个原生自定义工具，包括 `run - tests`、`check - coverage` 和 `security - audit`；LLM 文档，提供 `llms.txt` 用于全面的 OpenCode 文档。

v1.2.0（2026 年 2 月）：Python/Django 支持，提供 Django 模式、安全、TDD 和验证技能；Java Spring Boot 技能，包括 Spring Boot 的模式、安全、TDD 和验证；会话管理，新增 `/sessions` 命令用于会话历史管理；持续学习 v2，基于本能的学习系统，支持置信度评分、导入/导出和进化。

快速开始

大多数 Claude Code 用户应选择以下一种安装路径：推荐默认路径，安装 Claude Code 插件，然后仅复制实际需要的规则文件夹。只有在需要更精细的控制、想完全避免插件路径或 Claude Code 构建在解析自托管市场条目时遇到问题时，才使用手动安装程序。不要叠加安装方法，常见的错误设置是先安装插件，然后再运行 `install.sh --profile full` 或 `npx ecc - install --profile full`。如果已经进行了多次安装且出现重复情况，可直接进行重置/卸载 ECC；低上下文/无钩子路径，如果觉得钩子过于全局化，或者只需要 ECC 的规则、代理、命令和核心工作流技能，可跳过插件，使用最小手动配置文件：`./install.sh --profile minimal --target claude`、`.\install.ps1 --profile minimal --target claude`、`npx ecc - install --profile minimal --target claude`，此配置文件有意排除了钩子运行时。如果需要正常的核心配置文件但需要禁用钩子，可使用 `./install.sh --profile core --without baseline:hooks --target claude`。如果之后需要运行时强制实施钩子，可使用 `./install.sh --target claude --modules hooks - runtime`；确定合适的组件，如果不确定要安装哪个 ECC 配置文件或组件，可从任何项目中使用打包的顾问工具：`npx ecc consult "security reviews" --target claude`，它将返回匹配的组件、相关配置文件和预览/安装命令。如果想在安装前检查确切的文件计划，可使用预览命令。对于生产 ML/MLOps 工作流，应选择选择性安装并按组件范围进行：`npx ecc consult "mlops training model deployment" --target claude`、`npx ecc install --profile minimal --target claude --with capability:machine - learning`。

安装步骤

步骤 1：安装插件（推荐）：注意：插件使用方便，但如果 Claude Code 构建在解析自托管市场条目时遇到问题，下面的开源安装程序仍然是最可靠的路径。可通过 `/plugin marketplace add https://github.com/affaan - m/ECC` 添加市场，再通过 `/plugin install ecc@ecc` 安装插件，也可直接添加到 `~/.claude/settings.json`。这将使你立即访问所有命令、代理、技能和钩子。需要注意的是，Claude Code 插件系统不支持通过插件自动分发规则，因此需要手动安装规则。

步骤 2：按需安装规则：重要提示：Claude Code 插件无法自动分发规则。如果已经通过 `/plugin install` 安装了 ECC，请勿再运行 `./install.sh --profile full`、`.\install.ps1 --profile full` 或 `npx ecc - install --profile full`。插件已经加载了 ECC 技能、命令和钩子，再次运行完整安装程序会将相同的内容复制到用户目录，导致技能和运行时行为重复。对于插件安装，只需手动复制所需的 `rules/` 目录到 `~/.claude/rules/ecc/` 下，从 `rules/common` 开始，再选择一种实际使用的语言或框架包。除非明确需要所有上下文，否则不要复制所有规则目录。只有在完全手动安装 ECC 而不使用插件路径时，才使用完整安装程序。

完全手动安装（备用）：仅在有意跳过插件路径时使用：`./install.sh --profile full`、`.\install.ps1 --profile full` 或 `npx ecc - install --profile full`。选择此路径后，请勿再运行 `/plugin install`。

重置/卸载 ECC：如果 ECC 出现重复、干扰或故障，不要在现有安装基础上重复安装。插件路径，从 Claude Code 中移除插件，然后删除手动复制到 `~/.claude/rules/ecc/` 下的特定规则文件夹；手动安装程序/CLI 路径，从仓库根目录开始，先预览移除操作：`node scripts/uninstall.js --dry - run`，然后移除 ECC 管理的文件：`node scripts/uninstall.js`。也可使用生命周期包装器。ECC 仅移除安装状态中记录的文件，不会删除未安装的无关文件。如果采用了多种安装方法，应按以下顺序清理：移除 Claude Code 插件安装，从仓库根目录运行 ECC 卸载命令以移除安装状态管理的文件，删除手动复制且不再需要的额外规则文件夹，最后使用单一路径重新安装。

步骤 3：开始使用：技能是主要的工作流界面。在 ECC 从 `commands/` 迁移过程中，现有的斜杠式命令名称仍然可用。插件安装，使用规范的命名空间形式 `/ecc:plan "Add user authentication"`；手动安装，使用较短的斜杠形式 `/plan "Add user authentication"`；检查可用命令，`/plugin list ecc@ecc`。现在你可以访问 61 个代理、246 项技能和 76 个旧命令垫片。

仪表盘 GUI

启动桌面仪表盘以直观探索 ECC 组件：`npm run dashboard` 或 `python3 ./ecc_dashboard.py`。其特点包括：标签式界面，包括代理、技能、命令、规则和设置；暗/亮主题切换；字体自定义（字体家族和大小）；标题栏和任务栏显示项目徽标；支持在所有组件中进行搜索和过滤。

多模型命令

注意：多模型命令（如 `/multi - plan`、`/multi - execute`、`/multi - backend`、`/multi - frontend` 和 `/multi - workflow`）不在上述基本插件/规则安装范围内。要使用这些命令，必须安装 `ccg - workflow` 运行时，并使用 `npx ccg - workflow` 进行初始化。该运行时提供这些命令所需的外部依赖，包括 `~/.claude/bin/codeagent - wrapper` 和 `~/.claude/.ccg/prompts/*`。如果没有 `ccg - workflow`，这些多模型命令将无法正常运行。

跨平台支持

该插件现在完全支持 Windows、macOS 和 Linux，同时与主要的 IDE（Cursor、Zed、OpenCode、Antigravity）和 CLI 框架紧密集成。所有钩子和脚本均使用 Node.js 重写，以实现最大兼容性。

包管理器检测

插件会自动检测你首选的包管理器（npm、pnpm、yarn 或 bun），优先级如下：环境变量：`CLAUDE_PACKAGE_MANAGER`；项目配置：`.claude/package - manager.json`；`package.json`：`packageManager` 字段；锁定文件：从 `package - lock.json`、`yarn.lock`、`pnpm - lock.yaml` 或 `bun.lockb` 中检测；全局配置：`~/.claude/package - manager.json`；备用：第一个可用的包管理器。设置首选包管理器的方法如下：通过环境变量，`export CLAUDE_PACKAGE_MANAGER = pnpm`；通过全局配置，`node scripts/setup - package - manager.js --global pnpm`；通过项目配置，`node scripts/setup - package - manager.js --project bun`；检测当前设置，`node scripts/setup - package - manager.js --detect`。也可在 Claude Code 中使用 `/setup - pm` 命令。

钩子运行时控制

使用运行时标志调整严格程度或临时禁用特定钩子：`export ECC_HOOK_PROFILE = standard`；`export ECC_DISABLED_HOOKS = "pre:bash:tmux - reminder,post:edit:typecheck"`；`export ECC_SESSION_START_MAX_CHARS = 4000`；`export ECC_SESSION_START_CONTEXT = off`；`export ECC_CONTEXT_MONITOR_COST_WARNINGS = off`。在 Windows PowerShell 中：`[Environment]::SetEnvironmentVariable('ECC_CONTEXT_MONITOR_COST_WARNINGS', 'off', 'User')`。

项目结构

展示了 ECC 项目的详细结构，包括 `.claude - plugin/`、`agents/`、`skills/`、`commands/`、`legacy - command - shims/`、`rules/`、`hooks/`、`scripts/`、`tests/`、`contexts/`、`examples/`、`mcp - configs/`、`ecc_dashboard.py`、`assets/`、`marketplace.json` 等目录及其中的文件。

生态系统工具

技能创建器：有两种方法可从你的仓库生成 Claude Code 技能：选项 A：本地分析（内置），使用 `/skill - create` 命令进行本地分析，无需外部服务，可分析当前仓库，也可同时为 continuous - learning - v2 生成本能，此方法会在本地分析你的 git 历史记录并生成 `SKILL.md` 文件；选项 B：GitHub 应用（高级），适用于高级功能（10k + 提交、自动 PR、团队共享），安装 GitHub 应用 `ecc.tools`，在任何问题下评论 `/skill - creator analyze` 或在推送到默认分支时自动触发。两种方法都会创建 `SKILL.md` 文件、本能集合和模式提取。

AgentShield — 安全审计器：在 2026 年 2 月的 Claude Code 黑客松（Cerebral Valley x Anthropic）中开发。包含 1282 个测试，覆盖率达 98%，有 102 条静态分析规则。可扫描你的 Claude Code 配置，检测漏洞、错误配置和注入风险。可进行快速扫描、自动修复安全问题、使用三个 Opus 4.6 代理进行深度分析、从头生成安全配置等操作。它会扫描的内容包括：`CLAUDE.md`、`settings.json`、MCP 配置、钩子、代理定义和技能，涵盖 5 个类别：秘密检测（14 种模式）、权限审计、钩子注入分析、MCP 服务器风险分析和代理配置审查。`--opus` 标志会运行三个 Claude Opus 4.6 代理，形成红队/蓝队/审计员管道，攻击者寻找攻击链，防御者评估保护措施，审计员将两者综合成优先级风险评估，采用对抗性推理而非简单的模式匹配。输出格式包括终端（颜色分级 A - F）、JSON（CI 管道）、Markdown 和 HTML。在发现关键问题时，退出代码为 2，可用于构建门控。可在 Claude Code 中使用 `/security - scan` 运行，或通过 GitHub Action 添加到 CI 中。

持续学习 v2：基于本能的学习系统可自动学习你的模式：`/instinct - status` 显示带有置信度的已学习本能；`/instinct - import` 从他人处导入本能；`/instinct - export` 导出你的本能以进行共享；`/evolve` 将相关本能聚类成技能。完整文档请参考 `skills/continuous - learning - v2/`。仅在明确需要旧版 v1 Stop - hook 学习技能流程时，才保留 `continuous - learning/`。

要求

Claude Code CLI 最低版本：v2.1.0 或更高。由于插件系统处理钩子的方式发生了变化，此插件需要 Claude Code CLI v2.1.0 及以上版本。检查版本：`claude --version`。

重要提示：钩子自动加载行为

对于贡献者：请勿在 `.claude - plugin/plugin.json` 中添加 "hooks" 字段，这是由回归测试强制执行的。Claude Code v2.1+ 会按惯例自动从任何已安装的插件中加载 `hooks/hooks.json`。在 `plugin.json` 中显式声明会导致重复检测错误：`Duplicate hooks file detected: ./hooks/hooks.json resolves to already - loaded file`。此问题在该仓库中曾导致多次修复/回滚循环（问题编号 #29、#52、#103），Claude Code 版本之间的行为变化导致了混淆，现在有回归测试防止此问题再次出现。

安装选项

选项 1：作为插件安装（推荐）：这是使用此仓库的最简单方法，将其作为 Claude Code 插件安装，可通过 `/plugin marketplace add https://github.com/affaan - m/ECC` 和 `/plugin install ecc@ecc` 操作，也可直接添加到 `~/.claude/settings.json`。这将使你立即访问所有命令、代理、技能和钩子。需要注意的是，Claude Code 插件系统不支持通过插件分发规则，因此需要手动安装规则，可选择用户级规则或项目级规则。

选项 2：手动安装：如果你希望手动控制安装内容，可克隆仓库，将代理复制到你的 Claude 配置中，复制规则目录（通用 + 特定语言），并选择你的技术栈。