SuperAPI AI 工具集

mino-interface-implementation-separation

编程与开发

查看项目

更新于 10-16 06:49

技能介绍

该技能面向“接口与实现分离”,核心是把 consumer(使用方)需要知道的 purpose、must_know、must_not_know,以及每个 operation 的输入、结果、失败、副作用与不变量明确出来,同时把 SDK 类型、DB row、框架类型、提供方步骤、序列化、缓存、算法、退避等实现细节留在实现侧。依赖方向为 consumer 使用契约、adapter 实现契约。

操作需逐一筛查端到端截止时间、重试语义、幂等性、重复语义与结果不明确的情况,分别标记为适用、不适用或未知;不适用要留理由与证据,未知要留确认方法与影响。

边界划分依据调用方、公开契约、代码、依赖、质量与真实变体,把领域判断、用例协调、持久化、外部 I/O、表达与运维分层。只有真实存在多个变体时才设置选择边界;若存在外部故障隔离或契约稳定需求,即使只有一个实现也可使用小端口。

硬性要求包括:不以 if 数量或 interface 数量衡量质量;状态、判断与更新应集中到同一职责;只有目的、契约和变更理由一致时才做共通化;不保留隐藏不同含义的抽象或向调用方泄漏技术细节;不凭假设确定含义不明的部分。

完成判定:分离为 separated,技术泄漏或职责错误为 leaky,无依据抽象为 overabstracted,不适用为 not_applicable,重要未确认为 indeterminate。使用前需阅读共享规则,涉及代码职责、命名变更或公开契约变更时按指引阅读对应参考文档;仅在需要创建、更新或交接正式 package 时才读取 package 模式。具体安装命令与调用方式暂未提供。