从 Linear 迁移到 Weft
把 Linear 的 issue 搬到 Weft——进来时是键盘流，出去时是 AI 流。
Linear 的 issue 能干净地对应到 Weft 的任务：cycle 变成冲刺，status 变成列。整个迁移基本上就是几分钟的导出，加上给 Claude 的一条提示词——因为 Weft 的 MCP 服务器本来就是导入的通道。
1. 从 Linear 导出
打开 Linear ↗- 1打开 Linear → Settings → Workspace → Export。
- 2选择要迁移的团队，格式选 “CSV”。
- 3Linear 会在几分钟内把下载链接发到你邮箱——下载这个 CSV。
- 4用表格软件或文本编辑器打开 CSV，确认里面的 issue 就是你想要的。
2. 对照概念
Linear 和 Weft 给同样的东西起了不同的名字。这里是它们的对应关系。
| Linear | Weft |
|---|---|
| Status: Backlog | 列：Backlog |
| Status: Todo | 列：Todo |
| Status: In Progress / In Review | 列：Doing |
| Status: Done / Canceled | 列：Done |
| Priority: No priority / Low / Medium / High / Urgent | 优先级：none / low / medium / high / urgent |
| Cycle | 冲刺 为每个进行中或最近的 cycle 建一个冲刺，然后再把任务挂上去。 |
| Labels | 写在任务描述开头 Weft 还没有标签——把它们以 “[label]” 的形式放在描述最前面。 |
| Estimate（点数） | estimateMinutes 挑一个符合你团队习惯的换算（例如 1 点 = 60 分钟）。 |
| Assignee | 负责人（工作区成员） CSV 导入按姓名匹配负责人；匹配不上的名字保持未分配。 |
3. 用你的 AI 导入
Weft 不需要单独的导入脚本 — 因为 MCP 服务器本身就是导入通道。把导出内容贴进 Claude、Cursor、Codex 或 ChatGPT（先照其中一份设置指南接好 Weft），然后让 AI 替你创建任务。它用的就是真正的 create_task、create_sprint 和 move_task 工具。
这是从 Linear 导出的 CSV。请把每一行建成一个 Weft 任务。把 status 列对应到 Weft 的列（Backlog / Todo / Doing / Done），把 priority 对应到 Weft 的优先级，并在挂任务之前为每个 cycle 建一个冲刺。请把原来的 Linear issue ID 以 “Linear: ABC-123” 的形式留在每个任务的描述里，方便以后相互对照。
还没接 AI？用内置的 CSV 导入器 — 上传导出文件，映射好列，整批会在一次事务里落地。（AI 客户端通过 bulk_create_tasks 工具有同样的能力：一次调用完成整份导入。）
更想让人帮你迁？把导出文件发来联系支持，在 Weft 还早的阶段我们替你做。不收费。
哪些东西搬不过来
- 附件不会迁移——如果某个任务在 Linear 里带文件，请在描述里放一个链接。
- 评论不会迁移——把最重要的那一串粘到任务描述里。
- 子任务在 Weft 里成为独立任务，父任务在描述中引用。
- Linear 的 GitHub/GitLab 链接留在 Linear——Weft 目前还不对接 issue。
还在犹豫要不要离开 Linear？
看看老老实实的并排对比 — 什么时候 Linear 更好，什么时候 Weft 更好。我们不写抹黑文章；如果 Linear 更适合你这种形态的团队，我们会直说。
从头开始，但把活儿带过来。
50 个任务以内免费 — 通常够你试出 Weft 合不合你的交付方式。
要从 Linear 搬数据？我们可以帮忙 — 联系支持。