메뉴
Compare an SFSM FA definition JSON file against a draw.io UML state diagram and report every discrepancy. Use when validating that a diagram matches its source JSON, or vice versa. Combines drawio-to-json and compare-compact-jsons for round-trip verification.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Convert an SFSM FA definition JSON file (compact or extended format) to a professional draw.io UML state diagram with hierarchical ELK.js layout. Use when asked to visualize or diagram an SFSM JSON definition. The generated diagram may require small manual repositioning for visual perfection.
Extract an SFSM FA definition JSON file in compact format from a draw.io UML state diagram. Use when asked to convert, export, or reverse-engineer a diagram back into SFSM/StOP JSON.
Post-task checklist that runs after every agent task that makes essential changes to code, documentation, scripts, or configuration. Covers version bumping, release-notes update, and commit-text proposal. Applied automatically — the agent does not need to be asked.
Common rules for code development that apply across all project types (libraries, CLI tools, services, etc.). Covers development workflow, requirements clarity, bug-fix workflow, logging, coding style, testing discipline, version management, and commit conventions.
Documentation rules for the Aiavivo project. Covers README.md structure, per-sub-project DEVELOPMENT.md template, when/how to update documentation after code changes, and handling of sub-projects with no code yet.
| name | sfsm-compare-json-uml-diagram |
| description | Compare an SFSM FA definition JSON file against a draw.io UML state diagram and report every discrepancy. Use when validating that a diagram matches its source JSON, or vice versa. Combines drawio-to-json and compare-compact-jsons for round-trip verification. |
| metadata | {"author":"vsirotin","version":"2.0"} |
This skill validates the correspondence between an SFSM FA definition in compact JSON format and a draw.io UML state diagram. It combines two scripts to produce a detailed diff report without modifying either file:
drawio-to-json.js extracts JSON from the diagram (via SFSM metadata in cell styles or shape-based heuristics)compare-compact-jsons.js performs an intelligent comparison of the original and extracted JSONUse this skill when you need to:
sfsm-json-to-uml-diagram)The skill requests two file paths from you (unless you provide them upfront):
.drawio file (ideally generated by json-to-drawio.js)It then runs:
drawio-to-json.js <diagram.drawio> <extracted.json> — extract JSON from the diagramcompare-compact-jsons.js <original.json> <extracted.json> — compare and report differencesThe comparison report shows, per FA:
from/signal pair, different to or command)If both sides match exactly, the report confirms alignment with no discrepancies.
.drawio file path (requested if not provided)cd ts/ts-stop
node scripts/drawio-to-json.js <input.drawio> <extracted.json>
node scripts/compare-compact-jsons.js <original.json> <extracted.json>
No files are modified by this skill. If the comparison reveals discrepancies and you decide which side is authoritative, use:
sfsm-json-to-uml-diagram to regenerate the diagram from the JSON if the JSON is authoritativesfsm-uml-diagram-to-json to extract the diagram's corrected JSON if the diagram is authoritativeSee 04-tools.md § 7.5.5 for detailed documentation.