qa-requirement-review
Skill31 starsChanged 48 days agoMITView on GitHub
从完整性、清晰性、一致性、可测试性、可实现性五个维度系统化评审需求文档质量。当用户要求"评审这份需求"、"看看这个PRD写得怎么样"、或者测试用例设计前需要先评估需求质量时,应当使用此技能。如果需求本身有问题(模糊/矛盾/不可测试),后续的测试设计都是徒劳。不要只在用户明确说"需求评审"时才用——任何涉及需求文档的测试任务都应先过一遍需求评审。 触发场景:需求评审、评审需求、需求质量、PRD评审、需求检查、需求写得好不好、评审这份需求、需求提交测试前预审时。 Use when the user asks about: reviewing a PRD or requirement document for completeness, clarity, consistency, testability, and feasibility before test design starts.
In this repository50 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- qa-agent-testingSkill
- qa-ai-blindspot-compensationSkill
- qa-ai-context-engineeringSkill
- qa-ai-output-critiqueSkill
- qa-ai-prompt-strategySkill
- qa-api-testingSkill
- qa-boundary-deep-diveSkill
- qa-bug-lifecycleSkill
- qa-bug-reportingSkill
- qa-bug-root-cause-analysisSkill
- qa-ci-cd-testingSkill
- qa-code-review-for-testSkill
- qa-combination-strategySkill
- qa-critical-thinkingSkill
- qa-domain-modelingSkill
- qa-execution-observationSkill
- qa-expert-reviewSkill
- qa-exploratory-testingSkill
- qa-heuristic-checklistSkill
- qa-input-validationSkill
- qa-mobile-testingSkill
- qa-output-validationSkill
- qa-quality-metricsSkill
- qa-question-frameworkSkill
- qa-regression-testingSkill
- qa-release-risk-governanceSkill
- qa-req-deconstructionSkill
- qa-retrospectiveSkill
- qa-risk-intuitionSkill
- qa-scenario-treeSkill
- qa-shift-leftSkill
- qa-shift-rightSkill
- qa-specialized-testingSkill
- qa-stakeholder-communicationSkill
- qa-state-transitionSkill
- qa-team-coachingSkill
- qa-tech-debt-managementSkill
- qa-tech-selectionSkill
- qa-testability-advocacySkill
- qa-test-automation-archSkill
- qa-test-case-designSkill
- qa-test-data-engineeringSkill
- qa-test-env-dataSkill
- qa-test-estimationSkill
- qa-test-leadershipSkill
- qa-test-reportingSkill
- qa-test-skillsSkill
- qa-test-strategy-designSkill
The file
Files
⚠️ 本技能单独使用效果有限,建议配合完整技能集(12 步工作流)使用。安装:npx skills add Kokxi/qa-test-skills
需求评审专项
核心原则
需求评审不是挑刺,而是确保需求可理解、可测试、可实现。
五维评审速查
各维度的详细检查清单、评审问题速查和严重度矩阵参见
references/review-standards.md。
评分规则:每个维度10分,总分≥40分为"有条件通过",≥45分为"通过"。
| 维度 | 评分核心 | 典型问题 |
| 完整性 | 功能/非功能/约束/验收是否完整 | 主流程缺失、异常未定义、验收标准缺失 |
| 清晰性 | 术语/描述/示例是否清晰无歧义 | 术语歧义、描述模糊、缺少示例 |
| 一致性 | 内部/外部/版本是否一致 | 前后矛盾、与现有系统冲突 |
| 可测试性 | 验证/度量/自动化是否可行 | "体验好"不可验证、性能未量化 |
| 可实现性 | 技术/资源/业务是否可行 | 架构不支持、时间不合理 |
每维度的完整检查清单和评分标准详见
references/review-standards.md。
评审报告模板
完整模板(含五维评分表格、P0-P2问题清单)参见
references/report-template.md。
简要结构:
# 需求评审报告
## 评审结论:[通过/有条件通过/不通过]
## 五维评分:完整性X/10 清晰性X/10 一致性X/10 可测试性X/10 可实现性X/10
## 问题清单
### P0(必须修改)
### P1(建议修改)
### P2(可选修改)
## 改进建议加载时机
需要时才读,不要一上来全读:
| 什么时候读 | 读哪个 |
| 拿评审报告模板填 | references/report-template.md(报告结构与填写要求) |
| 判断某个需求问题算不算缺陷 | references/review-standards.md(五维评审标准) |
五维评分口径在本文;模板与逐条标准在 references,按需加载。
输出示例
评审一个PRD:用户登录功能需求 → 完整性检查:功能描述完整✅,但缺少非功能需求❌ → 清晰性检查:"登录超时"未定义具体时间❌ → 一致性检查:前后描述一致✅ → 可测试性检查:"响应要快"不可量化❌,应改为"登录响应<2秒" → 可实现性检查:技术方案可行✅ → 评审报告:P0问题(缺少非功能需求)+ P1问题(模糊表述)
五维评审判定示范(pass/fail 对照):
| 维度 | PASS 示例 | FAIL 示例 | 判定要点 |
| 完整性 | "支持用户名+密码登录、验证码、密码找回,含异常场景" | "用户能登录系统"(无边界/异常/非功能) | 主流程+分支+异常+非功能是否齐 |
| 清晰性 | "密码错误3次锁定15分钟" | "密码错误多次后锁定"(多次=?锁定多久=?) | 数量/时间/条件是否有具体值 |
| 一致性 | 全文用"验证码"表述,前后一致 | 前文"短信验证码"后文"图形验证码" | 术语/规则/数据定义前后是否矛盾 |
| 可测试性 | "登录响应时间<2秒(P95)" | "响应要快" | 指标是否可量化、可观测 |
| 可实现性 | "基于现有统一认证服务实现" | "接入自研AI人脸识别(当前无此能力)" | 技术方案在当前栈是否可行 |
检查清单
需求评审完成后检查:
- 评审维度是否覆盖?
- 检查清单是否执行?
- 问题是否识别?
- 问题是否分类?
- 建议是否可行?
- 报告是否规范?
常见评审陷阱
- 只挑刺不建树:发现100个问题但没给1个改进建议 → 每个P0/P1问题必须附带建议
- 凭感觉不打分:说"这块不够好"但不指哪个维度 → 评审结论必须基于五维评分
- 过度纠错细节:纠结错别字忽略结构性缺失 → 区分"格式问题"和"内容问题",优先评审内容
- 遗漏非功能:只看功能完整不看性能/安全 → 五维评审缺一不可
- 评审完不追踪:报告给了就完了 → 必须标注每条问题的处理状态(已修/待修/已确认)
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

