code buddy配置管理 — Code Buddy 配置管理

CodeBuddy 配置管理器 触发条件 当用户输入包含以下意图时触发本 Skill： 配置/安装/更新/检测某个 CodeBuddy 组件 需要安装或管理 MCP/Skill/Plugin/Model/CLI 工具 需要验证 CodeBuddy 配置状态

输入解析 输入参数 用户需提供以下信息（通过自然语言解析）： 参数 类型 必填 说明 默认行为 config_type string 是 配置类型：model / mcp / skill / cli / plugin / other - config_name string 是 要配置的内容名称 - config_url string 否 配置获取网址 若未提供，自动搜索互联网获取最新配置信息 config_scope string 否 global (全局) 或 project (项目) 默认为 project

输入解析示例 用户: "帮我安装一个名为 python-tools 的 MCP Server，从 https://example.com/mcp.json 获取配置，全局安装" → 解析结果: { type: "mcp", name: "python-tools", url: "https://example.com/mcp.json", scope: "global" } 用户: "检测一下有没有安装 browser-use 这个 Skill" → 解析结果: { type: "skill", name: "browser-use", url: null, scope: "project" } 用户: "安装 playwright 这个 CLI 工具" → 解析结果: { type: "cli", name: "playwright", url: null, scope: "project" }

工作流 阶段 1: 状态检测 调用: bash scripts/check_status.sh {config_type} {config_name} {config_scope} 集成提示: 如需跨目录搜索（如搜索全局和项目的多个技能目录），可使用 [subagent:code-explorer] 辅助检测。 检测目标: 配置类型 检测路径 状态判定 MCP ~/.codebuddy/mcp.json 或 {project}/.codebuddy/mcp.json mcpServers.{name} 配置块存在 Skill ~/.codebuddy/skills-marketplace/skills/{name}/ 或 {project}/.codebuddy/skills/{name}/ 目录存在且包含 SKILL.md Plugin ~/.codebuddy/settings.json → enabledPlugins 键存在且值为 true Model IDE 设置 / 环境变量 存在 API Key 或端点配置 CLI command -v {name} PATH 中存在可执行文件

输出格式: { "exists": true/false, "status": "enabled" | "disabled" | "error" | "not_found", "version": "当前版本号或 null", "needs_update": true/false, "details": "详细状态描述" }

判定逻辑: exists=true 且 status=normal → 返回"已存在无需操作"，终止流程 exists=true 且 needs_update=true → 进入阶段 2（更新模式） exists=false → 进入阶段 2（安装模式）

阶段 2: 安装/更新 2a: 获取配置信息 当 config_type 为 skill / other 或需要从外部获取配置信息时，按以下优先级获取： 优先级 1: 直接使用 config_url 若用户已提供 config_url： 使用 curl -sL 或 wget -qO- 下载 对于 MCP 类型，尝试解析为 JSON 并写入 mcp.json 对于 Skill 类型，尝试下载为 zip 包或 SKILL.md 优先级 2: 使用 [skill:agent-browser] 自动搜索 当未提供 config_url 时，调用 [skill:agent-browser] 进行互联网搜索：

• 调用 [skill:agent-browser] 搜索关键词:
• "CodeBuddy {config_name} {config_type} 安装"
• "{config_name} 文档 配置"
• 目标页面类型:
• 官方 GitHub 仓库: 查找 README、配置文件示例
• npm 包页: 查找安装命令、依赖
• 官方文档: 查找配置指南
• 需要提取的信息:
• 安装命令和方式
• 配置文件模板（JSON/YAML）
• 依赖要求（Python 包、npm 包等）
• 版本信息和更新日志
• 输出整理为结构化数据:
• install_command: string
• config_template: JSON object or null
• dependencies: string[]
• version: string

优先级 3: 使用 [skill:playwright-cli] 精细化提取 当 [skill:agent-browser] 搜索结果不精确或需要与页面交互（如下载需要展开的文档页面）时：

• 调用 [skill:playwright-cli] 打开目标页面
• 交互操作（如点击展开按钮、滚动加载等）
• 提取精确的配置信息
• 与 agent-browser 结果合并

优先级 4: 综合推理 当上述搜索均无法获取足够信息时：

• 基于 {config_name} 和 {config_type} 做合理推断
• 使用 [subagent:code-explorer] 在全局已安装配置中查找相似案例
• 参考 references/config-structures.md 中的格式模板
• 提供最佳猜测配置并标注"需人工确认"

2b: 按类型执行安装/更新 MCP Server → 脚本 + agent-browser 执行 bash scripts/install_mcp.sh {name} {scope} {command} [args...] agent-browser 集成: 当需要查找 MCP Server 的启动命令时： [skill:agent-browser] 搜索 "{name} mcp server github install" 从搜索结果提取 command 和 args 调用 install_mcp.sh 安装

示例: 搜索 "python-tools mcp server" → 发现 python-tools 需要 "python -m mcp_server" → install_mcp.sh python-tools global python -m mcp_server

Skill → 脚本 + find-skills + skill-creator 第一步: 搜索 Marketplace ← [skill:find-skills] 调用方式：

• 调用 [skill:find-skills] 搜索 {config_name}
• 从搜索结果获取:
• 精确匹配的 Skill 名称
• 模糊匹配的推荐列表（名称、描述、版本）
• 安装方式（一键安装或手动）
• 处理搜索结果:
• 找到精确匹配 → 确认是否已存在，不存在则安装
• 找到模糊匹配 → 按相似度排序，选择最佳匹配
• 未找到 → 进入第二步（自定义创建）

搜索后处理示例： 搜索 "browser-use" → 找到精确匹配 Skill "browser-use" → 执行 install_skill.sh browser-use project 搜索 "custom-slack" → 未在 marketplace 找到 → 进入第二步：使用 skill-creator 创建

第二步: 自定义创建 ← [skill:skill-creator] 当 marketplace 中未找到时：

• 调用 [skill:skill-creator] 创建自定义 Skill:
• 输入: {config_name} 名称、描述
• 输出: 完整的 Skill 目录结构
• skill-creator 会生成:
• SKILL.md 文件（含 YAML frontmatter、工作流模板）
• scripts/ 目录（如需要）
• references/ 目录（如需要）
• 创建完成后:
• 检查 SKILL.md 的 YAML frontmatter 是否完整
• 确认版本号是否正确
• 调用 check_status.sh 验证

Plugin → 脚本 + agent-browser 执行 bash scripts/install_plugin.sh {name} agent-browser 集成: 当需要查找插件对应的 marketplace 源时：

• [skill:agent-browser] 搜索 "CodeBuddy {name} plugin"
• 确定 marketplace 标识（如 codebuddy-plugins-official）
• 执行 install_plugin.sh {name} --marketplace {marketplace}

Model → 引导 + agent-browser

• [skill:agent-browser] 搜索 "{name} API 配置 教程"
• 提取 API Key 获取方式、Endpoint URL
• 引导用户在 IDE 设置中配置
• 提示用户设置环境变量（如需要）

CLI 工具 → 脚本 执行 bash scripts/install_cli.sh {name} 脚本自动检测 brew/npm/pip3/cargo/go 中可用的包管理器。

其他类型 (other) → agent-browser 优先 1. 调用 [skill:agent-browser] 搜索 "{name} 安装 {config_type}"

• 根据搜索结果确定具体安装方式
• 若搜索结果不足，使用 [skill:playwright-cli] 精细化搜索
• 按获取到的信息执行自定义安装流程

阶段 3: 验证配置 调用: bash scripts/verify_config.sh {config_type} {config_name} {config_scope} {operation} 流程: 再次调用阶段 1 的检测逻辑 比对预期状态与实际结果 输出结构化的验证报告