Documentation
README
API Verification Skill
职责
在 dev/fix 工作流涉及接口变更时,生成归档级双产物并执行验证:
.http— 可执行请求示例(VS Code REST Client 格式).cjs— 自动化执行脚本(Node.js)
说明:本 Skill 不负责“给前端或调用方看的轻量接口说明”。这类阅读型目标文档由
dev-docs的light-api/frontend-api模式负责。
与 test-router 的关系
test-router负责识别本轮是否存在 API/HTTP 契约变更、归档级接口验证或回归接口探针需求。- 一旦 TestRoute 判定需要
api-verification,本 Skill 的.http + .cjs双产物和自动化执行规则仍然强制适用。 - TestRoute 只记录验证路线,不替代本 Skill 的接口覆盖清单、断言脚本和执行结果。
触发时机
| 工作流 | 触发条件 |
|---|---|
| dev | 新增/修改 API 接口 |
| dev-optimization | 优化前(建立基线)和优化后(对比验证) |
| dev-scenario-test | 场景测试基于接口规范 |
| fix | 修复涉及接口行为变更 |
| test-router | TestRoute 判定存在对外 HTTP/API 契约变更、归档级接口验证或接口回归探针 |
双产物规范
.http 文件(可执行请求示例)
This is the opening of the README. Read the full README on GitHub.