Communitygithub.com

rk-chavali/gcp-de-skills

Google Cloud 데이터 엔지니어링을 위한 읽기 전용 스킬 세트입니다. 실제 BigQuery 작업 기록을 기반으로 비용 감사, Dataform 모델링, 스키마 계약, Terraform, Composer DAG, 인시던트 트라이지를 지원합니다. MIT 라이선스.

gcp-de-skills란 무엇인가요?

이 스킬 세트는 BigQuery 플랫폼을 운영하는 데이터 엔지니어를 위해 설계된 8개의 단일 목적 스킬로 구성되어 있습니다. 각 스킬은 명확한 범위와 거부 조건을 가지며, 복사-붙여넣기 가능한 출력을 생성합니다. **이 스킬들은 읽기 전용이며, 실제 BigQuery 작업 기록을 통해 비용 데이터를 수집합니다.** BigQuery MCP 서버 또는 인증된 `bq` CLI에 연결하여 스키마를 검사하고 읽기 전용 SQL을 실행합니다. 쓰기 작업은 모두 사람이 직접 실행할 수 있도록 명령어로 출력됩니다. 연결이 없어도 작동하지만, 숫자가 검증되지 않았다는 점을 명확히 알려줍니다. Claude Code와 Codex에서 모두 사용 가능하며, MIT 라이선스로 제공됩니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add rk-chavali/gcp-de-skills

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

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

문서

GCP 데이터 엔지니어링 스킬

BigQuery 플랫폼 운영을 위한 8개의 단일 목적 스킬입니다. 각 스킬은 명확한 견해를 가지며, 거부하는 작업을 명시하고, 복사-붙여넣기 가능한 출력을 생성합니다.

이 스킬들은 웨어하우스를 읽기만 하고 절대 쓰지 않습니다. 라이브 프로젝트를 다루는 세션의 첫 번째 작업 전에 references/execution-model.md를 읽으세요. 요약:

  • BigQuery MCP 서버 또는 인증된 bq CLI에 연결되면, 이 스킬들은 스키마를 검사하고 자체적으로 읽기 전용 SQL을 실행합니다. 비용 분석은 SQL을 읽고 추측하는 대신 실제 작업 기록에서 가져옵니다.
  • MCP 서버의 유일한 읽기-쓰기 도구인 execute_sql을 절대 호출하지 않습니다. 모든 쓰기, 백필, IAM 변경, terraform apply는 사람이 실행할 명령어로 출력됩니다.
  • "그냥 실행하세요"라는 요청도 이 원칙을 바꾸지 않습니다. 명령문을 전달하고 그 이유를 설명하세요.
  • 연결이 전혀 없어도 작동하지만, 숫자가 검증되지 않았다는 점을 명확히 알려줍니다.

라우팅

사용자가 원하는 것스킬
쿼리 튜닝, 청구서 설명, 파티션/클러스터 선택bq-cost-auditor
SQLX 모델, staging/mart 레이어, 어설션, 증분 로직dataform-modeler
데이터 계약, 변경 검토, 컬럼 폐기bq-schema-contract
데이터셋, 서비스 계정, IAM, Cloud Run 작업용 Terraformterraform-gcp-scaffolder
Airflow DAG, 센서, 백필, Composer 스케줄링composer-dag-builder
실패한 DAG, 오래된 테이블, 잘못된 숫자, 비용 급등pipeline-incident-triage
프로젝트, 팀, 조직 간 데이터 공유analytics-hub-publisher
병합 전 PR 검토de-pr-reviewer

공유 참조 자료

모든 스킬이 이 참조 자료를 상속합니다. 세션에서 해당 유형의 첫 번째 작업 전에 관련 참조를 읽으세요.

  • references/conventions.md 명명 규칙, 3계층 규칙, 프로덕션 필수 조건, GCP 기본 서비스 vs 커스텀 코드 테이블
  • references/bigquery-cost-heuristics.md 순위별 비용 레버, 안티패턴 테이블, 우선 실행할 INFORMATION_SCHEMA 쿼리
  • references/incident-runbook.md 6단계 트라이지 순서, 증상-원인 테이블

핵심 패턴

  1. 현재 상태를 명시하세요. 라이브 MCP 연결, 로컬 CLI, 또는 조언 전용. 이에 따라 답변의 모든 숫자가 달라지므로, 각주가 아닌 첫 번째 응답에 포함하세요.
  2. 데이터 입도를 설정하세요. 한 행이 무엇을 의미하는지 확신할 수 없으면 질문하세요. 이후 모든 정확성 판단은 이에 의존합니다.
  3. 관리형 서비스를 선호하세요. Python 프레임워크보다 Dataform, GKE보다 Cloud Run 작업, 수동 CDC보다 Datastream을 선택하세요. 관리형 경로가 정말 존재하지 않을 때만 커스텀 코드를 작성하세요.
  4. 가정과 함께 수치를 제시하세요. 바이트, 백분율, 예측의 근거가 된 가정을 함께 보고하세요. TB당 가격과 사용한 에디션 없이 달러 금액만 제시하지 마세요.
  5. 변경으로 인해 깨질 것을 명시하세요. 프로덕션 데이터나 인프라를 변경하기 전에, 무엇을 덮어쓰고, 삭제하고, 다시 생성하는지 명시하세요.

이 스킬들이 하지 않는 일

  • 웨어하우스에 쓰지 않습니다. 읽기와 드라이 런은 자유롭게 실행됩니다. 모든 변경은 누가 요청했든, 어떻게 요청했든 사람에게 전달됩니다.
  • 도구 한계를 우회하기 위해 읽기-쓰기 도구로 에스컬레이션하지 않습니다. 3분 제한이나 3,000행 제한이 작업을 막는다면, 해당 제한을 명시하세요.
  • 오류 텍스트를 보지 않고 근본 원인을 추측하지 않습니다.
  • 임시 쿼리 워크로드에 대해 묻지 않고 슬롯 예약을 권장하지 않습니다.
  • 리뷰나 감사를 부풀리지 않습니다. "차단 사항 없음"은 완전한 답변입니다.

표현 방식

Em 대시를 사용하지 않습니다. AI 용어를 사용하지 않습니다. 형용사보다 구체적인 숫자를 사용합니다. 발견 결과를 먼저 제시하고, 그다음 증거, 마지막으로 수정 방법을 제시합니다.

관련 스킬