메뉴
View immich photos: container→host path conversion, image display. Trigger: 'immich 사진 보여줘', 'immich 파일 보여줘', 'immich 사진 경로', 'upload-cache 파일 확인'. NOT for immich 컨테이너 관리 (use running-containers).
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | viewing-immich-photo |
| description | View immich photos: container→host path conversion, image display. Trigger: 'immich 사진 보여줘', 'immich 파일 보여줘', 'immich 사진 경로', 'upload-cache 파일 확인'. NOT for immich 컨테이너 관리 (use running-containers). |
macOS 또는 NixOS 환경에서 immich 사진 경로를 받아 이미지를 확인하는 방법입니다.
Immich 저장 경로 검증, 플랫폼별 파일 접근, 이미지 표시 절차를 다룬다.
| 항목 | 값 |
|---|---|
| 허용 루트 | /mnt/data/immich/photos/, /var/lib/docker-data/immich/upload-cache/ |
| macOS 동작 | scp minipc:…로 staging 후 이미지 표시 도구로 표시 (비이미지는 SSH 원격에서 file --) |
| NixOS 동작 | 로컬 경로를 이미지 표시 도구에 직접 전달 (비이미지는 로컬 file --) |
| 비허용 패턴 | .. 포함 경로 |
본문은 도구-중립 용어를 쓴다. 런타임별 실제 도구는 아래 표로 binding한다.
| 용어 | Claude Code | Codex |
|---|---|---|
| 이미지 표시 도구 | Read 도구 | view_image 도구 |
| 비이미지 메타데이터 명령 | 공통 셸 file -- <path> | 공통 셸 file -- <path> |
이미지 표시는 런타임 분기, 메타데이터 명령은 파일 형식 분기다 — 같은 축으로 섞지 않는다. 비이미지 메타데이터 명령의 실행 위치는 호스트 플랫폼에 따라 다르다: macOS는 SSH 원격에서 실행, NixOS는 로컬에서 실행 (상세는 아래 macOS/NixOS 섹션 참조).
요청된 경로가 immich 디렉토리 내부인지 먼저 확인:
/mnt/data/immich/photos/ 또는 /var/lib/docker-data/immich/upload-cache/.. 포함 경로는 거부 (path traversal 방지)로컬 호스트 기준으로 판별한다. SSH 원격 uname은 사용하지 않는다 — MiniPC 안의 OS는 항상 Linux이므로 분기에 무의미하다.
| 우선순위 | 신호 | 출처 |
|---|---|---|
| 1 | <env> 블록의 Platform: darwin / Platform: linux | Claude Code 하네스 메타 (Claude Code 한정) |
| 2 | 로컬 셸 uname -s 결과 (Darwin / Linux) | 양 런타임 공통 |
<env> 블록이 있으면 우선 사용, 없거나 불명확하면 로컬 셸에서 uname -s를 실행한다.
MiniPC에 저장된 파일이므로 이미지는 SSH로 staging한 뒤 이미지 표시 도구로 표시하고, 비이미지는 SSH 원격에서 file로 메타데이터만 가져옵니다.
/mnt/data/immich/photos/ 또는 /var/lib/docker-data/immich/upload-cache/로 시작 + .. 부재, path traversal 차단).jpg/.jpeg/.png/.webp/.gif): scp로 /tmp에 staging → 이미지 표시 도구로 표시file --을 보내 메타데이터만 출력 (staging 불필요). 명령 형식은 아래 명령어 블록 참조./tmp는 시스템 자동 정리 (수동 삭제 불필요)# 사전 검증된 원본 경로 (허용 루트 + ".." 부재 통과 후 변수에 담는다)
FILE_PATH="<검증 통과한 원본경로>"
BASENAME="${FILE_PATH##*/}"
EXT="${BASENAME##*.}"
# 확장자 없거나 ($BASENAME == $EXT) 비이미지 확장자면 메타데이터 fallback으로 보낸다
case "$BASENAME" in
*.jpg|*.jpeg|*.png|*.webp|*.gif|*.JPG|*.JPEG|*.PNG|*.WEBP|*.GIF)
DEST="/tmp/immich_photo_$(date +%s).$EXT"
scp -- "minipc:${FILE_PATH}" "$DEST"
# 이후 이미지 표시 도구에 "$DEST"를 전달
;;
*)
# 비이미지 fallback — 원격 셸에 단일 command string으로 전달.
# `ssh host arg...`는 arguments를 공백으로 join해 원격 셸이 재파싱하므로,
# 로컬에서 미리 shell-quote(`printf '%q'`, bash/zsh 공통)해야 메타문자가 보존된다.
ssh minipc "file -- $(printf '%q' "$FILE_PATH")"
;;
esac
보안: <원본경로> 같은 placeholder를 명령 문자열에 직접 삽입하지 마라.
scp 같은 로컬 명령에는 검증 통과한 변수를 quote("${FILE_PATH}")와 -- end-of-options 구분자로 전달한다.ssh host cmd args는 args를 공백으로 join해 원격 셸이 다시 파싱하므로, 로컬 quoting만으로 원격 셸 인자 경계가 보존되지 않는다. printf '%q'로 미리 quote해 단일 command string을 만들어 전달한다 (위 fallback 예시 참조).주의: minipc는 SSH config에 정의된 호스트 alias.
로컬 파일이므로 이미지는 경로를 직접 이미지 표시 도구에 전달하고, 비이미지는 로컬 file로 메타데이터만 출력합니다.
.. 부재)을 먼저 확인.jpg/.jpeg/.png/.webp/.gif): 로컬 경로를 이미지 표시 도구에 직접 전달file -- "${FILE_PATH}"로 메타데이터 출력| 유형 | 경로 패턴 |
|---|---|
| 업로드 캐시 | /var/lib/docker-data/immich/upload-cache/UUID/xx/xx/file.ext |
| 라이브러리 | /mnt/data/immich/photos/library/UUID/YYYY/MM/file.ext |
| Immich API 경로 | 호스트 경로 |
|---|---|
/usr/src/app/upload/upload/ | /var/lib/docker-data/immich/upload-cache/ |
/usr/src/app/upload/ | /mnt/data/immich/photos/ |
이미지 표시 도구는 이미지를 시각적으로 표시한다 (런타임 매핑은 위 "용어 binding" 표 참조):
.jpg, .jpeg, .png, .webp, .giffile -- <path>로 메타데이터만 출력 (시각적 표시는 불가)참고: Scriptable 업로드는 항상 .jpg로 저장됨
| 상황 | 대응 |
|---|---|
| SSH 연결 실패 | tailscale status 확인, ssh minipc "echo ok" 테스트 |
| 파일 없음 | 경로 오타 확인, Immich API 경로→호스트 경로 변환 확인 |
| 권한 없음 | 파일 소유자/권한 확인 (ls -la <path>) |
| 외부 전제조건 | minipc/mac은 SSH config alias, MiniPC는 Tailscale 도달 가정. SSH/Tailscale 가용성은 본 스킬 범위 밖 — managing-ssh 스킬 참조. |
modules/nixos/programs/docker/immich.nix의
virtualisation.oci-containers.containers.immich-server.volumes
(.../immich/photos:/usr/src/app/upload,
.../immich/upload-cache:/usr/src/app/upload/upload)docker/docker-compose.yml의 immich-server.volumes
(https://github.com/immich-app/immich/blob/main/docker/docker-compose.yml)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.