القائمة
Use when about to run pytest, python, uv, ruff, or any build/tooling command in this repo. Enforces running through the devenv shell.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when writing a scripts/tasks/processes entry or a manager module. Covers which surface to use, guarding enterShell echoes, and the 0/1/2/3 exit contract.
Use when editing devenv.yaml or adding an input/import. Covers flake:false for modules, nixpkgs-python for version pins, and transitive inputs.
Use when you edited a modules/ file, devenv.nix, or env.* and nothing changed. Resolves the lock + eval-cache staleness loop.
Use when starting a server or any long-running / heavy task. Use processes + devenv up; don't block the shell; poll logs instead of piping out of view.
Use on ModuleNotFoundError or import failures inside the devenv shell, or after a fresh venv. The venv exists but deps may not be installed.
Use on "command not found", the shell won't enter, or eval errors. A symptom→cause→fix decision tree for devenv repos.
| name | devenv-run-commands |
| description | Use when about to run pytest, python, uv, ruff, or any build/tooling command in this repo. Enforces running through the devenv shell. |
| auto_trigger | {"keywords":["command not found","run pytest","run the tests","run python","run uv","run ruff","run the build","bare command","wrong python"]} |
This repo is managed by devenv.sh. A bare pytest / python / uv / ruff runs in a
shell without the repo's pinned PATH, env vars, and determinism settings — it will behave
differently or fail.
Always run in-repo commands as:
devenv shell -- <command>
…or use the repo's own scripts/tasks (e.g. devenv shell -- repoman doctor). For a long or
heavy command, run it in the background and poll its log rather than blocking the shell — see
the devenv-processes skill.
If a command still isn't found inside the shell, it's a venv-vs-nix-vs-script question — see the
devenv-troubleshoot skill. Background and reference: shell.md in the devenv docs export.
For when to verify vs. commit vs. release, see the repoman skill.