mcpField
P
principle-boundary-discipline

principle-boundary-discipline

github.com/poteto开发161104 次安装22 周前更新
代码仓库

关于 principle-boundary-discipline

一项编码 Skill,主张在系统边界处理验证与错误,并将业务逻辑放入纯函数。适用于希望减少重复检查、让逻辑脱离框架进行测试的开发者。

主要功能

  1. 01在系统边界验证数据
  2. 02内部信任类型化数据
  3. 03将业务逻辑写成纯函数
  4. 04解析逻辑与框架接线分离

适用场景

  1. 01验证 CLI 参数和配置
  2. 02将评分逻辑提取为纯函数

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/poteto/plugins --skill principle-boundary-discipline

安装后在 Claude Code 中输入/principle-boundary-discipline确认已加载。

详细介绍

边界纪律

在系统边界进行验证、类型收窄和错误处理。无条件信任内部代码。业务逻辑放在纯函数中;外壳应当精简且只负责机械性工作。

原因: 零散的验证既繁琐又重复,还会带来虚假的安全感。在边界处验证一次数据即可。不要把逻辑放进框架接线代码中,这样无需依赖框架就能测试。

模式:

  • 在边界处(CLI 参数、配置文件、外部 API、网络协议):验证、返回错误,并进行防御性处理。
  • 在系统内部: 使用类型化数据,传播错误,不重复验证。信任类型。

应用:

验证和错误处理:

  • 在解析时(即边界处)验证配置,而不是在业务逻辑中验证
  • 在边界处存储原始数据;在使用时再延迟解析
  • 如果边界处已完成验证,就不要在调用链深处重复检查 nil

代码组织:

  • 将业务逻辑放在不依赖框架的纯函数中
  • 解析函数:将原始字节纯粹地转换为类型化状态
  • 提示词构造:输入结构化状态,输出字符串
  • 评分和评估:将状态纯粹地转换为结果

测试问题:

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

评论

支持 Markdown