safety-guard

safety-guard 스킬 개요

safety-guard가 하는 일

safety-guard 스킬은 파괴적이거나 고위험인 에이전트 동작에 보호 레이어를 더합니다. 위험한 명령을 막고, 쓰기를 특정 디렉터리로 제한하고, 자율 에이전트를 더 안전하게 돌리고 싶을 때 특히 유용합니다. 즉, 운영 환경, 배포 대상, 활성 데이터에 손상을 줄 가능성을 낮추는 데 초점이 맞춰져 있습니다.

가장 잘 맞는 사용 사례

라이브 시스템을 관리하거나, 코딩 에이전트를 full-auto 모드로 실행하거나, 마이그레이션·인프라 변경·릴리스 작업을 자주 다룬다면 safety-guard를 설치할 만합니다. safety-guard skill은 단순히 “조심하자”가 아니라, “위험한 동작을 실제로 실행하기 더 어렵게 만들자”가 필요한 상황에 잘 맞습니다.

왜 중요한가

핵심 가치는 워크플로 제어입니다. 이 스킬은 강제 푸시, hard reset, 파괴적인 삭제, 광범위한 시스템 정리 같은 위험한 명령을 차단하는 동시에, 편집을 한 경로로만 고정할 수 있게 해줍니다. 그래서 safety-guard for Access Control은 모델이 저장소 전체에 접근할 수는 있지만, 수정 범위는 좁게 제한해야 할 때 특히 유용합니다.

safety-guard 스킬 사용하는 방법

설치하고 소스 위치 확인하기

리포지토리에 안내된 safety-guard install 명령을 사용하세요:
npx skills add affaan-m/everything-claude-code --skill safety-guard

먼저 skills/safety-guard/SKILL.md부터 보세요. 가장 빨리 파악하려면 모드 정의를 먼저 읽고, 같은 파일 안에 연결된 구현 메모가 있으면 그다음에 훑는 편이 좋습니다.

대략적인 목표를 쓸 만한 프롬프트로 바꾸기

safety-guard usage 패턴은 작업, 위험 수준, 쓰기 경계를 함께 명시할 때 가장 잘 작동합니다. 좋은 입력은 대상 영역과 원하는 가드레일을 함께 적습니다.

• “결제 API를 업데이트하되, src/api/ 안에서만 쓰고 파괴적인 명령은 차단해줘.”
• “내가 배포 전에 변경 사항을 검토할 수 있도록 guarded mode로 실행해줘.”
• “프로덕션 마이그레이션 작업을 보호하고, 상태를 삭제하거나 초기화할 수 있는 명령은 실행 전에 물어봐줘.”

동작을 바꾸는 부분부터 읽기

실무용 safety-guard guide를 보려면 모드 설명과 unlock 흐름에 집중하세요. 이 리포지토리에서 실제로 도움이 되는 정보는 세 가지 보호 모드, 감시하는 명령, 그리고 정확한 freeze 문법입니다. 이런 요소들이 있어야 이 스킬이 실제 환경에서 강제 가능한지 판단할 수 있습니다.

더 좋은 결과를 내는 워크플로

확인 위주가 필요하면 careful 모드를 쓰세요. 쓰기 범위를 묶어야 하면 freeze 모드를 쓰세요. 두 위험이 모두 있으면 결합 가드 모드를 쓰면 됩니다. 작업 범위가 좁다면 허용 디렉터리를 명시적으로 적고, 운영 작업이라면 확인을 트리거해야 하는 구체적인 명령이나 액션을 적어두세요.

safety-guard 스킬 FAQ

safety-guard는 프로덕션 작업에만 쓰나요?

아닙니다. 프로덕션에서 가장 강력하지만, 스테이징, 공유 저장소, 로컬 자율 실행 환경에서도 잘못된 삭제·초기화·게시가 비용을 크게 만들 수 있다면 충분히 도움이 됩니다.

일반 프롬프트와 무엇이 다른가요?

일반 프롬프트는 모델이 주의를 기억해 주길 기대합니다. safety-guard skill은 그 주의를 반복 가능한 제어 패턴으로 바꿉니다. 위험한 명령을 감시하고, 허용된 트리 밖의 쓰기를 막고, 경계를 명확히 드러냅니다.

safety-guard는 초보자에게도 친화적인가요?

네, 목표가 단순하다면 그렇습니다. 에이전트가 편집하는 동안 저장소를 보호하고 싶을 때 특히 그렇습니다. 초보자가 가장 먼저 이해해야 할 것은 확인 기반 보호와 디렉터리 기반 쓰기 제한의 차이입니다.

언제 사용하지 말아야 하나요?

safety-guard를 코드 리뷰, 백업, 환경 권한의 대체물로 쓰지 마세요. 이 스킬은 가드레일이지 복구 계획이 아닙니다. 넓고 제한 없는 리팩터링이 필요한 작업이라면 freeze 모드가 너무 제약적일 수 있습니다.

safety-guard 스킬 개선 방법

스킬의 경계를 더 선명하게 주기

가장 효과적인 개선은 범위를 더 분명하게 적는 것입니다. “안전하게”라고만 하지 말고, 무엇을 보호해야 하는지, 무엇을 수정해도 되는지, 무엇은 읽기 전용이어야 하는지를 명확히 쓰세요. 입력이 구체적일수록 불필요한 차단이 줄고, 오가며 수정할 일도 적어집니다.

예상되는 위험 작업을 명시하기

워크플로에 배포, 게시, 데이터베이스 변경, 정리 명령이 포함된다면 처음부터 말해 두세요. safety-guard skill은 확인을 우선할지, 쓰기 동결을 우선할지, 아니면 둘 다 적용할지 알수록 더 잘 조정됩니다.

자주 생기는 실패 모드 확인하기

가장 흔한 실패는 freeze 범위가 너무 넓어서 정상 편집까지 막는 경우입니다. 두 번째는 작업 설명이 너무 모호해서 어떤 명령이 허용되는지 에이전트가 판단하지 못하는 경우입니다. 첫 결과가 너무 제한적이면 보호 경로를 좁히고, 너무 느슨하면 명시적인 명령 및 경로 제약을 추가하세요.

첫 실행 후 반복해서 다듬기

첫 시도 이후에는 결과물만 보지 말고 에이전트가 실제로 무엇을 시도했는지에 맞춰 조정하세요. 위험한 명령을 시도했다면 usage 지침에 차단 패턴을 더 넣으세요. 의도한 영역 밖으로 벗어났다면 허용 디렉터리를 더 엄격하게 좁히세요.