SRE 런북 Agent Skills
프로덕션 SRE 런북을 생성, 검토, 안전하게 실행하기 위한 휴대용 Agent Skills입니다.
런북을 만드세요. 깨끗한 컨텍스트로 검토하세요. 한 단계씩 안전하게 실행하세요.
이 저장소는 운영 문서 및 인시던트 대응 워크플로를 위한 재사용 가능한 Agent Skills를 게시합니다. 이 스킬들은 SRE, 플랫폼 엔지니어, DevOps 엔지니어, 인시던트 사령관, 온콜 엔지니어가 명확하고 안전하며 실행 가능한 AI 지원 런북을 사용할 수 있도록 설계되었습니다.
이 스킬들의 관행은 Google SRE 관행에서 영감을 받았으며, 실행 가능한 알림, 긴급 대응, 안전한 완화, 검증, 롤백 기준, 에스컬레이션, 명확한 소유권 등 일반적인 SRE 모범 사례에 부합합니다.
포함된 스킬
| 스킬 | 목적 |
|---|---|
sre-runbook-author | 알림, 인시던트, 완화, 롤백, 진단 및 에스컬레이션을 위한 실행 중심 런북을 생성합니다. |
sre-runbook-reviewer | 깨끗한 컨텍스트 관점에서 런북을 검토하고, 격차, 안전하지 않은 작업, 숨겨진 가정, 누락된 검증을 식별합니다. |
sre-runbook-executor | 증거 캡처, 모호함 중단, 위험 작업에 대한 승인 게이트를 통해 기존 런북을 한 단계씩 실행합니다. |
사용 사례 예시
- "이 높은 5xx 알림에 대한 런북을 만들어 줘."
- "사전 컨텍스트 없이 이 런북을 검토해 줘."
- "이 런북을 안전하게 실행하고 위험한 작업 전에 멈춰 줘."
- "이 롤백 절차에서 숨겨진 가정이나 누락된 단계를 찾아줘."
- "이 인시던트 대응 프로세스를 명확한 에이전트 실행 가능 런북으로 변환해 줘."
설치
호환되는 도구는 일반적으로 SKILL.md가 포함된 디렉토리를 스킬로 인식합니다.
프로젝트 로컬 설치:
mkdir -p .agents/skills
cp -r skills/sre-runbook-* .agents/skills/
사용자 수준 설치:
mkdir -p ~/.agents/skills
cp -r skills/sre-runbook-* ~/.agents/skills/
일부 도구는 .gemini/skills/, ~/.gemini/skills/ 또는 제품별 확장 디렉토리와 같은 자체 스킬 또는 플러그인 경로를 사용합니다. 설치 전에 도구의 현재 문서를 확인하세요.
안전 모델
이 스킬들은 보수적인 인시던트 대응을 기반으로 구축되었습니다:
- 인시던트 입력과 해당 런북으로 시작합니다.
- 읽기 전용 진단을 저위험 및 고위험 작업과 분리합니다.
- 단계가 모호하거나, 필요한 접근 권한이 없거나, 관찰된 상태가 런북과 다른 경우 중단합니다.
- 배포, 롤백, 재시작, 확장 작업, 장애 조치, 구성 변경, 데이터 변경, 권한 변경, 알림 억제, 리소스 삭제와 같은 위험한 작업 전에 명시적 승인을 요청합니다.
- 증거를 보존하고 실제 결과를 예상 결과와 비교합니다.
예시 프롬프트
<ALERT_NAME> 알림에 대한 프로덕션 SRE 런북을 만들어 줘. 누락된 대시보드, 임계값, 소유자 및 명령어는 플레이스홀더를 사용해.
이 런북을 깨끗한 컨텍스트 관점에서 검토해 줘. 오전 3시에 온콜 엔지니어를 혼란스럽게 할 수 있는 모든 것을 표시해.
이 런북을 한 단계씩 실행해 줘. 읽기 전용 진단으로 시작하고 위험한 작업 전에 멈춰.
예시
라이선스
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. LICENSE를 참조하세요.