ln-513-regression-checker

路径： 文件路径（references/、../ln-*）均相对于此技能目录。

回归检查器

类型： L3 Worker 类别： 5XX 质量

运行现有测试套件，确保实现变更后没有引入回归。

输入

输入	必需	来源	描述
storyId	是	args, git branch, kanban, user	要处理的 Story

解析： Story 解析链。 状态筛选： To Review

目的与范围

• 检测测试框架（pytest/jest/vitest/go test 等）和测试目录。
• 执行完整测试套件；捕获 stdout/stderr，供 Story 质量门禁使用。
• 返回 PASS/FAIL 及计数/日志摘录；绝不修改 Linear 或 kanban。
• 保留完整 stdout/stderr 输出，以供下游日志分析。

使用时机

• 代码质量检查通过后
• 代码质量检查已通过

工作流

阶段 0：解析输入

必须阅读： 加载 references/input_resolution_pattern.md、references/ci_tool_detection.md

1. 解析 storyId： 按指南运行 Story 解析链（状态筛选：[To Review]）。

阶段 1：执行测试

必须阅读： 加载 references/output_normalization.md

如果目标项目文件存在，则读取：docs/project/infrastructure.md、docs/project/runbook.md

1. 根据 ci_tool_detection.md 的命令注册表（Test Frameworks 部分）自动发现测试框架。
2. 从 infrastructure.md 获取服务端点和端口分配信息。从 runbook.md 获取精确的测试命令、Docker 设置和环境变量。根据 ci_tool_detection.md 的发现层级，Runbook 命令优先于自动检测结果。
3. 构建合适的测试命令；设置超时时间（根据 ci_tool_detection.md，5min）；捕获 stdout/stderr。
4. 解析结果：通过/失败计数；关键失败测试。
5. 规范化并归类失败： 将 references/output_normalization.md §1-§3 应用于测试输出。按错误类别归类失败测试（Import/Module、Assertion、Timeout、Type、Connection、Runtime）。按类别报告，例如：“auth/ 中有 3 个 Import 错误，payment/ 中有 2 个 Assertion 不匹配”。
6. 输出 verdict JSON（PASS 或 FAIL + 归类后的失败列表），并添加 Linear 评论。

关键规则

• 不得选择性运行测试；运行完整套件。
• 不要修复测试或更改状态；只做报告。
• 评论中保留原语言（EN/RU）。

运行时摘要产物

必须阅读： 加载 references/quality_summary_contract.md、references/quality_worker_runtime_contract.md

运行时配置：

• family：quality-worker
• worker：ln-513
• summary kind：quality-worker
• 协调器使用的 payload 字段：worker、status、verdict、issues、warnings、artifact_path

调用规则：

• 独立运行：省略 runId 和 summaryArtifactPath
• 受管理运行：同时传入 runId 和准确的 summaryArtifactPath
• 始终在终结结果前写入经过验证的摘要

Monitor（2.1.98+）： 对预计耗时超过 30s 的测试套件命令，使用 Monitor。回退方案：Bash(run_in_background=true)。

完成定义

• 已检测到框架；已执行命令
• 已解析结果；已生成 verdict，并列出失败测试（如有）
• 已发布包含摘要的 Tracker 评论

参考文件

• 下游使用的基于风险的限制：references/risk_based_testing_guide.md
• CI 工具检测： references/ci_tool_detection.md
• 输出规范化： references/output_normalization.md
• Pytest 模式： references/pytest_configuration.md

---

版本： 3.1.0 最后更新： 2026-01-09