SuperAPI AI 工具集

gsd-path-migrate

智能体与模型

查看项目

更新于 10-16 07:25

技能介绍

用途:把 GSD Core 项目的上下文、规则和未完成工作迁移为可被 GSD Path 接管的导入包,并处理 Core 与 Path 在同一宿主上的共存。首版支持的宿主为 Claude Code 和 Codex,插件安装与独立技能安装需分别处理。

主要能力:在停止 Core 工作前保存未提交成果并建立干净 Git 基线;检查用户、项目与本地钩子设置(含已安装插件钩子、状态行、托管策略),同时查看 AGENTS.md、CLAUDE.md 及宿主指令桥接,备份原始指令。使用附带脚本预览、生成和校验迁移包:

python3 -B <skill>/scripts/migrate_core.py preview --repo <source> python3 -B <skill>/scripts/migrate_core.py prepare --repo <source> --output <new-external-bundle> python3 -B <skill>/scripts/migrate_core.py verify --output <new-external-bundle>

校验后在迁移包中写 IMPORT.md,包含 Source、Context、Constraints and exclusions、Work map、History、Hook cutover、Open questions、Handoff 等部分;对每条源需求保留一行映射,区分已完成历史、剩余工作与不确定状态。

使用方式:若目标已有 .project/STATE.md,先用 scripts/discussion_records.py pending --repo <target> 检查待讨论项并交回 Path 路由器。钩子切换使用 core_hook_settings.py 的 plan / apply / restore 子命令,按清单 location 数组处理,应用前审阅 receipt,receipt 私密保存,restore 仅作回滚。完成后按 Handoff 提供 $gsd-path 与 $gsd-path-define 调用指令。

限制:迁移不复制 Core 阶段位置,也不把 Core 测试结果转为 Path gate 凭证;不得覆盖进行中的 Path 契约或丢弃其他阶段的待答项。设置 diff 或清单本身不足以证明切换成功;若无法证明 Core 钩子已停用、Path 守卫仍在运行且独立 Core 项目钩子保留,须在 IMPORT.md 标记 cutover blocked 并报告剩余宿主操作。Path 的常规 intent 审批仍必需,具体价格、平台支持范围等未在资料中提供。