关于 principle-boundary-discipline
一项编码 Skill,主张在系统边界处理验证与错误,并将业务逻辑放入纯函数。适用于希望减少重复检查、让逻辑脱离框架进行测试的开发者。
主要功能
- 01在系统边界验证数据
- 02内部信任类型化数据
- 03将业务逻辑写成纯函数
- 04解析逻辑与框架接线分离
适用场景
- 01验证 CLI 参数和配置
- 02将评分逻辑提取为纯函数
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ poteto/ plugins --skill principle-boundary-discipline安装后在 Claude Code 中输入/principle-boundary-discipline确认已加载。
详细介绍
边界纪律
在系统边界进行验证、类型收窄和错误处理。无条件信任内部代码。业务逻辑放在纯函数中;外壳应当精简且只负责机械性工作。
原因: 零散的验证既繁琐又重复,还会带来虚假的安全感。在边界处验证一次数据即可。不要把逻辑放进框架接线代码中,这样无需依赖框架就能测试。
模式:
- 在边界处(CLI 参数、配置文件、外部 API、网络协议):验证、返回错误,并进行防御性处理。
- 在系统内部: 使用类型化数据,传播错误,不重复验证。信任类型。
应用:
验证和错误处理:
- 在解析时(即边界处)验证配置,而不是在业务逻辑中验证
- 在边界处存储原始数据;在使用时再延迟解析
- 如果边界处已完成验证,就不要在调用链深处重复检查 nil
代码组织:
- 将业务逻辑放在不依赖框架的纯函数中
- 解析函数:将原始字节纯粹地转换为类型化状态
- 提示词构造:输入结构化状态,输出字符串
- 评分和评估:将状态纯粹地转换为结果
测试问题:
- “这些数据此刻是否正在跨越系统边界?”如果没有,验证就是多余的。
- “能否将其写成一个由外壳直接调用的纯函数?”如果可以,就把它提取出来。
评论
支持 Markdown