用途:health-check 用于回答关于“标准模式”集合(在 .template-manifest.json 中声明的文件)的三个问题:模式是否齐全(MISSING)、本地是否被修改(DRIFT)、远端是否有更新版本(BEHIND/NEEDS-SYNC)。它不执行文件拉取或推送,那是 /sync-template 的职责;也不检查 wiki 内容(如断链、孤立、过期),那由 harness/scripts/wiki-health.py 负责。
主要能力:以 harness/version.json 为版本唯一来源,保存 template_version 与各模式哈希,通过对比磁盘、version.json 与远端 version.json 得出每个模式的状态:OK、DRIFT、NEEDS-SYNC,并给出建议动作。报告还包含一行 OKF v0.1 检查结果,显示概念是否达到标准。
使用方式:运行 python3 harness/scripts/health-check.py --root . --branch orca。可选参数:--offline 仅检查本地;--json 输出机器可读结果;--fail-on behind,drift,missing 在指定组违规时以退出码 2 结束,用于 CI 门禁。同步后刷新指纹:python3 harness/scripts/health-check.py --update;仅在模板仓库发布新版本时使用 --update --bump patch(major/minor/patch)。
适用场景:会话开始时自动运行(SessionStart hook);用户手动调用 /health-check;在决定是否运行 /sync-template 之前。
限制:网络错误或缺少 version.json 时采取 fail-open,只报告本地部分,不阻塞会话;DRIFT 不明确是改进还是误改时需先与用户确认;--bump 只能在模板仓库 Rheinmir/setup 使用,子项目只能 --update;新增模式需先加入 .template-manifest.json 的 includes,再执行 --update。