企业官网建设流程全解析

ECC for CodeBuddy：通过 Target Adapter 在 CodeBuddy 中安装与管理 ECC 工作流

【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC

ECC（Everything Claude Code）不仅服务于 Claude Code，还可以通过统一的 Target Adapter 安装系统将其命令、智能体、技能与规则体系完整迁移到 CodeBuddy IDE。本文基于 .codebuddy/README.zh-CN.md 展开，完整覆盖统一安装系统的安装命令、参数与生命周期管理方式，并结合 codebuddy-project 适配器、旧版安装脚本 等源码，解释安装状态跟踪、规则扁平化与安全卸载的底层实现，帮助你在任意 CodeBuddy 项目中落地一套可检查、可修复、可安全移除的 ECC 工程化工作流。

一、ECC for CodeBuddy 是什么

ECC 为一套 Agent Harness 性能优化系统，其内容以 Markdown 形式组织为四类可复用资产：命令（commands）、智能体（agents）、技能（skills）与规则（rules）。.codebuddy/目录是 ECC 面向 CodeBuddy IDE 的适配入口，正如 README 所述："为 CodeBuddy IDE 带来 Everything Claude Code (ECC) 工作流……可以通过统一的 Target Adapter 架构安装到任何 CodeBuddy 项目中。"

安装完成后，四类资产全部落到目标项目的.codebuddy/目录中：

• 命令（commands）：通过 CodeBuddy 聊天中的/菜单调用的按需工作流，直接复用自项目根目录的commands/文件夹；
• 智能体（agents）：具有特定工具配置的专门 AI 助手，直接复用自根目录agents/文件夹；
• 技能（skills）：同样通过聊天/菜单调用的按需工作流，复用自skills/文件夹；
• 规则（rules）：提供始终适用的规则和上下文，塑造智能体处理代码的方式。规则会被扁平化为命名空间文件（如common-coding-style.md）以兼容 CodeBuddy。

其中"规则扁平化"不是文档层面的口头描述，而是有明确源码支撑的：codebuddy-project 适配器 在处理模块路径时，会对rules源路径调用createFlatRuleOperations，将rules/下的目录结构展开为<命名空间>-<文件名>形式的扁平文件写入.codebuddy/rules/；其余路径则走通用的createScaffoldOperation复制逻辑。

二、快速开始：统一安装系统（推荐）

README 推荐的方式是使用统一安装系统scripts/install-apply.js，获得完整生命周期管理。三条核心命令：

# 使用默认配置安装 node scripts/install-apply.js --target codebuddy --profile developer # 使用完整配置安装（所有模块） node scripts/install-apply.js --target codebuddy --profile full # 预览模式查看变更 node scripts/install-apply.js --target codebuddy --profile full --dry-run

2.1 参数说明

从 install-apply.js 的帮助文本 可以确认codebuddy是受支持的 target 之一，其定义为：

codebuddy - Install commands, agents, skills, and flattened rules into ./.codebuddy/

即 codebuddy 是**项目级（project kind）**安装，安装根目录为当前项目的.codebuddy/，与全局安装的~/.claude/等 target 不同。常用选项还包括：

• --profile <name>：解析并安装 manifests/install-profiles.json 中定义的安装配置（profile）；
• --modules <id,id,...>：按显式模块 ID 安装，用于比 profile 更细粒度的选择；
• --with <component>/--without <component>：增删用户可见的安装组件；
• --dry-run：只打印安装计划，不复制任何文件；
• --json：输出机器可读的计划/结果 JSON。

2.2 developer 与 full 两个 profile 的差异

manifests/install-profiles.json 定义了minimal、opencode、core、developer、security、research、full等配置。README 示例中的两个配置对应关系为：

• developer（默认工程画像）：包含rules-core、agents-core、commands-core、hooks-runtime、platform-configs、workflow-quality、framework-language、database、orchestration九个模块，官方描述为"面向跨应用代码库工作的大多数 ECC 用户的默认工程画像"；
• full（完整安装）：在 developer 基础上再叠加skill-unified-memory、security、research-apis、business-content、operator-workflows、optimization-workflows、media-generation、swift-apple、machine-learning等全部已分类模块，共 25 个模块。

如果你的项目不需要预测市场技能、媒体生成、供应链等领域模块，用developer即可获得覆盖命令、智能体、规则与框架/数据库/编排规则的均衡配置。

三、CodeBuddy 目标适配器的安装结构

从源码结构看，codebuddytarget 对应 scripts/lib/install-targets/codebuddy-project.js 中注册的适配器，其关键配置为：

module.exports = createInstallTargetAdapter({ id: 'codebuddy-project', target: 'codebuddy', kind: 'project', // 项目级安装 rootSegments: ['.codebuddy'], // 安装根：./.codebuddy/ installStatePathSegments: ['ecc-install-state.json'], // 状态文件 nativeRootRelativePath: '.codebuddy', // ... });

这段配置解释了 README"项目结构"小节中两个关键条目：

1. .codebuddy/ecc-install-state.json（安装状态跟踪）：适配器把安装状态文件固定在安装根下，卸载与修复均以此为准，"仅删除 ECC 管理的文件"这一保证正是来源于此；
2. 规则的扁平化：planOperations中对rules路径的特殊处理（调用createFlatRuleOperations），使rules/common/、rules/typescript/等嵌套规则变为 CodeBuddy 可直接识别的common-coding-style.md之类命名空间文件。

安装完成后.codebuddy/的目录结构与 README 描述一致：

.codebuddy/ ├── commands/ # 命令文件（复用自项目根目录） ├── agents/ # 智能体文件（复用自项目根目录） ├── skills/ # 技能文件（复用自 skills/） ├── rules/ # 规则文件（从 rules/ 扁平化） ├── ecc-install-state.json # 安装状态跟踪 ├── install.sh # 旧版安装脚本 ├── uninstall.sh # 旧版卸载脚本 └── README.zh-CN.md # 此文件

四类资产的来源目录分别是仓库根下的 commands/、agents/、skills/、rules/。其中commands/内可直接看到 plan 命令、code-review 命令 等工作流定义，它们会被原样复用为 CodeBuddy 中的/plan、/code-review斜杠命令。

四、生命周期管理命令

README 给出的三条管理命令全部通过统一安装系统执行：

# 检查安装健康状态 node scripts/doctor.js --target codebuddy # 修复安装 node scripts/repair.js --target codebuddy # 清洁卸载（通过 install-state 跟踪） node scripts/uninstall.js --target codebuddy

• Doctor 检查（scripts/doctor.js）：验证安装健康状态并检测偏移，即比对目标目录现状与安装状态记录是否一致；
• 修复（scripts/repair.js）：自动修复损坏的安装，把缺失或被改动的 ECC 管理文件恢复到预期状态；
• 清洁卸载（scripts/uninstall.js）：仅依据 install-state 记录删除 ECC 安装的文件，不影响你在.codebuddy/中的自有内容。

这三条命令与.codebuddy/自带的 Node 版卸载脚本 uninstall.js 在理念上是一致的：卸载只移除"清单中登记过的文件"。例如 uninstall.js 的 isValidManifestEntry 函数 会显式拒绝空条目、绝对路径、~开头路径以及任何包含/../、..\\的条目，防止清单异常时误删.codebuddy/之外的文件——这是一个值得参考的安全设计细节。

五、旧版 Shell 脚本安装（快速设置）

除了统一安装系统，README 还保留了旧版 Shell 脚本路径，适合只需快速把 ECC 复制进项目的场景：

# 安装到当前项目 cd /path/to/your/project .codebuddy/install.sh # 全局安装 .codebuddy/install.sh ~

从 .codebuddy/install.sh 的源码可以确认其行为细节：

1. 仓库根定位：脚本通过find_repo_root（见 install.sh L22-L31）向上查找VERSION标记文件与commands/、agents/目录来确认 ECC 仓库根，找不到则报错退出；
2. 目标解析：传入~（或$HOME）时安装到~/.codebuddy/（全局安装）；默认安装到当前目录下的.codebuddy/；如果当前目录名本身就是.codebuddy，则直接以该目录为目标；
3. 清单管理：所有复制操作写入.codebuddy/.ecc-manifest清单文件，逐条登记commands/xxx.md、skills/<skill>/<path>、rules/<path>等相对路径，卸载脚本依据该清单回收文件；
4. 计数摘要：安装结束时打印命令、智能体、技能、规则四类的安装数量。

.codebuddy/install.js 是同一逻辑的跨平台 Node 版本（支持 Windows/macOS/Linux），其核心函数copyManagedFile（见 install.js L81-L108）体现了"幂等复制"策略：目标文件已存在且已登记在清单中时直接跳过，不覆盖用户可能修改过的文件，只补登记清单；新文件则复制后追加清单条目。这与 README 中"安装状态跟踪：安全卸载，仅删除 ECC 管理的文件"的描述互为印证。

六、Target Adapter 安装的优势

README 归纳的统一 Target Adapter 安装相对旧版脚本的优势，可以逐条对应到仓库实现：

七、推荐的工作流

README 给出的日常开发工作流建议按"计划 → 测试 → 实现 → 审查 → 修复"的节奏使用斜杠命令：

1. 从计划开始：使用/plan命令分解复杂功能（对应 commands/plan.md）；
2. 先写测试：在实现之前调用/tdd命令；
3. 审查您的代码：编写代码后使用/code-review（对应 commands/code-review.md）；
4. 检查安全性：对于身份验证、API 端点或敏感数据处理，再次使用/code-review；
5. 修复构建错误：如果有构建错误，使用/build-fix。

从源码结构看，当前仓库commands/目录中可直接确认存在plan.md、code-review.md等命令定义；/tdd、/build-fix是否可用取决于你所安装版本实际携带的命令集，建议以安装后 CodeBuddy 聊天/菜单中实际列出的命令为准。

八、上手清单

1. 在 ECC 仓库根目录执行node scripts/install-apply.js --target codebuddy --profile developer --dry-run，先预览安装计划；
2. 确认无误后去掉--dry-run正式安装，产出.codebuddy/{commands,agents,skills,rules}与ecc-install-state.json；
3. 用node scripts/doctor.js --target codebuddy验证安装健康状态；
4. 在 CodeBuddy 中打开项目，输入/查看可用命令，按"计划 → 测试 → 实现 → 审查"工作流开始使用；
5. 后续升级或清理时，优先使用repair/uninstall而非手工删除，保证只回收 ECC 管理的文件。

适用前提与限制：以上命令均需在 ECC 仓库根目录、以 Node.js 运行时执行；codebuddy是项目级 target，安装落在目标项目的./.codebuddy/下，而非用户主目录。如需全局式布局，可参考 README 中旧版脚本的~参数用法。

【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC