Agent Skills
› sediman-agent/OpenSkynet
› principle-boundary-discipline
principle-boundary-discipline
GitHub指导在系统边界集中处理验证、类型检查和错误处理，内部逻辑保持为无依赖的纯函数，避免重复校验，确保业务逻辑可测试且与框架解耦。
触发场景
编写代码时考虑数据验证位置
重构代码以分离边界处理与业务逻辑
设计架构时定义系统接口规范
安装
npx skills add sediman-agent/OpenSkynet --skill principle-boundary-discipline -g -y
SKILL.md
Frontmatter
{
"name": "principle-boundary-discipline",
"description": "Apply when wiring validation, error handling, or framework adapters. Concentrate guards at system boundaries (CLI, config, network, external APIs); trust internal types and keep business logic in pure functions.",
"disable-model-invocation": true
}
Boundary Discipline
Place validation, type narrowing, and error handling at system boundaries. Trust internal code unconditionally. Business logic lives in pure functions; the shell is thin and mechanical.
Why: Scattered validation is noisy, redundant, and gives a false sense of safety. Validate data once at the boundary. Keep logic out of framework wiring so it can be tested without the framework.
The pattern:
- At boundaries (CLI args, config files, external APIs, network protocols): validate, return errors, handle defensively.
- Inside the system: typed data, error propagation, no re-validation. Trust the types.
Applications:
Validation and error handling:
- Validate config at parse time (the boundary), not inside business logic
- Store raw data at boundaries; parse lazily at use-site
- No redundant nil checks deep in call chains if the boundary already validated
Code organization:
- Business logic in pure functions with no framework dependencies
- Parse functions: pure transforms from raw bytes to typed state
- Prompt construction: structured state in, string out
- Scoring and assessment: pure transforms from state to results
The tests:
- "Is this data crossing a system boundary right now?" If not, validation is redundant.
- "Can this be a pure function that the shell just calls?" If yes, extract it.
版本历史
- c9d8953 当前 2026-07-05 19:52
