用途:对已有旧 llmwiki(case B)或已有 harness(case C)的项目,一条命令完成 harness 栈(L0–L4)的安装/更新,并自动替用户补还 wiki 遗留欠账。触发词包括 self-maintain、migrate harness、update harness、/harness-update 等。不适用于尚无内容、需从代码生成 wiki 的项目(case A,应改用 /new-project-setup),也不处理网络、python3、validator 等基础设施故障。
主要能力:installer 以 --self-heal 在单个进程内完成安装 L0–L4、审计(Origin/index/OKF 合并为一次 audit.py)、自动 backfill(Origin 用一次 git log 取哈希、index 补缺失行、OKF 将粗体 Type: 迁移为 YAML)、再审计一次、activate 与 smoke。补还只做新增,绝不修改或删除已有 wiki 内容,也不触碰 raw/。
使用方式:按项目布局选择命令。dot 布局(含 .llmwiki/.harness-stamp)应运行 bootstrap:curl -fsSL https://raw.githubusercontent.com/Rheinmir/setup/orca/harness/poc-vendor-neutral/bootstrap.sh | bash;在带 pty 的终端可加 -s -- --with-graph 跳过 60 秒检查清单。旧式裸布局(llmwiki/ 与 harness/ 在项目内、无 stamp)使用:test -f harness/scripts/install-harness.sh && bash harness/scripts/install-harness.sh . --self-heal || { git clone -q --depth 1 -b orca git@github.com:rheinmir/setup.git /tmp/llmwiki-tpl && bash /tmp/llmwiki-tpl/harness/scripts/install-harness.sh . --self-heal ; rm -rf /tmp/llmwiki-tpl; }。framework 仓库不运行 installer,更新用 git pull。
退出码与限制:rc=0 表示干净;rc=3 表示仍有 self-heal 无法自动处理的欠账,需按输出列表手动修一次后重跑;其他 rc(1/4)为基础设施错误,应停止并原样告知用户,不要自行猜测或修复。不带 --self-heal 时行为与旧版一致(审计后若有欠账退出 3),保持向后兼容。完成后可运行 python3 ~/.claude/harness/hooks/build-capabilities.py --root . 刷新 CAPABILITIES.md(旧版无此文件则跳过),可选 /health-check 验证,并向 llmwiki/wiki/log.md 追加日志。报告需含:运行模式与 backfill 数量、settings root 的 .bak.* 备份、提示新会话才会加载新 hooks、建议 /harness-tour。