AI运维宝库 컴패니언 스킬

AIOps Vault Companion Skill

이 스킬은 프로시저 레이어입니다. 사용자의 현재 자산을 포함하지 않습니다. 현재 사실은 로컬 AIOps 볼트(기본적으로 $AIOPS_ROOT 또는 ~/ai-ops)에 저장됩니다.

진리 소스 계약

다음과 같이 분할하여 사용합니다:

• README.md: 안정적인 로컬 규칙, 파일 역할, 안전 경계, 프로젝트별 규칙.
• resources.md: 현재 신뢰해야 하는 상태.
• maintenance-log.jsonl: 결정, 유지보수, 점검, 인시던트, 수정 사항의 추가 전용 히스토리.
• secrets-location.md: 비밀 이름, 저장 위치, 접근/로테이션 노트만 포함하며, 절대 비밀 값은 포함하지 않습니다.
• services/<service>/service-card.md: 서비스별 런북 및 세부 정보 (중앙 리소스 파일이 너무 커질 경우 사용).
• scripts/aiops.py: 볼트 위에서 동작하는 저토큰 명령 인터페이스.

이 스킬로부터 현재 인프라를 유추하지 마십시오. 볼트를 읽고 안전한 경우 실제 상태를 점검하십시오.

기본 읽기 순서

1. 볼트 경로 확인 ($AIOPS_ROOT가 설정된 경우, 그렇지 않으면 ~/ai-ops).
2. 태스크가 파일, 서비스, 노출, 자격 증명 또는 백업을 변경할 가능성이 있으면 먼저 로컬 볼트의 README.md를 읽습니다.
3. 전체 읽기 전에 명령 레이어 실행:
   • python3 "$AIOPS_ROOT/scripts/aiops.py" index
   • python3 "$AIOPS_ROOT/scripts/aiops.py" resources --section "<section>"
   • python3 "$AIOPS_ROOT/scripts/aiops.py" service "<name>"
   • python3 "$AIOPS_ROOT/scripts/aiops.py" host "<name>"
   • python3 "$AIOPS_ROOT/scripts/aiops.py" log --tail 20 --summary
4. 슬라이스된 출력이 충분하지 않은 경우에만 전체 resources.md, 서비스 카드 또는 로그 라인을 읽습니다.
5. 실제 상태와 볼트 문서가 질문에 답할 수 없는 경우에만 세션 히스토리를 사용합니다.

안전 경계

• 비밀 값을 읽거나, 출력하거나, 복사하거나 저장하지 마십시오. secrets-location.md는 메타데이터일 뿐 비밀 덤프가 아닙니다.
• resources.md, 로그, 서비스 카드, 프롬프트, 이슈 코멘트, 커밋 또는 채팅 요약에 비밀을 기록하지 마십시오.
• 되돌릴 수 없거나 노출 위험이 높은 작업(삭제, 덮어쓰기, 로테이션, 복원, 공용 포트 열기, DNS 변경, 데이터 마이그레이션, 백업 비활성화, 타사/친구 소유 리소스 접근)은 실행 전에 확인을 받으십시오.
• 리소스 풀을 명시적으로 유지하십시오. 사용자가 해당 대상을 명시적으로 승인하지 않는 한 타사 또는 친구 소유 인프라에서 작업하지 마십시오.
• 최소 노출 선호: 관리 경로의 경우 리버스 프록시 뒤의 localhost 또는 프라이빗 네트워크; 의도적이고 인증된 경우에만 공용 HTTPS.

유지보수 워크플로우

1. 대상 분류: 호스트, 서비스, 도메인/DNS, 리버스 프록시, 데이터/백업, 비밀 위치, 자동화 또는 볼트 자체.
2. 리소스 풀 및 권한 경계 식별.
3. aiops.py 및 서비스 카드를 통해 최소한의 현재 컨텍스트 로드.
4. 필요한 경우 안전한 명령으로 실제 상태 점검.
5. 가장 작은 되돌릴 수 있는 작업을 계획하고 고위험 단계를 명시.
6. 최소 권한으로 실행.
7. 소비자 측의 실제 출력(헬스 체크, 로그, HTTP 요청, systemctl, docker ps, 백업 목록 등)으로 검증.
8. 올바른 레이어 업데이트:
   • 현재 사실 -> resources.md 또는 서비스 카드;
   • 중요한 히스토리 -> 하나의 추가된 maintenance-log.jsonl 객체;
   • 비밀 위치 -> secrets-location.md (값 없이);
   • 서비스 로컬 세부 정보 -> 서비스 README/카드.
9. 변경 사항이 개인 로컬 사실뿐만 아니라 재사용 가능한 AIOps 워크플로우/도구를 개선하는 경우, 일반적인 부분을 템플릿 저장소(~/projects/aiops-vault-template)에 동기화하고, 테스트/검사를 실행한 후 커밋 및 푸시하여 다운스트림 AIOS Kit 소비자가 개선 사항을 받을 수 있도록 합니다. 개인 리소스, 로그 또는 비밀을 공개 템플릿에 복사하지 마십시오.
10. 볼트 변경 후 python3 "$AIOPS_ROOT/scripts/aiops.py" check 실행.
11. 변경된 파일, 명령, 검증, 건너뛴/차단된 항목 및 후속 조치 보고.

쓰기 백 규칙

• 현재 상태는 히스토리 로그뿐만 아니라 resources.md 또는 서비스 카드에 속합니다.
• 히스토리는 maintenance-log.jsonl에 속하며, 각 줄은 하나의 유효한 JSON 객체입니다.
• 수정 사항은 새로운 correction 또는 supersede 항목으로 추가되어야 합니다. 사용자가 마이그레이션을 요청하지 않는 한 히스토리를 다시 쓰지 마십시오.
• 동일한 사실을 README, resources, 서비스 카드, 로그에 중복하지 마십시오. 소유 레이어를 선택하십시오.
• 대량의 원시 증거는 evidence/ 아래 또는 경로 참조와 함께 볼트 외부에 저장해야 합니다.

검증 체크리스트

최종 확정 전:

• python3 "$AIOPS_ROOT/scripts/aiops.py" check 통과 또는 실패 이유 설명.
• JSONL 파일 구문 분석 가능.
• 명백한 비밀 값 추가되지 않음.
• 현재 상태 변경이 유지보수 로그에만 있는 것은 아님.
• 응답의 주장이 볼트 파일 또는 라이브 명령 출력에 의해 뒷받침됨.
• 모든 고위험 작업이 확인되었거나 명시적으로 제안 단계로 남겨짐.

볼트가 없는 경우

AIOps 볼트가 없고 사용자가 원하는 경우, 템플릿 저장소를 설치하거나 최소 레이아웃을 생성하십시오:

aio-ops/
  README.md
  resources.md
  maintenance-log.jsonl
  maintenance-log.schema.md
  secrets-location.md        # 비공개, Git에서 무시됨
  secrets-location.example.md
  scripts/aiops.py

그런 다음 python3 scripts/aiops.py check 실행.