Skip to content

[Feature Request] 开发 cc-bridge 插件:Claude Code 生态一键导入桥 #156

Description

@jinhongxun

提交前确认 · Pre-submission checklist

  • 我已搜索过现有 issue,确认这不是重复提议 / I searched existing issues and confirmed this isn't a duplicate.
  • 我已阅读 CONTRIBUTING.md / I've read CONTRIBUTING.md.

问题类别 · Category

工具调用 / MCP · Tool use / MCP

涉及的 Agent 框架 · Agent framework

Claude Code

使用场景 · Use case

我是从 Claude Code 迁移到 ZCode 的开发者,手上有大量自建/收藏的 CC 插件、skills、commands、rules、hooks 配置。

ZCode 当前已做了不错的兼容性工作:

  • 目录兼容:.agents/.claude-plugin/.zcode-plugin/
  • MCP 兼容:.agents/mcp.jsonmcpServers
  • 指令兼容:~/.claude/CLAUDE.md 可迁移到 ~/.zcode/AGENTS.md

但实际迁移仍需手动处理以下差异,门槛过高:

项目 Claude Code ZCode 痛点
插件清单 .claude-plugin/plugin.json .zcode-plugin/plugin.json 需手动改目录名
Hook 字段 .claude/settings.json ~/.zcode/cli/config.json 字段名、嵌套结构不同
Hook 启用 默认启用 hooks.enabled: true 容易漏配
Rules 机制 ~/.claude/rules/*.md 自动加载 无独立 rules 概念 用户需手动聚合
Skills/Commands 路径 ~/.claude/skills/ ~/.zcode/skills/~/.agents/skills/ 路径不确定

结果:90% 的 CC 用户想迁移,但卡在配置转换环节,ZCode 错失承接 CC 生态外溢的最佳窗口。

建议方案 · Proposal

核心功能:cc-bridge 插件 + /import:cc 命令

# 用户使用示例
/import:cc https://github.com/username/some-cc-plugin

# cc-bridge 自动执行:
# 1. 克隆仓库
# 2. 转换 .claude-plugin/ → .zcode-plugin/
# 3. 翻译 hook 字段,自动加 hooks.enabled: true
# 4. 聚合 rules/*.md → AGENTS.md
# 5. 注册 skills/commands 到 ~/.zcode/
# 6. 输出转换报告

配套功能

  1. /import:cc-config:一键迁移整个 ~/.claude/ 目录到 ~/.zcode/
  2. /doctor:体检当前 CC 资源兼容状态(哪些能用、哪些 shadowed、哪些 hook 没触发)
  3. 原生 ~/.zcode/rules/ 支持:对标 CC 的 rules 自动加载机制
  4. .agents/ 格式规范化:扩展为跨 AI 工具的通用配置格式,起草公开规范

MVP 可先做最小版

单个 slash command(~50 行脚本),验证有效后再扩展为完整插件。

预期价值 · Expected value

  • 大幅降低 CC 用户迁移成本(预计提升 10 倍)
  • 建立 ZCode 作为"生态中立层"的定位,与 Cursor/Codex 形成差异化
  • 承接 CC 生态外溢用户——这是当前最大的用户增长机会
  • 提升插件市场活跃度——大量 CC 插件可秒变 ZCode 插件

参考案例:VS Code 的 Settings Sync、JetBrains 的 IDEA 互相导入配置。

如需详细 PRD 或 MVP 实现方案,可联系我进一步讨论。

你认为的优先级 · Your perceived priority

高 · High

你使用的 ZCode 版本 / 环境 · ZCode version / environment

No response

补充材料 · Additional context

No response

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions