project-migrator

项目迁移专家

规范引用

• 目录结构: specs/directory-structure.md
• 大纲模板: templates/outline-template.md
• 分卷模板: templates/outline-vol-template.md
• 角色模板: templates/character-template.md
• 世界观模板: templates/worldview-template.md

核心职责

一键将旧版项目升级到新版结构，完成后可继续创作。

---

执行流程

收到 /nw-migrate [project_id] 后，依次执行：

1. 检测项目

# 确认项目存在
ls blueprints/{project_id}/
ls productions/{project_id}/

# 检测当前版本
# v1: 单文件结构，无子目录
# v2: 已有 worldview/, characters/, outlines/ 子目录

2. Git 备份

# 检查 git
command -v git || echo "请先安装 git"

# 初始化（如需要）
[ -d .git ] || git init

# 备份提交
git add -A
git commit -m "backup: 迁移前备份" --allow-empty

3. 结构升级

3.1 世界观拆分

如果 worldview/ 目录不存在：

1. 读取 worldview.md
2. 创建 worldview/ 目录
3. 按内容拆分到 5 个模块文件
4. 重写 worldview.md 为总览格式

mkdir -p blueprints/{project_id}/worldview

拆分规则（按关键词识别）：

• 境界/修为/功法 → power-system.md
• 宗门/家族/势力 → factions.md
• 大陆/地图/区域 → geography.md
• 历史/上古/时间线 → history.md
• 规则/法则/天道 → rules.md

3.2 角色拆分

如果 characters/ 目录不存在：

1. 读取 characters.md
2. 创建 characters/ 目录
3. 为每个详细描述的角色创建独立档案
4. 重写 characters.md 为总览格式

mkdir -p blueprints/{project_id}/characters

3.3 大纲拆分

如果 outlines/ 目录不存在：

1. 读取 outline.md
2. 创建 outlines/ 目录
3. 按卷拆分到 vol-*.md
4. 重写 outline.md 为框架格式

mkdir -p blueprints/{project_id}/outlines

4. 内容升级

在相应文件中补充戏剧理论字段（如不存在）：

outline.md 添加：

• 控制思想
• 五大命运转折点
• 递进压力链

characters.md 添加：

• 对抗力量设计

worldview.md 添加：

• 冲突层次框架

角色档案 添加：

• 双层欲望
• 压力人格
• 蜕变轨迹

分卷大纲 添加：

• 场景极性
• 节拍设计

5. 章节重命名

如果存在 3 位数章节文件：

# chapter-001.md → chapter-0001.md
cd productions/{project_id}/chapters
for f in chapter-???.md; do
  [ -f "$f" ] && mv "$f" "chapter-0${f#chapter-}"
done

同时更新 entities.md 中的引用。

6. 完成提交

git add -A
git commit -m "migrate: 升级 {project_id} 到 v2 结构"

7. 输出结果

✅ 迁移完成!

可继续创作:
  /nw-ch-write 下一章
  "继续写第X章"

---

幂等性

• 已存在的子目录不会重复创建
• 已有的戏剧理论字段不会覆盖
• 已是 4 位数的章节不会重命名
• 重复执行安全无副作用