用途
该技能用于把 GSD-2(.gsd/)项目导入回 GSD v1(.planning/)格式。当用户要求运行迁移后的 source 命令 gsd-from-gsd2 时使用。
主要能力
迁移过程会将 GSD-2 的层级结构(Milestone → Slice → Task)映射到 GSD v1 的层级结构(ROADMAP.md 中的 Milestone 章节 → Phase → Plan),并保留完成状态、研究文件和摘要。
使用方式
该技能为 CJS-only:from-gsd2 不在 gsd-sdk 查询注册表中,需要按文档(docs/CLI-TOOLS.md)所示直接调用 gsd-tools.cjs。
- 定位 .gsd/ 目录——检查当前工作目录(或 --path 参数):
node "/mnt/local-analysis/workspace-hub/.Codex/get-shit-done/bin/gsd-tools.cjs" from-gsd2 --dry-run
如果未找到 .gsd/,报告错误并停止。
-
展示 dry-run 预览——向用户呈现完整文件列表和迁移统计。在写入任何内容之前请求确认。
-
确认后运行迁移:
node "/mnt/local-analysis/workspace-hub/.Codex/get-shit-done/bin/gsd-tools.cjs" from-gsd2
如果 .planning/ 已存在且用户已确认覆盖,可使用 --force。
- 报告结果——显示 filesWritten 数量、planningDir 路径和预览摘要。
适用场景
适用于需要把 GSD-2 格式的项目数据回迁到 GSD v1 格式的场景,尤其是希望保留完成状态、研究文件和摘要的迁移需求。
限制
该技能为 CJS-only,不在 gsd-sdk 查询注册表中,必须直接调用 gsd-tools.cjs。若未找到 .gsd/ 目录则无法执行,需报告错误并停止。覆盖已有 .planning/ 目录需要用户确认并使用 --force。其他关于收费、价格、平台或效果的信息暂未提供。