SuperAPI AI 工具集

principle-boundary-discipline

编程与开发

查看项目

更新于 11-01 16:54

技能介绍

边界纪律(Boundary Discipline)

边界纪律是一套关于验证、类型收窄与错误处理放置位置的工程原则。它的基本立场是:把验证、类型收窄和错误处理放在系统边界上,对内部代码无条件信任;业务逻辑放在纯函数中,外壳保持轻薄、机械。

为什么这样做

分散的验证是嘈杂的、冗余的,并且会带来虚假的安全感。把逻辑排除在框架接线之外,才能在不依赖框架的情况下对其进行测试。

模式

在边界处(CLI 参数、配置文件、外部 API、网络协议):进行验证、返回错误、防御性处理。

在系统内部:使用带类型的数据、传播错误、不做重复验证。信任类型。

跨越边界时:暴露领域概念,而不是边界自身的私有表示。把通用机制留在内部,把专用策略放在边缘。

应用

验证与错误处理:

在解析时(即边界处)验证配置,而不是在业务逻辑内部验证

在边界处把原始数据解析为领域类型

不要通过公共接口重新导出传输、存储、框架或线路类型

如果边界已经验证过,就不要在调用链深处做冗余的 nil 检查

代码组织:

业务逻辑放在不依赖框架的纯函数中

解析函数:从原始字节到带类型状态的纯转换

提示词构造:结构化状态输入,字符串输出

评分与评估:从状态到结果的纯转换

自检问题:

“这份数据现在正在跨越系统边界吗?”如果不是,验证就是冗余的。

“这能不能成为一个纯函数,让外壳只负责调用?”如果可以,就把它提取出来。