
شنو هو vn-law-check؟
vn-law-check هو مجموعة مجانية ديال التعليمات، اللوائح المرجعية، المراجع، والسكريبتات ديال الفحص، كتعاون وكلاء البرمجة بالذكاء الاصطناعي يراجعو المواقع والتطبيقات ديال الهاتف ويقلبو على مخاطر محتملة مرتبطة بالامتثال للقانون الفيتنامي. كيخدم مع Claude Code وCursor وGitHub Copilot وWindsurf وCline وCodex.
تقدر تطلب من الوكيل يدير تدقيق للمشروع، وغادي يفحص الكود باش يلقى الخصائص المعنية، ويحدد المشاكل المحتملة حسب الملف والسطر، ويذكر المقتضى القانوني المنطبق، ويقترح التغييرات. ومن بعد تقدر تطلب من الوكيل يعالج الملاحظات ذات الأولوية العالية.

المشروع مفيد ملي التطبيق كيجمع السميات، عناوين البريد الإلكتروني، ولا أرقام الهاتف؛ أو كيستعمل خدمات بحال Google Analytics ولا Facebook Pixel؛ أو كيوفر الحسابات، سلات الشراء، ولا الأداء؛ أو فيه روبوت محادثة بالذكاء الاصطناعي. يقدر حتى يراجع المواقع الثابتة البسيطة ويبلغ ملي ما كيلقاش جمع معني للبيانات.
vn-law-check أداة للمراجعة الأولية، وماشي بديل على المحامي. التقارير والسياسات اللي كتتولد به يقدرو يكونو ناقصين ولا غير صحيحين، وخص الملاحظات الحرجة يراجعها مهني مؤهل فالمجال القانوني.
أهم الخصائص
- تدقيق الكود المصدري والروابط: راجع مشروع محلي ولا فحص الصفحات المتاحة للعموم فموقع.
- ملاحظات على مستوى الملف: التقارير تقدر تحدد الملف، السطر، النص ولا التنفيذ اللي فيه المشكل، الأساس القانوني، والتصحيح المقترح.
- نتائج مرتبة حسب الأولوية: الملاحظات كتتصنف إلى 🔴 خاصها اهتمام فوري، 🟡 تحسينات موصى بها، 🟢 مطابق، ولا ⚪ ما كينطبقش.
- إعداد مسودة الخصوصية: الوكيل يقدر يوجّد مسودة سياسة الخصوصية اعتماداً على تدفقات البيانات وخدمات الأطراف الثالثة اللي لقاها فالكود.
- إرشادات الموافقة: اللوائح المرجعية فيها إرشادات لاستمارات الموافقة ولافتات ملفات تعريف الارتباط.
- تغطية تطبيقات الهاتف: الماسح يقدر يفحص الصلاحيات، حزم التتبع ولا الإشهار، ووظيفة حذف الحساب.
- أدوات متعددة ديال الذكاء الاصطناعي: ملفات المستودع منظمة بطريقة كتخلي الوكلاء المدعومين يحملو نفس إرشادات الامتثال الأساسية باستعمال صيغة التعليمات اللي كيناسباهم.
المجالات القانونية المغطاة
المستودع كيقول إن المراجع ديالو كتشمل الوثائق القانونية الفيتنامية المحيّنة حتى نوفمبر 2026. المجالات المذكورة كتشمل حماية المعطيات الشخصية، التجارة الإلكترونية، الأمن السيبراني، الإشهار، الذكاء الاصطناعي، حماية المستهلك، والمعاملات الإلكترونية. الروابط الكاملة للنصوص وتواريخ دخولها حيز التنفيذ محفوظة فـ sources/legal-references.md.
ملف README كيسلط الضوء بالخصوص على قانون حماية المعطيات الشخصية 91/2025 والمرسوم 356/2025. وكيذكر أنه ابتداءً من 1 يناير 2026، خاص المؤسسات توضّح بجلاء علاش كتجمع المعطيات الشخصية وتحصل على الموافقة بالطريقة المناسبة. المستودع كينبه حتى من السياسات القديمة اللي مازال كتشير للقواعد اللي تبدلات.
التثبيت والإعداد
الخيار 1: التثبيت فـ Claude Code
دخل الأوامر التالية داخل Claude Code، وماشي فالتيرمينال العادي:
/plugin marketplace add mhfed/vn-law-check
/plugin install vn-law-checkمن بعد التثبيت، حلّ المشروع اللي بغيتي تراجعو فـ Claude Code.
الخيار 2: التثبيت لـ Cursor أو Windsurf أو Copilot أو Cline أو Codex
حلّ التيرمينال فمجلد المشروع وشغّل:
curl -fsSL https://raw.githubusercontent.com/mhfed/vn-law-check/main/install.sh | bashالمثبّت كيحط اللائحة المرجعية فـ .vn-law-check/ وما كيبدلش ملفات المشروع ديالك. إلا كان المشروع فيه من قبل ملف تعليمات بحال AGENTS.md ولا CLAUDE.md، السكريبت غير كيزيد مرجع قصير للائحة المثبتة. وإلا عاودتي شغّلتي المثبّت، كيحدّث الربط بلا ما يزيد مراجع مكررة.
الخيار 3: استنساخ المهارة يدوياً
باش تثبّت المهارة عالمياً لـ Claude بلا ما تستعمل السوق، شغّل:
git clone --depth=1 https://github.com/mhfed/vn-law-check ~/.claude/skills/vn-law-checkإلى بغيتي تثبيت خاص بمشروع معين، استنسخها داخل .claude/skills/vn-law-check فداك المشروع، بلاصة المسار ديال المجلد الرئيسي.
دير أول تدقيق قانوني ديالك
تدقيق مشروع محلول
حلّ المشروع فوكيل البرمجة بالذكاء الاصطناعي اللي كيدعم هاد الأداة، ودخل البرومبت الفيتنامي اللي كيوصي به المستودع:
audit pháp lý website này theo luật Việt Namالمعنى ديالو هو «دقّق فهاد الموقع حسب القانون الفيتنامي». الوكيل كيبدا أولاً بتحديد نوع الموقع، ومن بعد كيطبق اللوائح المرجعية المناسبة. على حساب المشروع، يقدر يقلب على الاستمارات، أدوات التتبع، أنظمة الحسابات، خصائص الشراء، الأداء، ربط الذكاء الاصطناعي، تفاصيل الاستضافة، والإفصاحات المرتبطة بها.
تدقيق رابط عمومي
إلا ما كانش عندك الكود المصدري، عطِ عنوان الموقع المتاح للعموم:
audit pháp lý https://ten-mien-cua-ban.vnفحالة تدقيق الرابط، سكريبت fetch-site.sh ديال المستودع كيحمّل الصفحات العمومية من الموقع المحدد باش يقدر scan.sh يفحصها. حسب README، هاد العملية محدودة فـ 15 صفحة و20 ملف JavaScript من نفس النطاق. وما كترسلش بيانات الموقع المجموعة لشي جهة أخرى.
الفحص اللي كيعتمد غير على الرابط ما يقدرش يفحص كود الخادم الخاص ولا الإعدادات اللي ما بايناش للعموم. اعتبر النتائج ديالو مراجعة للموقع المتاح، وماشي تقييماً كاملاً للنظام اللي خدام من وراه.
فهم التقرير
كل نتيجة كتتوصل بواحد من أربعة تصنيفات:
- 🔴 اهتمام فوري: مشكل محتمل يكون خطير وخصّو يتفحّص ويتصلّح بسرعة.
- 🟡 التحسين موصى به: نقطة ضعف ولا تطبيق ناقص خاصّو يتحسّن.
- 🟢 مُرضي: العنصر اللي تراجع باين كيلبّي اللائحة المرجعية المعنية.
- ⚪ ما كينطبقش: هاد المتطلب ما كينطبقش على المشروع ولا الميزة اللي تراجعات.
الملاحظة تقدر تحدد نص فيه مشكل، والمكان ديالو فالمصدر، والأساس القانوني المذكور، وتغيير مقترح. واحد المثال من العرض التجريبي كيشير لسياسة خصوصية كتعتبر الاستعمال المتواصل لموقع إلكتروني موافقة. التقرير كَيستشهد بالمادة 9، الفقرة 4، النقطة d من القانون 91/2025/QH15، واللي بموجبها ما يمكنش اعتبار السكوت ولا عدم الرد موافقة، وكيقترح طلب موافقة صريحة فاش كتجمع المعطيات.
مدونة ولا موقع ثابت ما كيجمعش المعطيات المعنية يقدر ياخذ غير خلاصة قصيرة بلا لائحة طويلة ديال الملاحظات.
طلب من الوكيل يصلّح الملاحظات الحرجة
من بعد ما تراجع التقرير، طلب من الوكيل يعالج البنود الحمرا:
sửa giúp các mục 🔴هاد الشي كيعني «صلّح البنود 🔴». قبل ما تقبل التعديلات، راجع التغييرات المقترحة، وجرّب الاستمارات المتأثرة وسلوك التتبع، وتأكد بلي التطبيق كيطابق المسطرة التجارية الحقيقية. تغيير فالكود ما يقدرش يتحقق من الحقائق التنظيمية اللي ما كايناش فالمستودع.
إنشاء مسودة سياسة خصوصية
إلا كان المشروع ما فيهش سياسة خصوصية، ولا كيستعمل حاليا سياسة عامة منسوخة، طلب مسودة خاصة بالمشروع:
soạn chính sách bảo mật cho dự án nàyالوكيل يقدر يفحص الكود باش يحدد شنو هي المعطيات اللي باين أن التطبيق كيجمعها، وشنو هي الخدمات اللي ممكن توصل ليها، بما فيها التكاملات بحال Google Analytics وFirebase وOpenAI. ومن بعد يقدر يصيغ نص السياسة ويقترح تحديثات لاستمارات الموافقة ولافتات ملفات تعريف الارتباط.
المعلومات اللي ما يمكنش تحديدها من الكود، بحال الاسم القانوني ديال المؤسسة ولا رقم التعريف الضريبي، كتخلى خاوية باش تكملها نتا. تحقق من كل خانة، والغرض من المعطيات، والجهة المستقبلة، وممارسات الاحتفاظ، ومعلومات الاتصال قبل ما تنشر المسودة.
نصائح متقدمة للاستعمال
فضّل افتحاص الكود المصدري إلا أمكن
الافتحاص المحلي للمصدر يقدر يفحص تفاصيل فالتطبيق اللي ما كيبانوش فالرابط العمومي. المستودع كيوضح بلي scan.sh كيقرا غير الملفات المحلية فاش كيفحص مجلد ديال الكود. وهاد الشي كيخلي افتحاص المصدر هو الاختيار الأحسن لاكتشاف حزم SDK المدمجة، وأدوات التتبع المشروطة، وأذونات الهاتف، ومنطق حذف الحساب، والتكاملات اللي ما كيبانوش بوضوح فالصفحات المعروضة.
تحقق من التتبع قبل الموافقة
ردّ البال خصوصا لسكربتات التحليلات والإعلانات اللي كتحمّل قبل ما يختار الزائر واش موافق ولا لا. وتحقق حتى من أن إشعارات الخصوصية كتوصف الخدمات اللي لقاها المشروع بدقة، وما كتعتمدش على التصفح المتواصل، ولا السكوت، ولا عدم النشاط كموافقة.
فرّق بين الحقائق التقنية وحقائق المؤسسة
الوكيل يقدر يستنتج بزاف ديال تفاصيل التطبيق، ولكن ما يقدرش يكتاشف بشكل موثوق كل الممارسات التشغيلية من الكود. أكد مع المسؤولين فالمؤسسة ديالك على حقائق بحال هوية المسؤول على معالجة المعطيات، ومدد الاحتفاظ، وقواعد الولوج الداخلية، والمعالجة عبر الحدود، والعلاقات التعاقدية، ومساطر دعم الزبناء.
استعمل اللوائح المرجعية بلا وكيل للذكاء الاصطناعي
سير العمل الآلي كيتطلب حاليا واحد من أدوات الذكاء الاصطناعي المدعومة. إلا ما كتستعملش وكيل للبرمجة بالذكاء الاصطناعي، تقدر مع ذلك تقرا الملفات فـ مجلد المراجع ديال المستودع وتستعملها كلائحات للمراجعة الذاتية اليدوية.
تعامل مع افتحاصات الأطراف الثالثة بمسؤولية
إلا فحصتي موقع ماشي ديالك، خَلّي النتائج خاصة وصيفطها مباشرة لمالك الموقع. المشروع كينصح صراحة بعدم التشهير العلني بالمؤسسات بناءً على نتائج الفحص.
راجع المراجع غير المتحقق منها بعناية
المشرف كيعرف براسو كمطور ماشي كمحامي، وكيعلّم المراجع اللي ما تراجعاتش مقابل النصوص القانونية الكاملة بعبارة CHƯA XÁC MINH، اللي كتعني «مازال ما متحققاش». ملف README كَيقول بلي مازال كاينين عشرات من هاد البنود، خصوصا فمرجع العقوبات ومواد المرسوم 356/2025. تعامل مع هاد الإدخالات بحذر زائد.
المساهمة بالتصحيحات
الاستشهادات القانونية واللوائح المرجعية تقدر تتبدل، وهاد الشي علاش المراجعة من طرف المجتمع مهمة. تقدر تحلّ مشكل فـ GitHub باش تبلغ على رقم مادة غير صحيح، أو وثيقة قديمة، أو غرامة غير دقيقة، أو قانون ناقص، أو مشكل شائع ما مغطّاهش التحقق، أو تصنيف غير صحيح للموقع. إلا ضمّنت رابط للنص القانوني الأصلي، غادي تعاون المشرف يتحقق من التصحيح.
المطورون اللي كيقدمو طلب دمج خاصهم يعدلو الملفات المصدرية اللي محددها المستودع، ويشغلو tools/sync.sh باش يعاودو ينشئو النسخ الخاصة بكل أداة، ويشغلو tests/run.sh من بعد تغيير scripts/scan.sh. التكامل المستمر كيعطي خطأ إلا ما تزامناتش النسخ المولدة.
التكلفة، الترخيص، والحدود
المستودع مجاني. التكلفة الوحيدة للاستعمال ديالك هي استهلاك الذكاء الاصطناعي اللي كتخلص عليه فالأداة البرمجية اللي كتستعمل أصلا. الكود وبنية المستودع متاحين بموجب ترخيص MIT، أما النصوص القانونية الفيتنامية المشار إليها فهي وثائق حكومية عمومية وما كيشملهاش داك الترخيص البرمجي.
الأهمّ هو بلّي المراجعة ما كتضمنش الامتثال القانوني الكامل. استعمل vn-law-check باش تكتاشف الثغرات المحتملة، وتنظّم خدام الإصلاح، وتوجد مسودة أولى. خلي مهني قانوني مؤهّل يراجع النتائج الحسّاسة ووثائق السياسات قبل ما تعتمد عليها فالإنتاج.
الخلاصة
كيقدّم vn-law-check جسر عملي بين لوائح الامتثال فالقانون الفيتنامي وتطوير البرمجيات بمساعدة الذكاء الاصطناعي. ثبّتو فوكيل مدعوم، وراجع الكود المصدري ديالك ولا الرابط العمومي، وتفحّص التقرير المرتّب حسب الأولوية، وطلب إصلاحات مركّزة ولا مسودة ديال سياسة الخصوصية. هاد المسار يقدر يسرّع المراجعة الأولية، ولكن القرارات القانونية النهائية باقية كتحتاج معطيات مؤكّدة، ونصوص مصدرية محيّنة، وتقدير مهني.
