zai-org / zai-org/feedback

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

Open
#156 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority: P2 status: 待评估 type: 功能建议
Dominant language
No language data
Stars
22
Forks
1
PR merge metrics
No merged PRs in 30d

Description

提交前确认 · 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

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with CONTRIBUTING.md and the proposed /import:cc flow. Review the listed Claude Code and ZCode paths, including .claude-plugin/plugin.json, .claude/settings.json, rules/*.md, and the ~/.zcode locations. Done would mean a defined MVP scope and an implemented import command that performs the stated conversions and reports its results.

Written by the indexing model from the issue text.

Assessment

Domain
cli, tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
28/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.