菜单
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.