فَیبل آرکیسٹریٹر کے ساتھ روٹ کیے گئے کوڈنگ ورک فلو بنائیں

Fable کیا کرتا ہے

Fable، Codex کے لیے ایک مختصر، مقامی ترجیحی روٹنگ اسکل ہے۔ یہ منصوبہ بندی کو عمل درآمد سے الگ کرتا ہے: Claude Fable 5.1 کام کی منصوبہ بندی اور فیصلوں کا اختیار سنبھالتا ہے، جبکہ Codex رن ٹائم رہتا ہے، ورک اسپیس کو کنٹرول کرتا ہے، اور محدود دائرہ کار والے عمل درآمد کے کام OpenCode Go ایجنٹس کو سونپتا ہے۔

معمول کا عمل درآمد GPT-5.6 Luna کو سونپا جاتا ہے۔ لوپس، بار بار کی تکرار، یا زیادہ تھروپٹ والے عمل درآمد سے متعلق کام DeepSeek V4 Flash کو سونپے جاتے ہیں۔ Claude Fable 5.1 عمل درآمد کے گراف سے باہر رہتا ہے اور نہ کوڈ لکھتا ہے، نہ ورک اسپیس کی ملکیت رکھتا ہے۔

Fable ایک آرکیسٹریشن اسکل ہے، خودمختار ماڈل گیٹ وے یا ڈویلپمنٹ ڈیش بورڈ نہیں۔

اہم خصوصیات

• مقامی ترجیحی آپریشن: اسکل مقامی Codex skills ڈائریکٹری میں انسٹال ہوتا ہے۔
• واضح کرداروں کی تقسیم: Fable منصوبہ بندی اور فیصلوں کا اختیار سنبھالتا ہے، جبکہ Codex کام کو انجام دے کر اس کی تصدیق کرتا ہے۔
• محدود دائرہ کار کی تفویض: عمل درآمد کے نوڈز صرف مجاز GPT-5.6 Luna یا DeepSeek V4 Flash روٹس استعمال کرتے ہیں۔
• متوازی عمل درآمد: ضرورت کے مطابق Codex تیار ورکرز کو بیک وقت شروع کر سکتا ہے۔
• شواہد پر مبنی تصدیق: Codex ورکرز کے شواہد جمع کرتا ہے اور ورک فلو مکمل کرنے سے پہلے نتائج کی تصدیق کرتا ہے۔
• ناکامی سے محفوظ روٹنگ: اگر دونوں مجاز OpenCode Go روٹس میں سے کوئی بھی قابلِ استعمال نہ ہو، تو ورک فلو غیر منظور شدہ ماڈل کا متبادل استعمال کرنے کے بجائے رکاوٹ کی اطلاع دیتا ہے۔
• محفوظ، دہرائے جانے کے قابل انسٹالیشن: انسٹالر ڈرائی رن، حسبِ ضرورت اہداف، اور idempotent کاپی کی سہولت فراہم کرتا ہے۔

ریپوزٹری کو سمجھیں

ریپوزٹری میں انسٹال کیے جانے کے قابل اسکل، اس کا انسٹالر، ٹیسٹس، اور ایک آرکیٹیکچر اثاثہ شامل ہے:

skill/fable/
├── SKILL.md
├── agents/openai.yaml
└── scripts/ask_fable.sh
assets/fable-orchestrator.svg
install.sh
tests/test_skill.sh

skill/fable/ کے اندر موجود تین فائلیں انسٹال کیے جانے کے قابل اسکل بناتی ہیں۔ ask_fable.sh اسکرپٹ قابلِ اجرا ہے اور سیشن برقرار رکھے بغیر Claude Code کے مقامی fable عرف کو کال کرتا ہے۔

ضروریات

اسکل انسٹال کرنے سے پہلے Codex Router کے ذریعے قابلِ استعمال opencode-go/ اور opencode-go-responses/ ایجنٹس ترتیب دیں۔ Fable ان ایجنٹس کو استعمال کرتا ہے، لیکن اپنا پراکسی، ڈیش بورڈ، ماڈل کیٹلاگ، اسناد کا ذخیرہ، یا API key فراہم نہیں کرتا۔

پرووائیڈر یا ایجنٹ کی تعریفیں تبدیل کرنے کے بعد Codex کو دوبارہ شروع کریں۔ اس سے یقینی ہوتا ہے کہ نیا ٹاسک موجودہ روٹنگ کنفیگریشن دیکھے۔

Fable انسٹال کریں

1. انسٹالیشن کا پیش منظر دیکھیں

ریپوزٹری کی جڑ سے انسٹالر کو ڈرائی رن موڈ میں چلائیں:

./install.sh --dry-run

یہ فائلیں بنائے بغیر درست منزل اور کاپی کے آپریشنز دکھاتا ہے۔ تبدیلیاں کرنے سے پہلے یہ تصدیق کرنے کے لیے استعمال کریں کہ انسٹالر کیا کرے گا۔

2. طے شدہ ڈائریکٹری میں انسٹال کریں

اسکل کو Codex کی طے شدہ skills جگہ پر کاپی کریں:

./install.sh --copy

طے شدہ منزل ~/.codex/skills/fable ہے۔ انسٹالر صرف مطلوبہ ڈائریکٹریاں بناتا ہے اور اسے بار بار چلانا محفوظ ہے۔

3. حسبِ ضرورت skills ڈائریکٹری منتخب کریں

جب طے شدہ جگہ کے بجائے کہیں اور انسٹال کرنا ہو تو --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 keys، ٹوکنز، یا دیگر راز کبھی شامل نہ کریں۔

چونکہ اسکرپٹ سیشن برقرار رکھے بغیر مقامی fable عرف کو کال کرتا ہے، اس لیے ہر درخواست میں منصوبہ بندی یا فیصلہ کروانے کے متعلقہ مرحلے کے لیے درکار حقائق شامل ہونے چاہییں۔

انسٹالیشن ٹیسٹ کریں

ریپوزٹری کی جڑ سے اس کا کم انحصار والا ٹیسٹ سوٹ چلائیں:

tests/test_skill.sh

ٹیسٹ میں یہ چیزیں شامل ہیں:

• Shell syntax۔
• انسٹالر کے ذریعے کاپی کی جانے والی source فائلیں۔
• مطلوبہ روٹنگ اسٹرنگز۔
• بنیادی YAML ساخت۔
• xmllint کے ذریعے اختیاری XML توثیق۔
• SVG کی حفاظتی پابندیاں۔
• عارضی home ڈائریکٹری استعمال کرتے ہوئے ڈرائی رن۔
• idempotent کاپی آپریشن۔
• عام credential جیسی اسٹرنگز کی جانچ۔

اس ٹیسٹ کے لیے PyYAML یا فعال Claude login درکار نہیں، اس لیے یہ ہلکی پھلکی مقامی توثیق کے لیے موزوں ہے۔

اعلیٰ درجے کے آپریٹنگ نکات

اسکل کو ڈیبگ کرنے سے پہلے روٹنگ کی توثیق کریں

اگر Fable رپورٹ کرے کہ کوئی بھی مجاز implementation route قابلِ استعمال نہیں ہے، تو پہلے Codex Router کی تعریفوں میں opencode-go/ اور opencode-go-responses/ کو چیک کریں۔ provider یا agent کی تعریفیں تبدیل کرنے کے بعد Codex کو دوبارہ شروع کریں اور نیا task شروع کریں۔

حسبِ ضرورت deployments کے لیے dry runs استعمال کریں

کسی project-local یا غیرمعیاری skills directory میں انسٹال کرتے وقت، کاپی کرنے سے پہلے --dry-run کو --target کے ساتھ استعمال کریں:

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

اس سے منتخب directory میں تبدیلی کرنے سے پہلے آپ destination اور مجوزہ file operations کا جائزہ لے سکتے ہیں۔

اپ ڈیٹ کرتے وقت installation دوبارہ چلائیں

چونکہ copy operation idempotent ہے، اس لیے repository سے installed skill کو تازہ کرتے وقت آپ اسے دوبارہ محفوظ طریقے سے چلا سکتے ہیں۔ copy کے بعد tests/test_skill.sh چلائیں تاکہ repository checks کی توثیق ہو سکے۔

ذمہ داریاں الگ رکھیں

Fable کو implementation worker نہ سمجھیں۔ اس کی دستاویزی ذمہ داریاں planning اور final adjudication ہیں۔ Codex runtime control، workspace ownership، delegation، evidence collection، اور verification اپنے پاس رکھتا ہے۔

نتیجہ

Fable Codex میں محدود planning اور model routing شامل کرنے کا ایک مرکوز طریقہ فراہم کرتا ہے۔ OpenCode Go agents کو configure کریں، skill کا preview اور copy کریں، اسے واضح objective کے ساتھ invoke کریں، اور setup کی توثیق کے لیے شامل tests استعمال کریں۔ credentials کو planning packets سے باہر رکھیں اور routing definitions تبدیل ہونے پر Codex کو دوبارہ شروع کریں۔