用途:为项目规则设计可落地的强制执行机制,判断某条约束应停留在软约定,还是升级为 hook 或外部校验器。资料指出,依赖自觉的规则在压力下会失效,强制层让正确路径成为唯一路径。
三层机制:软誓约(技能指令、CLAUDE.md 规则,约80%合规);硬誓约(PreToolUse/PostToolUse hooks、settings.json 权限,接近100%);Nen Court(外部校验代理检查输出,确定性)。
分类流程:新约束先作为软誓约添加;通过日志、事后审计、用户反馈监控违规率;30天内违规率超20%时,二元约束升级为硬誓约,需判断的约束升级为 Nen Court,模糊时先试硬誓约,误报超过10%再转 Nen Court。升级触发条件还包括严重违规、用户明确要求强制。
Nen Court 校验器:位于 plugins/imbue/validators/ 的独立脚本,从 stdin 读 JSON,向 stdout 写判定 JSON,退出码 0 通过、1 违规、2 不确定。例如:echo '{"files": ["README.md", "docs/guide.md"]}' | python plugins/imbue/validators/markdown_wrap.py;iron_law.py 校验提交顺序;proof_of_work.py 检查证据引用与状态。校验可在 specify、plan、execute、pr-prep 等阶段边界调用,退出码1作为阻断门,退出码2仅提示,用户可显式 override。
限制与边界:一次性规则、已强制且有效的约束、探索性工作不宜使用。降级条件为误报率超过10%或约束过于激进。部分具体实现证据、版本与后续变更资料暂未提供。