mflux-dev-env

Set up and work in the mflux dev environment (arm64 expectation, uv, Makefile targets, lint/format/test).

📖 中文导读:Set up and work in the mflux dev environment (arm64 expectation, uv, Makefile targets, lint/format/test). 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: mflux-dev-env description: Set up and work in the mflux dev environment (arm64 expectation, uv, Makefile targets, lint/format/test).

mflux dev environment

This repo expects macOS arm64 and prefers uv + Makefile targets.

When to Use

  • You’re setting up the repo locally or diagnosing environment/setup issues.
  • You need the canonical way to run lint/format/check/build/test.

Instructions

  • Prefer Makefile targets:
    • Install: /install (or make install)
    • Lint: /lint (or make lint)
    • Format: /format (or make format)
    • Pre-commit suite: /check (or make check)
    • Build: /build (or make build)
  • Prefer uv run ... for running Python commands to ensure the correct environment.
  • When running tests, keep MFLUX_PRESERVE_TEST_OUTPUT=1 enabled (the /test* commands do this).