SuperAPI AI 工具集

business-api-context

测试与质量

查看项目

更新于 10-16 07:16

技能介绍

用途:把被测系统的 API 作为业务界面来理解,回答“这个 API 对业务意味着什么”,而不是仅给出接口形状。加载后改变智能体已知的信息,技能本身只做一件事:对自己维护的地图提出编辑建议。

主要能力与信息范围:覆盖端点分组、调用方与目的、变更内容、所需认证级别与角色、多调用流程的串联关系、各错误对用户的含义,以及后端第三方。

使用方式:通过 bun run context:map business-api-context 读取地图,可用 --section <id> 只读某个端点分组;不要直接读取 references/business-api-map.html 原始文件,其 SVG 占大部分字节且不含事实。字段名、类型与必填标志以 schema([API_TOOL] schema read,api/schemas/)为准,含义取自地图;形状冲突以 schema 为准,行为冲突以运行中的 API 为准。发现与某节矛盾时,向用户(受监督时向 conductor)提出单节修改并附证据,获批后才应用,流程见 references/refresh.md。使用 api-schema 或 diagrams 前先跑 agentic-qa-core/references/preflight-gate.md §8 的使用点检查。构建 API 层任务简报、判断某节是否过时、提出地图修改时读完整 SKILL.md。

限制:只能写本技能自己的 references/,不得写 Jira、.context/、其他技能、api/schemas/ 或产品代码;不得把地图内容复制进 SKILL.md。占位地图视同“没有地图”,应说明并交给用户 project-context mode api,不得当作 API 为空来回答。载荷模式与类型详见 OpenAPI 契约;实体、状态机与触发器见 business-data-context;用户旅程与功能目录见 business-e2e-context;令牌与凭据在 .env 与 bun run api:login 中,绝不写进地图。