Claude Code 技能迁移到 Craft Agents：一句话完成 Skills 与 MCP 搬迁的完整指南
【免费下载链接】craft-agents-oss项目地址: https://gitcode.com/GitHub_Trending/cr/craft-agents-oss
Craft Agents是一个开源的桌面 AI Agent 工作台，支持多会话管理、MCP 数据源连接与 Skills 技能扩展。如果你正在使用 Claude Code，并且积累了不少自定义 Skills（技能）和 MCP 服务器配置，那么好消息是：你只需要告诉 Agent 一句话，它就能自动帮你把 Claude Code 的 Skills 与 MCP 配置整体搬迁过来——无需手动拷贝目录、无需逐个改配置。
本文面向新手，带你从零开始了解这项"一句话迁移"能力是如何工作的。
快速安装 Craft Agents
迁移之前，先装好 Craft Agents。它支持 macOS、Linux 与 Windows：
- macOS / Linux：执行一行
curl -fsSL https://agents.craft.do/install-app.sh | bash即可自动下载安装 - Windows：在 PowerShell 中运行
irm https://agents.craft.do/install-app.ps1 | iex
如果你更喜欢从源码构建，可以克隆仓库后使用 Bun 工具链：
git clone https://gitcode.com/GitHub_Trending/cr/craft-agents-oss cd craft-agents-oss bun install bun run electron:start安装脚本的完整实现可以参考 install-app.sh 与 install-server.sh。
一句话迁移：Skills 搬迁只需开口
Craft Agents 的核心理念是Agent-Native（智能体原生）：你不需要理解配置文件在哪、格式是什么，直接用自然语言描述需求即可。
迁移 Claude Code Skills 的操作步骤：
- 启动 Craft Agents，选择你的 API 连接（Anthropic API Key 或 Claude Max 等）
- 创建一个 Workspace（工作区），作为会话与技能的容器
- 在对话中直接输入，例如：
“帮我把 Claude Code 里的所有 Skills 导入到当前工作区”
Agent 会自动定位 Claude Code 的技能目录，读取每一个 Skill 的说明文件，将它们转换并写入 Craft Agents 的工作区，最后告诉你导入了哪些技能、哪些需要人工确认。
迁移 MCP 配置的操作步骤：
- 打开你现有的 MCP 配置 JSON（Claude Code 或 VS Code 里的那份）
- 粘贴到对话中，说一句：“这是我的 MCP 配置，帮我接入”
- Agent 会解析 JSON 中的
mcpServers，逐个配置为 Craft Agents 的Sources（数据源），包括远程 HTTP 服务和本地 stdio 进程
整个过程不需要重启应用——新增的技能与数据源即时生效，甚至可以在对话中途直接用@符号唤起它们。
迁移背后：Skills 是怎么存储的？
理解存储结构，能让你对迁移结果更放心。Craft Agents 中的每个技能都是一个独立目录，核心是一个带 YAML 前置元信息的 Markdown 文件（SKILL.md）：
- name / description：技能名称与描述（必填）
- globs：触发该技能的文件匹配模式（可选）
- alwaysAllow：技能激活时自动允许的工具（可选）
- requiredSources：技能激活时自动启用的数据源（可选）
技能有三个作用层级，这也是 Claude Code 技能能"无缝落地"的原因：
| 层级 | 位置 | 说明 |
|---|---|---|
| 全局 | ~/.agents/skills/ | 所有工作区可用 |
| 工作区 | {workspace}/skills/ | 当前工作区专属 |
| 项目 | .agents/skills/ | 跟随项目目录 |
技能的解析与加载逻辑位于 skills/storage.ts，元数据定义在 skills/types.ts。由于 Claude Code 与 Craft Agents 的技能格式高度兼容，Agent 迁移时基本是"平移"而非"改写"，你的技能描述、图标、附加文件都会原样保留。
迁移之后：MCP 与 Sources 体系
搬迁过来的 MCP 服务器会以Sources（数据源）的形式出现在工作区中。Craft Agents 的数据源远不止 MCP，还包括：
| 类型 | 示例 |
|---|---|
| MCP 服务器 | Craft、Linear、GitHub、Notion、自定义服务 |
| REST API | Google（Gmail、Calendar、Drive）、Slack、Microsoft |
| 本地文件 | 文件系统、Obsidian 库、Git 仓库 |
本地 stdio 类型的 MCP 服务器完全受支持——指向一个 npx 命令、Python 脚本或任意本地二进制即可运行。MCP 连接池的实现见 mcp/mcp-pool.ts，数据源构建逻辑在 sources/server-builder.ts。
迁移完成后，你可以继续用一句话扩展能力，比如：
“把 Linear 添加为数据源” —— Agent 会自己找到公开 API 与文档，配置凭证，全程无配置文件、无安装向导。
常见问题（FAQ）
Q1：迁移后原来的 Claude Code 配置还在吗？在。迁移是"复制"不是"移动"，两个工具可以同时使用同一套技能。
Q2：导入的技能需要重启应用才能生效吗？不需要。Craft Agents 中一切变更即时生效，对话中途也能用@引用新技能或新数据源。
Q3：MCP 配置 JSON 格式不标准怎么办？直接把内容贴给 Agent。它能处理 OpenAPI 规范、端点 URL 甚至文档截图，并引导你完成剩余配置。
Q4：权限方面要注意什么？Craft Agents 提供三级权限模式：safe（只读探索）、ask（编辑前询问，默认）、allow-all（自动批准），在聊天界面按SHIFT+TAB即可切换。迁移涉及文件写入时，默认模式会请求你的确认。
小结
| 你过去的做法 | 现在在 Craft Agents 里 |
|---|---|
| 手动复制技能目录、改路径 | 一句话："帮我导入 Claude Code 的 Skills" |
| 手工编辑 MCP 配置文件 | 粘贴 JSON："这是我的 MCP 配置，帮我接入" |
| 重启应用验证 | 即时生效，@即可唤起 |
从 Claude Code 迁移到 Craft Agents，本质上就是开口说一句话的事。技能的解析、MCP 的解析、凭证的配置，全部交给 Agent 完成——这正是 Agent-Native 软件的初衷：你描述目标，它搞定路径。
想进一步了解 CLI 用法，可以阅读 docs/cli.md。
【免费下载链接】craft-agents-oss项目地址: https://gitcode.com/GitHub_Trending/cr/craft-agents-oss
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
