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.