api-verification

# 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` 文件（可执行请求示例） ```http # <模块名> API 验证请求示例 @baseUrl = http://localhost:3000 @contentType = application/json @token = replace-with-token-if-required @language = zh-CN @userName = test-user @userEmail = test@example.com ### POST 创建用户 # @description 创建新用户账号 # @expects 201 + 返回体包含 data.id（人工检查提示） POST {{baseUrl}}/api/users Content-Type: {{contentType}} Accept-Language: {{language}} # 鉴权值默认可按用户要求直写；只有用户 / 项目要求可分享或脱敏时才保留占位变量 Authorization: Bearer {{token}} { "name": "{{userName}}", "email": "{{userEmail}}" } ### ``` 存放：任务目录根 `*-接口验证.http`（dev 需求目录或 fix bug 目录，遵循 `02-output-paths.instructions.md` 产物路径规范） ### `.cjs` 文件（自动化脚本） ```js // *-接口验证.cjs const http = require('http') const https = require('https') const assert = require('assert') const BASE_URL = process.env.API_BASE_URL i...