ada-srs-revision

Revises large SRS documents with terminology replacement, renumbering, and cross-reference repair.

Updated Jul 23, 2026
One-click install
npx skills add https://github.com/wubing7755/Ada --skill ada-srs-revision-wubing7755
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ada-srs-revision
Source: https://github.com/wubing7755/Ada/tree/main/skills/software-development/ada-srs-revision
Command: npx skills add https://github.com/wubing7755/Ada --skill ada-srs-revision-wubing7755

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Making a large-scale change to a structured requirements document — such as renaming a core concept across hundreds of occurrences — is error-prone: global replacements corrupt tables and diagrams, acceptance criteria drift out of sync, and statistics sections go stale. This Skill enforces a disciplined review-then-execute workflow so mass revisions stay consistent and verifiable. ## Core Features & Use Cases - Semantic change mapping: Identifies every surface form of an old concept (nouns, table headers, diagram labels, requirement titles) and distinguishes pure renames from behavioral changes that require rewriting acceptance criteria. - Ordered patching with fallout repair: Applies replacements in dependency order (terminology → data model → requirements → diagrams → statistics) and fixes common breakage such as double-pipe table corruption, mermaid diagram damage, and spacing artifacts. - Grep-based validation: Verifies zero remaining occurrences of old terms, checks requirement counts against statistics tables, and includes a Python script to automate old-term residue checks. - Use Case: Replacing "Panel Stacking" with "Tab Group" across a 4700-line SRS — updating term definitions, rewriting Given/When/Then acceptance criteria, adding new requirements with suffix IDs, and regenerating the statistics section. ## Quick Start Ask the agent to rename a core concept across your SRS document and have it propose a comparison table of changes for approval before patching anything.

Frequently Asked Questions about ada-srs-revision

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I rename a term across a large SRS document safely?

Map every surface form of the old term with grep first, present a comparison table of proposed changes for approval, then patch in dependency order from terminology definitions outward to requirements and diagrams. Finish with zero-count grep checks on every old term.

How to replace terminology in Markdown specs without breaking tables?

Avoid replace_all on short or punctuation-only strings like double pipes, which corrupt Markdown tables and mermaid ER diagrams. Use targeted single-match patches with surrounding context, then grep for lines starting with double pipes to detect corruption.

Should I renumber requirements when adding new ones to an SRS?

No, avoid renumbering existing requirements because it breaks cross-references and traceability matrices. Use suffix notation such as REQ-F-069-TG1 for new requirements and update the statistics section to reflect the new total.

When should I not use a mass-revision workflow on a specification?

Skip it for single-line typo fixes, writing new content from scratch, or adding one isolated requirement. The review-then-execute overhead only pays off when a change exceeds roughly five individual edits across a large document.

Why do mermaid diagrams break after global text replacement?

Mermaid ER diagrams use double-pipe syntax like ||--o{ for relationships, so a global replace of pipe sequences destroys them. Always verify mermaid blocks after batch operations and reverse-patch any corrupted lines immediately.