principle-describe-interfaces-first
这是一个面向 AI 编程智能体的技能条目,内容是一项面向软件开发的设计原则「接口契约先行」:在创建或实质性变更公开、跨模块或行为不直观的接口之前,先用自然语言把调用方需要理解的关键契约描述清楚,再写实现,并用该描述改进设计。它给出了激活条件(接口公开或跨越模块边界,且调用方需理解至少一项关键保证、错误、副作用、顺序规则、生命周期约束或不变量)、决策流程(命名抽象及其职责、说明输入与约束、区分既定事实与未知项、列出错误与副作用、写出契约草案)、设计警示(难以解释契约往往意味着设计有问题),以及与 codebase-design、architect、typescript、docs 等技能的职责分工,并配有文档替换、缓存 API、生成接口门面、未决语义等示例。适合智能体在开发多模块接口时用于规范设计流程。