Skip to content

Constitutional Engineering

AI必须在宪法下运作。毫无例外。

原则

在传统软件开发中,我们依赖约定、风格指南和代码审查来维护质量和一致性。但当AI进入等式时,这些非正式的防护措施变得危险地不足。AI不理解细微差别——它需要明确的、可执行的规则。

Constitutional Engineering是定义一套不可变规则的实践,这些规则管理你开发环境中的每一次AI交互。这些不是建议或指南——它们是不能被违反的架构约束。

工作原理

每个AI建议都通过多个验证层:

AI Suggestion → Constitutional Validation → Context Check → Action Verification → Human Review

如果任何层失败,建议要么被修改以符合要求,要么被完全拒绝。

在Hatcher中的实现

Playbooks:你的项目法律

Playbooks是可执行的规范,定义了:

  • 必须遵循的代码模式
  • 不能违反的架构决策
  • 不能跨越的安全边界
  • 必须维护的性能阈值
yaml
# 示例Playbook
name: API Security Constitution
rules:
  - no_public_endpoints_without_auth
  - all_inputs_must_be_validated
  - rate_limiting_required
  - audit_log_all_mutations

这样想:Playbooks是法律,Hatcher Actions是警察。Playbooks(.yaml)以人类可读的方式声明规则是什么。Actions(.ts)提供可执行逻辑以实时执行这些规则。

Hatcher Actions:实时执行

Actions是执行机制——它们拦截AI建议并在它们到达你的代码库之前根据你的宪法验证它们。

typescript
// 示例Action
export const validateAPIEndpoint: HatcherAction = {
  trigger: 'api.endpoint.created',
  validate: (code) => {
    // 检查认证
    if (!hasAuthDecorator(code)) {
      return reject('All endpoints must have authentication')
    }
    // 检查输入验证
    if (!hasInputValidation(code)) {
      return reject('All inputs must be validated')
    }
    return approve(code)
  },
}

Constitutional Engineering的力量

1. 可预测的AI行为

AI变得可预测,因为它受到明确规则的约束。你知道它能做什么和不能做什么。

2. 大规模团队对齐

每个开发者,无论是人类还是AI,都遵循相同的宪法。不再有"风格之争"或不一致的模式。

3. 设计即合规

监管要求成为宪法规则。GDPR、HIPAA、SOC2——自动编码和执行。

4. 无混乱的演进

随着项目的发展,你更新宪法。所有未来的AI交互立即适应新规则。

5. 跨范式的统一治理

宪法不仅适用于新生成的UI代码。它管理整个系统的行为方式,包括AI如何与在Universal Fabricator中运行的遗留业务逻辑交互。这提供了对新旧的单一、统一的控制平面。

真实示例:安全宪法

考虑一个安全至上的金融科技应用:

yaml
constitution:
  data_handling:
    - encrypt_all_pii_at_rest
    - no_pii_in_logs
    - tokenize_payment_data

  authentication:
    - multi_factor_required
    - session_timeout_15_minutes
    - jwt_rotation_hourly

  api_design:
    - versioned_endpoints_only
    - deprecation_notice_90_days
    - backward_compatibility_required

有了这个宪法,AI不能:

  • 生成记录敏感数据的代码
  • 创建没有适当认证的端点
  • 建议破坏向后兼容性的更改

超越规则:文化编码

Constitutional Engineering不仅仅是技术约束——它是将你的工程文化编码到开发过程中。你的价值观、优先级和不可妥协的原则成为系统本身的一部分。

这就是如何扩展文化。这就是如何确保无论你有10个开发者还是1000个,无论他们是人类还是AI,每个人都以你决定的方式构建软件。

开始使用

  1. 定义你的核心原则:你的不可妥协是什么?
  2. 创建你的第一个Playbook:从一个关键领域(安全、性能等)开始
  3. 编写执行Actions:将规则转化为代码
  4. 迭代和扩展:随着学习发展你的宪法

宪法不是一成不变的——它随着你的理解而发展。但在任何给定时刻,它是法律,没有你的明确批准,任何东西都无法通过。


Constitutional Engineering将AI从不可预测的神谕转变为遵守你的规则、遵循你的模式并维护你的标准的守纪律的团队成员。每一次。

定义你的开发宪法

创建每个AI和开发者都必须遵循的不可破坏的规则