메뉴
Manage NixOS MiniPC: disko, rollback, config placement, hardware. Trigger: 'MiniPC', '미니PC', 'nixos-rebuild', '설정 배치', 'WoL', 'smartd', '온도 모니터링'. NOT for nix-darwin (use managing-macos). NOT for flake (use understanding-nix).
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
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.
SOC 직업 분류 기준
| name | managing-minipc |
| description | Manage NixOS MiniPC: disko, rollback, config placement, hardware. Trigger: 'MiniPC', '미니PC', 'nixos-rebuild', '설정 배치', 'WoL', 'smartd', '온도 모니터링'. NOT for nix-darwin (use managing-macos). NOT for flake (use understanding-nix). |
NixOS MiniPC 설치, 설정, 유지보수, 설정 배치 가이드입니다. (NixOS 전용)
새 NixOS 설정을 추가할 때 반드시 아래 기준에 따라 배치 위치를 결정할 것.
| 배치 위치 | 기준 | 예시 |
|---|---|---|
hosts/<hostname>/default.nix | 특정 하드웨어에 종속된 설정 | 인터페이스명(enp2s0), 디스크 UUID, WoL, PCI 장치 |
hosts/<hostname>/disko.nix | 디스크 파티셔닝 | NVMe 파티션 레이아웃 |
hosts/<hostname>/hardware-configuration.nix | 자동 생성 하드웨어 감지 | 커널 모듈, CPU 마이크로코드 |
modules/nixos/configuration.nix | 모든 NixOS 호스트에 공통 적용 | watchdog, kernel.panic, sudo, nix-ld |
modules/nixos/programs/*.nix | 공통 서비스/프로그램 모듈 | Tailscale, SSH 서버, Caddy |
libraries/constants.nix | 여러 모듈에서 참조하는 값 | IP, 포트, 경로, SSH 키, UID |
다음 중 하나라도 해당하면 hosts/<hostname>/에 배치:
enp2s0, wlp1s0, eno1 등)/dev/nvme0n1, by-uuid/...)0000:02:00.0)fileSystems.* 마운트 포인트 (disko가 관리하지 않는 추가 디스크)# 하드웨어 종속 설정만 포함
users.users.${username}.openssh.authorizedKeys.keys = [ ... ]; # 이 호스트의 SSH 접근 허용키
networking.interfaces.enp2s0.wakeOnLan.enable = true; # NIC 종속 (Intel igc, PCI 02:00.0)
fileSystems."/mnt/data" = { device = "by-uuid/..."; }; # HDD UUID 종속
nrs --force # 소스 빌드 경고 무시하고 진행
nrs --force --cores 2 # 코어 제한으로 진행 (과열 방지)
소스 빌드 Pre-flight 체크: nrs/nrp가 nix build --dry-run으로 non-trivial 소스 빌드를 사전 감지하여 nrs는 abort, nrp는 경고 출력.
nrs/nrp 소스:
modules/shared/scripts/rebuild-common.sh,modules/nixos/scripts/{nrs,nrp}.sh
Platform이 darwin(Mac)일 때만 SSH 접속 필요:
ssh minipc # ~/.ssh/config에 정의됨 (macOS 전용)
Platform이 linux이면 이미 MiniPC — SSH 금지. 명령어를 직접 실행할 것.
| 파일 | 용도 |
|---|---|
hosts/greenhead-minipc/default.nix | 호스트별 하드웨어 종속 설정 |
hosts/greenhead-minipc/disko.nix | 디스크 파티셔닝 |
hosts/greenhead-minipc/hardware-configuration.nix | 하드웨어 설정 (자동 생성) |
modules/nixos/configuration.nix | NixOS 공통 설정 + 홈서버 서비스 활성화 |
modules/nixos/options/homeserver.nix | mkOption 기반 서비스 정의 |
modules/nixos/programs/ | 공통 서비스 모듈 (Tailscale, SSH, Caddy 등) |
modules/nixos/programs/docker/karakeep.nix | Karakeep 웹 아카이버/북마크 관리 (3컨테이너) |
modules/nixos/programs/smartd.nix | S.M.A.R.T. 디스크 건강 모니터링 + Pushover 알림 |
modules/nixos/programs/temp-monitor/ | lm-sensors 온도 모니터링 + Pushover 알림 (5분 주기) |
modules/nixos/home.nix | Home Manager (NixOS) |
modules/shared/scripts/rebuild-common.sh | nrs/nrp 공통 함수 라이브러리 → ~/.local/lib/ |
nixos-rebuild switch --rollback 또는 systemd-boot 메뉴에서 이전 세대 선택.
상세 내용: references/installation.md
커널 패닉 자동 재부팅(10초), systemd watchdog(30초 hang 감지 → 10분 후 강제 재부팅), WoL(같은 LAN 전용). 상세 내용: references/features.md
modules/nixos/programs/smartd.nix에서 NixOS services.smartd 모듈 활용.
NVMe + HDD 자동 감지, 디스크 장애 사전 감지 시 Pushover 알림 전송.
-W 5,50,60)pushover-system-monitor.age (smartd + temp-monitor 공유, NixOS 모듈 시스템이 merge)systemctl status smartd # 서비스 상태
sudo smartctl -a /dev/nvme0n1 # NVMe SMART 데이터
sudo smartctl -a /dev/sda # HDD SMART 데이터
modules/nixos/programs/temp-monitor/에서 systemd timer로 5분마다 CPU/NVMe 온도를 체크.
임계값 초과 시 단계별(경고/위험) Pushover 알림 발송. 임계값은 libraries/constants.nix의 tempMonitor에서 관리.
| 센서 | 경고 (priority 0) | 위험 (priority 1) | 하드웨어 crit |
|---|---|---|---|
| CPU Package | 80°C | 95°C | 105°C |
| NVMe Composite | 70°C | 85°C | 94.8°C |
pushover-system-monitor.age (smartd와 공유)coretemp-/nvme-)로 동적 탐색sensors # 수동 온도 확인
sensors -j # JSON 출력 (스크립트가 사용하는 형식)
systemctl status temp-monitor.service # 서비스 상태
systemctl list-timers | grep temp-monitor # 타이머 확인
journalctl -u temp-monitor.service -n 20 # 최근 로그
ls -la /var/lib/temp-monitor/ # 상태 파일 (쿨다운 기록)
--refresh 옵션 사용이 스킬은 NixOS MiniPC 호스트 환경 전제다. AI 에이전트 세션(Claude Code · Codex CLI · headless)이 어디서 실행되든 다음 의존을 충족하지 못하면 명령은 실행 불가하다.
nixos-rebuild, nrs, nrp 등 NixOS 전용 명령은 NixOS 호스트에서만 동작 (macOS 호스트는 nrs 입력 시 nix-darwin 경로로 분기됨 — managing-macos 사용)sudo 권한으로 systemd/smartd/temp-monitor 명령 실행enp2s0), 디스크 UUID는 hosts/greenhead-minipc/에 호스트 종속으로 박혀 있음 — 다른 NixOS 호스트로 이식 시 직접 수정 필요~/.local/lib/의 rebuild-common.sh 등 user-scope helper는 home-manager activation에 의해 설치되며 host 외부에선 부재본 스킬을 macOS Codex 세션이나 다른 NixOS 호스트에서 호출하면 호스트 종속 부분(인터페이스명/UUID/하드웨어 모니터링)이 실패할 수 있다.