用途:该技能用于从终端手动调用 dym 验证器(validator),确认规则确实生效,并获取确切退出码,以便在脚本或 CI 中按码分支,而不是靠猜测 0/1。它不生成文件,只把违规信息打印到 stderr 并以对应退出码结束。可通过 /dym-setup guardrail-cli 调用,若已单独 symlink 也可直接 /dym-setup-guardrail-cli。
主要能力与调用方式:一个二进制三种模式,命令形式为 python3 .harness/poc-vendor-neutral/bin/llmwiki-validate.py [--policy P] {path <FILE> | files <F...> | claude-hook}。path 读取一个路径、应用 repo 层规则、违规退出码 2;files 读取多个路径、repo 层、退出码 1;claude-hook 从 stdin 读取 Claude hook 的 JSON、session 层、退出码 2。--policy P 可指向其他策略,默认使用二进制同级目录的 policy.yaml。同一违规在不同模式下退出码不同是代码本身的设计(path/claude-hook 为 2,files 为 1),按码分支的脚本必须清楚自己调用的是哪个模式。
规则集:资料称从 policy.yaml 计得 19 条规则 R1–R19,enforce_at 分 session(agent 写入时经 hook 拦截)与 repo(commit/PR 时经 pre-commit + CI 拦截)两层,覆盖 raw/ 只读、origin 必填、index 同步、审计日志、目录结构、提交前验证、SPEC 完整性、frontmatter、docs 提醒、seq-html 样式、pull 前置、ADR 引用、patterns 保护、禁止 AI 署名、report 路径、problem-tree 更新、PLAN 可执行、evidence 链终端等。
需注意的缺陷与限制:资料列出四条 fail-open 路径,均以 0 退出——模式写错、无参数、文件不存在(完全静默)、无法读取 policy.yaml(如缺少 pyyaml 会关闭全部规则),都会导致 CI 假绿,因此 CI 中应先检查文件存在再交给验证器。另记录 R14、R16、R19 在 .llmwiki/ 点前缀布局下 glob 不匹配(已在 PR #114 上游修复,需重跑 installer 才生效),以及 Bash 分支只做 'raw/' 子串匹配导致 R1 误报与 R14 漏报,不应依赖 R14 阻止有 Bash 权限的 agent 写入 patterns/。自测可用 bash .harness/poc-vendor-neutral/demo.sh(13 断言)与 test-broad.sh(80 断言)。