SuperAPI AI 工具集

aisdlc-project-discover-modules-contracts

编程与开发

查看项目

更新于 10-16 09:56

技能介绍

用途:在项目发现阶段为模块同时产出组件页与契约入口页,把权威入口、不变量摘要和证据入口立起来,避免写成字段大全或缺少证据链。开始时可声明正在使用该技能生成页面并建立证据链。

输出文件:.aisdlc/project/components/{module}.md;.aisdlc/project/contracts/api/{module}.md;.aisdlc/project/contracts/data/{module}.md。并回填 components/index.md、contracts/api/index.md、contracts/data/index.md。

组件页包含模块定位 In/Out、Owner、代码与运行入口、对外契约入口链接、代表性协作场景、NFR 摘要与证据链接。API 契约页包含权威入口(OpenAPI/Proto、网关/路由)、3–7 条不变量摘要(鉴权、幂等/重试、错误码族、版本兼容、审计合规)及证据入口(handler、测试、CI 门禁)。数据契约页包含数据主责、核心对象与主键、权威入口(Schema/DDL/迁移、ORM model)、不变量摘要(口径、状态机、唯一性/外键)与证据入口。

质量门禁:P0 模块三份文件须同时存在并正确互链;两个契约页都需具备权威入口、不变量摘要、证据入口三件套;不确定内容只能写“未发现/待定位”或下一步找证据的线索。

限制:契约页不是字段字典,不贴大量字段表格;协作场景不写详细时序;不新增 docs/api-reference、data-dictionary 等目录堆字段细节。出现上述红旗应停止并纠正。