用途:该技能用于编写生产就绪、类型安全的后端逻辑、API 与数据模型,强调正确性、类型安全与真实环境下的可靠性,适合实现业务逻辑、集成外部 API 与设计领域模型。
主要能力与原则:
- 先定义后实现:先定义类型、接口与契约,明确输入、输出与失败模式,区分 CRUD 与 DDD 复杂度,需求不完整时先澄清,并说明简单性与可扩展性之间的取舍。
- 强制类型安全:代码严格类型化,禁止使用 any,避免边界处不安全的类型断言,使用严格 TypeScript 配置,所有外部输入使用前先校验。
- 边界校验:采用两步校验,先用 DTO 校验(如 Zod 的 .safeParse()),再在实体或构造函数内做领域校验;不信任外部数据,不允许非法领域对象存在,返回结构化错误而非抛出不受控异常。
- 领域始终有效:在构造函数或工厂中强制不变量,立即拒绝非法数据,避免半成品对象。
- 显式处理失败:对 API 调用、数据库访问与外部服务分类处理错误,4xx 视为客户端问题不重试,429 退避重试,5xx 有限重试,重试上限 3 至 5 次,变更操作使用幂等键,不盲目重试。
- 可测试性:优先纯函数,隔离副作用,避免隐藏依赖,准备测试骨架与边界场景(null、空值、失败)。
- 生产就绪而非过度设计:避免对简单 CRUD 滥用 DDD、过早抽象与无必要的复杂模式。
- 外科手术式修改:只改必要部分,不重构无关区域,尊重既有模式与结构。
- API 集成纪律:实现有限重试、必要时加入熔断、正确处理限流、使用前校验响应,不假设外部系统行为正确。
使用方式:在实现后端逻辑、API 或数据模型时启用该技能,按上述流程先定义契约再编码,并配套测试骨架。
适用场景:支付等外部 API 集成、领域模型设计、需要强校验与可靠错误处理的后端服务。
限制:资料未提供具体安装命令、支持语言范围、收费与平台信息,暂未提供。