ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

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

ECC for CodeBuddy:通过 Target Adapter 在 CodeBuddy 中安装与管理 ECC 工作流 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/ECCECCEverything 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-run2.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项目结构小节中两个关键条目.codebuddy/ecc-install-state.json安装状态跟踪适配器把安装状态文件固定在安装根下卸载与修复均以此为准仅删除 ECC 管理的文件这一保证正是来源于此规则的扁平化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 codebuddyDoctor 检查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 的源码可以确认其行为细节仓库根定位脚本通过find_repo_root见 install.sh L22-L31向上查找VERSION标记文件与commands/、agents/目录来确认 ECC 仓库根找不到则报错退出目标解析传入~或$HOME时安装到~/.codebuddy/全局安装默认安装到当前目录下的.codebuddy/如果当前目录名本身就是.codebuddy则直接以该目录为目标清单管理所有复制操作写入.codebuddy/.ecc-manifest清单文件逐条登记commands/xxx.md、skills/skill/path、rules/path等相对路径卸载脚本依据该清单回收文件计数摘要安装结束时打印命令、智能体、技能、规则四类的安装数量。.codebuddy/install.js 是同一逻辑的跨平台 Node 版本支持 Windows/macOS/Linux其核心函数copyManagedFile见 install.js L81-L108体现了幂等复制策略目标文件已存在且已登记在清单中时直接跳过不覆盖用户可能修改过的文件只补登记清单新文件则复制后追加清单条目。这与 README 中安装状态跟踪安全卸载仅删除 ECC 管理的文件的描述互为印证。六、Target Adapter 安装的优势README 归纳的统一 Target Adapter 安装相对旧版脚本的优势可以逐条对应到仓库实现优势说明源码依据安装状态跟踪安全卸载仅删除 ECC 管理的文件适配器将状态文件固定为.codebuddy/ecc-install-state.jsoncodebuddy-project.jsDoctor 检查验证安装健康状态并检测偏移scripts/doctor.js修复自动修复损坏的安装scripts/repair.js选择性安装通过配置文件选择特定模块manifests/install-profiles.json 中的 profile 与--modules跨平台基于 Node.js支持 Windows/macOS/Linuxscripts/install-apply.js 为纯 Node 实现七、推荐的工作流README 给出的日常开发工作流建议按计划 → 测试 → 实现 → 审查 → 修复的节奏使用斜杠命令从计划开始使用/plan命令分解复杂功能对应 commands/plan.md先写测试在实现之前调用/tdd命令审查您的代码编写代码后使用/code-review对应 commands/code-review.md检查安全性对于身份验证、API 端点或敏感数据处理再次使用/code-review修复构建错误如果有构建错误使用/build-fix。从源码结构看当前仓库commands/目录中可直接确认存在plan.md、code-review.md等命令定义/tdd、/build-fix是否可用取决于你所安装版本实际携带的命令集建议以安装后 CodeBuddy 聊天/菜单中实际列出的命令为准。八、上手清单在 ECC 仓库根目录执行node scripts/install-apply.js --target codebuddy --profile developer --dry-run先预览安装计划确认无误后去掉--dry-run正式安装产出.codebuddy/{commands,agents,skills,rules}与ecc-install-state.json用node scripts/doctor.js --target codebuddy验证安装健康状态在 CodeBuddy 中打开项目输入/查看可用命令按计划 → 测试 → 实现 → 审查工作流开始使用后续升级或清理时优先使用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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表