SuperAPI AI Directory

requirement-gap-analysis

Writing & research

View repository

Updated 10-16 01:34

About this skill

Requirement Gap Analysis (Chinese Version)

When to Use

  • You need to discover ambiguity, omissions, conflicts, unverifiable items, and cross-role dependency gaps in requirements.
  • You need to conduct a risk review of existing solutions, results, or evidence, and form actionable improvement items.
  • The input is incomplete, but a usable initial version with assumptions and information gaps still needs to be provided first.

Output Format Options

  • The default output is Markdown, suitable for review, execution, and continuous supplementation.
  • When the user requests a table, CSV, JSON, or ticket format, retain the same risk, evidence, priority, and boundary fields.
  • If the output will enter an automated process, first confirm the field schema, enumeration values, and required items.

How to Use

  1. First read and follow prompts/requirement-gap-analysis.md 's input, execution rules, minimum coverage checklist, and output order.
  2. Supplement the scope, environment, version, constraints, evidence, and success criteria that genuinely affect judgment.
  3. First conduct an input audit, then distinguish confirmed facts, reasonable assumptions, and issues to be confirmed.
  4. Sort by risk and evidence strength, and produce results that can be directly executed, reviewed, or verified.
  5. When information is insufficient, do not stop at asking questions: first deliver a constrained initial version, and state which conclusions cannot currently hold.

Reference Files

  • When calibrating domain results, correct comparisons, or evidence gaps, read references/domain-decision-example.md 's desensitized input, item-by-item expectations, and recalculation basis.

  • Each execution must read prompts/requirement-gap-analysis.md; it is the complete execution specification of this Skill.

  • When evaluating or regressing this Skill, read evals/eval.yaml and the matching evals/cases/ test cases.

  • Only read references/、examples/、scripts/ or output-formats.mdwhen the directory actually exists and the task requires it; do not assume assets that do not exist.

Domain Execution Key Points

  1. Build a requirements checklist based on scope/version and applicable roles, states, rules, exceptions, and closure conditions; note the source and coverage of provided materials for each item, and do not force a generic checklist onto an inapplicable product.
  2. List MISSING_RULE (confirmed relevant but the rule is undefined), MISSING_MATERIAL (referenced material not provided), CONFLICT (provided rules conflict), N/A (not applicable with a scope reason), and COMPLETE separately.
  3. For gaps, provide the original requirement ID, missing content, affected scenarios, blocking degree, owner, and minimum clarification; an empty document or unseen fields do not automatically prove a product defect.
  4. Closure requires authoritative supplementary rules/source version and testable expectations, and updates the traceability; suggested filling methods remain proposals without approval, and a sufficiently defined correct comparison must not be reported as a gap.

Core Constraints

  • Do not make business decisions on behalf of stakeholders
  • Distinguish facts, inferences, and questions
  • Prioritize gaps that would cause rework or incidents
  • Do not fabricate system behavior, fields, data, metrics, or root causes that do not exist in the input.
  • Key conclusions must be linked to evidence; when evidence is insufficient, mark them as assumptions and provide a verification method.
  • Priority must state the basis in business impact, likelihood of occurrence, or detectability.

Pre-delivery Self-check

  • Covered: objectives and scope, roles, rules, states, exceptions, data, permissions, dependencies, non-functional requirements, acceptance, and rollback.
  • Facts, assumptions, gaps, and recommendations are distinguished.
  • High-risk items have clear priorities, evidence, owners, or next steps.
  • The output includes verifiable judgment criteria rather than generalities.
  • No unauthorized production write operations or destructive actions were performed.

Common Pitfalls

  • Listing only checkpoints without specifying input conditions, expected results, or evidence.
  • Marking everything as high priority, losing the value of trade-offs.
  • Replacing domain judgment with tool names or general theories.
  • Directly refusing when input is incomplete, or conversely pretending the conclusion is already certain.

Best Practices

  • Start with the paths most likely to cause business loss, security issues, or release blockers.
  • Use the smallest verifiable experiment to reduce uncertainty, and record the reproduction conditions.
  • Make the output directly executable and reviewable by another engineer.