Claude-skill-registry ext-triage-reqs

Triage extension for requirements findings during plan-finalize phase

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/ext-triage-reqs" ~/.claude/skills/majiayu000-claude-skill-registry-ext-triage-reqs && rm -rf "$T"
manifest: skills/data/ext-triage-reqs/SKILL.md
source content

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:

"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