Skip to content

zyfgi/carsim-guide-skill

carsim-guide

Verified

Operate and automate CarSim simulations from an agent, including safe output and parameter discovery, named Run Control execution contexts, structured overrides, isolated batch sweeps, dataset dependency inspection, control-mode selection, result validation, diagnostics, and version-aware CLI/Simulink/VS API routing. Use for executing, configuring, exploring, or debugging CarSim. Do not use for vehicle-dynamics theory alone, generic dataframe work, or unrelated simulators.

FileKindSize
SKILL.mdskill md6.3 KB
examples/batches/friction_sweep.yamlconfig159 B
examples/batches/mass_friction_grid.yamlconfig198 B
examples/discovery/dataset_tree.pyscript693 B
examples/discovery/find_output.pyscript715 B
examples/discovery/find_parameter.pyscript761 B
examples/scenarios/basic_cruise.yamlconfig380 B
examples/scenarios/friction_change.yamlconfig379 B
examples/scenarios/steering_maneuver.yamlconfig377 B
examples/scenarios/tire_force_output.yamlconfig437 B
examples/scenarios/vehicle_override.yamlconfig376 B
examples/simulink_cosim.pyscript5.5 KB
examples/torque_vectoring.pyscript5.6 KB
references/advanced-controls.mdmarkdown4.0 KB
references/batch-workflows.mdmarkdown1.6 KB
references/compatibility.mdmarkdown1.4 KB
references/control-modes.mdmarkdown1.0 KB
references/database-exploration.mdmarkdown7.4 KB
references/dataset-syntax.mdmarkdown6.6 KB
references/outputs-and-units.mdmarkdown2.1 KB
references/parameter-discovery.mdmarkdown1.4 KB
references/parameters.mdmarkdown3.3 KB
references/python-interface.mdmarkdown7.9 KB
references/run-validation.mdmarkdown2.2 KB
references/scenarios.mdmarkdown3.3 KB
references/simulink-cosim.mdmarkdown4.0 KB
references/troubleshooting.mdmarkdown1.4 KB
references/version-compatibility.mdmarkdown811 B
references/vs-c-api.mdmarkdown3.3 KB
scripts/base_registry.pyscript4.7 KB
scripts/batch_runner.pyscript7.1 KB
scripts/carsim_batch.pyscript23.4 KB
scripts/carsim_errors.pyscript2.2 KB
scripts/control_modes.pyscript1.8 KB
scripts/cosim_model.mother4.7 KB
scripts/database_tools.pyscript16.5 KB
scripts/diagnose_run.pyscript444 B
scripts/diagnostics.pyscript6.9 KB
scripts/discovery_query.pyscript1.0 KB
scripts/dump_dll_exports.pyscript1.9 KB
scripts/output_registry.pyscript8.9 KB
scripts/override_registry.pyscript2.9 KB
scripts/parameter_discovery.pyscript8.6 KB
scripts/parameters.pyscript10.0 KB
scripts/result_contract.pyscript548 B
scripts/scenario_runner.pyscript11.3 KB
scripts/scenario_schema.pyscript4.0 KB
scripts/setup_paths.pyscript11.2 KB
scripts/tv_cosim.mother8.5 KB
scripts/validate_run.pyscript6.1 KB
scripts/version_compatibility.pyscript2.0 KB

scripts/version_compatibility.py

View on GitHub
"""Explicit, conservative CarSim version compatibility registry."""
import re
from dataclasses import dataclass

from carsim_errors import VersionCompatibilityError


@dataclass(frozen=True)
class CarSimVersion:
    """Parsed CarSim release identifier."""

    major: int
    minor: int
    raw: str

    @property
    def key(self) -> str:
        """Return normalized ``YYYY.minor`` spelling."""
        return f"{self.major}.{self.minor}"


@dataclass(frozen=True)
class CompatibilityStatus:
    """Compatibility evidence for one version."""

    version: CarSimVersion
    verified: bool
    features: frozenset[str]
    warning: str | None = None


# Only real solver evidence may be added here. CarSim 2024.0 is the verified
# environment; parsing another version is not compatibility proof.
COMPATIBILITY: dict[str, frozenset[str]] = {
    "2024.0": frozenset({"cli_solver", "dll_64", "simfile_v1"}),
}


def parse_version(value: str) -> CarSimVersion:
    """Parse a version or install-path fragment without guessing a release."""
    match = re.search(r"(?:CarSim[ _-]?)?(\d{4})\.(\d+)", str(value), re.IGNORECASE)
    if not match:
        raise VersionCompatibilityError(
            "CarSim version must contain an explicit value such as 2024.0")
    return CarSimVersion(int(match.group(1)), int(match.group(2)), match.group(0))


def compatibility_status(value: str) -> CompatibilityStatus:
    """Return verified evidence or a non-blocking unverified warning."""
    version = parse_version(value)
    features = COMPATIBILITY.get(version.key, frozenset())
    if features:
        return CompatibilityStatus(version, True, features)
    return CompatibilityStatus(
        version, False, frozenset(),
        f"CarSim {version.key} is detected but unverified; attempting the "
        "generic compatible path and recording this status")


def supports(feature: str, value: str) -> bool:
    """Return true only when ``feature`` has evidence for ``value``."""
    return feature in compatibility_status(value).features
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall