claude-to-zcode

仓库创建 2026年7月6日最近提交 23 天前SkillHot 收录 22 天前

▸ 精选理由

覆盖协议差异（尤其 hooks），节省大量手工调试

这个 Skill 做什么

将 Claude Code 的工程化配置迁移并适配到 ZCode

把 Claude Code 项目的工程化配置迁到 ZCode 并适配协议差异，尤其会处理 hooks 的格式和 stdout/JSON 不兼容问题。适用于从 .claude 切到 .zcode、修复 hook 失败或从零搭建 ZCode 结构的场景。除了复制文件，还会诊断配置、生成 .zcode/config.json 并列出常见坑与修复步骤。

▸ 展开 SKILL.md 英文原文

当需要把 Claude Code 的工程化配置（skills/commands/hooks/agents/templates/config）迁移或适配到 ZCode 时使用此 Skill。适用于任何项目。触发场景： - 需要把 .claude/skills 迁移到 .zcode/skills（任何项目通用） - 需要把 Claude hooks 适配为 ZCode 的严格 JSON 协议 - 需要为 ZCode 配置 .zcode/config.json（hooks/mcp 等） - 现有 .zcode 配置不生效、hook 失败、需要诊断 - 从零搭建 ZCode 工程化目录结构 - 需要理解 Claude Code 与 ZCode 的协议差异触发词：claude转zcode、迁移到zcode、zcode迁移、适配zcode、.claude转.zcode、ZCode配置、hook协议不兼容、ZCode hooks失败、additionalContext、工具配置迁移、Claude Code to ZCode、zcode hooks不触发

开发编程迁移工具hooks适配工程化通用

Stars

Forks

仓库内 Skill

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/phoben/agent-skills/main/skills/claude-to-zcode/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/phoben/agent-skills/main/skills/claude-to-zcode/SKILL.md"

SKILL.MD 节选查看完整文件 ↗

# Claude Code → ZCode 工程化迁移指南

## 概述

把一个项目从 Claude Code 切到 ZCode（或同时支持两者），需要把 `.claude/` 下的工程化配置迁移到 `.zcode/`，并**适配协议差异**——不是简单复制目录就能跑通。

ZCode 与 Claude Code 的**资源类型相同**（都是 skills/commands/hooks/agents/templates 五种），但**协议不同**：

- skills/commands/agents/templates：格式基本一致，直接复制可用
- **hooks：协议差异巨大**，是最容易踩坑的地方（Claude 的纯文本 stdout 在 ZCode 会全部失败）

本技能覆盖**全部 5 种资源**的迁移规则、配置文件转换、标准流程、诊断验证和 12 个常见陷阱。

### 与官方技能的关系

| 官方技能 | 关系 | 用途 |
|---------|------|------|
| `zcode-guide:zcode-configuration-guide` | 互补 | 提供 ZCode 配置地图（资源位置、合并规则、优先级） |
| `zcode-guide:diagnosing-hooks` | 互补 | 提供深度 hook 诊断流程（本技能引用其 12 个陷阱） |
| `skill-creator` | 互补 | 教你**创建**新技能；本技能教**迁移**已有配置 |

### 本技能的边界

- ✅ **管**：工具配置迁移（`.claude/*`

via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有