사용 가능 자원 탐지 (get-available-resources)
현재 프로세스가 실제로 쓸 수 있는 CPU·메모리·디스크·GPU 한계를 안전하게 탐지해 JSON 스냅샷과 병렬 작업 계획을 만들어 줍니다.
유틸리티중급★ 33,030⑂ 3,248AI 점수 8/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
scripts/detect_resources.py로 호스트 전체 사양이 아니라 현재 프로세스에 실제 적용되는 한계를 탐지합니다: CPU 논리/물리 코어, 프로세스 affinity, cgroup v2 cpuset·quota, 메모리memory.max/memory.high, 디스크 여유 공간, Slurm 할당량, NVIDIA/AMD/Apple 가속기 후보.- 호스트명, 절대 경로, cgroup 경로, 작업 ID, GPU UUID, PCI 주소 등 식별 가능한 값은 모두 제거된(redacted) JSON만 출력합니다.
- 스트레스 테스트·벤치마크·대용량 할당·드라이버 설치를 하지 않고, 짧은 타임아웃의 읽기 전용 조회만 수행합니다.
plan_workload.py로 워커 수와 워커당 스레드 수를 보수적으로 계산하고,snapshot_tools.py로 스냅샷 검증·비교,accelerator_diagnostics.py로 '실행하지 않는' 가속기 점검 계획을 만듭니다.- 관측되지 않은 값은 '무제한'이 아니라 항상
unknown으로 처리하는 원칙을 지킵니다.
이런 분께 추천
- Slurm 클러스터나 Docker/Kubernetes 컨테이너에서 과학 계산·데이터 처리를 돌리는 연구자·엔지니어
- 병렬 워커 수를 잘못 잡아 OOM이나 CPU 오버서브스크립션을 겪어본 분
- 로그나 스냅샷을 공유해야 해서 민감한 경로·호스트 정보가 새면 안 되는 팀
- Apple 실리콘 통합 메모리처럼 플랫폼별 자원 개념을 정확히 이해하고 싶은 분
활용 예시
- 컨테이너 안 실제 한계 확인 — "이 컨테이너에서 내가 쓸 수 있는 CPU와 메모리를 알려줘"라고 하면
python scripts/detect_resources.py를 실행해cpu.effective.capacity_cores, cgroupmemory.max기준으로 호스트 사양과 구분해 보고합니다. - 병렬 처리 계획 수립 — 100개 작업, 워커당 2GiB가 필요할 때
plan_workload.py ... --workload cpu --tasks 100 --memory-per-worker-mib 2048으로suggested_workers와threads_per_worker를 함께 받아 BLAS 스레드 폭주를 방지합니다. - 환경 변화 추적 — 잡 제출 전/후 스냅샷을 저장해
snapshot_tools.py diff before.json after.json으로 타임스탬프를 제외한 자원 변화만 비교합니다. - GPU 사용 가능성 사전 점검 —
accelerator_diagnostics.py --backend auto로 가시성·권한·런타임 호환성 게이트를 분리한 점검 계획만 받아, 드라이버를 건드리지 않고 검토합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 K-Dense-AI/scientific-agent-skills 의 skills/get-available-resources 폴더를 내 ~/.claude/skills/get-available-resources/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/scientific-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/scientific-agent-skills/skills/get-available-resources ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 저장소를 내려받습니다:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - 스킬 폴더가 없으면 만듭니다:
mkdir -p ~/.claude/skills - 이 스킬만 복사합니다:
cp -r scientific-agent-skills/skills/get-available-resources ~/.claude/skills/ - Python 3.11 이상이 설치되어 있는지 확인합니다:
python --version - (선택) 크로스 플랫폼 정확도를 높이려면
uv pip install "psutil==7.2.2"또는pip install "psutil==7.2.2"를 실행합니다. 설치하지 않아도 표준 라이브러리로 동작합니다. - Claude Code를 재시작한 뒤 "현재 사용 가능한 CPU/메모리 자원을 탐지해줘"처럼 요청하면 스킬이 활성화됩니다.
- 결과를 파일로 남기려면
python scripts/detect_resources.py --output resource-snapshot.json처럼 현재 디렉터리의.json파일명을 명시하세요(덮어쓰기는--force필요).
GitHub에서 원본 보기 ↗라이선스: MIT