منصوبے کے بارے میں

جولز پرامپٹس ایک کیوریٹڈ لائبریری ہے جو مشین-readable ٹاسک پرامپٹس، ایجنٹ سکلز، اور پودے لگائے گئے نقائص والے فکسچر پر مشتمل ہے، جو کوڈنگ ایجنٹس کے لیے ڈیزائن کی گئی ہے۔ یہ نام تاریخی ہے؛ ہدایات ہارنس-ایگنوسٹک ہیں اور کسی مخصوص پروڈکٹ جیسے جولز، کلاڈ کوڈ، کوڈیکس، یا کرسر پر منحصر نہیں ہیں۔ ریپوزٹری کئی تہوں میں منظم ہے: - `_prompts/`: کینونیکل طریقہ کار کا متن، بشمول ویب سائٹ، JSON انڈیکس، اور MCP سلیش کمانڈز۔ - `skills/`: وہی متن ایجنٹ سکلز کے طور پر فارمیٹ کیا گیا، جو `_prompts/` سے تیار کیا گیا ہے، اور `.claude/skills/` یا `.agents/skills/` میں کاپی کرنے کے لیے تیار ہے۔ - `fixtures/`: چھوٹی ریپوزٹریاں جن میں پودے لگائے گئے نقائص ہیں تاکہ یہ ظاہر کیا جا سکے کہ سکلز کیسے ناکام ہوتی ہیں۔ - `plugin/`: پوری لائبریری ایک انسٹال ایبل بنڈل کے طور پر جس میں مینی فیسٹ، سکلز، اور سلیش کمانڈز شامل ہیں۔ - `library.json`: ہر طریقہ کار، اس کی کیٹیگری، اور ٹیئر کی مشین-readable فہرست۔ تمام تیار کردہ آؤٹ پٹس CI میں بائٹ-بہ-بائٹ چیک کیے جاتے ہیں تاکہ یہ یقینی بنایا جا سکے کہ وہ ماخذ کے ساتھ ہم آہنگ رہیں۔ نیا آؤٹ پٹ فارمیٹ شامل کرنا `scripts/emit.py` کی `TARGETS` فہرست میں ایک اندراج ہے۔ طریقہ کار کو `core` کے طور پر درجہ بند کیا جاتا ہے جب تک کہ `status: legacy` نشان زد نہ ہو۔ کور طریقہ کار ان ناکامیوں کو حل کرتے ہیں جو ایجنٹس کو درپیش ہوتی ہیں، جبکہ لیگیسی طریقہ کار 2025 کے عمومی مقصد کے ٹاسک متن ہیں جو مفید رہتے ہیں لیکن اس لائبریری کی انفرادیت کا سبب نہیں ہیں۔ لائبریری میں `harness/AGENTS.md` میں `AGENTS.md` کے لیے ایک مستقل ڈاکٹرائن شامل ہے تاکہ یہ یقینی بنایا جا سکے کہ جب کوئی سکل منتخب نہ ہو تو یہ فعال ہو۔ شروع کرنے کے رہنما `PROMPTS_GUIDE.md` (ہر پرامپٹ اور تجویز کردہ ترتیب کی وضاحت) اور `ENVIRONMENT_SETUP.md` (ایجنٹ کلوننگ، انسٹالیشن، اور ٹیسٹنگ کے لیے ریپوزٹری تیار کرنا) میں فراہم کیے گئے ہیں۔ استعمال کے اختیارات میں شامل ہیں: - ایجنٹ سکلز کے طور پر: سکل ڈائریکٹریز کو `.claude/skills/` میں کاپی کریں اور `harness/AGENTS.md` کو پروجیکٹ کے `AGENTS.md` میں پیسٹ کریں۔ - MCP سرور کے طور پر: سرور کو `mcpServers` میں کنفیگر کریں تاکہ پرامپٹس کو کلاڈ کوڈ، کلاڈ ڈیسک ٹاپ، VS Code/Copilot Chat، Windsurf، اور Zed میں سلیش کمانڈز کے طور پر ظاہر کیا جا سکے۔ سرور ریپوزٹری کو لائیو پڑھتا ہے، اور `<PR_URL_OR_DIFF_RANGE>` جیسے پلیس ہولڈرز کو آرگیومنٹس کے طور پر ظاہر کیا جاتا ہے۔ - انسانوں کے لیے: YAML فرنٹ میٹر کے بعد پرامپٹ فائل کا باڈی کاپی کریں اور اسے ایجنٹ کے انسٹرکشن ان پٹ میں پیسٹ کریں۔ - ایجنٹس کے لیے: `https://jules-prompts.wecanuseai.com/prompts.json` حاصل کریں، عنوان/تفصیل/کیٹیگری کے ذریعے پرامپٹ منتخب کریں، اور اس کے URL سے رینڈر شدہ پرامپٹ حاصل کریں یا `_prompts/<slug>.md` پڑھیں۔ - فکسچر کے خلاف: `python scripts/score_fixture.py fixtures/unfailable-tests path/to/REPORT.md` استعمال کریں تاکہ فکسچر کو اسکور کیا جا سکے، جس میں holds/broken/skipped کے فیصلے اور کوریج لائن شامل ہو۔ شراکت کے رہنما اصولوں میں صرف ان بار بار آنے والے کاموں کے لیے پرامپٹس شامل کرنے پر زور دیا گیا ہے جو پہلے سے کور نہیں ہیں، YAML فرنٹ میٹر کو ہم آہنگ رکھنا، ہارنس-ایگنوسٹک ہدایات لکھنا، سکلز کو دوبارہ تیار کرنا، رہنما اور ورک فلو کو اپڈیٹ کرنا، ناکامی کو پکڑنے والے پرامپٹس کے لیے فکسچر شامل کرنا، اور انٹیگریٹی چیکس پاس کرنا۔