AGENT SKILL
principle-boundary-discipline
在接入验证、错误处理或框架适配器时适用。将守卫集中在系统边界(CLI、配置、网络、外部 API);信任内部类型,业务逻辑放在纯函数中。
- License 许可
- MIT
- 最近更新
- 2026-10-21
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- principle-boundary-discipline
- description
- 在接入验证、错误处理或框架适配器时适用。将守卫集中在系统边界(CLI、配置、网络、外部 API);信任内部类型,业务逻辑放在纯函数中。
- disable-model-invocation
- true
03 SKILL.md 正文
边界纪律
将验证、类型收窄和错误处理放在系统边界。无条件信任内部代码。业务逻辑放在纯函数中。外壳层应薄而机械。
原因: 分散的验证既嘈杂又冗余,还会制造虚假的安全感。把逻辑从框架接线中剥离,才能在不依赖框架的情况下测试。
模式:
- 在边界处(CLI 参数、配置文件、外部 API、网络协议):验证、返回错误、防御性处理。
- 系统内部: 类型化数据、错误传播、不重复验证。信任类型。
- 跨越边界。 暴露领域概念,而非边界的私有表示。通用机制留在内部,专用策略放在边缘。
应用:
验证与错误处理:
- 在解析时验证配置(边界处),而非业务逻辑内部
- 在边界将原始数据解析为领域类型
- 不要通过公共面向重新导出传输、存储、框架或 wire 类型
- 若边界已验证,调用链深处不要冗余 nil 检查
代码组织:
- 业务逻辑放在无框架依赖的纯函数中
- 解析函数:从原始字节到类型化状态的纯变换
- 提示词构建:结构化状态进,字符串出
- 评分与评估:从状态到结果的纯变换
检验:
- 「这些数据此刻是否正在跨越系统边界?」若不是,验证就是冗余的。
- 「这能否做成纯函数,由外壳层直接调用?」若能,就提取出来。
04 同仓库更多 Skills
why
用于「为什么 X 是这样实现的」「为什么选了 Y」、设计理由、回归、事后复盘,或数据支撑的阈值问题。发现可用 MCP 并并行查询各证据类别(源码控制、工单跟踪、长文文档、实时聊天、基础设施可观测性、错误跟踪、产品分析数仓),然后返回带引用的决策与权衡解读。运行时行为请用 how。
★ 3
unslop
从任意写作中剔除 AI 痕迹。
★ 3
typescript-best-practices
TypeScript 最佳实践。读取或编辑任意 .ts 或 .tsx 文件时使用。
★ 3
technical-writing
分层技术写作标准:Diátaxis 结构、Google 开发者风格句子、STE 指令规则、Global English 句法。用于 /technical-writing,或撰写/审查文档、RFC、README、PR 描述、commit message 时。
★ 3
teach
用平实语言解释一段工作,让人真正理解。运行 how 与 why skill,把发现织成一份清晰说明。用于「teach me this」「help me really understand X」「explain this change or subsystem to me」。
★ 3
tdd
仅当用户明确要求 TDD、失败测试或回归测试时使用,或 bug 有明显且廉价的本地测试目标时使用。测试路径不清、昂贵、偏集成或未要求时跳过。
★ 3