ln-520-test-planner
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChinesePaths: File paths (,shared/,references/) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root.../ln-*
路径: 文件路径(、shared/、references/)是相对于技能仓库根目录的路径。如果在当前工作目录找不到,请找到此SKILL.md所在目录,向上跳转一级即可到达仓库根目录。../ln-*
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-302ln-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-302Workflow
工作流
Phase 1: Discovery
阶段1:信息梳理
- Auto-discover Team ID from
docs/tasks/kanban_board.md - Validate Story ID provided by ln-500
Input: Story ID from ln-500-story-quality-gate
- 从自动获取团队ID
docs/tasks/kanban_board.md - 校验ln-500提供的用户故事ID
输入: 来自ln-500-story-quality-gate的用户故事ID
Phase 2: Research Delegation
阶段2:调研任务委派
-
Check if research exists:
- Search Linear comments for "## Test Research:" header
- If found → skip to Phase 3
-
If no research:
- Use Skill tool to invoke
ln-521-test-researcher - Pass: Story ID
- Wait for completion
- Verify research comment created
- Use Skill tool to invoke
-
检查是否已有调研结果:
- 在Linear评论中搜索"## Test Research:"标题
- 若已存在 → 直接跳至阶段3
-
若无调研结果:
- 使用Skill工具调用
ln-521-test-researcher - 传入参数:用户故事ID
- 等待执行完成
- 校验调研评论已生成
- 使用Skill工具调用
Phase 3: Manual Testing Delegation
阶段3:手动测试任务委派
-
Check if manual testing done:
- Search Linear comments for "## Manual Testing Results" header
- If found with all AC passed → skip to Phase 4
-
If manual testing needed:
- Use Skill tool to invoke
ln-522-manual-tester - Pass: Story ID
- Wait for completion
- Verify results comment created
- Use Skill tool to invoke
-
If any AC failed:
- Stop pipeline
- Report to ln-500: "Manual testing failed, Story needs fixes"
-
检查手动测试是否已完成:
- 在Linear评论中搜索"## Manual Testing Results"标题
- 若存在且所有验收标准都已通过 → 跳至阶段4
-
若需要执行手动测试:
- 使用Skill工具调用
ln-522-manual-tester - 传入参数:用户故事ID
- 等待执行完成
- 校验结果评论已生成
- 使用Skill工具调用
-
若有验收标准未通过:
- 停止流水线
- 向ln-500上报:"手动测试未通过,用户故事需要修复"
Phase 4: Auto Test Planning Delegation
阶段4:自动化测试规划任务委派
-
Invoke auto test planner:
- Use Skill tool to invoke
ln-523-auto-test-planner - Pass: Story ID
- Wait for completion
- Use Skill tool to invoke
-
Verify results:
- Test task created in Linear (or updated if existed)
- Return task URL to ln-500
-
调用自动化测试规划器:
- 使用Skill工具调用
ln-523-auto-test-planner - 传入参数:用户故事ID
- 等待执行完成
- 使用Skill工具调用
-
校验结果:
- Linear中已创建测试任务(若已存在则更新)
- 将任务URL返回给ln-500
Phase 5: Report to Caller
阶段5:向调用方上报结果
- Return summary to ln-500:
- Research: completed / skipped (existed)
- Manual testing: passed / failed
- Test task: created / updated + URL
- 向ln-500返回汇总信息:
- 调研:已完成/已跳过(已存在)
- 手动测试:已通过/未通过
- 测试任务:已创建/已更新 + 对应URL
Worker Invocation (MANDATORY)
工作流节点调用规则(强制)
CRITICAL: All delegations use Task tool withfor context isolation.subagent_type: "general-purpose"
| Phase | Worker | Purpose |
|---|---|---|
| 2 | ln-521-test-researcher | Research real-world problems |
| 3 | ln-522-manual-tester | Manual AC testing via bash scripts |
| 4 | ln-523-auto-test-planner | Plan 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"
| 阶段 | 工作流节点 | 用途 |
|---|---|---|
| 2 | ln-521-test-researcher | 调研实际业务问题 |
| 3 | ln-522-manual-tester | 通过bash脚本执行验收标准手动测试 |
| 4 | ln-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