用途:在代码实现变更后运行现有测试套件,验证是否引入回归,作为 Story 的质量门禁。
主要能力:自动检测测试框架(pytest/jest/vitest/go test 等)与测试目录;执行完整测试套件并捕获 stdout/stderr;解析通过/失败数量与关键失败用例;按错误类别(导入/模块、断言、超时、类型、连接、运行时)对失败进行分组;输出 PASS/FAIL 判定并添加 Linear 评论;保留完整输出供下游日志分析。
使用方式:输入 storyId(必填,来源为 args、git 分支、kanban 或用户),状态过滤为 To Review。先解析输入,再读取项目文件 docs/project/infrastructure.md 与 docs/project/runbook.md 获取服务端点、端口、测试命令、Docker 设置与环境变量;runbook 命令优先于自动检测。构建测试命令后以超时(5 分钟)运行并捕获输出。独立运行时省略 runId 与 summaryArtifactPath;托管运行时需传入两者,并在终态前写入校验后的摘要。预期超过 30 秒的测试命令可使用 Monitor,回退方案为 Bash(run_in_background=true)。
适用场景:代码质量检查通过后,Story 需要回归验证时使用。
限制:必须运行完整测试套件,不允许选择性运行;不修复测试、不更改状态,仅报告;评论需保留原语言(EN/RU)。