CraftKit/plugins/dev/skills/prepare-api/references/sources.md

契约来源

优先使用与目标环境和版本一致的契约：

1. 用户指定的正式 OpenAPI 或其他机器可读契约。
2. 当前项目生成并用于目标环境的接口文档。
3. 服务端控制器、请求响应模型、校验和契约测试。
4. 经过项目维护的 Markdown 文档和示例。
5. 用户明确说明的临时约定。

记录来源路径、版本或提交、生成时间和已知偏差。多个来源冲突时不自动裁决；列出冲突并由契约所有者确认。示例响应只能证明示例形态，不能代替完整字段约束。