用途
run-qa 用于对项目执行质量验证，触发场景包括用户要求“运行 QA”“验证真实播放”“测试提供方连接”，或检查网站、浏览器扩展与 Android 流程。它面向需要真实运行而非静态检查的回归验证。
主要能力
- 读取 .agents/skills/qa/SKILL.md 与 .agents/qa/config.json 获取项目 QA 配置，并运行 project-qa run --root <repo>。若文件缺失，走 setup 流程。
- 支持 --filter <id-substring> 限定后续运行范围。
- 支持 --base-url <url> 临时指定网站目标，无需改动项目设置；API 与认证 URL 仍单独配置。
- 报告输出 report.json，可查看生效的 baseUrl 与实际测试的版本，并确认浏览器目标。
- 报告区分 pass、fail、blocked，记录 Git 版本，截图默认私密保存；退出码 0 表示所选用例通过，1 表示失败，2 表示阻塞。
- 单独报告被省略的用例与配置缺口。
使用方式
优先使用确定性脚本。交互式排查可用于修复失败流程，随后将可重复步骤写入其受跟踪的测试套件。不得用模拟成功替代失败的实时行为。若需 UI 审计，可在已安装时使用 ui-regression 技能，并分别报告功能、渲染质量与运行时结论。恢复登录前先读取会话，生产流量前先读取遥测，并暴露相关组件的需求。Runner API 定义可执行用例及可选的 browser-network-cli 诊断，必要时包含安装。最后验证创建的数据与标签页已清理，保留会话供下次运行；不要关闭个人浏览器标签、不要在每次测试后登出提供方，也不要并发运行共享同一 stateGroup 的套件。
适用场景
适用于需要真实回放和端到端流程验证的项目，涵盖网站、扩展与 Android 流程。
限制
通过某条流程仅证明其断言成立，不代表未检查的视觉质量或运行时健康。具体配置项、安装步骤与依赖细节暂未提供。