Install
npx skills add apollographql/skillsلمن يناسب
إن كنت تستخدم أصلًا أدوات Apollo GraphQL وتريد أن يكتب وكيل ترميز الاستعلامات والmutations والذاكرة المؤقتة وفق المهارات الرسمية، بدل خلط واجهات قديمة من الذاكرة، فهذه المجموعة أنسب. تتوجه إلى وكلاء ترميز ذكاء اصطناعي يستخدمون تقنيات Apollo وتتبع تنسيق Agent Skills. توضيح التنسيق:
https://agentskills.io/
يمكن إيجاد المهارات أيضًا في
https://skills.sh/
تفترض أنك تقبل تثبيتًا تفاعليًا واحدًا: اختر المهارات أولاً ثم Agent الهدف. من يريد قراءة الوثائق فقط ولا ينوي كتابة المهارات في Agent محلي فائدته محدودة. سيظهر المعالج عدة أسماء Agent؛ تلك خيارات وقت التثبيت وليست «هذه المنتجات وحدها تستطيع استخدام Apollo».
أنهِ أول محاولة في 3 دقائق
التثبيت الرسمي مكتوب في الصفحة هكذا:
npx skills add apollographql/skills
واجهة الأوامر تمشيك في تثبيت تفاعلي: اختر أولاً المهارات ثم Agent الهدف. هذا يغيّر إعداد مهارات الـ Agent المحلي؛ ليس نظرة للقراءة فقط. قبل التنفيذ أكّد أن الجهاز فيه npx وأنك تعرف بيئة الـ Agent التي سيُكتب إليها. انظر الخيارات ثم أكّد؛ لا تواصل الضغط على Enter في بيئة غير معروفة.
بعد التثبيت افحص للقراءة فقط. الصفحة تقول إنه بعد التثبيت يمكنك استخدام أوامر بشرطة مائلة ذات مساحة أسماء، و/apollo-skills:apollo-client يقابل Apollo Client 4.x for React من queries وmutations وcaching وlocal state. أرسل هذا الأمر إلى الوكيل، أو اطلب بوضوح فحص استعلام قائم وفق تلك المهارة؛ لا تغيّر شيفرة العمل بعد. إشارة النجاح: الإجابة تتحدث عن الاستعلامات أو الذاكرة المؤقتة بـ Apollo Client 4.x / React، لا تقول إن المهارة غير مثبتة. إن بدأ إعادة كتابة طبقة البيانات كلها فتوقف أولاً.
حالات استخدام
الحالة 1: افحص أو اكتب مسودة استعلامات وmutations في React. توضيح /apollo-skills:apollo-client يشمل queries وmutations. سلّم عملية GraphQL قائمة إلى الوكيل واسأل فقط «كيف تُرسل في React مع Apollo Client 4.x». المقتطف لا يعطي أسماء hook ملموسة ولا يكتب مقارنة مع عملاء GraphQL آخرين. لذا تؤكد: هذه المهارة تغطي استعلامات وmutations لـ Client 4.x؛ واجهات البرمجة الملموسة تتبع متن المهارة أو شيفرة 4.x في مشروعك. لا تدعه يرقّي على الجانب الإصدار الرئيسي كله للعميل.
الحالة 2: راجع الذاكرة المؤقتة والحالة المحلية. المهارة نفسها تكتب أيضًا caching وlocal state. يجب أن تكون المهمة تشخيصًا للقراءة فقط، مثل «هل مفتاح الذاكرة / الحالة المحلية معقول وفق تلك المهارة». لا تكتب جردًا كاملاً لاستراتيجيات طرد الذاكرة ولا أي مخزن يجب أن تستخدمه الحالة المحلية. القبول يرى فقط: النقاش يبقى على ذاكرة أو حالة محلية لـ Client 4.x؛ إن اقترح الوكيل تغيير schema أو إضافة وسيط رابط جديد فهذا خارج هذا المقتطف أصلًا.
حدود الاستخدام
هذه مجموعة مهارات لأدوات وتقنية Apollo GraphQL، لا درس GraphQL عام. تطبيق أوامر الشرطة المائلة هذه خارج منظومة Apollo خارج ما تكتبه الصفحة. أوامر الشرطة تحمل البادئة apollo-skills:؛ المقتطف يصف بالكامل فقط /apollo-skills:apollo-client. حتى إن وُجدت أوامر أخرى فهذا المادة لا تشرحها؛ لا تخترع قدرات.
مسار التثبيت هو معالج npx skills add التفاعلي أعلاه. لا تضع مثبّتًا آخر بجانبه. المعالج يجعلك تختار المهارات وAgent؛ البيئة الخاطئة تعني كتابة المهارات في زمن تشغيل خطأ. الصفحة لا تكتب خطوات إزالة.
في المرة الأولى توقف عند الفحص للقراءة فقط. أي تغيير للاستعلامات أو استراتيجية الذاكرة أو ترقية Apollo Client يجب أن يجعل الوكيل يعيد أولاً الملفات التي سيغيّرها؛ تؤكد أنت ثم تتابع.