메뉴
Resolve Nix fundamentals: flake, derivation, substituter, direnv. Trigger: 'Nix 빌드 느림', 'flake 인식 안 됨', 'substituter', 'direnv', 'pre-commit hook 실패'. NOT for NixOS MiniPC (use managing-minipc). NOT for nix-darwin (use managing-macos).
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Manage encrypted secrets with agenix (.age) and 1Password (op CLI, Service Account token, SSH/Automation vault). Covers .age re-encryption, decryption failures, github-pat 무인 gh 인증, SA token 90일 rotation, SSH device key. Trigger: '시크릿', '암호화', '복호화', 'agenix', 'secrets.nix', 'age key', '.age', '토큰 추가', 're-encrypt', '/run/agenix', '1Password', '1password', 'op CLI', 'op_get', 'opnix', 'service account token', 'SA token', 'Automation vault', 'SSH vault', 'github-pat', 'gh 무인 인증', '90일 rotation', 'op read', 'biometric unlock', 'SSH device key', 'mobile-ssh', 'Termius'.
Attach explicitly provided file evidence (screenshots, demo videos, logs) to a GitHub issue or PR with the gh-attach CLI — content-inspection masking gate, irreversible-upload staging, fail-open ATTACH_STATUS reporting. Trigger: standalone attach requests on an existing issue/PR ('이 스크린샷 이슈에 올려줘', 'gh attach로 첨부'), or another GitHub publishing skill reaching for the evidence-attachment procedure. Format/size limits delegated to the GitHub server; Discussions unsupported. NOT for issue/PR creation or body authoring (use create-issue/create-pr).
Create a structured GitHub issue with auto-enriched labels. Trigger: '이슈 등록', '이슈 만들어', 'todo 등록', '버그 등록', '이슈 추가'. NOT for PR 본문 (use create-pr).
Create structured PR. Default: create new PR. Args: update (existing PR body). Trigger: 'PR 만들어줘', 'PR 생성', 'PR 올려', 'create PR', 'PR 업데이트', 'Human Test'. NOT for DA (use run-da). NOT for PR 코멘트 (use review-pr-feedback). NOT for 머지 후 종결 절차 (use finish-pr).
사용자가 `/analyzing-da-sessions` 슬래시 명령으로 명시 호출했을 때만 DA 세션 로그 정량 통계를 측정한다. 자연어 trigger 매칭은 사용하지 않는다 — 자연어로 측정을 원하더라도 사용자가 명시 호출해야 한다.
Run Codex CLI subprocesses for explicit codex exec requests, Claude Code or headless automation, and non-interactive code review. Use when requests mention `codex exec` or `비대화형 codex`. Use using-claude-p for Claude headless execution.
| name | understanding-nix |
| description | Resolve Nix fundamentals: flake, derivation, substituter, direnv. Trigger: 'Nix 빌드 느림', 'flake 인식 안 됨', 'substituter', 'direnv', 'pre-commit hook 실패'. NOT for NixOS MiniPC (use managing-minipc). NOT for nix-darwin (use managing-macos). |
NixOS와 nix-darwin 모두에 해당하는 Nix 공통 개념 및 이슈입니다.
flake 평가, derivation 해석, substituter/빌드 성능, 공통 오류 복구 절차를 다룬다.
| 파일 | 용도 |
|---|---|
flake.nix | 입력과 출력 정의 (nixpkgs → nixos-unstable) |
flake.lock | 입력 버전 고정 |
modules/shared/configuration.nix | 공통 Nix 설정 (experimental-features, GC, substituter) |
modules/shared/programs/direnv/default.nix | direnv + nix-direnv 설정 |
lefthook.yml | Pre-commit hooks 정의 |
~/.config/nix/nix.conf | 사용자별 Nix 설정 |
nfu # fzf로 input 선택 → update → FOD fix → nrs (권장)
nfu -a # 모든 input 일괄 업데이트
nix flake update <input-name> # 수동: 특정 input만 업데이트
nix flake check --no-build --all-systems # flake 평가 오류 검사
experimental-features = nix-command flakes가 modules/shared/configuration.nix에서 시스템 전역 설정됨.
부트스트랩 전에는 --extra-experimental-features "nix-command flakes" 플래그 필요.
| 방법 | 명령어/설정 | 효과 |
|---|---|---|
| 오프라인 빌드 | nrs --offline | 네트워크 요청 없음 (~10초, 18배 빠름) |
| 병렬 다운로드 | max-substitution-jobs = 128 | 동시 128개 다운로드 (기본 16) |
| HTTP 연결 | http-connections = 50 | 동시 50 연결 (기본 25) |
| 다운로드 버퍼 | download-buffer-size = 256 * 1024 * 1024 | 기본 64 MiB → 256 MiB |
| GitHub 토큰 | access-tokens = github.com=... | rate limit 해제 |
nix build --show-trace # 상세 빌드 로그
nix derivation show .#darwinConfigurations.<host>.system # derivation 확인
git add . — Nix flakes는 git-tracked 파일만 인식한다.nix flake update <input-name> — 외부 input 갱신이 필요한 경우.nrs 또는 nrs --offline으로 빌드.--show-trace로 에러 원인 모듈을 좁힌다.nix derivation show로 derivation 구조를 확인한다.nrs로 재검증한다.프로젝트 디렉토리 진입 시 devShell 환경을 자동 활성화한다.
echo "use flake" > .envrc # .envrc 생성 (nixos-config은 이미 커밋됨)
direnv allow # 최초 1회 허용
cd ~/Workspace/nixos-config # 자동 활성화 (이후 이탈 시 자동 해제)
.direnv/에 결과를 캐싱 (첫 로드 ~수 초, 이후 ~100ms)Hook 상세 목록과 staged snapshot 정책은 repo 루트의 README.md와 lefthook.yml을 기준으로 확인한다.
요약:
gitleaks는 staged .gitleaks.toml / .gitleaksignore policy만 사용한다.git commit 경로는 worktree-local pre-Lefthook guard가 lefthook.yml drift와 unsupported merged config surface를 차단한다.direnv allow 실행으로 해결.git add 필요 (untracked 파일은 무시됨)nix-command flakes 활성화 필요nrs --offline 사용 또는 substituter 설정 확인direnv allow 실행pkgs.formats.json 사용으로 pretty-print