Menü
当工作追踪需要把已验证实现事实追平到正确文档层，减少后续开发引用过期上下文时，使用这个技能。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
当需要运行 Harness 分层闭环控制系统时，使用这个技能。它是 Codex 中顶层监督控制器的入口，负责状态估计、算子选择、技能绑定、子代理分派、证据收集、裁决与状态更新，而不是直接执行编码。
当 Harness 系统尚未初始化，或 `.servo/goal-charter.md` 不存在，需要初始化 repo 级 Goal Charter 与 Harness 控制面时，使用这个技能。
当 Harness 处于 WorktrackScope.closing，且需要一轮限定范围的收尾处理来处理合并请求、合并、清理与代码仓库刷新交接，同时不能悄悄越过审批边界时，使用这个技能。
当 Harness 处于 WorktrackScope.dispatching，且需要一轮不扩大范围的限定范围分派来选择专用技能或执行载体时，使用这个技能。
当 Harness 处于 WorktrackScope.judging，且需要基于现有证据完成一轮限定范围关卡判定，而不重新执行工作或刷新代码仓库状态时，使用这个技能。
当 Harness 处于工作追踪范围.验证中，且需要一轮限定范围的审查证据流程来收集并综合审查发现、但不输出最终关卡判定结果时，使用这个技能。
| name | worktrack-doc-catch-up-skill |
| description | 当工作追踪需要把已验证实现事实追平到正确文档层，减少后续开发引用过期上下文时，使用这个技能。 |
本技能是 Harness 执行平面的文档追平 worker。它负责在每个 worktrack 的实现或验证事实稳定后，把事实同步到正确的长期文档层，减少后续开发因为引用旧文档、旧计数、旧路径或旧操作流程导致的错误。
本技能只追平已经验证的事实；写入 docs/ 的内容仅限已验证事实；推测、计划或未通过验证的中间结论必须在输出中显式暴露并标记为待验证，留待后续验证通过后再追平。本技能的输出是文档基线对齐；设计、review、gate 或 repo-goal 变更必须路由到对应专用技能。
它也负责 version fact sync：当 package 版本、approval lock、CLI 版本输出、npm dist-tag、registry artifact 或 GitHub Release 事实发生变化时，把已验证版本事实同步到 release/channel/testing/usage 文档，并明确哪些入口不需要更新。
当满足以下任一条件时使用：
--version 输出或 GitHub Release 事实latest / next / canary、published version、gitHead 和 tarball 事实写回治理文档不适用于：
repo-change-goal-skill 修改 Repo 级目标worktrack-gate-skill 做最终放行判断调用本技能时，任务 Prompt 至少应包含：
已验证事实触及实现或配置可能过期的文档范围应同步的 truth layer不应同步的内容验证证据完成信号如果任务是 version fact sync，Prompt 还应包含：
source version facts：root/package package.json、approval lock、CLI --version、release tagvcs tracking facts：git branch、commit SHA、tag、remote refpublished version facts：npm view servo-installer dist-tags --json，以及相关 npm view servo-installer@<tag-or-version> version gitHead dist.tarball --jsonrelease evidence：GitHub Release、publish workflow run、npx/package smoke 结果doc update decision：哪些根入口、governance、testing、usage-help 文档需要更新，哪些不需要更新及理由默认 truth layer：
product/ 或 toolchain/docs/、product/ 和 toolchain/；长期事实写入 .agents/、.claude/、.nav/ 的行为必须返回 blockedsource version、published version 和 docs freshness，再更新对应文档；version fact 的输出只能映射到对应的权威来源：本地 candidate 只能出现在 source version 字段中，registry artifact 只能出现在 published version 字段中，registry fact 只能写入已复核的页面；把本地 candidate 写成 registry artifact 或把 registry fact 写进未复核页面的行为必须返回 blocked。updated / last_verified，仅限本轮实际复核过的文档。版本事实同步是本技能的专用模式，触发时机固定在这些节点：
harness entry observation：harness-skill 启动一轮控制回路时，如发现 package/release/VCS 文档事实与当前代码或 registry 证据可能不一致，先记录 freshness risk，并在不阻塞主流程的前提下排入文档追平任务。pre-publish readiness：approval lock 或 package version 变更后，publish 前确认 root README、release channel、pre-publish、testing/usage docs 没有指向旧 selector 或旧行为。post-publish verification：publish workflow 成功并完成 registry 查询后，更新 registry fact、dist-tag、published version、gitHead、tarball URL 和后续 immutable version 约束。post-smoke closeout：registry npx / local .tgz smoke 通过后，必要时更新 testing docs 的 selector、命令矩阵或 pass criteria。harness closeout：harness-skill 命中 handback/closeout 前，若本轮触碰 release、deploy、adapter、package、VCS baseline 或 operator-facing docs，必须调用本技能确认文档版本事实已追平。release rollback / failed publish：只记录已验证失败事实和恢复边界；published fact 字段仅接受 registry 查询或已验证 release 输出的值；把未发布 candidate 写入 published fact 字段的行为必须返回 blocked。推荐证据命令：
git status --short --branch
git rev-parse HEAD
git describe --tags --always --dirty
npm view servo-installer dist-tags --json
npm view servo-installer@latest version gitHead dist.tarball --json
npm view servo-installer@next version gitHead dist.tarball --json
npx servo-installer --version
同步目标通常包括：
文档质量审查是本技能的只读审查子模式，用于在 Milestone 验收或定期维护中发现文档质量问题。它不影响实现代码，不写入文档。
milestone-status-skill 的 doc_freshness_warning 触发）stale-frontmatter worktrack 完成后）Stale frontmatter 检测：
docs/ 下所有正文 .md 文件的 last_verified 字段last_verified 未更新，标记为 frontmatter_driftBroken link 扫描：
docs/ 下所有 .md 文件中的相对链接和引用格式，验证目标文件和章节是否存在AGENTS.md、INDEX.md、docs/README.md 中的路由链接做重点检查中英文表达一致性检查：
docs/）。error（阻断性问题，如关键入口死链）、warning（非阻断，如 stale frontmatter）、info（建议性）。review_scope：审查范围stale_frontmatter：{ file, last_verified, days_stale, severity }broken_links：{ source_file, target, reason, severity }language_consistency：{ file, issue_type, description, severity }total_errors / total_warnings / total_infosrecommendations：建议修复动作info 或 warning，不做 auto-fix。遵循本包内最小公共约束 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 保持限定范围，避免不必要的全仓重发现。
docs/、product/ 和 toolchain/；在 .agents/、.claude/ 或 .nav/ 写入长期事实的行为必须返回 blocked。剩余文档风险 返回。last_verified；更新未实际复核过的 last_verified 的行为必须返回 blocked。latest、next 或 canary 的 dist-tag 变更写进 release docs 才合法；否则必须将 dist-tag 信息标记为 证据缺失 并阻塞写入。使用本技能时，返回一份 文档追平报告，至少包含：
已验证事实文档同步范围已更新文档未同步内容验证结果返回 Harness字段至少包括：
truth layer引用的验证证据旧上下文清理version fact sync（如适用：source version、published version、VCS tracking facts、docs freshness、未更新文档及理由）剩余文档风险建议下一动作使用当前 worktrack 的实现 diff、验证命令输出、AGENTS.md、docs/README.md、docs/project-maintenance/README.md、docs/harness/README.md 和相关承接层文档作为输入。