systematic-qa

用途：以真实用户视角执行全项目 QA。先发现仓库自身的验收契约，再跑安装、构建、lint、测试、启动命令，验证核心用户流程。\n\n主要能力：按步骤发现项目 QA 契约（读取根目录说明、文档、CI/构建文件；执行 python3 scripts/discover-project-contract.py --root . 探测候选命令；优先 make verify、just verify 等仓库级总入口）；定义 QA 范围（基线验证、改动流程、未改动的关键业务流程）；建立基线（先装依赖，再跑一次规范验证门槛，启动服务并确认就绪）；执行用户式流程（通过 CLI、HTTP 端点、浏览器流程、worker 任务等公开入口，记录命令、输入与可观测结果，先验证改动功能，再验证至少一个回归关键流程）；诊断与修复回归（稳定复现后再修，添加最窄回归测试，修源码或配置而非削弱测试）；最终状态验证（从零重跑完整验证门槛与关键场景，按模板汇总证据）。\n\n使用方式：工件默认放在 /tmp/codex-qa-<slug>（若仓库无约定）；可参考 references/project-signals.md、references/checklist.md、assets/issue-template.md、assets/verification-report-template.md。\n\n适用场景：需要端到端验证仓库改动、跑真实集成流程、或需要可复现 QA 证据时。\n\n限制：mock 只能作为单元测试边界，不能作为用户流程的最终证明；缺少凭据或实时依赖时需逐项验证本地可达边界并单独报告被阻塞步骤；不得声称完成而缺少当前仓库的新鲜验证证据。