ข้อกำหนดและเกณฑ์ความสำเร็จ

ตัวอย่างที่ 1 ตรวจข้อกำหนดเบื้องต้นด้วยโปรแกรม

โปรแกรมหาอาการที่พบบ่อย: คำกำกวม ไม่มีตัวเลข และหลายเรื่องในข้อเดียว (ตรวจได้เพียงบางลักษณะ ยังต้องให้คนตรวจ)

import re

VAGUE = ["user-friendly", "fast", "quickly", "adequate", "sufficient", "easy", "approximately",
         "as appropriate", "etc", "and/or", "good", "robust"]

requirements = {
    "R1": "The system shall detect canal bank cracks of 5 cm width or more with recall of at least 0.90.",
    "R2": "The system shall be user-friendly.",
    "R3": "The drone shall fly fast and take good photos.",
    "R4": "The system shall complete one 2 km inspection round in at most 15 minutes of flight.",
    "R5": "The system shall store images and send reports and alert the office.",
    "R6": "The system shall mark each defect with coordinates accurate to within 3 m.",
}
for rid, text in requirements.items():
    words = text.lower()
    issues = [f"vague '{w}'" for w in VAGUE if re.search(r"\b" + re.escape(w) + r"\b", words)]
    if not re.search(r"\d", text):
        issues.append("no measurable value")
    if words.count(" and ") >= 2 or words.count(" shall ") > 1:
        issues.append("several requirements in one")
    print(f"{rid}: {'ok' if not issues else '; '.join(issues)}")

R1: ok
R2: vague 'user-friendly'; no measurable value
R3: vague 'fast'; vague 'good'; no measurable value
R4: ok
R5: no measurable value; several requirements in one
R6: ok

R2 และ R3 ใช้คำที่วัดไม่ได้ R5 รวมสามเรื่องไว้ในข้อเดียว ทำให้ตรวจพิสูจน์แยกไม่ได้ ควรแยกเป็นสามข้อ ส่วน R1, R4 และ R6 ผ่านการตรวจเบื้องต้น แต่ยังต้องถามต่อว่าจำเป็นจริงไหมและเป็นไปได้ไหม ซึ่งโปรแกรมตอบแทนไม่ได้

ตัวอย่างที่ 2 ตรวจสัดส่วน MoSCoW

effort = {  # ข้อกำหนด: (ลำดับ, แรงงานประมาณ คน-สัปดาห์)
    "R1 crack detection": ("Must", 6), "R4 round time": ("Must", 3), "R6 coordinates": ("Must", 2),
    "R5a store images": ("Should", 2), "R5b send report": ("Should", 3),
    "R5c alert office": ("Could", 2), "R7 night flight": ("Won't", 0), "R8 web dashboard": ("Could", 2),
}
total = sum(e for _, e in effort.values())
for group in ("Must", "Should", "Could"):
    share = sum(e for g, e in effort.values() if g == group) / total
    print(f"{group:<6} {share:.0%}")
must = sum(e for g, e in effort.values() if g == "Must") / total
print("Must share OK" if must <= 0.60 else "Must share too high: move items or cut scope")

Must   55%
Should 25%
Could  20%
Must share OK