ln-520-test-planner

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
Paths: File paths (
shared/
,
references/
,
../ln-*
) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root.
路径: 文件路径(
shared/
references/
../ln-*
)是相对于技能仓库根目录的路径。如果在当前工作目录找不到,请找到此SKILL.md所在目录,向上跳转一级即可到达仓库根目录。

Test Planning Orchestrator

测试规划编排器

Coordinates the complete test planning pipeline for a Story by delegating to specialized workers.
通过委托给专业工作流节点,协调整个用户故事的测试规划流水线。

Purpose & Scope

目的与范围

  • Orchestrate test planning: research → manual testing → automated test planning
  • Delegate to workers: ln-521-test-researcher, ln-522-manual-tester, ln-523-auto-test-planner
  • No direct work — only coordination and delegation via Skill tool
  • Called by ln-500-story-quality-gate after regression tests pass
  • 编排测试规划:调研→手动测试→自动化测试规划
  • 委托给工作流节点:ln-521-test-researcher、ln-522-manual-tester、ln-523-auto-test-planner
  • 不直接执行工作 —— 仅通过Skill工具进行协调和任务委派
  • 调用方:回归测试通过后由ln-500-story-quality-gate调用

When to Use

使用场景

This skill should be used when:
  • Invoked by ln-500-story-quality-gate after quality checks pass
  • All implementation tasks in Story are Done
  • Need complete test planning (research + manual + auto)
Prerequisites:
  • All implementation Tasks in Story status = Done
  • Regression tests passed (ln-514)
  • Code quality checked (ln-511)
此skill适用于以下场景:
  • 质量检查通过后,由ln-500-story-quality-gate调用
  • 用户故事下的所有实现任务都已完成
  • 需要完整的测试规划(调研+手动测试+自动化测试)
前置条件:
  • 用户故事下所有实现任务的状态 = 已完成
  • 回归测试已通过(ln-514)
  • 代码质量已检查(ln-511)

Pipeline Overview

流水线概览

ln-520-test-planner (Orchestrator)
    ├─→ ln-521-test-researcher
    │     └─→ Posts "## Test Research: {Feature}" comment
    ├─→ ln-522-manual-tester
    │     └─→ Creates tests/manual/ scripts + "## Manual Testing Results" comment
    └─→ ln-523-auto-test-planner
          └─→ Creates test task in Linear via ln-301/ln-302
ln-520-test-planner (Orchestrator)
    ├─→ ln-521-test-researcher
    │     └─→ Posts "## Test Research: {Feature}" comment
    ├─→ ln-522-manual-tester
    │     └─→ Creates tests/manual/ scripts + "## Manual Testing Results" comment
    └─→ ln-523-auto-test-planner
          └─→ Creates test task in Linear via ln-301/ln-302

Workflow

工作流

Phase 1: Discovery

阶段1:信息梳理

  1. Auto-discover Team ID from
    docs/tasks/kanban_board.md
  2. Validate Story ID provided by ln-500
Input: Story ID from ln-500-story-quality-gate
  1. docs/tasks/kanban_board.md
    自动获取团队ID
  2. 校验ln-500提供的用户故事ID
输入: 来自ln-500-story-quality-gate的用户故事ID

Phase 2: Research Delegation

阶段2:调研任务委派

  1. Check if research exists:
    • Search Linear comments for "## Test Research:" header
    • If found → skip to Phase 3
  2. If no research:
    • Use Skill tool to invoke
      ln-521-test-researcher
    • Pass: Story ID
    • Wait for completion
    • Verify research comment created
  1. 检查是否已有调研结果:
    • 在Linear评论中搜索"## Test Research:"标题
    • 若已存在 → 直接跳至阶段3
  2. 若无调研结果:
    • 使用Skill工具调用
      ln-521-test-researcher
    • 传入参数:用户故事ID
    • 等待执行完成
    • 校验调研评论已生成

Phase 3: Manual Testing Delegation

阶段3:手动测试任务委派

  1. Check if manual testing done:
    • Search Linear comments for "## Manual Testing Results" header
    • If found with all AC passed → skip to Phase 4
  2. If manual testing needed:
    • Use Skill tool to invoke
      ln-522-manual-tester
    • Pass: Story ID
    • Wait for completion
    • Verify results comment created
  3. If any AC failed:
    • Stop pipeline
    • Report to ln-500: "Manual testing failed, Story needs fixes"
  1. 检查手动测试是否已完成:
    • 在Linear评论中搜索"## Manual Testing Results"标题
    • 若存在且所有验收标准都已通过 → 跳至阶段4
  2. 若需要执行手动测试:
    • 使用Skill工具调用
      ln-522-manual-tester
    • 传入参数:用户故事ID
    • 等待执行完成
    • 校验结果评论已生成
  3. 若有验收标准未通过:
    • 停止流水线
    • 向ln-500上报:"手动测试未通过,用户故事需要修复"

Phase 4: Auto Test Planning Delegation

阶段4:自动化测试规划任务委派

  1. Invoke auto test planner:
    • Use Skill tool to invoke
      ln-523-auto-test-planner
    • Pass: Story ID
    • Wait for completion
  2. Verify results:
    • Test task created in Linear (or updated if existed)
    • Return task URL to ln-500
  1. 调用自动化测试规划器:
    • 使用Skill工具调用
      ln-523-auto-test-planner
    • 传入参数:用户故事ID
    • 等待执行完成
  2. 校验结果:
    • Linear中已创建测试任务(若已存在则更新)
    • 将任务URL返回给ln-500

Phase 5: Report to Caller

阶段5:向调用方上报结果

  1. Return summary to ln-500:
    • Research: completed / skipped (existed)
    • Manual testing: passed / failed
    • Test task: created / updated + URL
  1. 向ln-500返回汇总信息:
    • 调研:已完成/已跳过(已存在)
    • 手动测试:已通过/未通过
    • 测试任务:已创建/已更新 + 对应URL

Worker Invocation (MANDATORY)

工作流节点调用规则(强制)

CRITICAL: All delegations use Task tool with
subagent_type: "general-purpose"
for context isolation.
PhaseWorkerPurpose
2ln-521-test-researcherResearch real-world problems
3ln-522-manual-testerManual AC testing via bash scripts
4ln-523-auto-test-plannerPlan E2E/Integration/Unit tests
Prompt template:
Task(description: "[Phase N] test planning via ln-52X",
     prompt: "Execute ln-52X-{worker}. Read skill from ln-52X-{worker}/SKILL.md. Story: {storyId}",
     subagent_type: "general-purpose")
Anti-Patterns:
  • ❌ Direct Skill tool invocation without Task wrapper
  • ❌ Running web searches directly (delegate to ln-521)
  • ❌ Creating bash test scripts directly (delegate to ln-522)
  • ❌ Creating test tasks directly (delegate to ln-523)
  • ❌ Skipping any phase without justification
重要提示: 所有任务委派都要使用Task工具,指定
subagent_type: "general-purpose"
以实现上下文隔离。
阶段工作流节点用途
2ln-521-test-researcher调研实际业务问题
3ln-522-manual-tester通过bash脚本执行验收标准手动测试
4ln-523-auto-test-planner规划E2E/集成/单元测试
提示模板:
Task(description: "[Phase N] test planning via ln-52X",
     prompt: "Execute ln-52X-{worker}. Read skill from ln-52X-{worker}/SKILL.md. Story: {storyId}",
     subagent_type: "general-purpose")
反模式:
  • ❌ 不使用Task封装直接调用Skill工具
  • ❌ 直接执行网页搜索(委派给ln-521执行)
  • ❌ 直接创建bash测试脚本(委派给ln-522执行)
  • ❌ 直接创建测试任务(委派给ln-523执行)
  • ❌ 无合理理由跳过任意阶段

Critical Rules

核心规则

  • No direct work: Orchestrator only delegates, never executes tasks itself
  • Sequential execution: 521 → 522 → 523 (each depends on previous)
  • Fail-fast: If manual testing fails, stop pipeline and report
  • Skip detection: Check for existing comments before invoking workers
  • Single responsibility: Each worker does one thing well
  • 不直接执行工作: 编排器仅做任务委派,从不自行执行任务
  • 顺序执行: 521 → 522 → 523(每个阶段依赖前一阶段的结果)
  • 快速失败: 若手动测试失败,立即停止流水线并上报
  • 跳过逻辑: 调用工作流节点前先检查是否已有对应评论
  • 单一职责: 每个工作流节点仅专注做好一件事

Definition of Done

完成定义

  • Story ID validated
  • Research phase: ln-521 invoked OR existing comment found
  • Manual testing phase: ln-522 invoked OR existing results found
  • Auto test planning phase: ln-523 invoked
  • Test task created/updated in Linear
  • Summary returned to ln-500-story-quality-gate
Output: Summary with phase results + test task URL
  • 用户故事ID已校验
  • 调研阶段:已调用ln-521 或 已找到现有评论
  • 手动测试阶段:已调用ln-522 或 已找到现有结果
  • 自动化测试规划阶段:已调用ln-523
  • Linear中已创建/更新测试任务
  • 已向ln-500-story-quality-gate返回汇总信息
输出: 包含各阶段结果+测试任务URL的汇总信息

Reference Files

参考文件

  • Workers:
    ../ln-521-test-researcher/SKILL.md
    ,
    ../ln-522-manual-tester/SKILL.md
    ,
    ../ln-523-auto-test-planner/SKILL.md
  • Caller:
    ../ln-500-story-quality-gate/SKILL.md
  • Risk-based testing:
    ../shared/references/risk_based_testing_guide.md

Version: 4.0.0 Last Updated: 2026-01-15
  • 工作流节点:
    ../ln-521-test-researcher/SKILL.md
    ../ln-522-manual-tester/SKILL.md
    ../ln-523-auto-test-planner/SKILL.md
  • 调用方:
    ../ln-500-story-quality-gate/SKILL.md
  • 风险导向测试:
    ../shared/references/risk_based_testing_guide.md

版本: 4.0.0 最后更新: 2026-01-15