[!info] related notes

• 所属 MOC: Matt Pocock Skills MOC
• 前置概念: Git Hooks
• 并列概念: Architecture Decision Record (ADR)
• 易混淆概念: Progressive Disclosure
• 关系笔记: Matt Pocock Skills 的工程闭环

Policy as Code

一句话定义

把“不能做什么”或“必须满足什么”写成系统可执行规则，而不是只写进文档里。

核心机制 / 工作原理

人会忘、会跳过、会在压力下妥协；机器可执行策略只有接在不可绕过的执行入口，并使用可信输入时，才能形成有效边界。

最小例子 / 最小场景

用 hook 阻止危险 Git 命令，或者在 CI 中强制检查某类配置是否存在。

边界与易混淆点

• 不是所有规则都适合代码化，前提是规则足够明确
• 写成代码后仍要持续维护，否则策略会过时
• 本地 Git hook 可被跳过；它是本地防错层，不替代服务端权限与受保护分支
• 区分策略决策与策略执行：返回 deny 但继续调用工具仍是失效
• 测试 allow、deny、缺失上下文和策略加载失败等路径，并记录策略版本；代码化不自动保证规则正确