olafkfreund/nix-skills

devenv-project

Create, explain, review, and debug devenv project environments, including devenv.nix, devenv.yaml, lockfiles, languages, tasks, services, and shell activation.

ソースを見る

使い方

  1. インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
  2. 必要なツール、認証情報、対応環境を原文で確認します。
  3. 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/olafkfreund/nix-skills --skill devenv-project

開始前の確認

  • 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

devenv project environments

Read the project's devenv.nix, devenv.yaml, devenv.lock, applicable local configuration, and repository instructions before editing. Preserve existing conventions and overrides. For a new project, use devenv init when available; inspect its output before adding the smallest configuration needed.

Check devenv version, the locked devenv modules and nixpkgs revisions, and require_version when present. These versions can differ independently. The bundled references describe the release in sources.json, not necessarily the user's project. Verify version-sensitive options against its actual modules. devenv info evaluates configuration; devenv search NAME uses the project's package input. Evaluation can fetch or build dependencies.

Read only the references needed for the task:

imports, profiles, and YAML version requirements.

  • Workflows: native activation versus direnv, scripts,

task dependencies, processes, tests, and git hooks.

  • Options: selected option types, defaults, declarations,

and Python/JavaScript/Rust/Go/PostgreSQL examples. For other options, consult the target revision's modules or documentation; this is not a full catalogue.

Keep project dependencies in project configuration. Host installation follows local platform policy. Update locks deliberately (devenv update NAME for one input), inspect the diff, and preserve the lock in version control as appropriate. Do not delete it to hide evaluation failures. Package versions come from project inputs; changing the host toolchain does not change those pins.

Distinguish native devenv hook directory trust (devenv allow) from direnv's .envrc approval (direnv allow). Inspect the active integration and shell setup before changing either. Do not silently grant trust, edit startup files, execute unknown hooks, or start services merely to inspect a project. Respect task authorization already granted; do not repeatedly request the same consent.

Choose validation according to side effects: devenv info evaluates; devenv shell -- COMMAND also runs shell initialization; tasks execute their dependencies; devenv up starts processes; devenv test runs enterTest and can start and stop configured processes. Inspect hooks/tasks first and report what was actually run. Keep secrets out of committed configuration and the Nix store.

Guidance was informed by upstream's setup skill. References contain modified upstream excerpts under Apache-2.0. This portable skill does not replace a machine-specific devenv policy skill.

Nix style

  • Never search /nix/store (for example find /nix/store/*foo-* -name libfoo.so)

and never copy a literal store path. Find the providing package with nix-locate, and refer to it through Nix: ${pkgs.foo}/lib or lib.makeLibraryPath [ pkgs.foo ].

  • Do not quote attribute names that are valid identifiers

([A-Za-z_][A-Za-z0-9_'-]*, dashes included). Write pkgs.foo-bar and packages.x86_64-linux, not pkgs."foo-bar". Quote only other names (".config/foo", "2.0"), the keywords assert else if in inherit let or rec then with, and interpolations ("${name}"). Upstream examples in references sometimes quote needlessly; do not copy that style.

同じリポジトリから

関連する Skills

すべての Skills