Community코딩 & 개발github.com

boshu2/sbh

SBH를 사용하여 디스크 압력을 검사하고, 승인된 복구 작업을 수행합니다. 사용 시기: 스토리지 진단 또는 SBH 복구가 요청될 때; 검사는 삭제를 승인하지 않습니다.

sbh란 무엇인가요?

이 스킬은 스토리지 압력(디스크 공간 부족) 문제를 진단하고 복구하는 전문 도구인 SBH(Storage Ballast Helper)의 기능을 제공합니다. 개발자와 AI 에이전트는 이 스킬을 통해 디스크 압력 상태, 밸러스트(ballast) 상태, 스캔 결과 및 복구 명령을 안전하게 실행할 수 있습니다. Claude Code, Cursor, Codex 등 주요 AI 에이전트 플랫폼에서 사용할 수 있도록 설계되었으며, 비가역적인 데이터 삭제 전에 증거 기반의 순차적 복구를 강조합니다. 이 스킬은 먼저 `sbh --json status`와 같은 읽기 전용 명령으로 사실적 기준선을 수집한 후, 명시적 승인이 있는 경우에만 제한된 변이 명령(예: `sbh clean --yes`)을 실행합니다. 잘못된 마운트 해제 방지, `.git/` 보호, 열린 파일 보호 등 안전 장치를 통해 실수로 인한 데이터 손실을 방지하며, 각 작업 전후의 증거를 수집하여 호출자에게 반환합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/boshu2/agentops/tree/main/skills/sbh

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

SBH — 스토리지 압력 전문가

SBH는 디스크 압력 상태, 밸러스트(ballast), 스캔 및 복구 명령을 제공합니다. 이 스킬은 증거를 수집하고 호출자가 승인한 명시적 작업만을 최대 한 번 수행합니다. 승인된 작업은 파일을 삭제하고 호스트 스토리지 구성을 변경할 수 있으므로, 명시적인 호출자 승인 없이는 어떤 변이도 실행되지 않습니다. 아래 명령어는 sbh 0.4.27을 기준으로 합니다. 특정 플래그에 의존하기 전에 다른 호스트에서 sbh --version으로 버전을 다시 확인하십시오.

증거 우선 복구는 디스크 압력에 저렴하고 되돌릴 수 있는 해결책과 비싸고 되돌릴 수 없는 해결책이 모두 존재하기 때문에 중요합니다. 사실적 기준선은 어떤 조치가 필요한지 삭제 전에 구분해 줍니다. 비가역성 순서로 복구를 진행하십시오: 상태 확인 및 dry-run 우선, 밸러스트 해제 다음, 보호되지 않은 파일 정리, 그리고 마지막으로 긴급 삭제 — 더 가역적인 단계를 시도하지 않고 다음 단계로 넘어가지 마십시오.

명명된 실패 모드 — 잘못된 마운트 해제: 제약된 마운트가 아닌 파일시스템에서 기가바이트를 회수하고 압력이 해결되었다고 선언하는 경우.

안티 패턴: 압력이 심각하다는 이유로 바로 emergency --yes로 직행하는 것. 교정: 긴급 상황은 되돌릴 수 없는 실수의 위험을 높입니다. 결코 승인 기준이나 위의 순서를 낮추지 않습니다.

제약 사항

  • 복구 결정에는 사실적 기준선이 필요하므로 sbh --json status, sbh check 또는 정확한 마운트에 대한 dry-run으로 시작하십시오.
  • clean --yes, emergency --yes, 밸러스트 해제, tune --apply, unprotect 또는 서비스/구성 변경은 호스트 상태를 변경하므로 명시적 승인 없이 실행하지 마십시오.
  • .git/, 열린 파일, 최근 파일, 쓰기 불가능한 부모 디렉토리 및 .sbh-protect 거부권을 유지하십시오. 이는 안전하지 않거나 비효율적인 정리를 방지합니다.
  • 밸러스트 또는 회수된 바이트가 제약된 마운트에 영향을 미치는지 확인하십시오. 다른 파일시스템의 여유 공간은 압력을 해결하지 않습니다.
  • 한 번에 하나의 작업을 실행하고, 전/후 증거를 수집한 후 중단하십시오. 추가 변이는 호출자가 결정합니다. 부정적인 결과는 호출자에게 반환되며, 이 스킬은 재시도하거나 에스컬레이션하지 않습니다.

출력

마운트, 여유 바이트, 압력 상태, dry-run 후보, 사용된 승인, 정확한 명령어 및 종료 코드, 회수된 바이트, 보호 거부권, 검사 및 미검사 영역을 반환합니다.

전체 명령어 문서: https://github.com/Dicklesworthstone/storage_ballast_helper

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

관련 스킬