دليل قراءة متعدد اللغات للمهارة
wiki-page-writerالغرض والاستخدام والمصدر
يُنشئ صفحات توثيق تقني غنية برسومات توضيحية بتقنية Mermaid في الوضع الداكن، ومراجع لشفرة المصدر، وشرح معمق للمبادئ الأساسية. استخدمه عند كتابة التوثيق، أو إنشاء صفحات ويكي، أو إنشاء شروحات تقنية معمقة، أو توثيق مكونات أو أنظمة محددة.
تم استرجاع المصدر:
- مستودع المصدر
- microsoft/skills
- SKILL.md
.github/plugins/deep-wiki/skills/wiki-page-writer/SKILL.md- نجوم المستودع
- 3,157
- آخر تحديث للمستودع
- 2026-10-31
- تصنيف القدرات
- المستندات
- وقت التجميع الأخير
الترخيص: MIT
مقتطفات سير العمل هي أدوات مساعدة للقراءة، وليست تعليمات تنفيذية من Codez. لم يتم تشغيل أي مهارة تابعة لجهة خارجية لإنتاج هذه الصفحة.
تُعدّ فقرات الغرض وسير العمل الواردة أدناه موادًا أساسية، مُنظّمة ومترجمة لتسهيل القراءة. وهي تختلف عن التحليل التحريري لـ Codez المُصنّف بشكل منفصل.
ما تفعله هذه المهارة
يُنشئ صفحات توثيق تقني غنية برسومات توضيحية بتقنية Mermaid في الوضع الداكن، ومراجع لشفرة المصدر، وشرح معمق للمبادئ الأساسية. استخدمه عند كتابة التوثيق، أو إنشاء صفحات ويكي، أو إنشاء شروحات تقنية معمقة، أو توثيق مكونات أو أنظمة محددة.
طريقة الاستخدام وفق المستند الأصلي
إجراء
التخطيط: تحديد النطاق والجمهور وميزانية التوثيق بناءً على عدد الملفات. التحليل: قراءة جميع الملفات ذات الصلة؛ تحديد الأنماط والخوارزميات والتبعيات وتدفق البيانات. الكتابة: إنشاء ملف Markdown منظم مع الرسوم البيانية والاقتباسات. التحقق: التأكد من وجود مسارات الملفات، ودقة أسماء الفئات، وأن برنامج Mermaid يعرض بشكل صحيح.
مقتطف من المصدر · L39 ↗متى يتم التفعيل
يطلب المستخدم توثيق مكون أو نظام أو ميزة معينة. ويرغب المستخدم في شرح تقني معمق مع رسومات توضيحية. ويحتاج قسم من فهرس ويكي إلى إنشاء محتواه.
مقتطف من المصدر · L14 ↗كاتب صفحة ويكي
أنت مهندس توثيق أول تقوم بإنشاء صفحات توثيق فنية شاملة ذات عمق قائم على الأدلة.
مقتطف من المصدر · L10 ↗---
title: "Page Title"
description: "One-line description"
---المتطلبات والإعداد
متطلبات العمق (غير قابلة للتفاوض)
تتبّع مسارات التعليمات البرمجية الفعلية — لا تعتمد على أسماء الملفات للتخمين. اقرأ تفاصيل التنفيذ. كل ادعاء يحتاج إلى مصدر — مسار الملف +function/classاسم.
مقتطف من المصدر · L31 ↗توافق VitePress
الهروب من الأنواع العامة المجردة خارج حدود الكود: قائمة not bare قائمة No في كتل حورية البحر
الحدود وفحوصات الجودة
لم يتم تحديد أي مقطع حدود منفصل من هذا الملف. هذا لا يعني أن المهارة آمنة لكل مدخلات أو بيئة. راجع المصدر بالكامل وتحقق من صحة النتيجة بنفسك.
ابدأ بتجربة آمنة
- تحقق من المضيف المدعوم وتعليمات تثبيت المستودع. احتفظ بمجلد المهارات والبرامج النصية والأصول والوثائق المشار إليها معًا؛SKILL.mdقد يؤدي وجود شخص واحد فقط إلى إغفال بعض التبعيات.
- زوّد البرنامج ببياناتك الفعلية، والمخرجات المطلوبة، ومعايير القبول. يعتمد بناء جملة الاستدعاء والأدوات المتاحة على النظام المضيف؛ ولا يفترض هذا الموقع وجود أمر تثبيت موحد.
- جرّب سير العمل الأصلي في مشروع مؤقت أو على نسخة احتياطية. راجع العمليات التي تُغيّر الملفات أو الخدمات البعيدة أو الموارد القابلة للفوترة قبل السماح بها.
- تحقق من صحة المخرجات بمقارنتها بفحوصات جودة المصدر ومتطلباتك الخاصة. لا يُعدّ نجاح عملية التشغيل أو ارتفاع عدد النجوم في المستودع دليلاً على صحة النتيجة.
اقرأ المزيد في المصدر
المهارات ذات الصلة
الترجمة والنطاق
يختار دليل القراءة هذا مقاطع من المصدر الرئيسي المثبتSKILL.mdهذه الترجمة مساعدة. وهي ليست دليلاً كاملاً ولا تضمن التوافق المُختَبَر. يُرجى قراءة النص الأصلي والملفات المُشار إليها قبل الاستخدام.
تشير هذه المقدمة إلى النسخة المثبتة أدناه؛ ويتم عرض نشاط المستودع الحالي ووقت التجميع بشكل منفصل.
- المصدر بإصدار ثابت
- اقرأ الأصل ↗
- تم استرجاع المصدر
- معرّف نسخة Git
00d66a64919edca5bca2c673373444e36a4b5461- المصدر SHA-256
f1270ea4123116e846bf2dc7a53a9e396ed43d694cdb7be22b9a35da9a40feb6