دليل
كيفية استخدام rezero.md
يحوّل rezero.md أي موقع ويب عام إلى مستندات Markdown قائمة على الأدلة يمكن لوكيل البرمجة بالذكاء الاصطناعي قراءتها. يعمل بالكامل في الطرفية — بدون إضافة متصفح، وبدون حساب، وبدون أي تثبيت.
قبل أن تبدأ
- Node.js 22 أو أحدث (تحقق باستخدام node -v).
- طرفية مفتوحة داخل مجلد مشروعك.
- لا حاجة إلى حساب أو مفتاح API للبدء.
بداية سريعة
شغّل أمرًا واحدًا. يقوم npx بتنزيل الحزمة عند أول استخدام، لذا لا شيء لتثبيته مسبقًا.
١. حلّل موقعًا
وجّهه إلى أي رابط عام. يزحف إلى الصفحات العامة ويكتب ثمانية مستندات Markdown داخل .rezero/<domain>/ في المجلد الحالي.
$ npx rezero-md analyze https://linear.app٢. أو جهّز وكيلك باستخدام init
ينفّذ init التحليل نفسه، ثم يكتب أيضًا ملفات سياق للوكيل (CLAUDE.md وAGENTS.md وقواعد .cursor وغيرها) في جذر مشروعك حتى تلتقطها أداة الذكاء الاصطناعي تلقائيًا.
$ npx rezero-md init https://linear.appما الذي تحصل عليه
ثمانية مستندات قائمة على الأدلة في .rezero/<domain>/، يفصل كل منها بين الملاحظة والاستنتاج والتوصية:
يضيف init ملفات سياق جاهزة للوكيل في جذر المشروع لتقرأها أدوات البرمجة دون أي إعداد:
كيف يعمل
يُبنى كل مستند على المبدأ الصادق نفسه — الدليل قبل الرأي. الغرض هو تعلّم كيفية بناء المنتج، وليس استنساخه أبدًا.
الملاحظة (Observe)
البيانات الوصفية العامة والبنية والروابط ورموز الواجهة والبصمات التقنية — فقط ما تقدّمه الصفحة فعليًا.
الاستنتاج (Infer)
فرضيات حذرة بمستوى ثقة ظاهر، موسومة بوضوح كتخمينات لا كحقائق.
التوصية (Recommend)
إرشادات قابلة للنقل لتكييف النمط مع منتجك الخاص، لا لنسخ الأصل.
استخدمه في أداة الذكاء الاصطناعي لديك
المخرجات هي Markdown عادي داخل مستودعك، فيمكن لأي وكيل قراءتها. بالنسبة للأدوات الشائعة:
Claude Code
تلقائي. يقرأ Claude Code ملفي CLAUDE.md وAGENTS.md في جذر المستودع. شغّل claude داخل المجلد واطلب منه استخدام مرجع rezero.md.
Cursor
تلقائي. يوجّه ملف .cursor/rules/rezero.mdc المُنشأ اقتراحات Cursor. يمكنك أيضًا الإشارة بـ @ إلى ملفات داخل .rezero/ في المحادثة.
Codex CLI
يقرأ AGENTS.md تلقائيًا. شغّل codex في المجلد، أو وجّهه إلى المستندات في .rezero/<domain>/.
Gemini CLI
أشِر إلى ملفات Markdown المُنشأة في طلبك — مثل: «استخدم الملفات في .rezero/<domain>/ كسياق تصميم».
أي وكيل آخر
Windsurf وCline وContinue وغيرها: كل شيء Markdown عادي داخل .rezero/، لذا أضف تلك الملفات إلى سياق الأداة.
التوليد الكامل بالذكاء الاصطناعي (اختياري)
بدون مفتاح، يكتب rezero.md مستندات أولية حتمية لترى الشكل فورًا. اضبط GEMINI_API_KEY (أو OPENAI_API_KEY) للحصول على تحليل كامل مكتوب بالذكاء الاصطناعي. يبقى مفتاحك وملفاتك على جهازك.
$ export GEMINI_API_KEY=your_key_here$ npx rezero-md init https://linear.appاستكشاف الأخطاء وإصلاحها
الأمر لا يفعل شيئًا أو يظهر «not found».
تأكد من Node.js 22+ باستخدام node -v، ثم شغّل npx rezero-md analyze <url>. يقوم npx بتنزيل الحزمة عند أول تشغيل، ولا حاجة لتثبيت عام.
تبدو المستندات ضعيفة أو عامة.
هذه هي المخرجات الأولية بدون مفتاح. اضبط GEMINI_API_KEY (أو OPENAI_API_KEY) للتحليل الكامل، أو تصفّح المكتبة حيث تكون المدخلات مُولّدة بالكامل بالفعل.
تظهر «No public HTML pages could be fetched.».
يجب أن يكون الهدف صفحة عامة تسمح بالزحف. استخدم الرابط العام للموقع وتأكد أنه ليس خلف تسجيل دخول ولا يحجب برامج الزحف.
أين توجد الملفات؟
داخل .rezero/<domain>/ في المجلد الذي شغّلت فيه الأمر، بالإضافة إلى CLAUDE.md وAGENTS.md وملفات السياق الأخرى عند استخدام init.
جاهز للتجربة؟
تصفّح منتجات تم تحليلها بالفعل، أو أنشئ منتجك الخاص بأمر واحد.