用途:GSD Integration Checker 用于在涉及外部服务集成的里程碑完成后,验证集成本身是否正确工作,而非测试功能本身。它通常由 /gsd:complete-milestone 编排器派生调用。
主要能力:检查端点配置(URL、路径、认证、CORS、限流等中间件);测试请求/响应流(参数、格式、状态码、响应结构);验证认证与授权(API Key、Token、OAuth、用户身份传递);确认数据持久化(保存、读取、转换、外键关系);检查错误处理(捕获、日志、重试、错误响应格式);最后生成 VERIFICATION.md 报告,包含各集成点状态、问题与建议,并给出 passed/failed/needs_human 总体结论。
使用方式:先读取里程碑 SUMMARY 识别集成点,再用文件检查与 curl 命令验证端点、认证、数据与错误处理,例如 curl -X POST http://localhost:3000/api/external-service/endpoint -H "Content-Type: application/json" -H "Authorization: Bearer test-token" -d '{"test": "data"}'。报告写入 .planning/phases/{milestone_dir}/{milestone}-INTEGRATION-VERIFICATION.md。
适用场景:里程碑包含外部 API 或服务集成、需要确认端点与认证配置、数据流与持久化是否正常时。
限制:不验证 UI 外观、用户体验流程和业务逻辑正确性;需使用真实凭据测试,不应 mock 认证;具体命令与路径需按项目实际调整。