SuperAPI AI 工具集

stashing

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

用途:当当前工作未完成但需要切换到其他项目、被外部输入或依赖阻塞、希望保持 .planning/ 整洁且不丢失上下文时,使用 stashing 暂停工作。已完成工作应使用 superpower-planning:archiving。

主要能力:保存整个活动项目(设计、计划、发现、进度、agents),生成带元数据的 snapshot.md(日期、状态、当前目标、停止位置、下一步、遗留问题、重要文件或分支),重置活动状态并保留 archive/ 和 stash/,列出和恢复暂存,恢复时强制进行陈旧发现检查。

使用方式:开始前声明“I'm using the stashing skill to pause this work safely.”。先运行 ${CLAUDE_PLUGIN_ROOT}/scripts/check-planning-state.sh,按结果处理;用 mkdir -p .planning/stash 和 ${CLAUDE_PLUGIN_ROOT}/scripts/unique-filename.sh .planning/stash "<name>" "" 生成唯一目录名,再用 ${CLAUDE_PLUGIN_ROOT}/scripts/snapshot-save.sh "<returned-path>" 保存;随后写入 snapshot.md,并用 ${CLAUDE_PLUGIN_ROOT}/scripts/planning-reset.sh 重置活动状态。恢复时先检查状态,可选先暂存或归档,列出暂存用 ${CLAUDE_PLUGIN_ROOT}/scripts/stash-list.sh,恢复用 ${CLAUDE_PLUGIN_ROOT}/scripts/stash-restore.sh ".planning/stash/<selected>",读取 snapshot.md 后运行 git diff --stat 并核对文件、路径、分支。旧版单 .md 暂存格式则读入 .planning/findings.md 和 .planning/progress.md。

限制:不得用于已完成工作;无有意义内容时停止;不得未经确认覆盖活动工作;恢复必须做陈旧发现检查,漂移较大时应建议重新规划而非继续。选择暂存名需用户确认。