worktrack-close-skill

name	worktrack-close-skill
description	当 Harness 处于 WorktrackScope.closing，且需要一轮限定范围的收尾处理来处理合并请求、合并、清理与代码仓库刷新交接，同时不能悄悄越过审批边界时，使用这个技能。

关闭工作追踪技能

概览

本技能实现 WorktrackScope.Close 状态转移算子，对应 Harness 控制回路中的关闭并交接阶段。它负责处理工作追踪的收尾路径（PR → merge → cleanup → repo refresh 交接），完成验证过的状态到 repo 级真相层的回写，闭合控制回路。

当 Harness 已经持有一个可合并或已合并的 Worktrack，并且需要在 WorktrackScope.closing 内完成一轮限定范围收尾时，使用这个技能。

这个技能会为一次 通用高能力模型 SubAgent 运行打包最小收尾上下文，判断当前收尾阶段，并返回结构化的收尾结果与明确的 代码仓库刷新交接，按照工作追踪合同规定的 closeout target 推进，不在未经审批的情况下推进合并、分支清理或代码仓库级回写。

何时使用

当需要在不跨越权限边界的前提下完成工作追踪的收尾路径时，使用这个技能：

• 当前 Worktrack 已经有允许进入收尾处理的 关卡证据 结果
• 系统需要判断本轮处于 合并请求、合并、清理分支 还是 代码仓库刷新交接
• 收尾状态可能只完成了一部分，例如 合并请求已开但未合并 或 已合并但清理仍在等待
• Harness 需要一份限定范围报告，说明哪些收尾动作已完成、哪些仍需审批、哪些应回交给 代码仓库范围
• 结果必须停留在收尾处理范围内，不能漂移回实现、关卡裁决或代码仓库刷新执行
• 工作追踪恢复成功后需要收尾时

工作流

1. 载入最小 WorktrackScope 产物，以及与收尾有关的当前分支、合并请求和合并状态证据。
2. 为一轮限定范围的 通用高能力模型 SubAgent 构建一份 关闭工作追踪任务简报 和一份 关闭工作追踪信息包。
3. 从 Worktrack Contract 读取 closeout target 与 checkpoint 对比基准。baseline_branch 是 servo-managed final baseline；branch_source_ref 是本 Worktrack 分支来源；integration_target_ref / closeout_target_ref 是本轮 PR target、merge target 与 checkpoint 基准的唯一合法来源。Milestone-derived worktrack 默认合回 active Milestone branch，而不是直接合回 servo-managed baseline。PR target、merge target 和 checkpoint 基准不得从当前分支名或写死默认分支名推断。
4. Pre-Closeout Checks（在确定收尾阶段之前）：
   • Self-Review：执行 Self-Review Contract 定义的结构化自查，覆盖 artifact 更新完整性、scope 合规、docs 一致性三个维度。产出 structured self-review record。若 overall_verdict = blocked，handback 修复后重试，不进入收尾阶段。
   • Single-Acceptance：执行 Single-Acceptance Contract 定义的单体验收，对照 worktrack contract 的 completion_signals 逐条验证。产出 structured single-acceptance verdict。accepted / accepted_with_notes 允许继续；blocked 触发 critical failure 升级阻断，需区分以下子路径：
     • critical_failure (own WT)：blocking 原因源于当前 WT 自身（如 completion_signals 未通过、证据缺失）→ 必须修复后才可重试收尾，不得绕过。
     • critical_failure (upstream)：blocking 原因源于上游依赖（如上游 WT 未合并、milestone baseline 未就绪、外部 contract 不满足）→ 记录阻断来源，可选 defer 到上游解决后重试（非本 WT 的责任范围）。
   • Post-Feedback Update Revalidation：若 review feedback、Worktrack Gate feedback、Closeout Gate feedback、Self-Review 或 Single-Acceptance feedback 之后发生 post-review/post-gate updates，Close 不得把更新前的 Gate/review/acceptance evidence 当作 final acceptance evidence。Single-Acceptance 和 Closeout Gate 必须接收更新后的 updated_files_or_artifacts 与 post_update_validation_timestamp，并确认 validation and acceptance evaluation 已在更新后重跑；否则 closeout 阶段阻塞并回到验证/验收重跑。
   • 两步均 clear 后，进入收尾阶段判定。
   • 更新后的 closeout pipeline 顺序：Self-Review → Single-Acceptance → Closeout Gate → 准备合并请求 → PR → Merge → Doc-Catch-Up → Refresh → Cleanup → return RepoScope
   • closeout 输出必须同时形成 closeout_evidence_bundle。该 bundle 记录 self-review、single-acceptance、Worktrack Gate、Closeout Gate、dispatch provenance、composite lane records、repo-refresh checkpoint 与 historical gap 状态；其中 dispatch provenance 必须链接 runtime evidence 中的 runtime_dispatch_record / subagent_dispatch_record refs；composite acceptance 必须链接六条 composite_lane_record refs/statuses；不得用 prose closeout summary 替代。
   • closeout evidence 必须保留 task_producing_subagent 与 review_acceptance_subagent 的 role provenance。producer_carrier_ref、review_carrier_ref、acceptance_carrier_ref 和 evidence_provenance 必须分开写入；若收尾只能使用 current-carrier fallback 验收，必须记录 fallback_reason_code，不得把 task-producing carrier 的自述提升为独立 acceptance。
5. 判断当前收尾阶段：
   • 准备合并请求
   • 合并请求已开
   • 准备合并
   • 已合并
   • 文档追平 / doc-catch-up
   • 准备清理
   • 基线固化 / checkpoint
   • 准备代码仓库刷新
   • 收尾被阻塞
6. 将收尾结果拆分为：
   • 本轮已完成的动作
   • 仍在等待程序员审批或外部合并状态的动作
   • 只有在确认合并后才安全的清理项
   • 应交给 代码仓库刷新技能 的已验证材料
7. 在一轮限定范围收尾后停止，并返回一份固定格式的 关闭工作追踪报告 与一份 代码仓库刷新交接。
8. 写回动作（progress_counter、latest_closed_worktrack_commit、control-state route 等）使用 repo-writeback-skill 执行，不再使用 ad-hoc 字段写入。

收尾约定

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

关闭工作追踪任务简报

• 触发条件
• 目标
• 当前工作追踪
• 当前收尾阶段
• 范围内
• 范围外
• 权限边界
• 需要审批
• 完成信号

关闭工作追踪信息包

• 当前工作追踪状态
• 工作追踪约定摘要
• baseline_branch: 从 Worktrack Contract 读取的 servo-managed final baseline
• branch_source_ref: 从 Worktrack Contract 读取的 Worktrack branch 来源
• worktrack_branch: 从 Worktrack Contract 读取的 Worktrack 执行分支
• integration_target_ref: 从 Worktrack Contract 读取的集成目标
• closeout_target_ref: 从 Worktrack Contract 读取的 PR target / merge target / checkpoint 基准
• checkpoint_base_ref: 从 Worktrack Contract 读取的 checkpoint 对比基准
• 关卡判定摘要
• 合并请求状态
• 合并状态
• 分支清理状态
• 已接受变更摘要
• 残留风险
• 所需上下文

代码仓库刷新交接

• 已关闭工作追踪
• closeout_record
  • worktrack_id
  • branch
  • base_ref
  • head_ref
  • merge_commit
  • pr
  • files_changed
  • acceptance_result（应携带 single-acceptance verdict 的 notes 字段，即 accepted_with_notes 的 notes 来源为 single-acceptance 产出的 structured notes，不得凭空构造或丢弃）
  • gate_verdict
  • evidence_refs
  • decision_refs
  • docs_updated
  • snapshot_refreshed
  • backlog_updated
  • cleanup_done
  • remaining_risks
  • next_repo_scope_action
• closeout_evidence_bundle
  • schema_version
  • self_review_record
  • single_acceptance_verdict
  • worktrack_gate_evidence
  • closeout_gate_evidence
  • dispatch_provenance
    • status
    • runtime_dispatch_record_ref
    • subagent_dispatch_record_refs
    • missing_dispatch_record_refs
    • dispatch_result_status
    • resolved_runtime_dispatch_status
    • task_producing_subagent
    • review_acceptance_subagent
    • producer_carrier_ref
    • review_carrier_ref
    • acceptance_carrier_ref
    • evidence_provenance
    • fallback_reason_code
  • composite_lane_records
    • code_review
      • status
      • record_ref
      • lane_id
      • producer_ref
      • validation_ref
      • missing_required_fields
      • contaminated_reason
      • not_applicable_reason
    • feature_completeness
      • status
      • record_ref
      • lane_id
      • producer_ref
      • validation_ref
      • missing_required_fields
      • contaminated_reason
      • not_applicable_reason
    • related_influence
      • status
      • record_ref
      • lane_id
      • producer_ref
      • validation_ref
      • missing_required_fields
      • contaminated_reason
      • not_applicable_reason
    • intent_completeness
      • status
      • record_ref
      • lane_id
      • producer_ref
      • validation_ref
      • missing_required_fields
      • contaminated_reason
      • not_applicable_reason
    • operator_simulation
      • status
      • record_ref
      • lane_id
      • producer_ref
      • validation_ref
      • missing_required_fields
      • contaminated_reason
      • not_applicable_reason
    • professional_review
      • status
      • record_ref
      • lane_id
      • producer_ref
      • validation_ref
      • missing_required_fields
      • contaminated_reason
      • not_applicable_reason
  • repo_refresh_checkpoint
  • post_feedback_update_revalidation
    • updated_files_or_artifacts
    • post_update_validation_timestamp
    • validation_after_update_status
    • acceptance_after_update_status
    • pre_update_final_acceptance_evidence_status
  • bundle_completeness
• dispatch_provenance_summary
  • dispatch_provenance.status
  • runtime_dispatch_record_ref
  • subagent_dispatch_record_refs
  • missing_dispatch_record_refs
  • dispatch_result_status
  • resolved_runtime_dispatch_status
• closeout_evidence_bundle_ref
• closeout_bundle_status: complete / incomplete / contaminated / historical_gap
• 基准分支
• baseline_branch
• branch_source_ref
• worktrack_branch
• integration_target_ref
• closeout_target_ref
• checkpoint_base_ref
• PR target
• merge target
• 已接受变更摘要
• 验证结果
• 收尾状态
• 可回写候选
• 节点策略
  • node_type: 从 Worktrack Contract 读取的节点类型
  • expected_baseline_form: Contract 中的 baseline_form
  • merge_required: Contract 中的 merge_required
  • actual_baseline_form: 本轮实际形成的 checkpoint 形式
  • checkpoint_policy_match: yes / no / deferred
• 基线追溯
  • checkpoint_type: commit / tag / annotated-tag / stash / explicit-declaration
  • checkpoint_ref: SHA 或 tag 名称或 stash ref
  • if_no_commit_reason: 如果不形成 commit，必须显式说明原因
  • alternative_traceability: 替代追溯物（如 PR URL、diff patch 引用、报告路径）
• 残留风险
• 推迟项
• 审批请求

基线固化策略（按节点类型）

根据 Worktrack Contract 中的 Node Type 选择基线固化方式：

优先级：Worktrack Contract 中显式填写的 baseline_branch、branch_source_ref、worktrack_branch、integration_target_ref、closeout_target_ref、checkpoint_base_ref、baseline_form、merge_required、if_interrupted_strategy 优先；下表只作为节点类型默认值。若 PR target、merge target 或实际 checkpoint 与 contract policy 不一致，必须在代码仓库刷新交接中标记 checkpoint_policy_match: no 并请求审批。

节点类型	默认 baseline_form	固化动作
feature	commit-on-feature-branch	PR → merge 到 closeout_target_ref → git commit 基线；Milestone final acceptance 再合回 baseline_branch
refactor	commit-on-refactor-branch	PR → merge 到 closeout_target_ref → git commit 基线；Milestone final acceptance 再合回 baseline_branch
bugfix	commit-on-bugfix-branch	PR → merge 到 closeout_target_ref → git commit 基线；Milestone final acceptance 再合回 baseline_branch
docs	commit-on-docs-branch	PR → merge 到 closeout_target_ref → git commit 基线；Milestone final acceptance 再合回 baseline_branch
config	commit-on-config-branch	PR → merge 到 closeout_target_ref → git commit 基线；Milestone final acceptance 再合回 baseline_branch
test	commit-on-test-branch	PR → merge 到 closeout_target_ref → git commit 基线；Milestone final acceptance 再合回 baseline_branch
research	annotated-tag-or-report	不 merge → git annotated tag + 报告文件 → 标记替代追溯物

如果 Node Type 未定义，fallback 到最保守策略：要求 commit 基线，否则显式声明替代追溯物。

硬约束

遵循本包内最小公共约束 C-1 至 C-8：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 保持限定范围，避免不必要的全仓重发现。

• 关卡通过 的唯一合法含义是允许进入收尾阶段。合并、删除分支或更新代码仓库真相的授权必须通过显式审批获得，关卡通过 不是这些操作的隐式授权。
• 仅当审批和状态确认已完整获得时，执行 合并、清理分支 或代码仓库回写才合法；否则必须保持等待并暴露缺失的审批项。
• 合并请求已开、已合并 和 代码仓库刷新已完成 是三个独立且递进的状态。合并请求已开 不能等同于 已合并，已合并 也不能等同于 代码仓库刷新已完成——每个状态必须独立验证。
• 仅当合并状态与回退路径安全性已明确后，清理分支才合法；否则必须保持分支等待确认。
• 在返回代码仓库刷新交接前，必须确认当前工作树是否已形成可追溯基线。
• 如果工作成果未形成 git commit（或 tag、annotated stash），必须显式记录不 commit 的原因及替代追溯物。
• 可安全回写的状态的判定条件是具备完整的基线追溯信息。缺少基线追溯信息的交接不能被视为可安全回写的状态。
• 已完成动作、待审批项和代码仓库刷新交接的唯一合法呈现形式是结构化字段。压缩成模糊收尾叙述的行为必须被阻断。
• Worktrack Close 后回到 RepoScope 观察的唯一合法路径是经过 repo-refresh-skill。跳过 repo-refresh-skill 直接返回的行为必须被阻断。Repo 慢变量必须通过 repo-refresh-skill 从已验证证据刷新；repo snapshot 在 merge 后自动更新的假设禁止作为跳过刷新步骤的依据。
• 仅当文档追平检查已完成或已显式安排时，结束涉及版本、release、deploy 或 VCS baseline 的轮次才合法；否则必须调用或显式安排 worktrack-doc-catch-up-skill。
• hash 存储的唯一合法时机是刷新/追平成功完成后。在刷新前或刷新失败时写入 hash 的行为必须被阻断。
• 闭环终点的判定条件是 merge → doc-catch-up → refresh repo snapshot → cleanup → return RepoScope 全部完成。PR 已发出 只是中间状态，不能被视为闭环终点。

输出协议

• 先生成尽可能长且完整的 关闭工作追踪报告，确保所有收尾信息被记录
• 然后从完整报告中提取 Control Signal 层（影响下一动作决策的关键结论）
• 代码仓库刷新交接 的基线追溯字段必须显式填充。省略基线追溯字段的行为必须被阻断
• closeout_record 不单独写入新的长期 Worktrack artifact；它必须作为 关闭工作追踪报告 与 代码仓库刷新交接 的结构化 section 输出，并由 repo-refresh 后续写入 repo 级 backlog / snapshot。省略 decision_refs 或闭环状态字段的行为必须显式说明原因
• closeout_evidence_bundle 是 closeout report / repo-refresh handoff 中的结构化 evidence envelope。若某项 evidence 未在执行时捕获，必须写为 missing；若历史 Worktrack 因旧合同未捕获，必须写为 historical_gap；不得后验合成 self-review、dispatch provenance 或 composite lane evidence。
• closeout_evidence_bundle.post_feedback_update_revalidation 必须保留 updated_files_or_artifacts 与 post_update_validation_timestamp。当 updated_files_or_artifacts 非 none 时，更新前的 final acceptance evidence 必须标记为 stale/history，不得作为 closeout 的验收依据；缺少更新后 validation and acceptance evidence 时必须阻塞 Close。
• dispatch_provenance 的唯一合法正向证据是 linked runtime_dispatch_record_ref 与 subagent_dispatch_record_refs。Close 可以保留、转写和标记这些 refs 的状态，并必须在 closeout_evidence_bundle.dispatch_provenance 和 代码仓库刷新交接.dispatch_provenance_summary 中原样携带 dispatch_provenance.status、runtime_dispatch_record_ref、subagent_dispatch_record_refs、missing_dispatch_record_refs、raw dispatch_result_status 与 resolved_runtime_dispatch_status；不得从 closeout prose、carrier 自述、模型名或 touched files 推断 delegated SubAgent execution。
• 如果 Close 无法 dereference 预期的 dispatch record，必须将 dispatch_provenance.status 标记为 missing / incomplete / historical_gap / contaminated 之一，并设置对应的 resolved_runtime_dispatch_status；不得把 current_carrier_fallback、delegated、permission_blocked、runtime_gap、dispatch_package_unsafe、blocked、historical_gap 压缩成 prose summary 或 generic failure。
• Close 必须把 task_producing_subagent 与 review_acceptance_subagent 的 evidence_provenance 原样传播到 closeout_evidence_bundle。若 producer_carrier_ref 与 review_carrier_ref / acceptance_carrier_ref 相同，只有在 current-carrier fallback 且 fallback_reason_code 为 runtime_gap、permission_blocked、coupling_or_shared_state、dispatch_package_unsafe 或 not_applicable 时才能继续；否则 closeout bundle 必须标记为 contaminated 或 incomplete。
• composite_lane_records 的唯一合法正向证据是 linked composite_lane_record。Close 必须为 code-review、feature-completeness、related-influence、intent-completeness、operator-simulation、professional-review 六条 lane 都输出 link envelope，状态值只能是 captured / linked / incomplete / missing / historical_gap / contaminated / not_applicable。每条 lane 必须保留 record_ref、producer_ref、validation_ref、missing_required_fields、contaminated_reason 和 not_applicable_reason；lane record 本体必须保留 findings、absorbed issue refs、residual risks、verdict、carrier/fallback 与 freshness。
• 如果 Close 只能看到 prose composite review、旧式 lane paragraph 或旧式 scalar *_ref，必须将对应 lane 标记为 incomplete、missing 或 historical_gap，除非该 ref 可 dereference 为完整 worktrack-composite-lane-record/v1。不得从 closeout prose summary 合成 lane verdict、findings、absorbed issue refs、residual risks 或 validation refs。
• 代码仓库刷新交接 必须同时填充节点策略字段，并说明 expected baseline 与 actual checkpoint 是否匹配
• 重复性上下文（如 worktrack contract 摘要）的唯一合法呈现形式是文件路径引用 [.servo/worktrack/contract.md#section]。内联全文的行为禁止发生
• 如果某个字段无实质内容，唯一合法行为是使用 N/A 或省略。用占位符填充的行为必须被阻断
• Supporting Detail 保留完整内容，只用于后续查阅，不纳入传递上下文

预期输出

使用这个技能时，产出一份至少包含以下章节的 关闭工作追踪报告：

• 收尾触发条件
• 当前收尾阶段
• 已执行的收尾动作
• 权限检查与待审批项
• 代码仓库刷新交接
• 建议下一范围
• 程序员审查请求

结果中至少应包含以下字段或等价表达：

• 子代理模型
• 收尾触发条件
• 当前工作追踪
• 收尾前阶段
• 收尾后阶段
• 关卡判定
• 合并请求状态
• baseline_branch
• branch_source_ref
• worktrack_branch
• integration_target_ref
• closeout_target_ref
• checkpoint_base_ref
• PR target
• merge target
• 合并状态
• 清理状态
• 已执行动作
• 待审批动作
• 决定性证据
• 残留风险
• 代码仓库刷新就绪
• 代码仓库刷新交接
• closeout_record
• closeout_evidence_bundle
• closeout_evidence_bundle_ref
• closeout_bundle_status
• 节点类型
• 基线策略
• checkpoint_policy_match
• 建议下一范围
• 建议下一动作
• 需要程序员审批
• 如何审查

资源

使用本轮收尾所需的最小 WorktrackScope 产物，以及当前分支、合并请求、合并状态和代码仓库刷新交接上下文。