SuperAPI AI 工具集

gsd-path-undo

通用与其它

查看项目

更新于 10-16 02:39

技能介绍

用途:gsd-path-undo 是 open-gsd/gsd-path 中用于撤销的辅助技能,仅在用户明确调用 $gsd-path-undo 时启用,用来预览并应用由辅助脚本负责的撤销,包括未发布的检查点、最近一次任务落地以及未提交的 ship。一次调用只做一次预览,只有在用户明确确认后才执行。

主要能力:所有撤销判断由随附的 pipeline_undo.py 负责,不要在模型推理中重新实现 git reset。该技能不会推进阶段门、不会强制推送,也不会重写 origin/main 祖先的提交。

使用方式:先运行 python3 <absolute-bundled-pipeline_undo.py> preview --repo <absolute-root>,并把返回的 JSON 作为唯一分类依据。若 target.kind 为空,报告 target.blocked 的全部原因,停止且不要应用。确认环节展示 target.effects、链接 STATE.md,并询问是否应用该 kind;仅在用户确认后,使用预览值原样执行 python3 <absolute-bundled-pipeline_undo.py> apply --repo <absolute-root> --kind <target.kind> --expected-head <target.head>。若期望 HEAD 与实际不符,说明 HEAD 已移动,应重新预览,不要自行编造 SHA。完成后报告 status: applied 及新的 STATE 阶段/状态,并提示用 $gsd-path status 查看而不推进。

限制:不得直接运行 git reset、git revert、git push --force 或 git checkout,除非通过该辅助脚本。不得撤销 ship 提交、集成合并、放弃提交或提升提交,这些属于被阻止项。已发布的 HEAD(可从 origin/<STATE.branch> 到达)会被阻止。已验证的待处理撤销日志会作为可恢复的预览目标返回,其他待处理辅助日志则被阻止,须由各自负责方恢复。辅助脚本出错时,应展示带错误的 Outcome,并在 STATE.md 存在时链接它,Next 指向 $gsd-path-forensics。更细的运行时选择与操作规则暂未提供。