sysml-author
/sysml-author
Tworzy i zmienia modele SysML v2 w plikach .sysml, z wymaganiami, przypadkami użycia i powiązaniami do sphinx-needs.
- Autor
- MichaelD-42 ↗
- Repozytorium
- sysml2-kit ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 07.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 07.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Tworzy i zmienia modele SysML v2 w plikach .sysml, z wymaganiami, przypadkami użycia i powiązaniami do sphinx-needs.
Oryginalny opis (EN)
Create and change SysML v2 models (.sysml files) - use cases, requirements, actions, parts, ports, allocations, satisfy/verify, Trace metadata links to sphinx-needs. Use when writing or editing any .sysml file.
Jak działa
- Conventions
- Rule
Podgląd SKILL.md
---
name: sysml-author
description: Create and change SysML v2 models (.sysml files) - use cases, requirements, actions, parts, ports, allocations, satisfy/verify, Trace metadata links to sphinx-needs. Use when writing or editing any .sysml file.
---
# SysML v2 authoring
`references/patterns.sysml` is a checked example of every construct the pipeline maps; copy from it. The `sysml` MCP server answers syntax and name questions: `notation` (how to write a construct), `visible_names` (what resolves at a point), `outline`, `library_search`, `check`. To read an existing model, use `find` (elements by kind, namespace, name, or a relation they lack: `kind: RequirementUsage, without: verifies`) and `relations` (every link of one element both ways, by qualified or short name) instead of opening files. If the server says it has no tool `find`, the installed `sysml` predates these tools: run `make tools`.
## Conventions
- One package per layer and file, system-prefixed (`VehicleFunctions`), never a bare library-like name (`UseCases`).
- Elements that become needs get a declared short name `<'SR-012'>`; prefix by kind (see `rflp-method`). Next free number: `grep -rhoE "<'SR-[0-9]+'>" model | sort -V | tail -1`. Never reuse or renumber an id; docs link to it.
- Every short-named element has `doc /* ... */`; it becomes the need text.
- Model traced elements as usages (`requirement <'SR-001'> range { ... }`, `action <'F-002'> propel;`, `part <'LC-002'> powertrain;`). `satisfy`, `allocate` and `perform` must point at usages, and both ends need short names.
- Links to RST needs: `@Realizes { need = "CRS-001"; }` / `@Satisfies` / `@Verifies`, after `private import Trace::*;`.
- Keywords cannot be names (`loop`, `state`, `action`, `port`, `in`, `out`, `then`, `first`, `entry`, `do`, `exit`, ...).
## Rule
The plugin runs `sysml check` after every `.sysml` write, then the bridge (`sysml export` + `sysml2kit needs`), and shows errors: language errors, duplicate ids, link ends without a short name, and requirement texts without exactly one `shall` or with a vague term. Fix them before moving on (`sysml-lint` skill for the loop). Before finishing, run `make all` (or `make docs STRICT=` mid-workflow).
Pliki w paczce (2)
- SKILL.md 2 KB
- references/patterns.sysml 3 KB
Wersje
W bazie nie ma innych skilli o nazwie sysml-author.
Migawka bazy z 13.11.2026 · wersja paczki 55000d8decd9 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 86sysml-init
Tworzy szkielet projektu SysML v2 i RFLP z Makefile i konfiguracją Sphinx, a także instaluje jego narzędzia. - 90sysml-lint
Sprawdza modele SysML v2 narzędziem sysml check w pętli poprawek i mierzy wpływ zmian przed zmianą nazw lub usunięciem. - 100model-library-lookup
Wyjaśnia, co znaczy i gdzie jest zadeklarowany element standardowej biblioteki modeli SysML v2 i KerML, na przykład ISQBase::mass, ScalarValues::Real lub Parts::Part w SysML.sysml. - 100spec-citation
Cytuje normatywny tekst specyfikacji OMG SysML v2 i KerML z dokładnym odniesieniem do klauzuli. - 100dpf-sysml-architecture-substrate
Wspiera pracę nad platformą DPF rozumowaniem architektury systemowej SysML v2: podłoże EA, wymagania, interfejsy, alokacje, przypadki weryfikacji i przekazanie planowania architektom.