SuperAPI AI 工具集

resume-hamster

编程与开发

查看项目

更新于 10-27 05:15

技能介绍

用途 resume-hamster 用于恢复被中断的 /hamster:ship 简报执行会话。它属于执行型技能:继续执行 .hamster/ 中已经生成好的计划,不会重新规划任务。

主要能力

  1. 就绪检查:运行技能自带的 ensure-ready 脚本(Unix 为 scripts/ensure-ready.sh,Windows 为 scripts/ensure-ready.ps1);若脚本不存在,则检查 hamster 是否在 PATH 中、是否已登录,并执行 hamster sync,只有输出 READY 才继续。
  2. 检测简报:先读取 brief-selection 并进行账户解析(Account Resolution);若返回 ACCOUNT_UNRESOLVED,则按其团队选择/重新同步指引处理并停止。随后启动或复用 hamster sync --watch,并根据当前 git 分支、含 in_progress 任务的简报等信号确定目标任务:优先使用传入参数解析出的 slug;否则从形如 feature/{key}-{n}-{slug} 的分支中提取 slug;若只有一个简报含进行中任务则使用它,多个则询问用户;都没有则提示无可恢复内容,建议使用 /hamster:ship。
  3. 定位恢复点:按 brief-selection 的 Scheduling 步骤进行前置元数据解析与波次分组,再结合 git 状态判断:已提交的父任务(通过提交信息中 feat(KEY-号) 格式识别)、未提交的在途改动。进而确定:全部已提交的波次视为完成并跳过;部分提交的波次只恢复未提交的父任务;均未提交则从该波次起点开始;某任务为 in_progress 且存在未提交改动,则提示其执行器检查 git diff 并从部分成果继续,而非重头开始。
  4. 确认与继续:以简洁格式汇报恢复计划(已完成、下一步、剩余父任务与波次数),请用户确认“从波次 n 恢复 / 从其他任务开始 / 取消”。
  5. 执行前校验:确认当前分支为 feature/{key}-{n}-{slug},否则询问是否切换或创建;对于无法归因于进行中任务的未提交改动,展示后询问作为当前任务提交、暂存或丢弃。
  6. 执行与收尾:按照 execution-loop 的 Execution Loop 与 Completion 部分执行,从恢复波次开始(部分波次仅对未提交父任务启动执行器)。完成时若已有 PR,则需推送并更新 PR 正文,合并恢复的任务状态与 Plan Feedback(保留其原有条目与决议及其他现有内容),并报告 URL;若无 PR,则需按循环要求取得用户同意后再创建。

使用方式 该技能通过参数 "$ARGUMENTS" 传入简报标识。需要先阅读 SKILL.md 并设置 SKILL_DIR 为包含该文件的目录绝对路径,再执行就绪检查命令(Unix 与 Windows 命令见官方说明,需保持单行、以分号分隔)。在 macOS 的 Codex 中若出现 SETUP_NEEDED 而 hamster 已在 PATH 中,可用提升权限重跑就绪命令,仍失败则运行本插件的 setup 技能后重试,直到输出 READY。

适用场景 适用于此前执行被中断的 Hamster 简报会话,需要基于 git 历史与任务状态判断进度并续跑的场景。

限制 该技能只续跑既有计划,不做重新规划;依赖 git 仓库与 Hamster 环境(需已登录并可同步);若账户无法解析或目录不存在会中止;若没有可恢复的简报则不会执行。