المهارات db-migration
📦

db-migration

مخاطر متوسطة ⚡ يحتوي على سكربتات🔑 متغيرات البيئة⚙️ الأوامر الخارجية

إدارة ترحيلات قاعدة البيانات باستخدام Alembic

يمكن أن تؤدي تغييرات مخطط قاعدة البيانات إلى تعطيل التطبيقات أو فقدان البيانات. ترشد هذه المهارة إلى إعداد Alembic، وإنشاء المراجعات، والترقيات، وعمليات التراجع، وفحوصات المراجعة.

يدعم: Claude Codex Code(CC)
⚠️ 50 ضعيف
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

موارد مهيّأة لـ Agents

استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.

تفاصيل Markdown GET /skills/awais68-db-migration.md manifest موقَّع GET /api/skills/awais68-db-migration/manifest lockfile موقَّع GET /api/skills/awais68-db-migration/lockfile

اختبرها

جارٍ استخدام "db-migration". أحتاج إلى إضافة جدول fees إلى مشروع SQLModel.

النتيجة المتوقعة:

خطة ترحيل تنشئ الجدول، وتضيف الفهارس، وتعرّف المفاتيح الخارجية، وتسرد خطوات الرجوع للتراجع الآمن.

جارٍ استخدام "db-migration". غيّرت قيمة enum مستخدمة بواسطة صفوف موجودة.

النتيجة المتوقعة:

قائمة فحص مراجعة تغطي تحويل النوع، وربط البيانات الحالية، وسلوك الرجوع، والتحقق في بيئة staging قبل إصدار الإنتاج.

جارٍ استخدام "db-migration". أريد تطبيق الترحيلات أثناء النشر.

النتيجة المتوقعة:

تسلسل إصدار يتضمن النسخ الاحتياطي، وفحوصات المراجعات المعلقة، وإرشادات الترقية بخطوة واحدة، واختبارات smoke، ونقاط قرار التراجع.

التدقيق الأمني

مخاطر متوسطة
v6 • 6/28/2026

Static analysis reported many weak cryptography and command execution patterns, but manual review found no malware, prompt injection, network access, or data exfiltration. Most high-severity cryptography findings are false positives caused by Markdown, migration identifiers, and validation regex. The remaining risk is operational: the skill teaches database commands and SQL migrations that can modify or remove data if used without review.

2
الملفات التي تم فحصها
415
الأسطر التي تم تحليلها
8
النتائج
6
إجمالي عمليات التدقيق
مشكلات متوسطة المخاطر (2)
SKILL.md:18-26SKILL.md:205-216SKILL.md:318-323
Destructive Migration Commands Require Operator Review
The skill documents Alembic upgrade and downgrade commands, including downgrade to base. These are legitimate migration operations, but they can alter or remove database schema state if run against the wrong environment.
SKILL.md:247-258SKILL.md:264-276
Raw SQL Data Migration Examples Can Modify Existing Data
The examples use op.execute for data updates, enum type changes, and type drops. This is normal for migrations, but it can cause data loss or outage if copied without review, backups, and environment checks.
مشكلات منخفضة المخاطر (3)
SKILL.md:38-42SKILL.md:56-58
Hardcoded Database URL Placeholder in Documentation
The setup examples include placeholder database URLs with user and password fields. They appear illustrative, but users should replace them with secret-managed configuration.
SKILL.md:3-5SKILL.md:163-164SKILL.md:175-179SKILL.md:302SKILL.md:348scripts/verify.py:34-39scripts/verify.py:47-48
Weak Cryptography Static Findings Are False Positives
The weak cryptography matches point to Markdown text, migration identifiers, regex parsing, and description handling. I found no hash, cipher, password storage, or cryptographic implementation in the cited locations.
scripts/verify.py:7-17scripts/verify.py:51-57
Verification Script Reads Local Skill Files
The verification helper accepts a skill path, reads SKILL.md, and checks frontmatter. This is expected local validation behavior and shows no network access or exfiltration.

عوامل الخطر

⚡ يحتوي على سكربتات (1)
scripts/verify.py:1-61
🔑 متغيرات البيئة (2)
SKILL.md:64 SKILL.md:78
⚙️ الأوامر الخارجية (5)
SKILL.md:18-26 SKILL.md:100-105 SKILL.md:186-202 SKILL.md:207-216 SKILL.md:301-323

الأنماط المكتشفة

Database Rollback CommandsDirect SQL Execution in Migration Examples
دقّقه: codex عرض سجل التدقيق →

درجة الجودة

45
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
69
المجتمع
49
الأمان
91
الامتثال للمواصفات

ما الذي يمكنك بناؤه

إعداد أدوات الترحيل

تهيئة Alembic وإعداد البيانات الوصفية لتطبيق SQLModel جديد.

مراجعة تغييرات المخطط قبل الإصدار

فحص المراجعات المولدة تلقائيًا للتحقق من الفهارس والقيود والقيم الافتراضية وسلامة التراجع.

تخطيط ترحيلات بيانات آمنة

تصميم تحديثات على دفعات وسلوك الرجوع للبيانات الإنتاجية الحالية.

جرّب هذه الموجّهات

تهيئة Alembic 
قم بإعداد Alembic لمشروعي الذي يستخدم FastAPI وSQLModel. اشرح الملفات التي أحتاج إلى إنشائها والإعدادات التي يجب أن أراجعها.
إنشاء مراجعة 
ساعدني في إنشاء ترحيل Alembic لتغييرات SQLModel الأخيرة. ضمّن قائمة فحص المراجعة قبل أن أطبقه.
مراجعة خطة ترحيل 
راجع خطة الترحيل هذه للتحقق من فقدان البيانات، والفهارس المفقودة، وترتيب المفاتيح الخارجية، وسلوك الرجوع، ومخاطر لهجة قاعدة البيانات.
تصميم ترحيل بيانات 
صمم ترحيل بيانات آمنًا باستخدام Alembic لجدول كبير. ضمّن استراتيجية المعالجة على دفعات، ونهج التراجع، وخطوات الاختبار، وتنبيهات النشر.

أفضل الممارسات

  • شغّل الترحيلات على قاعدة بيانات اختبار قابلة للاستبدال قبل استخدام البيئات المشتركة.
  • راجع المراجعات المولدة تلقائيًا للتحقق من العمليات التدميرية والقيود المفقودة.
  • انسخ بيانات الإنتاج احتياطيًا ووثّق حدود التراجع قبل تطبيق الترحيلات.

تجنب

  • تطبيق الترحيلات المولدة تلقائيًا دون قراءة العمليات المولدة.
  • تشغيل أوامر downgrade على الإنتاج دون خطة استرداد.
  • تضمين كلمات مرور قواعد البيانات الحقيقية في ملفات إعداد الترحيل.

الأسئلة المتكررة

هل تشغّل هذه المهارة ترحيلات قاعدة البيانات تلقائيًا؟
لا. توفر إرشادات وأمثلة أوامر. يجب على المستخدمين تحديد متى وأين يشغّلون الترحيلات.
ما أداة الترحيل التي تركز عليها؟
تركز على ترحيلات Alembic لمشاريع SQLModel وSQLAlchemy وFastAPI.
هل يمكنها المساعدة في عمليات التراجع؟
نعم. تشرح أوامر downgrade والأنماط، لكن سلامة التراجع تعتمد على كل ترحيل.
هل يمكنها إنشاء خطط ترحيل بيانات؟
نعم. تتضمن أمثلة لتحديث السجلات الحالية وتغيير أنواع enum.
هل هي آمنة لقواعد بيانات الإنتاج؟
استخدمها مع اختبارات staging والنسخ الاحتياطية ومراجعة التغييرات. يمكن لأوامر الترحيل تغيير بيانات الإنتاج أو إزالتها.
هل تدعم أدوات تتجاوز Claude وCodex وClaude Code؟
يسرد التقرير Claude وCodex وClaude Code كأدوات مدعومة.

تفاصيل المطور

المؤلف

Awais68

الترخيص

MIT

المستودع

https://github.com/Awais68/hackathon-2-phase-ii-full-stack-web-app/tree/main/.claude/skills/db-migration

مرجع

main

بنية الملفات

📁 scripts/

📄 verify.py

📄 SKILL.md