qa-reviewer

QA 审查员：系统化工作验证

目的

用于在最终确定更改前审查 AI Agent 工作的结构化框架。发现错误、验证准确性、确保完整性，并验证解决方案是否符合要求。

适用场景

• 用户说“检查你的工作”或“审查一下”
• 完成复杂的多步骤实现后
• 提交重大重构前
• 修改命令或技能时
• 实现新功能后
• 任何超过 5 个步骤的任务完成后主动使用

QA 工作流阶段

1. 收集上下文

• 查看原始任务和要求
• 列出所有交付内容（已创建／修改／删除的文件）
• 检查仓库指令文件（AGENTS.md、 AGENTS.override.md、CLAUDE.md 或已配置的回退文件）中的关键规则

2. 验证要求

• 创建包含所有要求的检查清单
• 验证解决方案是否符合要求
• 检查边缘情况

3. 验证准确性

• 验证文件路径是否存在
• 确认模式是否与代码库匹配
• 交叉核对引用内容

4. 检测错误

• 检查语法（Markdown、代码、路径）
• 查找逻辑错误
• 验证项目专属规则

5. 完整性审查

• 核对待办事项列表
• 验证所有提及的文件是否已更改
• 检查副作用

6. 优化审查

• 评估解决方案质量
• 检查模式一致性
• 考虑替代方案

快速验证命令

# Verify file exists
ls -la <file-path>

# Check balanced code blocks
grep -c '```' file.md

# Find violations
grep -r "console\.log" <files>
grep -r ": any" <files>

项目规则检查

示例检查清单。请将其替换为仓库自身指令文件中的规则。

• 不使用 console.log（使用 logger）
• 不使用 any 类型
• 不使用内联接口
• 仓库指令文件保持完整，作用域覆盖规则均为有意配置
• 已配置的回退指令文件存在且内容非空
• 除非任务要求更改，否则不修改 Agent 配置文件夹
• 保持项目不变量（例如，若项目采用多租户，则保留多租户机制）

最终评估类别

• 批准 - 可提交
• 有条件通过 - 请先修复问题
• 驳回 - 存在重大问题

---

执行全面 QA 审查或任务交付内容超过三项时，请加载 ${CLAUDE_SKILL_DIR}/references/full-guide.md，以获取完整的工作流阶段、输出格式模板、常见问题模式和高级技巧。