الانتقال إلى المحتوى الرئيسي

مفتوح المصدر · رخصة MIT

أعطِ وكيل البرمجة الذكي ضوابطَ كنت تتمنى وجودها أصلاً.

أجب عن أسئلة قصيرة حول ما تبنيه، واحصل على حزمة مهارات جاهزة للاستخدام مع Claude Code أو Cursor أو Codex أو أي وكيل يقرأ AGENTS.md — تغطي الامتثال السعودي، ونظافة الأمن، وانضباط الهيكلة.

يستغرق حوالي ٣ دقائق. بدون حساب. لا شيء يغادر متصفحك.

.claude/skills/zatca-phase2/SKILL.md
مُراجَع
---
name: zatca-phase2
description: ZATCA Phase 2 e-invoicing rules for Saudi Arabia
version: 0.4.2
status: reviewed
last_verified: 2026-03-18
---

# ZATCA Phase 2

> This is engineering guidance, not legal advice. Verify every
> rule against the official ZATCA documentation linked in /sources.

## When this applies

You are working on a product that issues invoices to Saudi customers
and is using **Node.js** as the backend stack.

## Non-negotiables

- Every B2B invoice must be cleared with ZATCA **before** being
  delivered to the buyer.
- Every B2C invoice must be reported within **24 hours** of issuance.
- Every invoice XML must include a cryptographic stamp derived from
  the taxpayer's CSID certificate.

## Your stack specifics

```ts
// Use the UBL builder — don't hand-roll the XML.
import { buildInvoiceXML, stamp } from "@zatca/ubl";
```

See references/invoice-b2c.xml for a full sample.

§ ٠١

ما هي «المهارة»، ولماذا تحتاجها؟

حين يفتح وكيل البرمجة الذكي مستودعك، يبحث عن تعليمات. المهارة وثيقة قصيرة ومركّزة — وربما سكربتات مساعدة — تُخبر الوكيل بقواعد مجال واحد محدّد: كيف يتعامل مع الفواتير في السعودية، كيف يبعد الأسرار عن الكوميتات، أين يرسم الحد بين كود المشرف وكود المستخدم. المهارات الجيدة تحوّل الوكيل من «متدرب ذكي» إلى «زميل قرأ دليل الشركة».

مكتوبة لمنصّتك

إجاباتك عن المنصة والمدفوعات والبيانات الشخصية تعيد كتابة المهارة بحيث يحصل مشروع Node أو Django أو Laravel على توجيه يناسب كوده فعلاً.

ملمّة بالامتثال افتراضيًا

مهارات السعودية (ZATCA المرحلة الثانية، نظام حماية البيانات، نفاذ) تشحن مع إخلاءات مسؤولية، وروابط مصدر، وتاريخ تحقق — لا قديمة ولا صامتة.

ملف واحد، كل الوكلاء

اختر Claude Code أو Cursor أو Codex أو AGENTS.md عاديًا. نفس المحتوى القانوني، مُقدَّم بصيغة كل وكيل.

§ ٠٢

المكتبة

كل مهارة مُرقَّمة ومؤرَّخة ومُراجَعة. العناصر التي ما زالت تحت المراجعة مُعلَّمة بوضوح — استخدمها كنقطة انطلاق، لا كحُجَّة نهائية.

تصفح المكتبة
الهيكلةمُراجَع

نظافة CI

إذا لم يكن للمستودع CI يُضيفه الوكيل. وإذا وُجد يُبقيه نظيفًا — Lint وفحص الأنواع والاختبارات ونظافة الترحيلات كقواعد يستطيع الوكيل فرضها فعليًا.

إصدار
0.6.0
تم التحقق
2026-04-24
الهيكلةمجتمعي

فحص قابلية الاختبار

أبقِ الكود المُنشأ قابلاً لكتابة اختبارات له. فواصل نظيفة وآثار جانبية معزولة ولا singletons مخفية — حتى تبقى مجموعة الاختبارات أصلاً من الدرجة الأولى مع نمو الكود.

إصدار
0.5.0
تم التحقق
2026-04-24
الامتثال السعوديمجتمعيإخلاء مسؤولية

أساسيات مدفوعات مدى وSTC Pay

ملاحظات تكامل عملية لقنوات الدفع المحلية في السعودية — التعامل مع BIN وخصائص 3DS وتوقعات التسوية والفخاخ التي تفوتها الأدلة العامة.

إصدار
0.3.0
تم التحقق
2026-04-24
الامتثال السعوديمسودّةإخلاء مسؤولية

نفاذ ويقين — التحقق من الهوية

يمنع الوكيل من اختراع نقاط نهاية وهمية لنفاذ أو يقين. يشرح مسار الموافقة ونمط التكامل والسلوكيات التي لا يمكن نشرها دون اعتماد.

إصدار
0.2.0
تم التحقق
2026-04-24
الامتثال السعوديمجتمعيإخلاء مسؤولية

أساسيات نظام حماية البيانات الشخصية للمهندسين

ضوابط هندسية لنظام حماية البيانات الشخصية في السعودية — الموافقة والاحتفاظ والتقليل والتصدير كقواعد يستطيع الوكيل فرضها فعليًا في الكود.

إصدار
0.3.0
تم التحقق
2026-04-24
الامتثال السعوديمسودّةإخلاء مسؤولية

الفوترة الإلكترونية زاتكا المرحلة الثانية

ضوابط هندسية لفوترة زاتكا المرحلة الثانية — بنية XML ومسار التوقيع وخطوات التسجيل التي يجب على وكيل البرمجة مراعاتها قبل كتابة الكود.

إصدار
0.2.0
تم التحقق
2026-04-24