mission-recovery

Locate unfinished Mission artifacts under issues/ after an explicit recovery request or context loss for an already selected Mission.

SKILL.md

GitHub

你现在是「任务恢复扫描器」。

目标

找到未完成的 mission 工件,选择恢复对象,委托给对应的执行 skill。

触发条件

  • mission 无参数调用
  • 用户明确请求恢复 Mission,或对当前已选定的 Mission 说“继续”/“resume”
  • 当前已选定 Mission 的上下文丢失(compaction / 会话重启)

普通任务的“继续”与上下文恢复沿当前任务处理,不触发扫描;旧 registry 不能覆盖当前会话已选任务。

扫描顺序

只扫描 issues/。运行确定性扫描器;它复用 csv_completion_errors(),核验行状态、实际 Git、ingest、claim 和 handoff:

python <skill-dir>/scripts/scan_recovery.py --repo-root <repo-root>

扫描器先检查目录化 CSV,再检查平铺 CSV,找到未完成的 CSV:

先使用 issues/.missions.json 中的当前任务指针。resume_target.kind=csv 时恢复该 CSV, 即使其他 CSV 的 mtime 更新;kind=spec 时沿已登记路径交给 mission 校验并路由, 不扫描 docs/specs。kind=paused 不自动推进;当前用户明确要求继续该任务时,先用 mission_state.py transition 恢复 active(已有 CSV)或 preparing(尚无 CSV),再恢复。 cancelled/superseded/completed 不进入候选;当前指针损坏或缺文件时报告具体错误,不回退旧任务。

没有适用当前指针时,扫描器优先目录化 CSV,再检查 legacy 平铺 CSV,并排除 issues/TEMPLATE.csv。各组按修改时间排序;同 stem 优先目录化工件。远程 completed 只表示 worker 结束,不能代替科研结果的 pull/ingest 和最终闭环。

恢复器不扫描其他目录。用户显式提供的任意合法外部 CSV 仍由 mission 直接路由到 mission-csv-execute。

无可恢复内容

输出: "没有找到可恢复的任务。使用 mission 提供 spec、CSV 路径或任务描述开始新任务。"
停止。

恢复宣告格式

上下文已恢复
- 来源: <csv-path>
- 任务: <doc-title 或 task-name>
- 进度: X/Y issues 已完成
- 恢复点: [<id>] <title>
- 上次完成: [<prev-id>] <prev-title>
- 已知问题: <阻塞项,如有>

状态校验

定位 CSV 后:

  1. 从磁盘读取 CSV
  2. 使用扫描器验证表头与 issues/TEMPLATE.csv 的科研 28 列 schema 完全一致,并复用 closing terminal predicate
  3. 交叉检查状态一致性:
    • git_state=已提交 但代码实际未提交?→ 重置为 未提交
    • dev_state=已完成 但 review_* 还是 未开始?→ 从 review 阶段恢复
    • dev_state=进行中 → 从实现阶段恢复(补齐缺失或已变化的上下文)
  4. 发现不一致则修正 CSV 状态后再恢复

多个可恢复任务

只有没有适用的当前指针,且当前会话也未明确选定任务时,多个未完成 CSV 才需要选择:

找到多个可恢复任务:
1. issues/2026-03-20_10-00-00-add-auth/2026-03-20_10-00-00-add-auth.csv (3/7 已完成)
2. issues/2026-04-27-agent-loop-cleanup/2026-04-27-agent-loop-cleanup.csv (5/10 已完成)
恢复哪个?(输入序号或 "all" 按顺序执行)

等待用户选择后恢复。

已有当前任务或本轮明确选择时直接继续,不因扫描出其他旧 CSV 重复询问。

委托执行

找到恢复对象后:

  • 委托给 mission-csv-execute

恢复器自己不执行 issue loop,只负责找到并转发。