بنِي مسارات خدمة برمجية موجّهة باستعمال منسّق Fable

شنو كيدير Fable

Fable هي مهارة صغيرة للتوجيه، كتخدم محلياً أولاً، ومخصّصة لـ Codex. كتفصل بين التخطيط والتنفيذ: Claude Fable 5.1 كتخطط للخدمة وكتحسم فالقرارات، بينما Codex كيبقى هو بيئة التشغيل، كيتحكم فمساحة العمل، وكيفوّض مهام تنفيذ محددة لوكلاء OpenCode Go.

التنفيذ العادي كيتسند لـ GPT-5.6 Luna. والخدمة اللي فيها حلقات، تكرار متواصل، أو تنفيذ بكثافة عالية كتتسند لـ DeepSeek V4 Flash. Claude Fable 5.1 كتبقى خارج مخطط التنفيذ، وما كتكتبش الكود وما كتملكش مساحة العمل.

Fable هي مهارة للتنسيق، وماشي بوابة مستقلة للنماذج ولا لوحة تحكم للتطوير.

الميزات الرئيسية

• خدمة محلية أولاً: المهارة كتتثبت فمجلد محلي ديال مهارات Codex.
• فصل واضح بين الأدوار: Fable كتخطط وكتحسم فالقرارات، وCodex كينفذ وكيحقق من الخدمة.
• تفويض محدد: عقد التنفيذ كتستعمل غير مسارات GPT-5.6 Luna أو DeepSeek V4 Flash المسموح بها.
• تنفيذ متوازي: Codex يقدر يبدا العمال الجاهزين بالتوازي ملي كيكون هاد الشي مفيد.
• تحقق مبني على الأدلة: Codex كيجمع أدلة العمال وكيحقق من النتائج قبل ما يكمل سير العمل.
• توجيه آمن عند الفشل: إلا ما كان حتى مسار مسموح من OpenCode Go قابل للاستعمال، سير العمل كيبلّغ بالعائق بلا ما يعوّض النموذج بنموذج غير معتمد.
• تثبيت آمن وقابل للتكرار: أداة التثبيت كتدعم المعاينة بلا تنفيذ، والأهداف المخصصة، والنسخ القابل لإعادة التشغيل بلا آثار إضافية.

فهم المستودع

المستودع فيه المهارة القابلة للتثبيت، وأداة التثبيت ديالها، والاختبارات، وملف معماري:

skill/fable/\n├── SKILL.md\n├── agents/openai.yaml\n└── scripts/ask_fable.sh\nassets/fable-orchestrator.svg\ninstall.sh\ntests/test_skill.sh

الملفات الثلاثة اللي داخل skill/fable/ كيشكلو المهارة القابلة للتثبيت. السكريبت ask_fable.sh قابل للتنفيذ وكيعيط على الاسم المستعار المحلي fable ديال Claude Code بلا ما يحتافظ بالجلسة.

المتطلبات المسبقة

قبل ما تثبت المهارة، كوّن الوكلاء القابلين للاستعمال opencode-go/ وopencode-go-responses/ عبر Codex Router. Fable كتستعمل هاد الوكلاء، ولكن ما كتوفّرش البروكسي ديالها، ولا لوحة تحكم، ولا كتالوج النماذج، ولا مخزن بيانات الدخول، ولا مفتاح API ديالها.

عاود شغّل Codex من بعد ما تبدّل تعريفات المزوّد أو الوكلاء. هاد الشي كيضمن أن المهمة الجديدة تشوف إعدادات التوجيه الحالية.

تثبيت Fable

1. معاينة التثبيت

من جذر المستودع، شغّل أداة التثبيت فالوضع التجريبي:

./install.sh --dry-run

هاد الأمر كيبيّن الوجهة الدقيقة وعمليات النسخ بلا ما ينشئ ملفات. استعملو باش تتأكد شنو غادي تدير أداة التثبيت قبل ما تبدّل شي حاجة.

2. التثبيت فالمجلد الافتراضي

نسخ المهارة للمكان الافتراضي ديال مهارات Codex:

./install.sh --copy

الوجهة الافتراضية هي ~/.codex/skills/fable. أداة التثبيت كتنشئ غير المجلدات الضرورية، وآمنة تعاود تشغّلها كثر من مرة.

3. اختيار مجلد مخصص للمهارات

استعمل --target إلا بغيتي تثبت فشي مكان آخر غير المكان الافتراضي:

./install.sh --copy --target "$PWD/.local/codex/skills"

أداة التثبيت كتقرا غير المستودع ومسار الوجهة. ما كتقراش بيانات الدخول، وما كتنشئهاش وما كتبدلهاش.

الاستعمال الأساسي

بدا مهمة جديدة فـ Codex، ومن بعد عيّط على المهارة بهدف:

$fable build the feature

Fable كترجع بمخطط خدمة محدد. Codex كيتحقق من هاد المخطط، وكيطلق العمال الجاهزين بالتوازي ملي كيكون مناسب، وكيجمع الأدلة ديالهم، وكيحقق من الخدمة الناتجة. إلا كانت حاجة لقرار تخطيطي آخر، Codex كيسول Fable باش تحسم فيه.

كيفاش كيخدم التوجيه

1. Fable كتحلل الهدف وكتنتج خطة محددة.
2. Codex كيتحقق من المخطط المقترح قبل التنفيذ.
3. عقد التنفيذ العادية كتتوجّه لـ GPT-5.6 Luna.
4. عقد التنفيذ اللي فيها تكرار بزاف أو إنتاجية عالية كتتوجّه لـ DeepSeek V4 Flash.
5. Codex كيجمع الأدلة وكيحقق من النتيجة النهائية.
6. كيتم الرجوع لـ Fable من جديد ملي كيكون حسم إضافي ضروري.

كل عقدة تنفيذ خاصها تستعمل واحد من جوج مسارات OpenCode Go المسموح بها. إلا ما كان حتى واحد متوفر، اعتبر العائق المبلّغ عليه مشكل فالإعدادات، وما تحاولش تتجاوز سياسة التوجيه.

التعامل الآمن مع حزم التخطيط

الحزمة اللي كتدوز لـ ask_fable.sh خاصها تحتوي غير على القرارات وحقائق مساحة العمل. عمّرْك تدخل بيانات الدخول، مفاتيح API، الرموز، ولا أي أسرار أخرى فالحزمة.

حيت السكريبت كيتاصل بالاسم المستعار المحلي fable بلا ما يحتافظ بالجلسة، كل طلب خاصو يتضمن الحقائق المهمة اللي محتاجاها مرحلة التخطيط أو الحسم ديك.

اختبار التثبيت

شغّل مجموعة الاختبارات ديال المستودع، اللي ما كتحتاجش بزاف ديال التبعيات، من جذر المستودع:

tests/test_skill.sh

الاختبار كيغطي:

• صحة صياغة Shell.
• الملفات المصدرية اللي كتنسخها أداة التثبيت.
• نصوص التوجيه الضرورية.
• البنية الأساسية ديال YAML.
• التحقق الاختياري من XML عبر xmllint.
• قيود السلامة ديال SVG.
• تشغيل تجريبي باستعمال مجلد مؤقت للمجلد المنزلي.
• عملية نسخ قابلة لإعادة التشغيل بلا آثار إضافية.
• التحقق من النصوص الشائعة اللي كتكون على شكل بيانات اعتماد.

الاختبار ما كيحتاجش PyYAML ولا تسجيل دخول حي مع Claude، وهاد الشي كيخليه مناسب للتحقق المحلي الخفيف.

نصائح متقدمة للتشغيل

تحقق من التوجيه قبل ما تبدا تشخّص المهارة

إلا بلّغ Fable بلي ما كاين حتى مسار تنفيذ مسموح به قابل للاستعمال، شوف اللول تعريفات Codex Router ديال opencode-go/ وopencode-go-responses/. من بعد ما تبدّل تعريفات المزوّد ولا الوكيل، عاود شغّل Codex وبدا مهمة جديدة.

استعمل التشغيل التجريبي فالنشرات المخصّصة

ملي كتثبّت فمجلد محلي ديال المشروع ولا فمجلد غير قياسي ديال المهارات، جمع --dry-run مع --target قبل النسخ:

./install.sh --dry-run --target "$PWD/.local/codex/skills"
./install.sh --copy --target "$PWD/.local/codex/skills"

هاد الشي كيخلّيك تفقد الوجهة وعمليات الملفات اللي مخطّط لها قبل ما تبدّل المجلد اللي اخترتي.

عاود التثبيت ملي كتحدّث

حيت عملية النسخ ما كتبدّلش النتيجة إلا إلا كان شي تغيير، تقدر تعاود تشغّلها بأمان ملي كتحدّث المهارة المثبّتة من المستودع. من بعد النسخ، شغّل tests/test_skill.sh باش تتأكّد من اختبارات المستودع.

خلّي المسؤوليات مفروقة

ما تعتبرش Fable خدام ديال التنفيذ. المسؤوليات الموثّقة ديالو هي التخطيط والتحكيم النهائي. Codex كيبقى متحكّم فالتشغيل، ومالك مساحة العمل، والتفويض، وجمع الأدلة، والتحقّق.

الخلاصة

Fable كيوفّر طريقة مركّزة باش تزيد التخطيط المحدود وتوجيه النماذج لـ Codex. كوّن وكلاء OpenCode Go، عاين المهارة ونسخها، عيّط ليها بهدف واضح، واستعمل الاختبارات المرفقة باش تتحقّق من الإعداد. خلّي بيانات الولوج برا حزم التخطيط، وعاود شغّل Codex كلما تبدّلات تعريفات التوجيه.