AgentSkillsCN

ext-triage-reqs

在方案定稿阶段,对需求发现的问题进行优先级排序与分类处理

SKILL.md
--- frontmatter
name: ext-triage-reqs
description: Triage extension for requirements findings during plan-finalize phase
user-invocable: false
allowed-tools: Read

Requirements Triage Extension

Provides decision-making knowledge for triaging requirements-related findings during the finalize phase.

Purpose

This skill is a triage extension loaded by the plan-finalize workflow skill when processing requirements documentation findings. It provides domain-specific knowledge for deciding whether to fix, suppress, or accept findings.

Key Principle: This skill provides knowledge, not workflow control. The finalize skill owns the process.

When This Skill is Loaded

Loaded via resolve-workflow-skill-extension --domain requirements --type triage during finalize phase when:

  1. AsciiDoc validation errors occur in requirements documents
  2. Requirements structure issues are detected
  3. Traceability gaps are identified
  4. Acceptance criteria format issues are found

Standards

DocumentPurpose
suppression.mdAsciiDoc comment syntax for suppression
severity.mdRequirements-specific severity guidelines

Extension Registration

Registered in marshal.json under the requirements domain:

json
"requirements": {
  "workflow_skill_extensions": {
    "triage": "pm-requirements:ext-triage-reqs"
  }
}

Quick Reference

Suppression Methods

Finding TypeSyntax
AsciiDoc lint// asciidoc-lint-disable comment
Link validation// skip-link-check comment
Structure issueDocument exception in requirements metadata

Decision Guidelines

SeverityDefault Action
Structure errorFix (requirements must be well-formed)
Missing traceabilityFix or document exception
Format inconsistencyFix for consistency
Style warningAccept or fix

Acceptable to Accept

  • Draft requirements pending review
  • Placeholder acceptance criteria in early stages
  • Legacy requirements pending migration
  • External reference format differences

Related Documents