Menu
当 Harness 在工作追踪收尾后回到代码仓库范围，并需要一轮限定范围的代码仓库刷新外加一份已验证的回写交接时，使用这个技能。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
当需要运行 Harness 分层闭环控制系统时，使用这个技能。它是 Codex 中顶层监督控制器的入口，负责状态估计、算子选择、技能绑定、子代理分派、证据收集、裁决与状态更新，而不是直接执行编码。
当 Harness 系统尚未初始化，或 `.servo/goal-charter.md` 不存在，需要初始化 repo 级 Goal Charter 与 Harness 控制面时，使用这个技能。
当 Harness 处于 WorktrackScope.closing，且需要一轮限定范围的收尾处理来处理合并请求、合并、清理与代码仓库刷新交接，同时不能悄悄越过审批边界时，使用这个技能。
当 Harness 处于 WorktrackScope.dispatching，且需要一轮不扩大范围的限定范围分派来选择专用技能或执行载体时，使用这个技能。
当 Harness 处于 WorktrackScope.judging，且需要基于现有证据完成一轮限定范围关卡判定，而不重新执行工作或刷新代码仓库状态时，使用这个技能。
当 Harness 处于工作追踪范围.验证中，且需要一轮限定范围的审查证据流程来收集并综合审查发现、但不输出最终关卡判定结果时，使用这个技能。
| name | repo-refresh-skill |
| description | 当 Harness 在工作追踪收尾后回到代码仓库范围，并需要一轮限定范围的代码仓库刷新外加一份已验证的回写交接时，使用这个技能。 |
本技能实现 RepoScope.Close（refresh-repo-state）状态转移算子，对应 Harness 控制回路中的状态更新阶段。
它是 Worktrack 闭环的终点和 Repo 闭环的起点：在 Worktrack 关闭（merge → cleanup）后，必须回到 RepoScope 刷新 repo snapshot，才能让 Repo 的慢变量被真实更新。这是完整控制回路的关键闭合环节。
它从已验证证据刷新代码仓库级真相。代码仓库真相产物的写入前提是经过 Gate 验证；未经验证的结论不得写入代码仓库真相产物。
它与 close-worktrack-skill 的关系：close-worktrack-skill 处理 WorktrackScope 的 Close（PR → merge → cleanup），而 repo-refresh-skill 处理回到 RepoScope 后的状态更新。
当 Harness 完成了一轮 工作追踪范围 收尾，并需要根据已验证证据刷新代码仓库级慢变量时，使用这个技能。
这个技能会为 通用高能力模型 SubAgent 打包一轮限定范围的收尾后刷新，更新代码仓库级评估，并返回一份供程序员审批的结构化回写交接结果，而不是假设代码仓库真相已经被更新。
这个技能只负责代码仓库级回写。它不会维护、修补或重新打开工作追踪本地 .servo/worktrack/* 产物。
它的主要刷新依据是：
关卡证据代码仓库目标/章程代码仓库快照/状态Harness 控制状态已关闭的工作追踪产物只是已完成切片的辅助证据。它们本身不是代码仓库级真相层，仅当有经过验证的证据支撑时，直接向上抄写才合法；否则必须声明证据缺失并阻塞该写入路径。
当需要根据那次已验证收尾刷新代码仓库级真相时，使用这个技能：
关卡证据 可用且已经建立了已验证结果代码仓库快照/状态 现在需要慢变量刷新Harness 在决定下一个代码仓库动作前需要限定范围的代码仓库刷新结果代码仓库目标/章程、当前 代码仓库快照/状态、当前 Harness 控制状态，以及刚刚关闭的工作追踪的已验证 关卡证据。通用高能力模型 SubAgent 构建一份 代码仓库刷新任务简报 和一份 代码仓库刷新信息包。baseline_branch、branch_source_ref、worktrack_branch、integration_target_ref、closeout_target_ref、checkpoint_base_ref、PR target、merge target 与 checkpoint 基准；这些值的唯一合法来源是原始 Worktrack Contract 的 Branch Policy 字段。baseline_branch 表示 servo-managed final baseline；Milestone-derived worktrack 的直接 checkpoint/merge target 通常是 closeout_target_ref 指向的 Milestone branch。从当前分支名或写死默认分支名推断的行为必须返回 blocked。closeout_evidence_bundle_ref、closeout_bundle_status 和 dispatch_provenance_summary。该 summary 必须 lossless carry dispatch_provenance.status、runtime_dispatch_record_ref、subagent_dispatch_record_refs、missing_dispatch_record_refs、raw dispatch_result_status 与 resolved_runtime_dispatch_status。如果传入字段缺失、bundle 不可读、record ref 无法 dereference，必须保留为 missing / incomplete / historical_gap / contaminated；不得从 closeout prose summary 合成 dispatch evidence。代码仓库目标/章程、当前 代码仓库快照/状态 和已验证收尾证据刷新代码仓库级评估。.servo/repo/worktrack-backlog.md（若 backlog 不存在则创建）。status 按以下映射从 gate verdict 转换后写入：gate pass/merge success → done，gate blocked → blocked，deferred decision → deferred，superseded/resolved → resolved。按 worktrack_id upsert：若同一 worktrack_id 已存在则更新（覆盖旧状态），否则追加新条目。milestone_id 按以下优先级获取：Worktrack Contract frontmatter milestone_id → close handoff 引用 → null（无绑定）。intake_route 按以下优先级获取：Worktrack Contract frontmatter → close handoff 中的 append request 引用 → "direct" fallback。此步骤对每个已验证关闭的 worktrack 无条件执行。若回写条目包含 closeout evidence refs，必须把第 4 步的 provenance 字段作为结构化字段转交给 repo-writeback-skill，不得只写 prose notes。worktrack_list 中；若在列表中，标记 Milestone progress counter 需要由 milestone-status-skill 在下一轮 Observe 中更新。
8b. Milestone Backlog 刷新：若已关闭 worktrack 携带 milestone_id，读取 live .servo/repo/milestone-backlog.md，在该 milestone 的 worktrack_list 中标记对应 worktrack 完成。不修改 milestone status（该职责属于 harness-skill 在收到 milestone-status-skill 输出后的状态更新阶段）。若 milestone 已在 .servo/repo/milestone-history.md 中，只有在修正 completed/superseded 历史记录的 stale worktrack marker 时才可更新 history，且必须保留 status 为 completed/superseded。代码仓库刷新报告 加一份 已验证回写交接。遵循本包内最小公共约束 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 保持限定范围，避免不必要的全仓重发现。
工作追踪约定 和 计划/任务队列 的输出角色仅限于工作追踪本地执行记录；将其当成代码仓库回写目标的行为禁止出现。dispatch_provenance.status、refs、raw dispatch_result_status 与 resolved_runtime_dispatch_status；无法读取时必须标记缺口状态，不能合成 delegated、current_carrier_fallback、permission_blocked、runtime_gap、dispatch_package_unsafe、blocked 或 historical_gap 结论。代码仓库刷新报告，确保所有刷新评估信息被记录Control Signal 层（影响下一动作决策的关键结论）基线验收状态 必须显式评估 incoming checkpoint 的可追溯性N/A 或省略；用占位符填充的行为必须返回 blocked。Supporting Detail 保留完整内容，只用于后续查阅，不纳入传递上下文每次运行这个技能时，都使用同一套限定范围约定格式。
触发条件目标已关闭工作追踪范围内范围外约束回写目标完成信号当前代码仓库状态参与中的代码仓库产物关卡证据摘要已接受变更摘要验证结果基线验收状态
baseline_branch: 从 close handoff 接收，原始来源必须是 Worktrack Contract.baseline_branchbranch_source_ref: 从 close handoff 接收，原始来源必须是 Worktrack Contract.branch_source_refworktrack_branch: 从 close handoff 接收，原始来源必须是 Worktrack Contract.worktrack_branchintegration_target_ref: 从 close handoff 接收，原始来源必须是 Worktrack Contract.integration_target_refcloseout_target_ref: 从 close handoff 接收，原始来源必须是 Worktrack Contract.closeout_target_refcheckpoint_base_ref: 从 close handoff 接收，原始来源必须是 Worktrack Contract.checkpoint_base_refpr_target: 本轮 PR targetmerge_target: 本轮 merge targetincoming_checkpoint_ref: 从 close-worktrack 交接接收的基线引用checkpoint_verified: yes / no / deferredbaseline_gap_risk: 如果基线不可追溯，标记风险等级（low / medium / high）closed_worktrack_node_type: 已关闭 worktrack 的节点类型expected_baseline_form: close handoff 中声明的预期基线形式actual_baseline_form: 实际 checkpoint 形式merge_required: close handoff 中声明的合并要求checkpoint_policy_match: expected 与 actual 是否匹配closeout_evidence_bundle
closeout_evidence_bundle_refcloseout_bundle_status: complete / incomplete / contaminated / historical_gap / missingdispatch_provenance.status: captured / linked / incomplete / missing / historical_gap / contaminatedruntime_dispatch_record_refsubagent_dispatch_record_refsmissing_dispatch_record_refsdispatch_result_statusresolved_runtime_dispatch_status已知风险所需上下文缺失或推迟项目回写目标已验证发现建议更新证据依据
closeout_evidence_bundle_refcloseout_bundle_statusdispatch_provenance.statusruntime_dispatch_record_refsubagent_dispatch_record_refsmissing_dispatch_record_refsdispatch_result_statusresolved_runtime_dispatch_status推迟项目审批请求使用这个技能时，产出一份至少包含以下章节的 代码仓库刷新报告：
代码仓库刷新触发条件代码仓库刷新评估已验证回写交接推迟或未验证项目建议代码仓库范围下一步程序员审查请求结果中至少应包含以下字段或等价表达：
子代理模型刷新触发条件基准分支baseline_branchbranch_source_refworktrack_branchintegration_target_refcloseout_target_refcheckpoint_base_refPR targetmerge target已关闭工作追踪已关闭工作追踪节点类型checkpoint_policy_match代码仓库状态变化已验证发现快照更新回写目标建议回写证据依据closeout_evidence_bundle_refcloseout_bundle_statusdispatch_provenance.statusruntime_dispatch_record_refsubagent_dispatch_record_refsmissing_dispatch_record_refsdispatch_result_statusresolved_runtime_dispatch_status推迟项目开放风险建议下一代码仓库动作需要程序员回写审批如何审查使用刚关闭的工作追踪对应的已验证 关卡证据、当前 代码仓库目标/章程、当前 代码仓库快照/状态、当前 Harness 控制状态，以及收尾后刷新所需的最小额外代码仓库上下文。读取已关闭的工作追踪产物时，工作追踪产物的输出角色仅限于已验证切片的辅助证据；把它们当成代码仓库真相替代品的行为，或把它们当作工作追踪维护目标的行为禁止出现。