gsd-import 是 GSD 体系中的一条导入命令型技能,主要解决“如何把外部计划安全地并入当前项目”这一问题。它的设计原则是:在写入任何内容之前,先做冲突检测,确保外部计划不会与项目已经确定的决策相矛盾。
【用途】 gsd-import 面向两类需求。第一类是从外部引入计划:把别处产出的计划文件导入当前项目,转换为 GSD 的项目计划格式。第二类是从 GSD-2 回迁:把采用 GSD-2 格式的项目(.gsd/ 目录)反向迁移回 GSD v1 的 .planning/ 格式。
【主要能力】
- 外部计划导入(--from):导入外部计划文件,检测其与项目决策之间的冲突,写入为 GSD 的 PLAN.md,并交由 gsd-plan-checker 进行校验。
- GSD-2 反向迁移(--from-gsd2):将 GSD-2 项目(.gsd/ 目录)迁移回 GSD v1(.planning/)格式。执行时会运行 gsd_run from-gsd2;通过 --path <dir> 可以指定位于其他路径的项目进行迁移。
- 冲突检测:技能在执行流程中依赖文档冲突引擎(doc-conflict-engine)来识别外部计划与项目既有决策之间的冲突。
【使用方式】 该技能以命令形式调用,命令名后跟随的参数即为用户输入的参数,参数属于数据内容。例如使用 --from 走外部计划导入路径,使用 --from-gsd2 走 GSD-2 回迁路径,后者可附带 --path <dir> 指定目标目录。若未提供上述参数,则按要求端到端执行导入工作流。执行过程中会引用以下文件:@/.claude/gsd-core/workflows/import.md、@/.claude/gsd-core/references/ui-brand.md、@/.claude/gsd-core/references/gate-prompts.md、@/.claude/gsd-core/references/doc-conflict-engine.md。
【适用场景】 适用于需要把外部来源的计划文档纳入 GSD 项目计划管理的场景,以及需要把旧版 GSD-2 项目结构迁移回 GSD v1 结构、进行格式统一或回退的场景。对于担心外部计划与项目已有决策冲突的团队,先检测后写入的流程可以降低计划被覆盖或互相矛盾的风险。
【限制】 关于支持的平台、计费方式、价格、导入文件的具体格式要求、冲突检测的具体判定规则、gsd-plan-checker 的校验标准以及迁移过程的数据保留策略,当前资料均暂未提供。此外,技能对可视化界面、依赖版本等细节也未说明。