메뉴
当 Harness 处于 WorktrackScope.closing，且需要一轮限定范围的收尾处理来处理合并请求、合并、清理与代码仓库刷新交接，同时不能悄悄越过审批边界时，使用这个技能。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
当需要运行 Harness 分层闭环控制系统时，使用这个技能。它是 Codex 中顶层监督控制器的入口，负责状态估计、算子选择、技能绑定、子代理分派、证据收集、裁决与状态更新，而不是直接执行编码。
当 Harness 系统尚未初始化，或 `.servo/goal-charter.md` 不存在，需要初始化 repo 级 Goal Charter 与 Harness 控制面时，使用这个技能。
当 Harness 处于 WorktrackScope.dispatching，且需要一轮不扩大范围的限定范围分派来选择专用技能或执行载体时，使用这个技能。
当 Harness 处于 WorktrackScope.judging，且需要基于现有证据完成一轮限定范围关卡判定，而不重新执行工作或刷新代码仓库状态时，使用这个技能。
当 Harness 处于工作追踪范围.验证中，且需要一轮限定范围的审查证据流程来收集并综合审查发现、但不输出最终关卡判定结果时，使用这个技能。
当 Harness 处于工作追踪范围，且需要一轮限定范围验证来针对验收标准与验证要求收集测试证据时，使用这个技能。
| 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 需要一份限定范围报告，说明哪些收尾动作已完成、哪些仍需审批、哪些应回交给 代码仓库范围WorktrackScope 产物，以及与收尾有关的当前分支、合并请求和合并状态证据。通用高能力模型 SubAgent 构建一份 关闭工作追踪任务简报 和一份 关闭工作追踪信息包。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 基准不得从当前分支名或写死默认分支名推断。overall_verdict = blocked，handback 修复后重试，不进入收尾阶段。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 的责任范围）。updated_files_or_artifacts 与 post_update_validation_timestamp，并确认 validation and acceptance evaluation 已在更新后重跑；否则 closeout 阶段阻塞并回到验证/验收重跑。Self-Review → Single-Acceptance → Closeout Gate → 准备合并请求 → PR → Merge → Doc-Catch-Up → Refresh → Cleanup → return RepoScopecloseout_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 替代。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。准备合并请求合并请求已开准备合并已合并文档追平 / doc-catch-up准备清理基线固化 / checkpoint准备代码仓库刷新收尾被阻塞代码仓库刷新技能 的已验证材料关闭工作追踪报告 与一份 代码仓库刷新交接。每次运行这个技能时，都使用同一套限定范围约定格式。
触发条件目标当前工作追踪当前收尾阶段范围内范围外权限边界需要审批完成信号当前工作追踪状态工作追踪约定摘要baseline_branch: 从 Worktrack Contract 读取的 servo-managed final baselinebranch_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_idbranchbase_refhead_refmerge_commitprfiles_changedacceptance_result（应携带 single-acceptance verdict 的 notes 字段，即 accepted_with_notes 的 notes 来源为 single-acceptance 产出的 structured notes，不得凭空构造或丢弃）gate_verdictevidence_refsdecision_refsdocs_updatedsnapshot_refreshedbacklog_updatedcleanup_doneremaining_risksnext_repo_scope_actioncloseout_evidence_bundle
schema_versionself_review_recordsingle_acceptance_verdictworktrack_gate_evidencecloseout_gate_evidencedispatch_provenance
statusruntime_dispatch_record_refsubagent_dispatch_record_refsmissing_dispatch_record_refsdispatch_result_statusresolved_runtime_dispatch_statustask_producing_subagentreview_acceptance_subagentproducer_carrier_refreview_carrier_refacceptance_carrier_refevidence_provenancefallback_reason_codecomposite_lane_records
code_review
statusrecord_reflane_idproducer_refvalidation_refmissing_required_fieldscontaminated_reasonnot_applicable_reasonfeature_completeness
statusrecord_reflane_idproducer_refvalidation_refmissing_required_fieldscontaminated_reasonnot_applicable_reasonrelated_influence
statusrecord_reflane_idproducer_refvalidation_refmissing_required_fieldscontaminated_reasonnot_applicable_reasonintent_completeness
statusrecord_reflane_idproducer_refvalidation_refmissing_required_fieldscontaminated_reasonnot_applicable_reasonoperator_simulation
statusrecord_reflane_idproducer_refvalidation_refmissing_required_fieldscontaminated_reasonnot_applicable_reasonprofessional_review
statusrecord_reflane_idproducer_refvalidation_refmissing_required_fieldscontaminated_reasonnot_applicable_reasonrepo_refresh_checkpointpost_feedback_update_revalidation
updated_files_or_artifactspost_update_validation_timestampvalidation_after_update_statusacceptance_after_update_statuspre_update_final_acceptance_evidence_statusbundle_completenessdispatch_provenance_summary
dispatch_provenance.statusruntime_dispatch_record_refsubagent_dispatch_record_refsmissing_dispatch_record_refsdispatch_result_statusresolved_runtime_dispatch_statuscloseout_evidence_bundle_refcloseout_bundle_status: complete / incomplete / contaminated / historical_gap基准分支baseline_branchbranch_source_refworktrack_branchintegration_target_refcloseout_target_refcheckpoint_base_refPR targetmerge target已接受变更摘要验证结果收尾状态可回写候选node_type: 从 Worktrack Contract 读取的节点类型expected_baseline_form: Contract 中的 baseline_formmerge_required: Contract 中的 merge_requiredactual_baseline_form: 本轮实际形成的 checkpoint 形式checkpoint_policy_match: yes / no / deferredcheckpoint_type: commit / tag / annotated-tag / stash / explicit-declarationcheckpoint_ref: SHA 或 tag 名称或 stash refif_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 保持限定范围，避免不必要的全仓重发现。
关卡通过 的唯一合法含义是允许进入收尾阶段。合并、删除分支或更新代码仓库真相的授权必须通过显式审批获得，关卡通过 不是这些操作的隐式授权。合并、清理分支 或代码仓库回写才合法；否则必须保持等待并暴露缺失的审批项。合并请求已开、已合并 和 代码仓库刷新已完成 是三个独立且递进的状态。合并请求已开 不能等同于 已合并，已合并 也不能等同于 代码仓库刷新已完成——每个状态必须独立验证。repo-refresh-skill。跳过 repo-refresh-skill 直接返回的行为必须被阻断。Repo 慢变量必须通过 repo-refresh-skill 从已验证证据刷新；repo snapshot 在 merge 后自动更新的假设禁止作为跳过刷新步骤的依据。worktrack-doc-catch-up-skill。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。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。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。*_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 是否匹配[.servo/worktrack/contract.md#section]。内联全文的行为禁止发生N/A 或省略。用占位符填充的行为必须被阻断Supporting Detail 保留完整内容，只用于后续查阅，不纳入传递上下文使用这个技能时，产出一份至少包含以下章节的 关闭工作追踪报告：
收尾触发条件当前收尾阶段已执行的收尾动作权限检查与待审批项代码仓库刷新交接建议下一范围程序员审查请求结果中至少应包含以下字段或等价表达：
子代理模型收尾触发条件当前工作追踪收尾前阶段收尾后阶段关卡判定合并请求状态baseline_branchbranch_source_refworktrack_branchintegration_target_refcloseout_target_refcheckpoint_base_refPR targetmerge target合并状态清理状态已执行动作待审批动作决定性证据残留风险代码仓库刷新就绪代码仓库刷新交接closeout_recordcloseout_evidence_bundlecloseout_evidence_bundle_refcloseout_bundle_status节点类型基线策略checkpoint_policy_match建议下一范围建议下一动作需要程序员审批如何审查使用本轮收尾所需的最小 WorktrackScope 产物，以及当前分支、合并请求、合并状态和代码仓库刷新交接上下文。