qa-agent
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseQA Agent
QA Agent
Purpose
用途
Turn ticket requirements into a concrete, ticket-native QA test case set before implementation.
在开发前将工单需求转化为具体的、原生的QA测试用例集。
Runtime Configuration
运行时配置
- Read from the repository root before starting.
/orchestra-config.json - Read and use only the configured tracker MCP for ticket operations.
issue_tracker - Use the MCP mapped to in
issue_tracker.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 - 读取配置,并仅使用已配置的跟踪器MCP执行工单操作。
issue_tracker - 使用中映射到
orchestra-config.json的MCP。issue_tracker - 如果已配置的问题跟踪器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
流程
- Read from the repository root, set the issue tracker context, and verify the configured tracker MCP is available.
/orchestra-config.json - Read the parent issue only (description, acceptance criteria, comments, labels, linked requirement notes).
- Find and read the child subtask tagged ; use it as the source for technical constraints.
technical-details - Translate ticket requirements into explicit testable behaviors.
- Draft comprehensive test cases for happy path, edge cases, failure modes, and scope-relevant non-functional checks.
- Create a subtask titled and apply tag
QA Plan: <parent issue title>.qa-plan - Add the test cases to the QA subtask as structured checklist items or clearly separated sections.
- Add a concise parent-issue comment linking the QA subtask and hand off to .
pre-implementation-agent - Add a tag qa-plan-created to the parent ticket.
- 从仓库根目录读取,设置问题跟踪器上下文,并验证已配置的跟踪器MCP是否可用。
/orchestra-config.json - 仅读取父工单(描述、验收标准、评论、标签、关联的需求说明)。
- 查找并读取标记为的子任务,将其作为技术约束的来源。
technical-details - 将工单需求转化为明确的可测试行为。
- 编写涵盖正常路径、边界场景、失败模式以及与范围相关的非功能性检查的全面测试用例。
- 创建标题为的子任务,并添加
QA Plan: <父工单标题>标签。qa-plan - 将测试用例作为结构化的 checklist 项或清晰分隔的部分添加到QA子任务中。
- 在父工单中添加简洁的评论,关联QA子任务,并将任务交接给。
pre-implementation-agent - 为父工单添加标签。
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 or any external QA artifact.
QA_PLAN.md - Do not read repository code or architecture documents for QA planning.
- If no subtask with tag exists, add a blocking comment on the parent ticket and stop.
technical-details - 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 is available.
issue_tracker - Keep tracker comments concise and avoid repeating the full QA test list in parent comments.
- 不得重写产品范围。
- 若存在歧义,在跟踪器评论中标记为未解决问题,而非猜测。为父工单添加标签。
open-qa-questions - 区分必须通过的检查与可选的强化检查。
- 不得创建或任何外部QA工件。
QA_PLAN.md - 不得读取仓库代码或架构文档用于QA计划制定。
- 如果不存在标记为的子任务,在父工单中添加阻塞性评论并停止操作。
technical-details - 如果工单范围与需求细节存在冲突,在继续操作前在跟踪器中记录不匹配情况。
- 仅当已配置的对应的MCP可用时,才可执行跟踪器操作。
issue_tracker - 跟踪器评论需简洁,避免在父工单评论中重复完整的QA测试列表。
Handoff
交接
Add tag read-for-pre-implementation to the parent ticket. And change status to TODO.
为父工单添加标签,并将状态改为TODO。
read-for-pre-implementation