SuperAPI AI 工具集

principle-boundary-discipline

编程与开发

查看项目

更新于 10-28 16:16

技能介绍

边界纪律(Boundary Discipline)是一套关于在何处放置验证、类型收窄与错误处理的工程原则。它的核心主张是:把守卫集中在系统边界,内部代码无条件信任。

用途 该原则用于指导验证、错误处理与框架适配相关代码的组织方式。它解决的问题是:分散各处的校验既嘈杂又冗余,还会带来虚假的安全感;同时,业务逻辑与框架接线混在一起,导致无法脱离框架进行测试。

主要能力

  • 在边界处(CLI 参数、配置文件、外部 API、网络协议)进行验证、返回错误、做防御性处理。
  • 在系统内部使用类型化数据、传播错误、不做重复验证,信任类型。
  • 跨边界时暴露领域概念,而不是边界私有的表示形式;把通用机制留在内部,把专用策略放在边缘。

使用方式 验证与错误处理方面:在解析时(即边界处)验证配置,而不是在业务逻辑内部验证;在边界处把原始数据解析为领域类型;不要通过公共接口重新导出传输、存储、框架或线格式类型;如果边界已经验证过,调用链深处不再做冗余的 nil 检查。

代码组织方面:业务逻辑写成无框架依赖的纯函数;解析函数是从原始字节到类型化状态的纯转换;提示词构造是结构化状态进、字符串出;评分与评估是从状态到结果的纯转换。

该原则提供了两个自检问题:

  • “这份数据此刻是否正在跨越系统边界?”如果不是,验证就是冗余的。
  • “这能否成为一个由外壳直接调用的纯函数?”如果可以,就把它提取出来。

适用场景 适用于需要处理配置解析、外部数据接入、框架适配层、提示词构造、评分评估等任务的开发工作。

限制与关联 资料未提供该技能的具体安装命令、收费方式、支持平台或效果数据。资料提到:进行模块/接口推理时可调用 /codebase-design;涉及已接受的项目术语、关系或归属变更时,可调用 /domain-modeling 并对齐项目权威产物。