SuperAPI AI 工具集

ln-523-auto-test-planner

测试与质量

查看项目

更新于 10-15 15:00

技能介绍

用途

ln-523-auto-test-planner 是一个自动化测试规划技能,类型为 L3 Worker。它在手工测试完成后,为 Story 创建包含完整自动化测试覆盖(E2E/集成/单元)的测试任务,方法基于风险测试(Risk-Based Testing)以及真实的手工测试结果。

它不适用于手工测试、研究或编排工作。

主要能力

  • 为 Story 自动化创建完整的测试任务。
  • 计算基于风险的优先级(影响 × 概率)。
  • 根据手工测试结果生成 11 个章节的测试计划。
  • 委派给 ln-301-task-creator(CREATE 模式)或 ln-302-task-replanner(REPLAN 模式)。

使用方式

输入

  • storyId(必填):来源为 args、git 分支、kanban 或用户;通过 Story Resolution Chain 解析,状态过滤为 To Review。

使用时机

  • 实现工作已完成,需要规划自动化测试覆盖时使用。
  • Story 中所有实现任务状态为 Done。
  • ln-521 研究:如可用则使用,缺失时生成最小化的内联研究。
  • ln-522 手工测试:如可用则使用,缺失时标记为“按策略跳过”。
  • 自动化:在托管运行中支持 autoApprove: true 以跳过人工确认。

工作流程

  • 阶段 0:工具配置。强制读取 references/environment_state_contract.md、references/storage_mode_detection.md、references/input_resolution_pattern.md;提取 task_provider(linear 或 file)。
  • 阶段 1:发现(自动化)。解析 storyId,自动从 docs/tasks/kanban_board.md 发现 Team ID。
  • 阶段 2:Story 与任务分析(无对话)。研究项目测试文件(tests/README.md、测试配置、现有测试结构、覆盖率配置),提取测试命令、框架、模式与覆盖率阈值;加载研究与手工测试结果;分析 Story 与子任务(状态 Done),识别需要测试的内容。
  • 阶段 3:手工测试结果解析策略。定位含“Manual Testing Results”的评论,校验格式版本 1.0,用正则提取结构化章节(验收标准、按 AC 的测试结果、边界情况、错误处理、集成测试),进行校验并映射到测试设计结构。
  • 阶段 4:基于风险的测试规划(自动化)。强制读取 references/risk_based_testing_guide.md;仅在规划完整测试策略或风险/有用性判断不明确时读取 references/risk_based_testing_methodology.md。采用 E2E 优先方法,按业务风险(优先级 = 影响 × 概率)排序。
  • 阶段 5:测试任务生成(自动化)。按 test_task_template.md 生成 11 个章节的完整测试任务,并显示预览供审阅。
  • 阶段 6:确认与委派。显示预览;autoApprove: true 时自动继续,否则提示用户输入“confirm”;检查是否已存在测试任务,决定 CREATE 或 REPLAN 模式,并通过 task-plan-worker-runtime 委派给 ln-301 或 ln-302。

风险决策标准

  • 优先级 ≥15:必须测试。
  • 优先级 9-14:若未覆盖则应测试。
  • 优先级 ≤8:跳过(手工测试已足够)。

测试选择

  • E2E 测试(2-5 个):基线 2 个(正向 + 负向)始终保留,额外 0-3 个仅限优先级 ≥15。
  • 单元测试(0-15 个):默认 0,仅针对复杂业务逻辑(优先级 ≥15):金融、安全、算法。
  • 集成测试:默认 0,仅当 E2E 存在缺口且优先级 ≥15 时添加:回滚、并发、外部 API 错误。

适用场景

  • 实现任务全部完成、需要为 Story 规划自动化测试覆盖。
  • 已有 ln-521 研究与 ln-522 手工测试结果,希望据此生成有优先级的测试计划。
  • 需要以 E2E 优先、基于风险的方式决定测试范围。

限制

  • 不用于手工测试、研究或编排。
  • 不创建任务本身,任务创建通过 ln-301/ln-302 worker 完成;本技能只生成计划。
  • 每个超出基线的测试必须通过全部 6 项有用性标准。
  • 不测试框架/库行为,每个测试必须验证自身业务逻辑。
  • 托管子运行仅限:父子委派必须使用 task-plan-worker-runtime、确定性子 runId、精确的子 summaryArtifactPath,并仅消费产物。
  • 手工测试结果缺失时按简化模式处理,标记为“按策略跳过”。

输出

  • CREATE 模式:Tracker Issue/Story URL + 确认。
  • REPLAN 模式:操作摘要 + URL。

参考文件

  • references/environment_state_contract.md
  • references/storage_mode_detection.md
  • references/risk_based_testing_guide.md
  • references/risk_based_testing_methodology.md
  • references/auto_discovery_pattern.md
  • references/templates/test_task_template.md
  • references/risk_based_testing_examples.md
  • references/research_tool_fallback.md

版本:1.0.0;最后更新:2026-01-15。