SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场ln-521-test-researcher

ln-521-test-researcher

测试与质量

查看项目

更新于 10-15 14:50

技能介绍

用途

ln-521-test-researcher 是一个 L3 Worker，属于测试规划工作流。它的目标是在测试规划开始之前，针对某个功能领域进行真实世界调研，确保测试覆盖实际用户痛点，而不仅仅是验收标准（AC）。

主要能力

  • 使用 Web Search、MCP Ref、Context7 研究功能领域的常见问题。
  • 分析竞品如何解决同一问题。
  • 从论坛、StackOverflow、Reddit 查找客户投诉与痛点。
  • 将结构化调研结果作为 tracker 评论（addComment）发布，供后续测试规划步骤使用。
  • 不创建测试，不改变状态。

使用方式

输入

  • storyId（必填）：来源为 args、git 分支、kanban 或用户。
  • 解析方式：Story Resolution Chain。
  • 状态过滤：To Review。

何时使用

  • 在测试规划工作流开始时，需要功能领域证据时使用。
  • Story 具有非平凡功能（外部 API、文件格式、认证）时使用。
  • 需要发现 AC 之外的边界情况时使用。

何时跳过

  • Story 很简单（简单 CRUD，无外部依赖）。
  • Story 上已存在调研评论。
  • 用户明确要求跳过。

工作流

  1. 发现阶段：必读 references/input_resolution_pattern.md；按指南运行 Story Resolution Chain 解析 storyId（状态过滤 [To Review]）；从 docs/tasks/kanban_board.md 自动发现 Team ID。
  2. 提取功能领域：通过配置的 tracker provider（getStory）获取 Story；解析 Story 目标与 AC，识别涉及的技术/API/格式、用户目标，并提取研究查询关键词。
  3. 研究常见问题：使用 Web Search（如 "[feature] common problems"、"[format] edge cases"、"[API] gotchas"、"[technology] known issues"）、MCP Ref（ref_search_documentation 查询错误处理最佳实践、验证规则等）、Context7（查询相关库文档的已知问题、API 文档限制）。
  4. 研究竞品方案：Web Search 查询竞品实现方式、功能对比、最佳实践；分析市场领先者如何处理该功能、使用的 UX 模式、常见错误处理方式。
  5. 研究客户投诉：Web Search 查询投诉、用户问题、Reddit/StackOverflow 上的问题；分析用户实际困难、常见挫败点、用户期望与典型实现之间的差距。
  6. 汇总并发布发现：将发现归类为输入验证问题、边界情况、错误处理、安全隐患、竞品优势、客户痛点；以 tracker 评论（addComment）发布到 Story，包含来源、常见问题、竞品分析、客户痛点、推荐测试覆盖等结构化内容。

输出

Tracker 评论，包含调研发现，供 ln-522 和 ln-523 使用。

适用场景

  • 功能涉及外部 API、文件格式、认证等非平凡逻辑。
  • 需要发现 AC 之外的边界情况。
  • 需要了解竞品做法与用户真实痛点以指导测试覆盖。

限制

  • 不创建测试：只做研究与文档。
  • 不改变状态：只发布 tracker 评论。
  • 必须标注来源 URL。
  • 每条问题应给出可执行的测试用例建议。
  • 不研究简单 Story（如“给页面加个按钮”）。

运行摘要

必读 references/test_planning_summary_contract.md 与 references/test_planning_worker_runtime_contract.md。

运行时配置：

  • family: test-planning-worker
  • worker: ln-521
  • summary kind: test-planning-worker
  • 协调器使用的 payload 字段：worker、status、warnings、research_comment_path

调用规则：

  • standalone：省略 runId 和 summaryArtifactPath。
  • managed：同时传入 runId 和确切的 summaryArtifactPath。
  • 始终在最终结果前写入已验证的摘要。

完成定义

  • 从 Story 提取功能领域（识别技术/API/格式）。
  • 研究常见问题（Web Search + MCP Ref + Context7）。
  • 分析竞品方案（至少 1-2 个竞品）。
  • 找到客户投诉（论坛、StackOverflow、Reddit）。
  • 将发现归类。
  • 发布带 "## Test Research: {Feature}" 标题的 tracker 评论。
  • 至少建议 3 个推荐测试用例。

参考文件

  • 研究方法：Web Search、MCP Ref、Context7 工具。
  • 评论格式：带来源的结构化 markdown。
  • 下游消费者：ln-522-manual-tester、ln-523-auto-test-planner。
  • 必读：references/research_tool_fallback.md。

版本：1.0.0 最后更新：2026-01-15