vibe-skills-gov-patterns

name	vibe-skills-gov-patterns
description	用于吸收 Vibe-Skills / VCO 一类大规模 skill OS 仓的治理精华，而不直接照搬其运行时。 当用户提到 Vibe-Skills、VCO、skill sprawl、promotion gate、replay ledger、M/L/XL 路由、proof bundle、workspace memory plane 时触发。
tags	["skills","governance","routing","promotion","memory"]
version	1

目标

• 吸收外部 skill OS 的治理方法，不引入第二控制面。
• 让 Hermes 在 skill 数量增长后，仍保持低冲突、可验证、可冻结。

何时用

• 用户要研究或吸收 Vibe-Skills / VCO / 类 skill operating system 仓。
• 需要设计 skill promotion / freeze / destructive gate。
• 需要把“大量 skills 如何不互撞”落入 Hermes 路由与治理。

默认立场

1. Learn + Absorb，非 direct-install。
2. 先做安全审查，再决定是否隔离安装。
3. 不把外部 runtime 当 Hermes 第二 orchestrator。
4. 只吸收能降低未来 steering 的治理件。

高价值可迁移件

1. Primary route first

   • 先选一条主路由，再让 specialist 只在阶段内介入。
   • 避免多个同类 skill 同时争抢控制权。

2. Route 后再定执行级别

   • 先决定“谁负责”，再决定 M / L / XL。
   • Hermes 可对应为：单代理 / 多步串行 / 可并行子任务。

3. Promotion metadata

   • 至少记录：promotion_eligible、contract_complete、destructive、snapshot_required、rollback_possible。
   • 没这些字段，不要谈自动 promotion。

4. Replay-ledger-first

   • 没有 replay / evidence ledger 的 adaptive routing 建议，不进入 promotion 讨论。
   • 先有证据，再有升格。

5. Destructive prompt gate

   • 对 delete / overwrite / reset / purge 类提示，单独打 destructive 标签。
   • destructive 命中时，不走无提示自动派发。
   • 需要确认、快照、回退条件三件套。

6. Proof bundle / execution manifest

   • done 不能只靠自然语言。
   • 要有测试、产物、验证路径、执行摘要等可检查证据。

7. Workspace memory plane

   • 可吸收“单控制面 + workspace 共享记忆”的思想。
   • 但 Hermes 内必须保持 memory truth source 单一，不许第二 orchestrator 抢 authority。

Hermes 落地规则

• 路由层：
  • 一个主 skill 负责总流程。
  • specialist 仅作为阶段/单元辅助，不夺全局调度权。
• 治理层：
  • promotion 必须 evidence-backed。
  • destructive 默认保守。
  • good skill freeze；middling 渐进修；bad 立即 patch 或停用。
  • 若先做轻量实现，优先把 promotion ledger 挂到现有安装/锁文件面，而非先造新运行时。
    • 在 Hermes 当前代码中，优先落点是 tools/skills_hub.py 的 HubLockFile.record_install()。
    • 先记录 eligible、proof_bundle_required、destructive_prompt_gate、source_origin、recorded_at 即可。
    • 这些值应从 skill metadata 派生，如 origin_repo、promotion_ledger_required、proof_bundle_required、destructive_prompt_gate。
  • 配套测试优先补四类：
    1. guard 不误杀 replay ledger / destructive gate / workspace memory plane 等治理词
    2. skills index / meta dict 保真 agent-created trust level
    3. quarantine -> install -> lock file 路径上，promotion ledger 与 metadata 一并持久化
    4. CLI surfaced 面要能看见 ledger；至少补 hermes skills list 与 hermes skills audit 的断言
  • CLI 最小落地顺序：
    1. hermes_cli/skills_hub.py::do_list() 增一列 Promotion
    2. hub skill 若有 ledger，显示 ledger / proof / destructive 三类短标签
    3. do_audit() 在 scan report 前打印 Promotion Ledger 与 Promotion Source
  • 测试实现时的经验坑：
    • CLI 层常是函数内局部 import；打桩时既要 patch tools.skills_hub，也可能要 patch hermes_cli.skills_hub 当前模块名下符号
    • Path.exists() 若挡住 audit 路径，可在隔离测试里临时 monkeypatch；否则只会看到 path missing 警告
    • Rich 输出会自动换行，断言长串时宜拆成多个短断言，而非整行精确匹配
• 记忆层：
  • workspace memory 只做辅助读取/写入面。
  • 用户显式指令 > repo truth > memory policy > candidate advice。

不该照搬的东西

• 直接改写真实 host root 的安装器。
• 第二套 runtime authority。
• 未清洗即导入的上游 contract 名词与巨型 policy 面。
• 用“live degraded result”继续冒充完成。

实操顺序

1. 读 README / install path / governance config。
2. 找 host-root 写入点、upgrade/reset/uninstall 面。
3. 抽取 route / promotion / freeze / destructive / memory 五件套。
4. 只把能在 Hermes 中机械执行的部分写入路由、skill、tests。
5. 若要新增治理规则，先补测试，再补实现。

验收

• 是否减少 skill 冲突？
• 是否让 promotion 更可证？
• 是否把 destructive 动作挡在更早处？
• 是否未引入第二控制面？
• 是否有 repo artifact / test 证明变更？

已知对 Vibe-Skills 的本机结论

• 适合吸收治理。
• 不适合默认直装到真实 ~/.codex / ~/.claude。
• 其测试面暴露过 promotion metadata、freeze gate、macOS /private/var 路径一致性问题；故只取方法，不取现成运行面。