| name | worktrack-recover-skill |
| description | 当 Harness 处于 WorktrackScope.recovering，且需要一轮带有明确权限边界的限定范围恢复决策来在重试、回滚、拆分工作追踪或刷新基准之间做选择时，使用这个技能。 |
恢复工作追踪技能
概览
本技能实现 WorktrackScope.Recover 状态转移算子，对应 Harness 控制回路中的恢复控制阶段。当 gate 判定为失败或阻塞时，它负责评估合法的恢复操作（重试、回滚、拆分、刷新基准、重新规划），选择恢复路径并停在权限边界处。
当 Harness 已经判定当前 工作追踪 无法沿现有路径继续推进，并且需要一轮限定范围恢复决策时，使用这个技能。
这个技能会为 通用高能力模型 SubAgent 打包最小失败路径上下文，评估合法的恢复操作，在 重试、回滚、拆分工作追踪 或 刷新基准 之间做选择，并向 Harness 返回结构化的恢复交接结果。
它会停在恢复权限边界处，而不是静默执行破坏性回滚、重定义范围，或改写代码仓库真相。
何时使用
当需要确定正确的恢复路径时，使用这个技能：
- 根据限定范围证据归类当前失败或阻塞状态
- 判断当前
工作追踪 是否能在相同目标与基准下安全重试
- 判断在任何新尝试之前是否必须先执行回滚
- 判断当前工作是否应拆成更小的限定范围工作追踪
- 判断基准漂移或代码仓库真相变化是否要求
刷新基准
- 返回带有明确审批边界和下一步交接结果的恢复决策
工作流
- 确认这是一轮限定范围的
工作追踪范围.恢复中，而不是初始规划、实现分派、最终关卡判定或收尾。
- 载入当前失败路径所需的最小恢复产物。
- 为限定范围的
通用高能力模型 SubAgent 构建一份 恢复选择任务简报 和一份 恢复选择信息包。
- 归类当前恢复触发器：
软失败硬失败阻塞基准漂移branch_policy_mismatch
- 评估合法的恢复选择：
重试回滚拆分工作追踪刷新基准重新规划（跨 Scope 回到 RepoScope）
- 选择一条主恢复路径，并在需要时给出一条后备恢复路径。
- 返回一份固定格式的
恢复选择结果 和一份 恢复权限交接。
- 在执行破坏性回滚、开启新工作追踪或变更代码仓库真相之前停止。
恢复决策约定
每次运行这个技能时，都使用同一套限定范围约定格式。
恢复选择任务简报
恢复触发器目标当前工作追踪范围内范围外恢复选项约束权限限制完成信号
恢复选择信息包
当前工作追踪状态工作追踪约定摘要节点类型节点策略Branch Policy: baseline_branch、branch_source_ref、worktrack_branch、integration_target_ref、closeout_target_ref、checkpoint_base_ref计划队列状态关卡证据摘要失败信号基准状态已知风险所需上下文未解决问题
恢复权限交接
所选恢复模式选择理由已应用中断处理策略权限边界即时安全动作需要审批后续产物交接目标
若恢复成功且所选模式非 replan，最终应经过 worktrack-close-skill 完成收尾。
恢复权限边界
恢复决策必须停留在以下权限限制内：
重试
- 只有在当前目标、排除目标与基准仍然有效时才允许。
- 必须检查
if_interrupted_strategy 是否允许继续同一 worktrack；如果策略要求 checkpoint、rollback 或 stop，应先转入对应恢复路径。
- 可以修订下一项限定范围任务或证据要求。
- 重试时的唯一合法行为是在现有范围、验收定义内重试，并对缺失证据显式暴露。扩大范围、重定义验收或静默跳过缺失证据的行为必须被阻断。
回滚
- 可以识别回滚目标、回滚原因与安全顺序。
- 除非程序员明确批准，否则在执行破坏性代码版本或工作区变更前必须停止。
- 回滚后的唯一合法行为是重新评估底层失败分类。假定仅靠回滚就能解决底层失败分类的行为必须被阻断。
拆分工作追踪
- 可以提出新的限定范围拆分形态和后续工作追踪身份。
- 新建工作追踪的创建、调度或切换必须通过显式审批和交接流程。从本技能静默创建、调度或切换到新工作追踪的行为必须被阻断。
- 必须保留哪些验收标准留在当前工作追踪，哪些会移出。
刷新基准
- 当上游真相变化或漂移使当前分支比较失效时，可以请求代码仓库级基准刷新或重新初始化触发器。
- 如果
branch_source_ref、worktrack_branch、closeout_target_ref、checkpoint_base_ref、baseline_form 或 merge_required 与当前 checkpoint 状态不匹配，必须把该不匹配作为刷新或重新初始化理由。
- 对
代码仓库快照/状态、目标/章程 或控制真相的唯一合法操作是读取消费。从本技能改写这些产物的行为必须被阻断。
- 必须返回一份交接结果，明确告诉
Harness 接下来需要哪一轮面向代码仓库的流程。
重新规划
- 当当前工作追踪的目标、范围或约定本身需要重新审定时，可以触发跨 Scope 回到 RepoScope 的重新规划。
- 新工作追踪的创建和上游约定的改写必须通过显式审批和交接流程。从本技能静默执行的行为必须被阻断。
- 必须返回明确的重新规划交接，说明哪些内容需要回到 RepoScope 重新评估。
if_interrupted_strategy → 恢复模式映射
| if_interrupted_strategy | 默认恢复行为 |
|---|
| checkpoint-or-recover | 保存 checkpoint → 优先 retry（目标与基准仍有效时） |
| checkpoint-or-rollback | 保存 checkpoint → 优先 rollback |
| preserve-report-and-stop | 保留报告 artifact → 禁止 retry/rollback → 路由到 replan 或 handback |
硬约束
遵循本包内最小公共约束 C-1 至 C-7：C-1 只在声明的 Scope/Function 内操作；C-2 只有授权的 SetGoal/ChangeGoal/Close/Refresh 路径可变更控制状态，其余技能返回结构化输出；C-3 先生成完整报告再提取 Control Signal，重复上下文用 artifact 引用，空字段用 N/A；C-4 不跨越 Observe/Decide/Init/Dispatch/Verify/Judge/Recover/Close 的角色边界；C-5 只消费已批准上游产物，不凭空发明验收或恢复标准；C-6 缺失证据必须显式暴露，不能当作成功；C-7 保持限定范围，避免不必要的全仓重发现。
- 仅当恢复决策已完成、审批已通过时，沿恢复路径继续执行才合法。仅因重试看起来可行而继续沿失败路径执行的行为必须被阻断。
回滚、拆分工作追踪 或 刷新基准 的唯一合法处理方式是作为需要程序员审批的显式恢复决策。将其作为隐藏实现细节的行为禁止发生。- 恢复分类、恢复选择与审批边界的唯一合法呈现形式是结构化字段。压缩成模糊叙述的行为必须被阻断。
预期输出
使用这个技能时，产出一份至少包含以下章节的 恢复选择结果：
恢复触发器恢复选项评估所选恢复路径恢复权限交接开放风险与后续跟进返回 Harness
结果中至少应包含以下字段或等价表达：
子代理模型恢复触发器失败分类当前工作追踪状态所选恢复模式选择理由已应用中断处理策略节点类型节点策略合同分支策略后备恢复模式重试可行性回滚目标或规则拆分理由基准刷新理由branch_policy_mismatch权限边界即时安全动作需要审批后续产物开放风险建议下一动作需要程序员审批如何审查
资源
使用当前失败路径证据、工作追踪约定、队列状态，以及选择合法恢复操作所需的最小额外代码仓库或相邻系统上下文。
