worktrack-recover-skill

name	worktrack-recover-skill
description	当 Harness 处于 WorktrackScope.recovering，且需要一轮带有明确权限边界的限定范围恢复决策来在重试、回滚、拆分工作追踪或刷新基准之间做选择时，使用这个技能。

恢复工作追踪技能

概览

本技能实现 WorktrackScope.Recover 状态转移算子，对应 Harness 控制回路中的恢复控制阶段。当 gate 判定为失败或阻塞时，它负责评估合法的恢复操作（重试、回滚、拆分、刷新基准、重新规划），选择恢复路径并停在权限边界处。

当 Harness 已经判定当前 工作追踪 无法沿现有路径继续推进，并且需要一轮限定范围恢复决策时，使用这个技能。

这个技能会为 通用高能力模型 SubAgent 打包最小失败路径上下文，评估合法的恢复操作，在 重试、回滚、拆分工作追踪 或 刷新基准 之间做选择，并向 Harness 返回结构化的恢复交接结果。

它会停在恢复权限边界处，而不是静默执行破坏性回滚、重定义范围，或改写代码仓库真相。

何时使用

当需要确定正确的恢复路径时，使用这个技能：

• 根据限定范围证据归类当前失败或阻塞状态
• 判断当前 工作追踪 是否能在相同目标与基准下安全重试
• 判断在任何新尝试之前是否必须先执行回滚
• 判断当前工作是否应拆成更小的限定范围工作追踪
• 判断基准漂移或代码仓库真相变化是否要求 刷新基准
• 返回带有明确审批边界和下一步交接结果的恢复决策

工作流

1. 确认这是一轮限定范围的 工作追踪范围.恢复中，而不是初始规划、实现分派、最终关卡判定或收尾。
2. 载入当前失败路径所需的最小恢复产物。
3. 为限定范围的 通用高能力模型 SubAgent 构建一份 恢复选择任务简报 和一份 恢复选择信息包。
4. 归类当前恢复触发器：
   • 软失败
   • 硬失败
   • 阻塞
   • 基准漂移
   • branch_policy_mismatch
5. 评估合法的恢复选择：
   • 重试
   • 回滚
   • 拆分工作追踪
   • 刷新基准
   • 重新规划（跨 Scope 回到 RepoScope）
6. 选择一条主恢复路径，并在需要时给出一条后备恢复路径。
7. 返回一份固定格式的 恢复选择结果 和一份 恢复权限交接。
8. 在执行破坏性回滚、开启新工作追踪或变更代码仓库真相之前停止。

恢复决策约定

每次运行这个技能时，都使用同一套限定范围约定格式。

恢复选择任务简报

• 恢复触发器
• 目标
• 当前工作追踪
• 范围内
• 范围外
• 恢复选项
• 约束
• 权限限制
• 完成信号

恢复选择信息包

• 当前工作追踪状态
• 工作追踪约定摘要
• 节点类型
• 节点策略
• 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
• 权限边界
• 即时安全动作
• 需要审批
• 后续产物
• 开放风险
• 建议下一动作
• 需要程序员审批
• 如何审查

资源

使用当前失败路径证据、工作追踪约定、队列状态，以及选择合法恢复操作所需的最小额外代码仓库或相邻系统上下文。