一键导入
worktrack-gate-skill
当 Harness 处于 WorktrackScope.judging,且需要基于现有证据完成一轮限定范围关卡判定,而不重新执行工作或刷新代码仓库状态时,使用这个技能。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
菜单
当 Harness 处于 WorktrackScope.judging,且需要基于现有证据完成一轮限定范围关卡判定,而不重新执行工作或刷新代码仓库状态时,使用这个技能。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
当需要运行 Harness 分层闭环控制系统时,使用这个技能。它是 Codex 中顶层监督控制器的入口,负责状态估计、算子选择、技能绑定、子代理分派、证据收集、裁决与状态更新,而不是直接执行编码。
当 Harness 系统尚未初始化,或 `.servo/goal-charter.md` 不存在,需要初始化 repo 级 Goal Charter 与 Harness 控制面时,使用这个技能。
当 Harness 处于 WorktrackScope.closing,且需要一轮限定范围的收尾处理来处理合并请求、合并、清理与代码仓库刷新交接,同时不能悄悄越过审批边界时,使用这个技能。
当 Harness 处于 WorktrackScope.dispatching,且需要一轮不扩大范围的限定范围分派来选择专用技能或执行载体时,使用这个技能。
当 Harness 处于工作追踪范围.验证中,且需要一轮限定范围的审查证据流程来收集并综合审查发现、但不输出最终关卡判定结果时,使用这个技能。
当 Harness 处于工作追踪范围,且需要一轮限定范围验证来针对验收标准与验证要求收集测试证据时,使用这个技能。
| name | worktrack-gate-skill |
| description | 当 Harness 处于 WorktrackScope.judging,且需要基于现有证据完成一轮限定范围关卡判定,而不重新执行工作或刷新代码仓库状态时,使用这个技能。 |
本技能实现 WorktrackScope.Judge 状态转移算子,对应 Harness 控制回路中的裁决阶段。它负责基于三个正交校验面(implementation/validation/policy)的证据,判断"当前状态是否允许推进",生成 verdict 并决定允许的下一路由。
本 gate 基于三个正交校验面(implementation/validation/policy)的证据做裁决,不直接消费 Self-Review Record 和 Single-Acceptance Verdict。
注意:Self-Review Record 和 Single-Acceptance Verdict 由
worktrack-close-skill在 Close 阶段的 pre-closeout checks 中产出,并被 Close 阶段内的 Closeout Gate(非本 Worktrack Gate)消费。详见harness-skill的 closeout pipeline section。
当 Harness 已经掌握当前轮次的证据,并需要在 WorktrackScope.judging 内完成一轮限定范围判定时,使用这个技能。
这个技能会为一轮 通用高能力模型 SubAgent 打包最小关卡上下文,评估当前证据维度,推导当前 实现/验证/策略 判定层面,吸收限定范围的低严重度噪声,并返回结构化判定结果与允许的下一步路由。
当需要基于本轮证据判定通过、失败或停止时,使用这个技能:
Harness 需要基于现有产物得到当前轮次的关卡判定结果集成、恢复 或继续阻塞之间做出选择工作追踪 的限定范围内WorktrackScope 产物和当前维度证据。通用高能力模型 SubAgent 构建一份 关卡任务简报 和一份 关卡信息包。审查测试策略updated_files_or_artifacts 与 post_update_validation_timestamp 已在更新后证据中出现。task_producing_subagent 与 review_acceptance_subagent 的 evidence_provenance 已分开记录;producer_carrier_ref 不得被复用为独立的 review_carrier_ref / acceptance_carrier_ref,除非证据显式标记 current-carrier fallback 并给出机器可检查 fallback_reason_code。实现关卡验证关卡策略关卡实现关卡 接收 review evidence 时,必须确认审查维度是否覆盖代码性能、Repo 架构、代码安全、代码质量与测试 review;对当前变更不适用的维度,应接收明确的 不适用 理由。P2/P3 残留到 残留风险 中,除非它跨越升级围栏可能存在上游约束问题,判定纯代码修复路径是否不再有效通过软失败硬失败阻塞关卡报告,其中包含维度接收情况、决定性证据、缺失证据和允许的下一步路由;有需要时,让结果与 templates/gate-evidence.template.md 保持一致。P2/P3,默认保留在 残留风险 中,只要它们没有在任一层面破坏验收、恢复路径安全、面向操作员的语义,或约定完整性。软失败 或 硬失败:
实现/验证/策略 中至少两个层面可能存在上游约束问题 的决定性发现,或者两个及以上发现指向同一个尚未解决的约定、边界或治理依赖,那么 建议下一路由 的唯一合法方向是非纯代码修复路径(如规则检查、约定修订、恢复重新定界)。纯代码修复的建议路由必须被阻断。规则检查、约定或文档修订,或 恢复工作追踪 重新定界,再去要求更多实现层反复修改。根据 Worktrack Contract 中的 Node Type 调整判定严格度:
优先级:Worktrack Contract 中显式填写的 gate_criteria 优先;Node Type Registry 只提供默认标准。若 gate_criteria 缺失,才按节点类型默认规则推导,并在关卡报告中记录 fallback 理由。
feature 节点:三个层面全部通过才允许推进refactor 节点:实现层面允许"无新增 surface",验证层面必须全部通过research 节点:只要求 review 层面通过,validation 层面为可选;产出不可合并时 gate 标准自动降级bugfix 节点:实现 + validation 必须通过,policy 层面允许"修复性例外"docs 节点:review + policy 通过即可config 节点:validation 层面必须覆盖配置正确性,policy 层面覆盖规则合规test 节点:validation 层面为核心,implementation 层面为辅助如果 Node Type 未定义,使用默认判定标准(三个层面全部通过)。
每次运行这个技能时,都使用同一套限定范围约定格式。
触发条件目标当前工作追踪当前轮次范围内范围外判定选项判定规则完成信号所需证据维度task_producing_subagentreview_acceptance_subagentproducer_carrier_refreview_carrier_refacceptance_carrier_refevidence_provenancefallback_reason_code节点类型适用 gate_criteria证据维度当前工作追踪状态工作追踪约定摘要与判定相关的队列状态实现证据五类审查覆盖验证证据策略证据低严重度发现摘要上游约束信号已知缺口或冲突所需上下文实现关卡验证关卡策略关卡SubAgent role / mode provenancereview_dimensions: performance / architecture / security / quality / tests节点类型适用 gate_criteria节点类型 fallback整体判定结果整体置信度整体置信度理由决定性证据缺失或冲突证据时效性阻塞项残留风险已应用低严重度吸收低严重度吸收理由需要上游路由路由理由允许的下一路由建议下一路由需要审批审批范围审批理由审批请求关卡报告,确保所有证据维度和判定依据被记录Control Signal 层(影响下一动作决策的关键结论:整体判定结果、允许的下一路由、需要审批)Supporting Detail 层N/A 或省略。用占位符填充的行为必须被阻断Supporting Detail 保留完整内容,只用于后续查阅,不纳入传递上下文遵循本包内最小公共约束 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 保持限定范围,避免不必要的全仓重发现。
本技能特有约束:
task_producing_subagent 与 review_acceptance_subagent 的 provenance 分离。缺少 producer_carrier_ref、review_carrier_ref / acceptance_carrier_ref 或 evidence_provenance 时,必须暴露为缺失证据;相同 carrier 只能作为 current-carrier fallback 接收,且必须有 fallback_reason_code(runtime_gap、permission_blocked、coupling_or_shared_state、dispatch_package_unsafe、not_applicable)。SubAgent-first 是条件偏好,不是 Gate 可硬编码的放行条件。Gate 只能检查 runtime_supports_subagent、permission_allows_delegation、dispatch_package_safety、task_coupling、state_sharing_need、risk_profile、context_budget_fit 和 fallback_reason_code 是否被证据记录;不得因未委派而自动失败,除非缺少合法 fallback reason。软失败 或 硬失败 才合法。停留在单一层面且未形成威胁的低严重度发现必须保留在残留风险中,仅凭数量升级的行为必须被阻断。可能存在上游约束问题 是决定性或重复出现时,建议路由的唯一合法方向是向上游路由(规则检查、约定修订或恢复重新定界)。建议纯实现重试的行为必须被阻断。证据维度 已经承载了维度封套时,唯一合法的字段结构是保持维度的封套层级。将审查/测试接收扩张成新的平铺顶层字段的行为必须被阻断。updated_files_or_artifacts 非 none,但缺少更新后的 post_update_validation_timestamp,或 validation and acceptance evidence 早于更新,整体判定不得输出可用于最终验收的通过结论,必须暴露为时效性阻塞并返回验证/验收重跑。使用这个技能时,产出一份至少包含以下章节的 关卡报告:
关卡触发条件维度接收摘要证据评估分层面判定结果整体关卡判定结果允许的下一路由程序员审查请求结果中至少应包含以下字段或等价表达:
子代理模型关卡触发条件当前工作追踪当前轮次所需证据维度证据维度SubAgent role / mode provenance实现关卡验证关卡策略关卡五类审查覆盖接收整体判定结果整体置信度整体置信度理由决定性证据缺失或冲突证据时效性阻塞项updated_files_or_artifactspost_update_validation_timestamp残留风险已应用低严重度吸收低严重度吸收理由需要上游路由路由理由允许的下一路由建议下一路由需要审批审批范围审批理由需要程序员审批如何审查当你需要本轮稳定的关卡报告草稿格式时,使用当前轮次的维度证据切片、工作追踪约定 和 templates/gate-evidence.template.md。把模板当成展示辅助,而不是数据模型的真相来源。