菜单
Use when changing SJV Script syntax or semantics in System Journey Viewer, including parser, import/export, editor sync, conversion, metadata, drilldown, notes, and documentation/showcase alignment with roundtrip test coverage.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | sjv-script-change-with-roundtrip-tests |
| description | Use when changing SJV Script syntax or semantics in System Journey Viewer, including parser, import/export, editor sync, conversion, metadata, drilldown, notes, and documentation/showcase alignment with roundtrip test coverage. |
Use this skill when modifying the product scripting language (SJV Script) or its conversion pipeline.
apps/web/src/dsl-lite/parser*apps/web/src/dsl-lite/*apps/web/src/model/*, apps/web/src/store/*docs/SJV_SCRIPT_SPEC.md, help content if neededSJV Script changes are behavior changes. Treat them like a contract update, not a UI tweak.
parser.test.ts)sync.test.ts, journeyDslSync.test.ts)useEditorStore.test.ts) if theme/workspace loading behavior changesdocs/SJV_SCRIPT_SPEC.mdnpm --workspace @sjv/web run lintnpm --workspace @sjv/web run test:runnpm --workspace @sjv/web run builddocs/WORKLOG.md and docs/AI_STATE.md.For language feature changes, verify at least one realistic sample can:
If exact text roundtrip is not expected, document what is normalized.
dsl-lite tests.Use when reorganizing frontend files in apps/web, classifying components vs non-components, applying folder/naming conventions, and adding top-of-file Purpose headers for faster human/AI navigation.
Use when changing System Journey Viewer local persistence shape or semantics (localStorage UI preferences, layout persistence, snapshots, recents), including backward compatibility, storage key versioning/migration logic, tests, and user-facing behavior safeguards.
Use when capturing or regenerating System Journey Viewer visual demos and screenshots with Playwright, including local dev server setup, deterministic showcase loading, presentation/journey playback automation, and media artifact validation for README/docs/help gallery.
Use when changing System Journey Viewer export behavior (SVG, PNG, PDF, GIF, MP4, animated SVG) or presentation/player capture flows, including validation of export tests, capture state restoration, format-specific constraints, and demo-gallery impacts.
Use when tuning System Journey Viewer light/dark themes, node/text color presets, palette defaults, and visual contrast/readability in canvas, inspector, showcase/tutorial examples, or desktop shell UI.
Use when syncing System Journey Viewer documentation after feature or workflow changes, covering WORKLOG, AI_STATE, SJV Script spec, help content, README, and naming consistency (especially SJV Script terminology and English UI/docs text).