SuperAPI AI 工具集

principle-boundary-discipline

编程与开发

查看项目

更新于 10-16 05:43

技能介绍

用途:这是一条编程原则,用于组织校验、错误处理与框架适配代码,避免把校验散落各处。

主要能力/规则:在边界(CLI 参数、配置文件、外部 API、网络协议)做校验、返回错误、防御式处理;系统内部使用已有类型、只传播错误、不重复校验,直接信任类型。解析时完成配置校验,而非在业务逻辑内做。原始数据在边界解析为领域类型。不要把传输、存储、框架或线格式类型通过公共接口再导出。边界已校验后,调用链深处不做冗余的 nil 检查。业务逻辑写成无框架依赖的纯函数,如解析函数(原始字节到类型化状态的纯变换)、提示构造(结构化状态入、字符串出)、评分评估(状态到结果的纯变换)。外壳只负责调用纯函数。

自检问题:当前数据是否正在跨越系统边界?若否,校验即冗余。能否抽成外壳只调用的纯函数?若能,就抽出来。

适用场景:需要在 CLI、配置、网络、外部 API 等边界接入校验与错误处理,并希望逻辑可脱离框架测试的项目。

限制:本资料未提供具体语言、框架、安装命令或代码示例,仅给出原则性描述;实际应用需结合具体技术栈。