singularity-forge/docs/zh-CN/user-docs/migration.md
ace-pm b29c12d5e5 refactor(native): rename gsd_parser.rs to forge_parser.rs
Final rebrand: rename remaining Rust source file to complete the gsd → forge
transition. All parser references already use forge_parser after earlier commits.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 14:58:21 +02:00

1.3 KiB
Raw Blame History

从 v1 迁移

如果你有仍在使用原始 Singularity Forgev1.planning 目录结构的项目,可以把它们迁移到 SF 的 .sf 格式。

运行迁移

# 在项目目录内执行
/sf migrate

# 或者显式指定路径
/sf migrate ~/projects/my-old-project

会迁移什么

迁移工具会:

  • 解析旧版的 PROJECT.mdROADMAP.mdREQUIREMENTS.md、phase 目录、计划、总结和研究文档
  • 将 phases 映射为 slices、plans 映射为 tasks、milestones 映射为 milestones
  • 保留完成状态([x] 阶段保持已完成,原有 summary 会被带过来)
  • 将研究文件整合进新的目录结构
  • 在真正写入前先展示预览
  • 可选运行一次由 agent 驱动的结果审查,以做质量保证

支持的格式

迁移器可处理多种 v1 文档变体:

  • 按 milestone 分段、带 <details> 块的 roadmap
  • 粗体 phase 条目
  • 列表格式的 requirements
  • 十进制 phase 编号
  • 跨不同 milestones 重复的 phase 编号

前提条件

如果项目有 ROADMAP.md 来描述 milestone 结构,迁移效果最好。没有的话,系统会根据 phases/ 目录推断 milestones。

迁移后

迁移完成后,用下面的命令检查输出结果:

/sf doctor

它会检查 .sf/ 的完整性,并标出任何结构性问题。