تحوّل مجموعة عامة من مهارات Claude Code مباراة شطرنج إلى ملف PGN مشروح ولوحة تحليل بصيغة HTML. ويتيح المؤلف أيضًا مسارًا لإنتاج فيديو سردي. يقيّم Stockfish الوضعيات؛ ثم يطرح Claude Code أسئلة متابعة ويكتب شروحًا للاعب. ويحتوي المستودع على مباراة نموذجية واحدة والبرامج النصية التي تنفذ هذه العملية. وفحص BIG CHANGE الوثائق والشفرة عند الالتزام 46919038، المؤرخ في 26 سبتمبر 2026؛ ولم نشغّل سير العمل أو نقيّم نصائح الشطرنج بأنفسنا.

التغيير الأبرز

  • ما الذي تغيّر: يوثق هذا المشروع العام الصغير سير عمل يصل بين فحوص المحرك للوضعيات وشروح موجهة إلى مباراة لاعب الشطرنج نفسه، وإلى منطقه المسجل عند تقديمه.
  • لماذا يهم ذلك: يستطيع اللاعب فحص ملف PGN ومسح المحرك وخطوط الاستعلام المحفوظة والتعليقات التوضيحية كلًا على حدة. وهذا يسهل مساءلة الشرح المُنشأ عند الوضعية التي يتناولها. لكن هذا المثال لا يقيس ما إذا كانت الأداة تساعد اللاعبين على التحسن.
  • ما الذي ينبغي متابعته: يختار النموذج الأسئلة ويفسر خطوط المحرك ويكتب الدرس. ويتحقق المدقق القائم على الموجه من هذا العمل، لكن وجوده لا يثبت الدقة. وينبغي للقارئ الذي يريد استخدام المخرجات للدراسة مراجعة الوضعيات والخطوط المشار إليها.

من سجل المباراة إلى الأخطاء المحتملة

المدخل هو مباراة بصيغة PGN، إما بتقديمها مباشرة أو باستخدام رابط للمباراة. وتبدأ مهارة chess-analysis بتحديد مستوى القارئ أولًا لتوجيه تعليقاتها إلى ذلك اللاعب. ويمكن إضافة ملاحظات مكتوبة. وإذا توفر تسجيل لتفكير اللاعب بصوت مرتفع، فيستخدم المسار الموثق تفريغ Whisper محليًا عبر whisper.cpp، ثم يطابق الكلام مع النقلات بالاستعانة بتعليقات الساعة في PGN. ويتوقف هذا التطابق على وجود بيانات ساعة صالحة وعلى مطابقة الإشارات المنطوقة بالنقلات؛ ولا يستعيد أفكار اللاعب من ملف PGN وحده.

ويظهر الفحص الآلي الأول في sweep.py. يطلب البرنامج من Stockfish تقييم الوضعية قبل كل نقلة لعبها اللاعب وبعدها، ويسجل النقلات المرشحة والنتائج، ويضع علامة على النقلة إذا بلغ مقدار الخسارة المقاسة الحد الافتراضي للبرنامج، وهو 30 سنتيبيدق. وعمق البحث الافتراضي الموثق 22. وتحدد هذه التقييمات وضعيات تستحق فحصًا أدق؛ أما الأرقام فلا تشرح الخطأ بذاتها.

ثم توجه المهارة محققًا يعمل عبر Claude Code إلى فحص كل وضعية تحمل علامة. ويمكنه query.py أن يستعلم من Stockfish عن النقلات البديلة، بما في ذلك بحث يقتصر على نقلة مقترحة، ويحفظ الخطوط الناتجة في JSON. وتطلب تعليمات منفصلة من المحقق فحص صور الرقعة وشرح سبب نجاح نقلة أو بديلها. ولا ينبغي أن تؤثر ملاحظات اللاعب في الشرح إلا إذا كانت تخص تلك النقلة. وهنا تتحول مخرجات المحرك إلى نثر شطرنجي يكتبه النموذج، فتدخل أحكامه واحتمالات الخطأ في النتيجة.

ما الذي تثبته الفحوص والمخرجات

وتتطلب مهارة chess-analysis مدققًا منفصلًا لمراجعة التعليقات النهائية بالاستعانة بمسح المحرك وملاحظات اللاعب. وتشمل قائمة التحقق الأخطاء المعلّمة، والتفرعات القانونية، وادعاءات التقييم، والعبارات المتعلقة بأفكار اللاعب؛ وينبغي أن تطابق ادعاءات التقييم نتائج المسح أو استعلامات المحرك المحفوظة. ثم يشغّل البرنامج النصي build_annotated.py، الذي يعيد أيضًا تحليل PGN ويبلغ عن أخطاء التحليل. وهذان فحصان مختلفان: يثبت التحليل أن النقلات قابلة للقراءة، بينما يمثل المدقق مراجعة أخرى للشروح يوجهها النموذج. ولا يثبت أي منهما صحة كل تفسير. ويقول المؤلف إن الأخطاء كانت نادرة في استخدامه الشخصي، لكنه لا يقدم دراسة مستقلة للأخطاء.

ويستخدم ملف PGN المشروح المحفوظ برنامجَ build_viewer.py لإنشاء لوحة مستقلة بصيغة HTML تضم التعليقات ورسم التقييم وخطوط المحرك المحفوظة مؤقتًا. ويتيح أيضًا مسارًا اختياريًا لاحقًا بعنوان chess-video، وتبدأ هذه المهارة من ملف PGN المشروح ومسح المحرك. وتطلب من Claude Code كتابة مخطط للمشاهد، ثم تعرض البرامج النصية الرقعة وتولّد السرد وتنشئ MP4 مع ترجمة نصية. ويتضمن المستودع مثالًا واحدًا من مباراة سريعة للمؤلف، مع النص المفرغ والمسح والتعليقات وفيديو مدته 6 دقائق و49 ثانية. وهذا المثال يعرض المخرجات المقصودة، لا نتيجة مقاسة عبر لاعبين أو مباريات.

المتطلبات والوقت والحدود

تقول وثيقة README إنه ينبغي نسخ مجلدات المهارات إلى مجلد المهارات الشخصي أو الخاص بالمشروع في Claude Code، ثم تقديم رابط مباراة أو ملف PGN. وتؤكد وثائق Claude Code الرسمية مواقع مجلدات المهارات هذه. ويتطلب التحليل Python مع python-chess و cairosvg، بالإضافة إلى برنامج Stockfish قابل للتنفيذ. ويستخدم برنامج التنزيل في المستودع ملفًا تنفيذيًا موجودًا إن توفر، وإلا نزّل إصدار Stockfish 17.1 المبني لنظام Linux بمعمارية x86-64. وتعرض صفحة تنزيل Stockfish الرسمية الحالية الإصدار 19، لذا يثبت البديل الموجود في المستودع على إصدار أقدم. ويتطلب الصوت الاختياري whisper.cpp ونموذجًا؛ وتشرح وثائق المشروع تحويل الصوت إلى WAV بدقة 16 بت لاستخدامه مع whisper-cli. وتتطلب مرحلة الفيديو أيضًا Pillow وتحويل النص إلى كلام عبر Piper أو espeak وFFmpeg. وهذه المسارات والاعتماديات موثقة؛ لكن المقال ليس اختبار تثبيت أو ضمانًا للتوافق مع جهاز بعينه.

يقدر المؤلف أن المراجعة الكاملة وإنتاج الفيديو يستغرقان نحو ساعة من المعالجة. ولا يذكر المستودع تكلفة تلك العملية. وتعرض جدول خطط Anthropic الحالي Claude Code ضمن خطة Pro لا Free؛ وسعر Pro هو 20 دولارًا شهريًا عند الدفع شهريًا، مع حدود للاستخدام. ويعتمد إجمالي التكلفة على بيئة القارئ، بما في ذلك وقت الحوسبة المحلية وأي اشتراك أو استخدام لواجهة برمجة التطبيقات وتجهيز التفريغ والفيديو الاختياري. وينبغي فهم مدة المثال ورأي المؤلف في دقته على أنهما رواية مستخدم واحد.