SuperAPI AI 工具集

pstack-principle-boundary-discipline

编程与开发

查看项目

更新于 10-28 17:14

技能介绍

边界纪律是一项面向 AI 编码代理的技能,其核心主张是把校验、类型收窄与错误处理集中在系统边界,内部代码则无条件信任类型。

用途 该技能用于在接入校验、错误处理或框架适配器时提供统一的架构约束,帮助开发者避免把校验逻辑散落在业务代码各处。资料给出的理由是:分散的校验既嘈杂又冗余,还会带来虚假的安全感;把逻辑从框架接线中剥离,才能在没有框架的环境下测试。

主要能力 技能定义了边界内外的分工模式:在边界处(CLI 参数、配置文件、外部 API、网络协议)执行校验、返回错误并做防御性处理;在系统内部使用已定型的类型、传播错误、不再重复校验。跨边界时只暴露领域概念,不对外泄露边界私有的表示;通用机制留在内部,特殊策略放在边缘。

具体应用覆盖两类场景。校验与错误处理方面:在解析时(即边界处)校验配置,而不是在业务逻辑内部校验;在边界把原始数据解析为领域类型;不通过公共接口重新导出传输、存储、框架或线上格式类型;边界已校验过的数据,不在深层调用链中重复做 nil 检查。代码组织方面:业务逻辑写成不依赖框架的纯函数;解析函数是从原始字节到类型化状态的纯变换;提示词构造是结构化状态进、字符串出;评分与评估是状态到结果的纯变换。

使用方式 技能提供两条自检问题来辅助判断:当前这份数据是否正跨越系统边界?如果不是,校验就是冗余的。这段逻辑能否抽成纯函数、由外壳直接调用?如果可以,就应抽取出来。资料还指出,涉及模块或接口推理时可调用 /codebase-design;涉及已确认的项目术语、关系或所有权变更时,可调用 /domain-modeling 并同步规范的项目产物。

适用场景 适用于需要接入配置解析、外部 API 调用、网络协议处理、框架适配层,或希望把业务逻辑抽为可独立测试的纯函数的工程场景。

限制 资料未提供具体安装命令、运行环境要求、支持的代理平台或版本信息,这些事实暂未提供。