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