SuperAPI AI 工具集

integration-contract

通用与其它

查看项目

更新于 10-15 21:08

技能介绍

用途:在 /to-tickets 之后,把 spec(PRD)的跨仓库接缝写成磁盘上的契约文件,并用冒烟门禁检查;在 spec 级交付和 PM 交接前运行。输入为 <SPEC-ID>,取自上下文或询问一次;用户不在且无法推断时停止并标注 Needs-user,绝不猜测。

主要能力:build 模式读取 spec 及其子问题,检测涉及的 PROJECT-CODE;若只有一个项目,则对其他 Project Matrix 仓库做窄检索消费者扫描,确认无外部调用点后报告“单项目,无需契约”并停止,不创建文件;发现外部调用点则构建契约并把每个消费者标为风险行。契约写入 <artifacts-root>/specs/integration/<SPEC-ID>-contract.md,含四个部分与门禁日志。gate 模式先验证环境(主机权限、服务可达、测试数据、变更面是否在运行产物中),再按 Driver 驱动各流程,记录 Evidence(截图路径、引用响应、观察文本),标记 pass/fail;失败会重开契约并阻断当前步骤。

使用方式:build 为默认模式,只写契约文件,不写产品代码、配置、issue 或 ADR;gate 使用已有契约,仅在结构或冒烟覆盖需修复时加载 schema。默认使用本地测试环境,绝不访问生产;staging 需明确批准和用户提供的访问权限,每次变更需单独批准。未知主机或缺少权限时相关流程保持 pending。

限制:只做窄检索,不批量读取仓库或 specs/ 树;消费者以 file:symbol 引用。仓库不可用则扫描不完整,记录风险且不得得出无需契约的结论。无定位到的消费者是风险而非通过;流程只有在已验证环境中才算通过,无证据保持 pending。build 不自动运行 gate,gate 不自动运行 /commit-push-*,只建议下一步并停止。子代理仅调度本地通道,不使用云代理。输出按 Stage / Found / Next / Needs user 模板。具体安装命令、收费与平台信息暂未提供。