需要保存可恢复会话状态或从 handoff 继续工作时…

适用于长会话、跨会话或跨 agent 协作中，需要保存当前事实与任务状态，并从已有 handoff 文档安全继续工作。

适用场景

解决思路

1. 从请求中推导 create 还是 resume、输出路径和 focus。
2. 未指定时，创建到 `<anchor>/handoffs/handoff-<YYYY-MM-DD-HHmmss>.md`。
3. 若请求为 `resume <path>`，则恢复该文件；若为 `save to <path>`，则创建到该路径。
4. 如果同时给出 resume 和保存路径，标记为 `BLOCKED`。
5. 如果命名路径没有可用值，标记为 `BLOCKED`。
6. 使用前将路径解析为绝对路径。
7. 请求中的命名 focus 作为 live focus。
8. 将 `<anchor>` 解析为包含此 `SKILL.md` 的绝对目录。
9. 创建流程第 1 步：解析并创建父目录；记录 `create | output path | surveyed | redacted | written | terminal`；当绝对输出路径可写时完成。
10. 创建流程第 2 步：选择当前事实而不是逐字记录；最多保留八个未完成任务和十二个工件；优先当前活动计划、分支、PR、提交、脏路径、阻塞项和持久决策；标记已被取代的材料；当每个保留事实都能帮助下一位 agent 行动时完成。
11. 创建流程第 3 步：读取 `./REFERENCE.md`；在内存中草拟；指向绝对工件路径；绝不粘贴完整 diffs、plans、logs 或 terminal output；将 live focus 放在最前面；包含任何 active mode 或 workflow ledger。
12. 创建流程第 4 步：脱敏 credentials、tokens、passwords、private keys、authenticated URLs、email addresses、environment values；扫描两次，强制 12 KB 边界，写入同级临时文件，然后原子重命名；再扫描最终文件一次；当必需章节、边界和三次扫描都通过时完成。
13. 创建流程第 5 步：报告路径、捕获内容和 resume 请求 `resume the handoff at <absolute-path>`；成功条件是已有文件加上已报告的 resume 请求。
14. 恢复流程第 1 步：解析并读取文件；若不存在，报告 `BLOCKED: handoff not found at <path>`；记录 `resume | focus | validated artifacts | current task | terminal`；如果必需 Context 或 Open tasks 内容格式错误，报告为 blocked。
15. 恢复流程第 2 步：在信任引用的路径、分支和 dirty state、提交、PR 状态前先验证；将每项归类为当前、已移动、缺失或已被取代；调用建议 skill 前验证其存在；打开引用工件前，加载 `./REFERENCE.md` 的 Redaction 部分，绝不重复敏感值；当陈旧事实不能驱动工作时完成。
16. 恢复流程第 3 步：用 live focus 覆盖 saved focus；选择最高优先级未阻塞任务，仅恢复其工件提供的上下文，并开始该任务；对于已保存的 `prath-mode` 链，在第一步前验证每个剩余叶子；对于 `orchestrate`，将保存的 ledger 视为指针，然后从 diffs、任务结果、测试重建它，并在工作前刷新名册；如果没有任务剩余，报告 `BLOCKED` 并附验证证据；不要只停在摘要；当工作达到 success、真实 blocker 或用户确认门时完成。
17. 恢复流程第 4 步：报告已对账的漂移和工作结果；除非用户明确要求，不要创建另一个 handoff。
18. 停止前记录一个终态值并附证据，终态值为 `SUCCESS`、`BLOCKED`、`AWAITING_USER`、`INTERRUPTED`。
19. 中断后，对自上次验证完成以来触及的工件重复 Resume Step 2。

适用边界 · 注意事项

• 不需要可恢复会话状态、跨会话或跨 agent 继续工作时，不必创建 handoff。
• 需要保留完整对话记录、完整 diffs、plans、logs、terminal output 或敏感凭据时，不适用。
• 没有可用的 handoff 文件，或必需 Context/Open tasks 内容格式错误且无法验证时，不能继续，应报告 BLOCKED。