SuperAPI AI 工具集

feature-verify

通用与其它

查看项目

更新于 10-16 08:08

技能介绍

用途:在功能部署后验证其实际运行行为,校验 API 响应,诊断生产问题,属于运行时优先的 API 验证流程。触发关键词包括 verify、investigate、diagnose、check if working、post-deploy、smoke test、validate。

主要能力:按 P0 至 P5 阶段推进——P0 范围与安全(读取 safety-rules.md 与 environments.md,确认环境、只读策略、API 可达性与部署一致性,判定降级等级);P1 基于 git diff 的轻量范围界定,将改动文件映射到受影响端点与依赖链;P2 生成测试章程(L1 回归、L2 主动触发、L3 被动观察、M1 指标),需用户确认;P3 只读执行 API 请求并记录状态码、请求 ID、延迟;P4 日志关联、时间窗扫描、后台服务与指标观察、盲区分析;P5 由 Claude 独立分析、Codex 第三方复核,输出综合判定与置信度。

降级矩阵:L4(API+日志+指标)、L3(API+日志)、L2-API(仅 API)、L2-OBS(仅日志,API 不可达)、L1(无运行时访问,仅代码审查)。缺失端点允许清单时跳过 P3;L1 跳过 P3/P4 并仅给低置信度结论。

使用方式:以 /feature-verify 调用,可带功能名、--env 与 --level 参数,例如 /feature-verify "User Auth API" --env test。P3 使用 curl 发送单次只读请求,示例命令保留原样:curl -s -w "\n%{http_code}\n%{time_total}" -X {{ METHOD }} "$HOST/{{ ENDPOINT }}" "${HEADERS[@]}" -d '{{ PAYLOAD }}'。

适用场景:部署后冒烟验证、API 响应校验、生产问题诊断、后台任务与定时作业观察。

限制:所有操作必须只读,仅允许清单内端点,单次请求、不做负载测试,使用固定测试参数、不含真实用户数据,需遵守速率限制。只读约束为行为性约束,命令执行前须对照 safety-rules.md 审查,Codex 在 P5 独立核验合规性。报告可建议后续技能但不自动调用。未提供环境配置时降级为 L1,结论为 Inconclusive 且低置信度。