مكتبة مهارات جيت هب كوبايلوت
تدقيق خطوط بيانات بايثون وبيغ كويري من حيث التكلفة وإعادة التشغيل الآمنة والجاهزية للإنتاج
نبذة عن المهارة
مهارة نصية توجّه الوكيل لمراجعة سكربتات Python التي تستخدم BigQuery كمهندس بيانات خبير. تكشف مخاطر التكاليف الخارجة عن السيطرة، مثل الاستعلامات داخل الحلقات وغياب maximum_bytes_billed. وتتحقق من وجود وضعَي dry_run وexecute، ومن تصميم إعادة الملء (backfill)، وأمان الاستعلامات وحجم المسح، وعدم تكرار الكتابة (idempotency)، وقابلية المراقبة. الناتج تقرير منظم من القسم A إلى F مع حكم PASS أو FAIL، وقائمة إصلاحات مرتبة حسب الخطورة تشير إلى الدوال والأسطر المعنية.
كيف تستخدم هذه المهارة؟
1. افتح مستودع الكود أو أرفق سكربت Python الذي ينفّذ عمليات BigQuery حتى يتمكن الوكيل من قراءته.
2. اطلب التدقيق صراحةً، مثلاً: «دقّق سكربت pipelines/daily_scores.py من حيث تكلفة BigQuery وأمان إعادة التشغيل، وأعطني قائمة الإصلاحات».
3. سيحدد الوكيل كل استدعاء مثل client.query وload_table_from_* والاستدعاءات الخارجية. ثم يقدّر أسوأ عدد ممكن من المهام، ويفحص وجود maximum_bytes_billed والعَلَم --mode وحدود نطاق التواريخ.
4. راجع الأقسام A إلى F في التقرير: التكلفة، والتشغيل التجريبي، وتصميم الحلقات، وأمان الاستعلامات، والكتابة الآمنة، والمراقبة. يقترح الوكيل في كل قسم تعديلات بسيطة، مثل استخدام MERGE على مفتاح حتمي أو إضافة run_id.
5. اعتمد على القسم الختامي لترتيب العمل: يتضمن حكم PASS أو FAIL لكل قسم، وقائمة الإصلاحات حسب الخطورة، وأكبر ثلاثة مخاطر للتكلفة مع تقدير تقريبي لها.
المتطلبات وما يجب معرفته
- تحتاج المهارة إلى وصول الوكيل لقراءة كود Python الخاص بخط البيانات.
- تعتمد على مكتبة عميل BigQuery من Google، لكن التدقيق يتم بقراءة الكود فقط. لا تنفّذ المهارة استعلامات ولا تتصل بحساب Google Cloud، ولا تحتاج إلى بيانات اعتماد.
- التقديرات الواردة في التقرير، مثل عدد المهام والتكلفة، تقريبية ومبنية على تحليل ثابت للكود. يجب مراجعتها واختبار الإصلاحات المقترحة قبل تطبيقها في بيئة الإنتاج.
- المهارة مخصّصة لخطوط Python مع BigQuery تحديداً.
- الترخيص الأصلي: MIT.
التثبيت حسب الوكيل
نزّل ملف ZIP من هذه الصفحة وفك الضغط. يحتوي على مجلد bigquery-pipeline-audit وملف SKILL.md الأصلي مع المرفقات والترخيص.
كلود — Claude Code
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.claude/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.claude/skills/bigquery-pipeline-audit/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور bigquery-pipeline-audit.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كوبايلوت — GitHub
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.github/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.github/skills/bigquery-pipeline-audit/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور bigquery-pipeline-audit.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كودكس — OpenAI
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.agents/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.agents/skills/bigquery-pipeline-audit/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور bigquery-pipeline-audit.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
كيرسر — Cursor
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.cursor/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.cursor/skills/bigquery-pipeline-audit/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور bigquery-pipeline-audit.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
ويندسيرف — ديفين
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.devin/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.devin/skills/bigquery-pipeline-audit/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور bigquery-pipeline-audit.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.
جيميني — Gemini CLI
- داخل مجلد مشروعك أنشئ المسار التالي إن لم يكن موجودًا:
.gemini/skills/ - انسخ مجلد المهارة المفكوك كاملًا إلى هذا المسار، ليصبح ملفها:
.gemini/skills/bigquery-pipeline-audit/SKILL.md - افتح المشروع في الوكيل أو حدّث قائمة المهارات، وتحقق من ظهور bigquery-pipeline-audit.
- اطلب المهمة الموضحة في المثال أعلاه واختر المهارة من قائمة الوكيل. وافق على الصلاحيات الضرورية فقط.