دليل قراءة متعدد اللغات للمهارة
figma-useالغرض والاستخدام والمصدر
شرط أساسي إلزامي - يجب عليك استخدام هذه المهارة قبل كلuse_figmaاستدعاء فني. لا تتصل أبدًاuse_figmaمباشرةً دون تحميل هذه المهارة أولاً. يؤدي تخطيها إلى حدوث أخطاء شائعة يصعب تصحيحها. يتم تشغيلها عندما يرغب المستخدم في تنفيذ عملية كتابة أو عملية قراءة فريدة تتطلب تنفيذ جافا سكريبت في سياق ملف Figma - على سبيل المثالcreate/edit/deleteالعقد، وإعداد المتغيرات أو الرموز، وبناء المكونات والمتغيرات، وتعديل التخطيط التلقائي أو التعبئة، وربط المتغيرات بالخصائص، أو فحص بنية الملف برمجيًا.
تم استرجاع المصدر:
- مستودع المصدر
- openai/skills
- SKILL.md
skills/.curated/figma-use/SKILL.md- نجوم المستودع
- 28,420
- آخر تحديث للمستودع
- 2026-10-29
- تصنيف القدرات
- تطوير
- وقت التجميع الأخير
الترخيص: غير محدد
مقتطفات سير العمل هي أدوات مساعدة للقراءة، وليست تعليمات تنفيذية من Codez. لم يتم تشغيل أي مهارة تابعة لجهة خارجية لإنتاج هذه الصفحة.
تُعدّ فقرات الغرض وسير العمل الواردة أدناه موادًا أساسية، مُنظّمة ومترجمة لتسهيل القراءة. وهي تختلف عن التحليل التحريري لـ Codez المُصنّف بشكل منفصل.
ما تفعله هذه المهارة
شرط أساسي إلزامي - يجب عليك استخدام هذه المهارة قبل كلuse_figmaاستدعاء فني. لا تتصل أبدًاuse_figmaمباشرةً دون تحميل هذه المهارة أولاً. يؤدي تخطيها إلى حدوث أخطاء شائعة يصعب تصحيحها. يتم تشغيلها عندما يرغب المستخدم في تنفيذ عملية كتابة أو عملية قراءة فريدة تتطلب تنفيذ جافا سكريبت في سياق ملف Figma - على سبيل المثالcreate/edit/deleteالعقد، وإعداد المتغيرات أو الرموز، وبناء المكونات والمتغيرات، وتعديل التخطيط التلقائي أو التعبئة، وربط المتغيرات بالخصائص، أو فحص بنية الملف برمجيًا.
طريقة الاستخدام وفق المستند الأصلي
5سير العمل التدريجي (كيفية تجنب الأخطاء)
السبب الأكثر شيوعًا للأخطاء البرمجية هو محاولة القيام بالكثير في مهمة واحدةuse_figmaاتصل. اعمل على خطوات صغيرة وتحقق من صحة كل خطوة.
استخدام Figma — مهارة واجهة برمجة تطبيقات Figma الإضافية
يستخدمuse_figmaMCP لتنفيذ جافا سكريبت في ملفات Figma عبر واجهة برمجة التطبيقات (API) الخاصة بالملحقات. جميع وثائق المرجع التفصيلية موجودة فيreferences/اجتز الاختبار دائمًاskillNames: "figma-use"عند الاتصالuse_figmaهذا مُعامل تسجيل يُستخدم لتتبع استخدام المهارات - وهو لا يؤثر على التنفيذ.
1القواعد الأساسية
يستخدمreturnلإرسال البيانات مرة أخرى. يتم تحويل القيمة المُعادة تلقائيًا إلى تنسيق JSON (كائنات، مصفوفات، سلاسل نصية، أرقام). لا تقم باستدعاءfigma.closePlugin()أو قم بتغليف الكود في دالة تنفيذية غير متزامنة (IIFE) - يتم التعامل مع هذا الأمر نيابةً عنك. اكتب جافا سكريبت عادية باستخدام المستوى الأعلىawaitوreturnيتم تغليف الكود تلقائيًا في سياق غير متزامن. لا تقم بالتغليف في(async () => { ... })().
// Switch to a specific page (loads its content)
const targetPage = figma.root.children.find((p) => p.name === "My Page");
await figma.setCurrentPageAsync(targetPage);
// targetPage.children is now populated
// Iterate over all pages
for (const page of figma.root.children) {
await figma.setCurrentPageAsync(page);
// page.children is now loaded — read or modify them here
}المتطلبات والإعداد
لم يتم اختيار أي فقرة متطلبات مختصرة من هذا الملف. هذا لا يعني أن المهارة لا تعتمد على أي ملفات أخرى. راجع تعليمات إعداد المستودع والملفات المرجعية.
الحدود وفحوصات الجودة
لم يتم تحديد أي مقطع حدود منفصل من هذا الملف. هذا لا يعني أن المهارة آمنة لكل مدخلات أو بيئة. راجع المصدر بالكامل وتحقق من صحة النتيجة بنفسك.
ابدأ بتجربة آمنة
- تحقق من المضيف المدعوم وتعليمات تثبيت المستودع. احتفظ بمجلد المهارات والبرامج النصية والأصول والوثائق المشار إليها معًا؛SKILL.mdقد يؤدي وجود شخص واحد فقط إلى إغفال بعض التبعيات.
- زوّد البرنامج ببياناتك الفعلية، والمخرجات المطلوبة، ومعايير القبول. يعتمد بناء جملة الاستدعاء والأدوات المتاحة على النظام المضيف؛ ولا يفترض هذا الموقع وجود أمر تثبيت موحد.
- جرّب سير العمل الأصلي في مشروع مؤقت أو على نسخة احتياطية. راجع العمليات التي تُغيّر الملفات أو الخدمات البعيدة أو الموارد القابلة للفوترة قبل السماح بها.
- تحقق من صحة المخرجات بمقارنتها بفحوصات جودة المصدر ومتطلباتك الخاصة. لا يُعدّ نجاح عملية التشغيل أو ارتفاع عدد النجوم في المستودع دليلاً على صحة النتيجة.
اقرأ المزيد في المصدر
- استخدام Figma — مهارة واجهة برمجة تطبيقات Figma الإضافية
- 1القواعد الأساسية
- 2قواعد الصفحة (هامة)
- التنقل بين الصفحات
- عبر عمليات تشغيل البرنامج النصي
- 3.
returnهل قناة الإخراج الخاصة بك - 4وضع المحرر
- 5سير العمل التدريجي (كيفية تجنب الأخطاء)
- النمط
- 6استعادة الأخطاء والتصحيح الذاتي
- متى
use_figmaيُرجع خطأً - عندما ينجح البرنامج النصي ولكن النتيجة تبدو خاطئة
- 7قائمة التحقق قبل الرحلة
- 8اكتشف الأعراف قبل البدء في الإنشاء
- نصوص الفحص السريع
- 9الوثائق المرجعية
- 10أمثلة على مقتطفات برمجية
المهارات ذات الصلة
الترجمة والنطاق
يختار دليل القراءة هذا مقاطع من المصدر الرئيسي المثبتSKILL.mdهذه الترجمة مساعدة. وهي ليست دليلاً كاملاً ولا تضمن التوافق المُختَبَر. يُرجى قراءة النص الأصلي والملفات المُشار إليها قبل الاستخدام.
تشير هذه المقدمة إلى النسخة المثبتة أدناه؛ ويتم عرض نشاط المستودع الحالي ووقت التجميع بشكل منفصل.
- المصدر بإصدار ثابت
- اقرأ الأصل ↗
- تم استرجاع المصدر
- معرّف نسخة Git
49f948faa9258a0c61caceaf225e179651397431- المصدر SHA-256
afa9c4ae068a18b93e4914b2d224180ace113db7713dd66f4df397f16ba9c4b4