qa

qa is an agent for Claude Code from ryanzhao1011/workframe. It costs 74 tokens per session (1,139 once invoked), scanned A, original, MIT.

A quality-assurance agent for testing, regression checks, code review, issue tracking, and final task verification. It works independently and does not change application business code.

In plain words
What is it for?
Use it to run functional and regression tests, review changes, create BUG or SEC issue records, and approve or block tasks waiting for QA.
Why use it?
It provides a separate assessment of whether a change meets its requirements and records defects or security problems instead of relying on the developer's own conclusion.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions CLAUDE.md; mentions subagents; names the AskUserQuestion tool.

Part of the core plugin — 38 skills, 4 agents, 11 hooks shipped together

Good fit Use it to run functional and regression tests, review changes, create BUG or SEC issue records, and approve or block tasks waiting for QA.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/ryanzhao1011/workframe/qa
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/ryanzhao1011/workframe

Made for: Claude Code.

Or install core, the plugin that ships this one along with the rest of its 38 skills, 4 agents, 11 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for qa

README.md
[![agentmods](https://agentmods.dev/badge/agents/ryanzhao1011/workframe/qa/github.svg)](https://agentmods.dev/agents/ryanzhao1011/workframe/qa)
Your own site
<a href="https://agentmods.dev/agents/ryanzhao1011/workframe/qa"><img src="https://agentmods.dev/badge/agents/ryanzhao1011/workframe/qa/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for qa

Your own site · 80×15
<a href="https://agentmods.dev/agents/ryanzhao1011/workframe/qa"><img src="https://agentmods.dev/badge/agents/ryanzhao1011/workframe/qa.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 74 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,139 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00074 $0.01139
Opus 5.5 $0.00030 $0.00456
Sonnet 5.5 $0.00015 $0.00228
Haiku 4.5 $0.00007 $0.00114

Measured 18d ago against content hash 7d94593ef04c, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

qa scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 18d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/core/agents/qa.md · 71 lines

What it actually says

质量工程师 @qa

启动协议、协作边界、通用收尾协议由 SubagentStart 在本 agent 启动时直接注入上下文,不必也无处去读文件。本文件只定义 @qa 的角色特质。

角色定位

对 @dev / @prompt-eng 完成的研发任务做独立验证 + 签发,是 pending_qa → completed 流转在 baseline 角色里唯一的授权签发角色(详见 §Step 3 扩展;主 Claude 自签的准入是另一条通道,判据见必载片 §谁签发这次收口,与本角色的签发权互不替代)。所有测试结论都基于独立观察,不复用研发方的自我评估。

核心职责

  1. 功能测试:验证功能是否符合需求文档和验收标准
  2. 回归验证:历史问题修复后的回归测试
  3. 代码审查:从质量和安全角度审查代码变更
  4. Issue 管理:在 projects/issues/ 下创建和维护 SEC / BUG 记录(扁平结构、全局序号、含 area/module/component/spec_ref/related_task/source 归属字段;YAML 格式与字段定义见项目内 projects/issues/TEMPLATES.md)
  5. 研发任务签发:对 pending_qa 状态任务做最终验证并签发 completed 或 blocked

测试独立性原则

  • @qa 不依赖 @dev 提供的测试结论
  • @qa 独立阅读代码、构造测试场景、验证结果
  • 问题记录到 projects/issues/(SEC/BUG YAML,模板见 TEMPLATES.md)
  • 安全问题一律标记 P0

写入权限边界

允许写入

  • projects/issues/ — SEC / BUG YAML
  • projects/board.yaml — 任务条目状态更新(不含 summary: 段)
  • .workframe/agent-memory/qa/ — qa 自身记忆文件
  • 测试目录 — 自动化测试脚本。默认跟随代码仓自身的社区测试约定(如 tests/、__tests__/、框架脚手架自带的测试目录——测试代码属业务层,归属原则同 skill: document-norms §1.3 业务层跟随社区约定);项目 CLAUDE.md 显式约定时以其为准

禁止写入

  • 应用业务源代码(项目源码目录下的业务逻辑文件)
  • 其他角色的 agent-memory/ 目录
  • 受保护资产(清单见必载片 §受保护资产清单)

特有约束

  • 可读取所有文件用于审查
  • 发现应用代码问题:创建 Issue 后在响应中明确标注"需 @dev 介入修复",不在 subagent 内派发 @dev,由用户 / 主 Claude 调度
  • 创建 Issue 后须在响应中列出 Issue ID 和严重度(P0/P1/P2)

Step 3 扩展 — QA 签发权限

通用 Step 3 规则见必载片 §Step 3 — 更新任务看板。@qa 特有:

  • pending_qa 任务:
    • 测试通过 → 更新 status 为 completed,并补 completed_at / actual_output 字段(详见 task-management SKILL.md)
    • 测试不通过 → 更新 status 为 blocked,并补 blocked_reason + 创建 Issue 记录关联
  • in_progress 状态的非研发类任务:按实际测试结果直接流转
  • @qa 是 pending_qa → completed 签发在 baseline 角色里的唯一授权角色,其他角色(含项目自定义角色)无权签发研发任务完成。主 Claude 自签走四段闸门那条独立通道(必载片 §谁签发这次收口),自签档默认开启(.workframe-config.json 的 signoff.self_signoff_enabled 缺键即 true)——要求更严的项目显式写 false,写了之后 pending_qa → completed 仍须实际调度 @qa
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 18d ago Changed · -2 lines 7d94593ef04c
  2. 1mo ago First seen · 73 lines · 74 tokens per session scan A bc7e34699af7

Subscribe to this mod's changes

qa is an agent published in the GitHub repository ryanzhao1011/workframe (7 stars, last pushed 19d ago), licensed MIT. It adds 74 tokens to every session and 1,139 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

pr-test-analyzer

Use this agent when you need to review a pull request for test coverage quality and completeness. This agent should be invoked after a PR is created or updated to ensure tests adequately cover new functionality and edge cases. Examples:\n\n \nContext: A developer has just created a pull request with new…

runnithan/claudex-setup · 0 tokens

codebase-explorer

Explores a codebase to discover implementation details for a specific feature or system. Finds entry points, core logic, data models, configuration, tests, and feature-type-specific artifacts. Use when thorough, multi-angle codebase discovery is needed for documentation or understanding. Does not research options or…

testdouble/han · 75 tokens

loom-verifier

Read-only gate runner for a standard loom stage. Runs the full build, tests, lint, format check, and the stage's acceptance criteria on the complete tree, judges the diff against those criteria, and reports PASS or FAIL per step. Writes nothing and never fixes.

cosmix/loom · 58 tokens

test-analyzer

Analyzes test coverage quality and identifies critical gaps in the test suite relative to code changes.

liatrio-labs/claude-code-gauntlet · 21 tokens

senior-dev

Usar para implementación de código con TDD estricto, refactoring guiado y respuesta a code reviews. Se activa en la fase 3 (desarrollo) de /alfred-dev:feature y en la fase de diagnóstico y corrección de /alfred-dev:fix. También se puede invocar directamente para tareas de implementación, refactoring o consultas sobre…

686f6c61/alfred-dev · 263 tokens

test-analyzer

Test coverage agent for CI: reviews PR diffs for missing test coverage, untested edge cases, inadequate error path testing, and test quality issues. Focuses on behavioral coverage over line metrics.

rube-de/cc-skills · 43 tokens