ada-tp-to-srs-derivation

Derives structured SRS documents from Technical Protocol files with traceability matrices.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Converting a Technical Protocol (TP) contract document into a complete Software Requirements Specification is error-prone: clauses get missed, requirement formats drift, statistics tables disagree with requirement headers, and traceability back to the source protocol is lost. This Skill provides a phased methodology that guarantees every TP clause maps to a requirement. ## Core Features & Use Cases - Six Derivation Paths: Direct mapping, clause decomposition, cross-tool common extraction, architecture-derived requirements, precision correction, and AC atomization. - Standardized REQ-F Format: Enforces a structured requirement template with priority emoji (P0/P1/P2), Actor roles, Chinese-English bilingual conventions, and Given/When/Then acceptance criteria. - Traceability & Verification: Maintains a TP-to-SRS traceability matrix, statistical consistency checks, and a Python script that validates fence pairing, ID continuity, and vague-term residue. - Use Case: An avionics team receives a Chinese technical protocol for embedded display tools and needs a multi-system SRS with full clause coverage, bilingual formatting, and an auditable traceability appendix. ## Quick Start Derive a complete SRS from the attached Technical Protocol document, confirming architecture decisions with me before drafting.

Frequently Asked Questions about ada-tp-to-srs-derivation

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

FAQPage Schema
How do I derive an SRS from a technical protocol document?▼

Read the full TP, confirm architecture decisions (deployment, frameworks, multi-system relationships) with stakeholders, then apply six derivation paths: direct mapping, decomposition, cross-tool extraction, architecture-derived, precision correction, and AC atomization. Every requirement must trace back to a TP clause.

What format should SRS requirements use with REQ-F numbering?▼

Each requirement uses a ### REQ-F-XXX heading with a priority emoji (P0/P1/P2), an Actor tag, bold Title/Description/Acceptance Criteria sections, and Given/When/Then acceptance criteria in English. The whole entry is wrapped in a code fence with a source annotation referencing the TP clause.

How do I maintain a traceability matrix between TP and SRS?▼

Add an appendix mapping every TP clause to its REQ-F requirement IDs, marking architecture-derived items as derived rather than protocol-sourced. Each requirement also carries an inline source annotation, and the matrix must show no orphan requirements or uncovered clauses.

When should acceptance criteria be split into separate requirements?▼

Split an AC into its own requirement only when it has a different Given precondition, different trigger, and an independently verifiable result. Exception and validation scenarios sharing the same Given/When should remain as ACs of the parent requirement, and splitting is done only on explicit user request.

How do I verify SRS document consistency automatically?▼

Run the verify-srs-fences.py script against the SRS markdown file. It checks that fence count equals twice the requirement count, REQ-F IDs are sequential without gaps, priority emoji distribution matches the appendix statistics, and no vague terms remain in requirement bodies.

When should I not use TP-to-SRS derivation?▼

Do not use it when writing an SRS from scratch without a source protocol, or when reviewing an existing SRS. The TP document must exist and be complete before derivation begins, since the methodology enforces strict fidelity to the source protocol.