qa-reviewer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

QA Reviewer: Systematic Work Verification

QA Reviewer: 系统性工作验证

Purpose

目的

Structured framework for reviewing AI agent work before finalizing changes. Catches bugs, verifies accuracy, ensures completeness, validates solutions match requirements.
Why this exists: AI agents can introduce subtle bugs, miss requirements, or make incorrect assumptions.
在最终确定变更前,为审核AI Agent工作提供结构化框架。用于发现漏洞、验证准确性、确保完整性、确认解决方案符合需求。
**存在意义:**AI Agent可能会引入细微漏洞、遗漏需求或做出错误假设。

When to Use

使用场景

  • User says "check your work" or "review this"
  • After completing complex multi-step implementations
  • Before committing major refactors
  • When modifying commands or skills
  • After implementing new features
  • Proactively after any task >5 steps
  • 用户要求“检查你的工作”或“审核此项内容”
  • 完成复杂的多步骤实现后
  • 提交重大重构前
  • 修改命令或Skill时
  • 实现新功能后
  • 主动审核任何超过5个步骤的任务

QA Workflow Phases

QA工作流阶段

1. Context Gathering

1. 上下文收集

  • Review original task and requirements
  • List all deliverables (files created/modified/deleted)
  • Check critical rules (CRITICAL-NEVER-DO.md)
  • 回顾原始任务与需求
  • 列出所有交付成果(创建/修改/删除的文件)
  • 检查关键规则(CRITICAL-NEVER-DO.md)

2. Requirement Verification

2. 需求验证

  • Create checklist of all requirements
  • Verify solution alignment
  • Check for edge cases
  • 创建所有需求的检查清单
  • 验证解决方案是否对齐需求
  • 检查边缘情况

3. Accuracy Verification

3. 准确性验证

  • Verify file paths exist
  • Confirm patterns match codebase
  • Cross-reference citations
  • 验证文件路径是否存在
  • 确认模式与代码库匹配
  • 交叉引用引用内容

4. Bug Detection

4. 漏洞检测

  • Check syntax (markdown, code, paths)
  • Look for logic errors
  • Verify project-specific rules
  • 检查语法(Markdown、代码、路径)
  • 查找逻辑错误
  • 验证项目特定规则

5. Completeness Audit

5. 完整性审计

  • Reconcile todo list
  • Verify all mentioned files changed
  • Check for side effects
  • 核对待办事项列表
  • 验证所有提及的文件均已修改
  • 检查副作用

6. Optimization Review

6. 优化审核

  • Evaluate solution quality
  • Check pattern consistency
  • Consider alternatives
  • 评估解决方案质量
  • 检查模式一致性
  • 考虑替代方案

Quick Verification Commands

快速验证命令

bash
undefined
bash
undefined

Verify file exists

Verify file exists

ls -la <file-path>
ls -la <file-path>

Check balanced code blocks

Check balanced code blocks

grep -c '```' file.md
grep -c '```' file.md

Find violations

Find violations

grep -r "console.log" <files> grep -r ": any" <files>
undefined
grep -r "console.log" <files> grep -r ": any" <files>
undefined

Project Rules Check

项目规则检查

  • No console.log (use logger)
  • No
    any
    types
  • No inline interfaces
  • AGENTS/CLAUDE/CODEX files intact
  • .agents/ folders untouched
  • Multi-tenancy preserved
  • 禁止使用console.log(请使用logger)
  • 禁止使用
    any
    类型
  • 禁止使用内联接口
  • AGENTS/CLAUDE/CODEX文件保持完整
  • .agents/文件夹不得修改
  • 多租户特性需保留

Final Assessment Categories

最终评估分类

  • Approve - Ready to commit
  • Conditional - Fix issues first
  • Reject - Significant problems

For complete workflow phases, output format template, common issue patterns, and advanced techniques, see:
references/full-guide.md
  • 批准 - 可提交
  • 有条件批准 - 需先修复问题
  • 拒绝 - 存在重大问题

如需完整工作流阶段、输出格式模板、常见问题模式及高级技巧,请参阅:
references/full-guide.md