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 (2.4 MB)
让 AI 学习该 Skill
学习一下当前目录中的技能
2. 明确任务类型
使用时先说明你要做哪类任务：
- 开始完整主题迁移
- 继续已有迁移
- 查看迁移进度
- 转换单个文件或代码片段
- 修复迁移失败
- finalize 并生成最终报告
3. 提供必要路径
完整主题迁移通常需要：
source_root: <OS2.1 源主题目录>
target_root: <OS3 目标主题目录>
继续迁移或查看进度通常只需要：
target_root: <已有 .migration-state 的 OS3 目标主题目录>
局部转换可以提供：
source: <源文件路径或粘贴代码>
target: <可选目标路径>
建议尽量使用绝对路径，避免 AI 猜错目录。
4. 完成迁移
完成后通常会得到：
- OS3 目标主题目录
final-report.md- 验证结果摘要
- 如有沉淀，会保留
knowledge-gaps.md - 如仍有人工事项，会明确列出
推荐提示词
完整迁移
任务：把 SHOPLINE OS2.1 / Handlebars 主题迁移到 OS3 / ThemeOS3 / SLine。
source_root: <OS2.1 源主题绝对路径>
target_root: <OS3 目标主题绝对路径>
请按完整主题迁移流程执行，直到生成最终报告。
如果目标目录有覆盖风险、出现失败任务，或需要我确认可选 cart OS3 CSR 升级，请先停下来说明。
继续迁移
任务：继续已有的 SHOPLINE OS2.1 到 OS3 / ThemeOS3 迁移。
target_root: <已有 .migration-state 的 OS3 目标主题绝对路径>
请恢复迁移状态并继续处理，直到完成或遇到需要我决策的问题。
查看进度
任务：查看 SHOPLINE OS2.1 到 OS3 / ThemeOS3 主题迁移进度。
target_root: <OS3 目标主题绝对路径>
只查看进度，不要继续迁移。
转换单个文件或片段
任务：把下面的 SHOPLINE OS2.1 / Handlebars 文件或片段转换为 OS3 / SLine。
source: <文件路径或粘贴代码>
target: <可选目标路径>
修复迁移失败
任务：检查并修复当前 SHOPLINE OS2.1 到 OS3 / ThemeOS3 迁移失败。
target_root: <OS3 目标主题绝对路径>
请先说明失败原因、影响范围和修复计划，再继续处理。
验收建议
完整迁移至少确认：
- 是否生成了
final-report.md - 是否说明全主题检查通过预先格式化的文本
- 目标目录是否不再存在进行中的
.migration-state - 是否列出了未解决或需要人工确认的问题
- 是否没有为了通过检查而删除业务逻辑、组件调用、表单、翻译、输出或 JS 行为
局部转换至少确认：
- 输出已经是 OS3 / SLine
- 没有保留明显的 OS2.1 Handlebars 语法
- 原始业务语义没有被删减
- 剩余诊断或不确定点有明确说明