# 如何通过 AI 将 2.1 定制主题升级到 3.0

**URL:** <https://community.shoplineapp.cn/t/topic/134>\
**Category:** AI\
**Tags:** skill\
**Created:** [2026 年6 月 10 日 07:04 UTC](https://community.shoplineapp.cn/t/topic/134 "2026-06-10T07:04:14Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![子寒](https://community.shoplineapp.cn/user_avatar/community.shoplineapp.cn/%E5%AD%90%E5%AF%92/32/41_2.png) [@子寒](https://community.shoplineapp.cn/u/%E5%AD%90%E5%AF%92)\
发布日期： [2026 年6 月 10 日 07:04 UTC](https://community.shoplineapp.cn/t/topic/134/1 "2026-06-10T07:04:14Z")

</div>

## SHOPLINE OS2.1 主题迁移 OS3 的 AI Skill

`website-upgrade-themeos3` 是一个面向 SHOPLINE 主题迁移场景的 AI Skill，主要用于把 **OS2.1 / Handlebars 主题代码** 迁移到 **OS3 / ThemeOS3 / SLine** 。

## 使用流程

### 1. 安装该 Skill

#### 下载 Skill

[website-upgrade-themeos3@1.0.1 .zip](https://community.shoplineapp.cn/uploads/short-url/euqElp0aFfwR9GWgwL9vCBJlrxQ.zip) (2.4 MB)

#### 让 AI 学习该 Skill

> 学习一下当前目录中的技能

 ![image](https://community.shoplineapp.cn/uploads/default/original/1X/6db0f4cfaa2f00dd5d88dad1f6ffd8dbcfa020cd.png)

### 2. 明确任务类型

使用时先说明你要做哪类任务：

- 开始完整主题迁移
- 继续已有迁移
- 查看迁移进度
- 转换单个文件或代码片段
- 修复迁移失败
- finalize 并生成最终报告

### 3. 提供必要路径

完整主题迁移通常需要：

```plaintext
source_root: <OS2.1 源主题目录>
target_root: <OS3 目标主题目录>

```

继续迁移或查看进度通常只需要：

```plaintext
target_root: <已有 .migration-state 的 OS3 目标主题目录>

```

局部转换可以提供：

```plaintext
source: <源文件路径或粘贴代码>
target: <可选目标路径>

```

建议尽量使用绝对路径，避免 AI 猜错目录。

### 4. 完成迁移

完成后通常会得到：

- OS3 目标主题目录
- `final-report.md`
- 验证结果摘要
- 如有沉淀，会保留 `knowledge-gaps.md`
- 如仍有人工事项，会明确列出

## 推荐提示词

### 完整迁移

```plaintext
任务：把 SHOPLINE OS2.1 / Handlebars 主题迁移到 OS3 / ThemeOS3 / SLine。

source_root: <OS2.1 源主题绝对路径>
target_root: <OS3 目标主题绝对路径>

请按完整主题迁移流程执行，直到生成最终报告。
如果目标目录有覆盖风险、出现失败任务，或需要我确认可选 cart OS3 CSR 升级，请先停下来说明。

```

### 继续迁移

```plaintext
任务：继续已有的 SHOPLINE OS2.1 到 OS3 / ThemeOS3 迁移。

target_root: <已有 .migration-state 的 OS3 目标主题绝对路径>

请恢复迁移状态并继续处理，直到完成或遇到需要我决策的问题。

```

### 查看进度

```plaintext
任务：查看 SHOPLINE OS2.1 到 OS3 / ThemeOS3 主题迁移进度。

target_root: <OS3 目标主题绝对路径>

只查看进度，不要继续迁移。

```

### 转换单个文件或片段

```plaintext
任务：把下面的 SHOPLINE OS2.1 / Handlebars 文件或片段转换为 OS3 / SLine。

source: <文件路径或粘贴代码>
target: <可选目标路径>

```

### 修复迁移失败

```plaintext
任务：检查并修复当前 SHOPLINE OS2.1 到 OS3 / ThemeOS3 迁移失败。

target_root: <OS3 目标主题绝对路径>

请先说明失败原因、影响范围和修复计划，再继续处理。

```

## 验收建议

完整迁移至少确认：

- 是否生成了 `final-report.md`
- 是否说明全主题检查通过预先格式化的文本
- 目标目录是否不再存在进行中的 `.migration-state`
- 是否列出了未解决或需要人工确认的问题
- 是否没有为了通过检查而删除业务逻辑、组件调用、表单、翻译、输出或 JS 行为

局部转换至少确认：

- 输出已经是 OS3 / SLine
- 没有保留明显的 OS2.1 Handlebars 语法
- 原始业务语义没有被删减
- 剩余诊断或不确定点有明确说明