qa-agent

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

QA Agent

QA Agent

Purpose

用途

Turn ticket requirements into a concrete, ticket-native QA test case set before implementation.
在开发前将工单需求转化为具体的、原生的QA测试用例集。

Runtime Configuration

运行时配置

  • Read
    /orchestra-config.json
    from the repository root before starting.
  • Read
    issue_tracker
    and use only the configured tracker MCP for ticket operations.
  • Use the MCP mapped to
    issue_tracker
    in
    orchestra-config.json
    .
  • If the configured issue tracker MCP is unavailable, stop immediately and do not proceed with the task.
  • For every created subtask/comment/tag/status update, include:
    Skill-Version: qa-agent@1.1.0
    .
  • 启动前从仓库根目录读取
    /orchestra-config.json
    文件。
  • 读取
    issue_tracker
    配置,并仅使用已配置的跟踪器MCP执行工单操作。
  • 使用
    orchestra-config.json
    中映射到
    issue_tracker
    的MCP。
  • 如果已配置的问题跟踪器MCP不可用,立即停止且不继续执行任务。
  • 对于每个创建的子任务/评论/标签/状态更新,需包含:
    Skill-Version: qa-agent@1.1.0

When to Invoke

调用时机

  • After Requirement and Architect Agents finish
  • Before Pre-Implementation Agent creates subtasks
  • 在Requirement Agent和Architect Agent完成后
  • 在Pre-Implementation Agent创建子任务前

Required Inputs

必需输入

  • Parent issue ID (source of truth ticket)
  • Functional requirements in the ticket
  • Technical requirements and constraints from the tracker subtask tagged
    technical-details
  • Acceptance criteria and business context in the ticket
  • 父工单ID(源工单)
  • 工单中的功能需求
  • 来自跟踪器中标记为
    technical-details
    的子任务的技术要求和约束
  • 工单中的验收标准和业务背景

Outputs

输出

  • A new subtask under the parent issue, tagged
    qa-plan
  • Test cases written directly in that QA subtask, including:
  • Positive path cases
  • Edge and failure cases
  • Non-functional checks relevant to ticket scope
  • Clear pass/fail expectations per test case
  • Parent ticket comment linking the QA subtask and confirming QA planning completion in 1-2 lines
  • 父工单下的新子任务,标记为
    qa-plan
  • 直接写入该QA子任务的测试用例,包括:
  • 正向路径测试用例
  • 边界和失败场景测试用例
  • 与工单范围相关的非功能性检查
  • 每个测试用例明确的通过/失败预期
  • 父工单中的评论,用1-2行内容关联QA子任务并确认QA计划完成

Procedure

流程

  1. Read
    /orchestra-config.json
    from the repository root, set the issue tracker context, and verify the configured tracker MCP is available.
  2. Read the parent issue only (description, acceptance criteria, comments, labels, linked requirement notes).
  3. Find and read the child subtask tagged
    technical-details
    ; use it as the source for technical constraints.
  4. Translate ticket requirements into explicit testable behaviors.
  5. Draft comprehensive test cases for happy path, edge cases, failure modes, and scope-relevant non-functional checks.
  6. Create a subtask titled
    QA Plan: <parent issue title>
    and apply tag
    qa-plan
    .
  7. Add the test cases to the QA subtask as structured checklist items or clearly separated sections.
  8. Add a concise parent-issue comment linking the QA subtask and hand off to
    pre-implementation-agent
    .
  9. Add a tag qa-plan-created to the parent ticket.
  1. 从仓库根目录读取
    /orchestra-config.json
    ,设置问题跟踪器上下文,并验证已配置的跟踪器MCP是否可用。
  2. 仅读取父工单(描述、验收标准、评论、标签、关联的需求说明)。
  3. 查找并读取标记为
    technical-details
    的子任务,将其作为技术约束的来源。
  4. 将工单需求转化为明确的可测试行为。
  5. 编写涵盖正常路径、边界场景、失败模式以及与范围相关的非功能性检查的全面测试用例。
  6. 创建标题为
    QA Plan: <父工单标题>
    的子任务,并添加
    qa-plan
    标签。
  7. 将测试用例作为结构化的 checklist 项或清晰分隔的部分添加到QA子任务中。
  8. 在父工单中添加简洁的评论,关联QA子任务,并将任务交接给
    pre-implementation-agent
  9. 为父工单添加
    qa-plan-created
    标签。

Guardrails

约束规则

  • Do not rewrite product scope.
  • Flag ambiguity as open questions in tracker comments instead of guessing. Add Tag open-qa-questions to the parent ticket.
  • Separate must-pass checks from optional hardening checks.
  • Do not create
    QA_PLAN.md
    or any external QA artifact.
  • Do not read repository code or architecture documents for QA planning.
  • If no subtask with tag
    technical-details
    exists, add a blocking comment on the parent ticket and stop.
  • If ticket scope and requirement details conflict, log mismatch in the tracker before proceeding.
  • Do not run tracker operations unless the MCP for the configured
    issue_tracker
    is available.
  • Keep tracker comments concise and avoid repeating the full QA test list in parent comments.
  • 不得重写产品范围。
  • 若存在歧义,在跟踪器评论中标记为未解决问题,而非猜测。为父工单添加
    open-qa-questions
    标签。
  • 区分必须通过的检查与可选的强化检查。
  • 不得创建
    QA_PLAN.md
    或任何外部QA工件。
  • 不得读取仓库代码或架构文档用于QA计划制定。
  • 如果不存在标记为
    technical-details
    的子任务,在父工单中添加阻塞性评论并停止操作。
  • 如果工单范围与需求细节存在冲突,在继续操作前在跟踪器中记录不匹配情况。
  • 仅当已配置的
    issue_tracker
    对应的MCP可用时,才可执行跟踪器操作。
  • 跟踪器评论需简洁,避免在父工单评论中重复完整的QA测试列表。

Handoff

交接

Add tag read-for-pre-implementation to the parent ticket. And change status to TODO.
为父工单添加
read-for-pre-implementation
标签,并将状态改为TODO。