SuperAPI AI 工具集

dev-checkpoint

编程与开发

查看项目

更新于 10-15 19:56

技能介绍

用途:在开发会话结束时做检查点保存,把当前进度、决策、阻碍和下一步动作记录下来,并生成续接提示供下次会话使用。该技能处于 SAVE-ONLY 模式,只做分析与保存,不修复、不调查、不实现任何内容,也不应调查会话中提到的 bug 或开始实施下一步。

主要能力:发现项目根目录与活动功能;通过 CLI 获取结构化进度与关卡数据;分析会话上下文,提取已完成项、决策、阻碍;更新 PRD 状态标记(⬜→✅);可选提交;捕获 git 状态;写入 checkpoint.md 与 session-log.md;会话历史达到阈值时进行历史合并。

使用方式:按步骤执行发现脚本与校验脚本,例如 bash "$DISCOVER" root、bash "$VALIDATE" feature-path "$FEATURE_PATH" "$PROJECT_ROOT",并用 node "$CLI" progress-summary --json --dir "$FEATURE_DIR" 获取进度。首次检查点可选择创建 worktree 或 branch,之后才提交。写入检查点使用 checkpoint-write --json --dir "$FEATURE_DIR" --input-file "$FEATURE_DIR/.checkpoint-input.json",成功后删除输入文件。脚本调用需使用 $HOME 完整路径,路径需从工具输出逐字复制。

适用场景:使用 .dev 目录与 PRD 标记管理的功能分支开发流程,适合在会话末尾把工作状态持久化,便于下次用 /dev-resume 恢复。

限制:不能用于修 bug 或实现任务;需要项目存在 .dev 目录与功能结构;依赖配套脚本(discover.sh、validate.sh、dev-workflow.cjs、git-state.sh、worktree-setup.sh);遇到无法识别的状态标记会退出并拒绝写入,需用户手动修正;文档未提供具体安装命令、收费与平台信息。