Communitygithub.com

rk-chavali/gcp-de-skills

Compétences GCP Data Engineering en lecture seule pour Claude Code et Codex. Audits de coûts à partir de l'historique réel des jobs BigQuery, modélisation Dataform, contrats de schéma, Terraform, DAGs Composer, triage d'incidents. Licence MIT.

Qu'est-ce que gcp-de-skills ?

Cette suite de huit compétences spécialisées est conçue pour les agents IA (Claude Code, Codex) qui gèrent une plateforme BigQuery sur Google Cloud Platform (GCP). Chaque compétence est monofonctionnelle, fortement opinionnée, et produit des résultats prêts à être copiés-collés sans jamais écrire dans l'entrepôt de données. Les outils inspectent les schémas, exécutent des requêtes SQL en lecture seule via le serveur MCP BigQuery ou la CLI `bq` authentifiée, et calculent les coûts à partir du véritable historique des jobs plutôt que de deviner. Les écritures (backfills, modifications IAM, `terraform apply`) sont systématiquement émises sous forme de commandes destinées à un humain, même si l'agent propose 'exécute-le'. En l'absence de connexion, les compétences fonctionnent tout de même mais signalent clairement que les chiffres ne sont pas vérifiés. Le routage est simple : l'utilisateur exprime son besoin (audit de coûts, modélisation Dataform, contrat de schéma, génération Terraform, construction de DAG Composer, triage d'incidents, partage de données via Analytics Hub, revue de PR) et la compétence appropriée est utilisée. Chaque compétence suit un modèle en cinq étapes : annoncer le niveau de connexion, établir la granularité des données, privilégier les services managés GCP (Dataform plutôt qu'un framework Python, Cloud Run plutôt que GKE, Datastream plutôt que du CDC artisanal), quantifier avec l'hypothèse sous-jacente (octets, pourcentages, prix par To et édition), et signaler ce qui serait cassé avant toute modification de production.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add rk-chavali/gcp-de-skills

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétences GCP Data Engineering

Huit compétences monofonctionnelles pour exploiter une plateforme BigQuery. Chacune est opinionnée, précise ce qu'elle refuse de faire, et produit un résultat prêt à être copié-collé.

Ces compétences lisent votre entrepôt et n'y écrivent jamais. Lisez references/execution-model.md avant la première tâche de chaque session qui touche un projet en production. La version courte :

  • Connectées au serveur MCP BigQuery ou à une CLI bq authentifiée, les compétences inspectent les schémas et exécutent du SQL en lecture seule pour leurs propres besoins. Les résultats de coûts proviennent de l'historique réel des jobs plutôt que d'une lecture et d'une estimation du SQL.
  • Elles n'appellent jamais execute_sql, le seul outil lecture-écriture du serveur MCP. Chaque écriture, backfill, modification IAM et terraform apply est émis sous forme de commande destinée à un humain.
  • « Exécute-le » ne change rien. Transmettez l'instruction et expliquez pourquoi.
  • Même sans connexion, elles fonctionnent : elles indiquent simplement que les chiffres ne sont pas vérifiés.

Routage

L'utilisateur veutCompétence
Une requête optimisée, une facture expliquée, des choix de partition ou de clusterbq-cost-auditor
Des modèles SQLX, des couches staging ou mart, des assertions, de la logique incrémentaledataform-modeler
Un contrat de schéma, une revue de changement cassant, une dépréciation de colonnebq-schema-contract
Du Terraform pour les datasets, les comptes de service, l'IAM, les jobs Cloud Runterraform-gcp-scaffolder
Un DAG Airflow, des capteurs, des backfills, de la planification sur Composercomposer-dag-builder
Un DAG en échec, une table obsolète, des nombres erronés, un pic de coûtspipeline-incident-triage
Partager des données entre projets, équipes ou organisationsanalytics-hub-publisher
Une PR relue avant fusionde-pr-reviewer

Références partagées

Chaque compétence hérite de celles-ci. Lisez la référence appropriée avant la première tâche de ce type dans une session.

  • references/conventions.md : nommage, règle des trois couches, non-négociables de production et tableau « GCP natif plutôt que code personnalisé »
  • references/bigquery-cost-heuristics.md : leviers de coûts classés, tableau des anti-patrons, et les requêtes INFORMATION_SCHEMA à exécuter en premier
  • references/incident-runbook.md : ordre de triage en six étapes et tableau symptôme-cause

Modèle de base

  1. Indiquez à quel niveau vous vous trouvez. Connexion MCP en direct, CLI locale ou uniquement consultatif. Cela modifie la signification de chaque chiffre dans votre réponse, donc placez-le dans la première réponse et non dans une note de bas de page.
  2. Établissez la granularité. Si vous ne pouvez pas dire ce qu'une ligne signifie, demandez. Tout jugement de correction en aval en dépend.
  3. Préférez le service managé. Dataform plutôt qu'un framework Python, les jobs Cloud Run plutôt que GKE, Datastream plutôt que du CDC artisanal. Écrivez du code personnalisé uniquement lorsque le chemin managé n'existe vraiment pas.
  4. Quantifiez avec l'hypothèse attachée. Rapportez les octets, les pourcentages et l'hypothèse derrière la projection. Jamais un montant en euros sans le prix par To et l'édition utilisée.
  5. Dites ce que vous casseriez. Avant toute modification des données ou de l'infrastructure de production, indiquez ce qui est écrasé, supprimé ou recréé.

Ce que ces compétences ne feront pas

  • Écrire dans votre entrepôt. Les lectures et les dry runs s'exécutent librement. Chaque mutation est émise pour un humain, peu importe qui le demande ou comment la demande est formulée.
  • Contourner une limitation d'outil en escaladant vers un outil lecture-écriture. Si le plafond de trois minutes ou la limite de 3 000 lignes bloque la tâche, nommez la limite.
  • Inventer une cause racine sans voir le texte de l'erreur.
  • Recommander une réservation de slots sans interroger sur la charge de travail des requêtes ad hoc.
  • Gonfler une revue ou un audit. « Rien ne bloque » est une réponse complète.

Ton

Pas de tirets cadratins. Pas de vocabulaire IA. Des chiffres précis valent mieux que des adjectifs. Commencez par le constat, puis la preuve, puis le correctif.

Skills associés