技能介绍

要解决什么问题

在 map-spec 的 integration 测试链路里，部署、写方案、跑 Diff、筛数据、生成 Python 用例、触发回归往往分散在多个子 Skill 和仓库里。若没有统一编排，参数不一致、阶段顺序错乱、产物路径不统一，上游 testing agent 也很难拿到可解析的终态结论。

本 Skill 定位为编排层：不实现业务 Diff/筛数/回归逻辑，只负责校验入参、推导 feature / host / driver_id 等上下文、按 test_plan.required_phases 调度子 Skill，并在末尾输出 qa_integration_report.md 与 MAP_SPEC_RESULT JSON。

流水线如何运转

Agent 调用形式：skill: qa-integration-pipeline，必填 designDoc、sourceFiles、type。若 type=unit，直接返回 skipped，仅处理 integration。

| Phase | 子 Skill | 要点 |
|-------|----------|------|
| 0 | service-deployer | 未配置 host 时自动部署目标+基线；初始化依赖仓库与 {diff,data,test_cases,reports,logs} |
| 1 | test-plan-writer | 生成 test_plan.md（含 experiment_config、required_phases、risk_level） |
| 2 | diff-executor-and-analyzer | 按 AB/灰度多组 Diff；对照组出现 unexpected_diff 可直接判 bug |
| 3 | data-filter-executor | 数据筛选与分析，策略上常跟随 Case 生成 |
| 4 | case-generator | 用例写入回归工程 AI_Case，并在 feature 目录留副本 |
| 5 | regression-executor-and-analyzer | Jenkins build_item 触发回归，失败可重试一次，不阻断 Phase 6 |
| 6 | （本 Skill） | 汇总各阶段产物 |

Phase 0 还可选查询 LLM-Wiki；配置优先级为传入参数 > 环境变量 > .claude/qa-pipeline.config.json > 默认值。data_mode（single / dual）由设计文档与变更文件推断。

边界与注意点

工作根目录默认 /home/xiaoju/map-spec/，按 feature 隔离；依赖 top30_city_points、search-ng-data、navi_guide_tools 等固定 git 工程。
Phase 0/1/2 失败会阻断后续；Phase 3–5 多为暂停策略，Phase 2 实验组 unexpected_diff 需人工选「预期内 / bug / 先跳过」。
dchat 通知受 notification.enabled 与 notification.dchat.enabled 控制。
报告末尾的 MAP_SPEC_RESULT（result / coverage / testCount / summary）供 map-spec testing agent 解析，须保持在输出最后。

截图预览

使用场景

map-spec testing agent 在拿到 designDoc 与变更文件列表后，需要只跑 integration 并拿到末尾 MAP_SPEC_RESULT。
新需求上线前 host 未配置，要先自动部署目标与基线服务，再按 test_plan 决定是否执行 Diff 与回归。
实验为 ab_test 或 grayscale 时，要按对照组/实验组（或白名单/非白名单）各跑一轮 Diff 并汇总 bad_case。
Diff 出现 unexpected_diff 时，要在更新 test_plan 预期、生成 phase2_bug 报告或跳过后续阶段之间做明确决策。

适合人员

维护 map-spec workflow 的测试平台工程师，要把 service-deployer、diff、case-generator 等子 Skill 按 Phase 串成一条可复用流水线。
负责地图导航/搜索接口质量的 QA，要在 /home/xiaoju/map-spec/{feature} 下产出 test_plan、diff 目录与回归分析报告。
做 AB/灰度实验配置的测试开发，需要验证对照组与基线一致、实验组差异是否符合 test_scenarios 定义。
编写或对接 map-spec testing agent 的工程师，需要统一的 result/coverage/testCount 字段供上游自动判 PASS 或 FAIL。