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

drawio-skill ایک اوپن سورس Agent Skills پیکیج ہے (MIT لائسنس) جو AI کوڈنگ ایجنٹس — Claude Code، Cursor، Copilot، OpenClaw، Codex، Autohand Code، Hermes، یا کسی بھی Agent Skills سے مطابقت رکھنے والے ہوسٹ — کو قدرتی زبان کے پرامپٹس اور حقیقی سسٹم ذرائع سے پیشہ ورانہ draw.io ڈایاگرام بنانے، برقرار رکھنے اور دوبارہ استعمال کرنے کی اجازت دیتا ہے۔ بنیادی جنریشن کا عمل: اسکل لے آؤٹ کی منصوبہ بندی کرتا ہے، .drawio XML لکھتا ہے، ڈرافٹ PNG ایکسپورٹ کرتا ہے، رینڈر کا خود معائنہ کرتا ہے اور اوورلیپس، کٹے ہوئے لیبلز اور اسٹیکڈ ایجز کو خود بخود ٹھیک کرتا ہے (2 راؤنڈ تک)، پھر حتمی ایکسپورٹ سے پہلے 5 راؤنڈ کا صارف فیڈبیک لوپ چلاتا ہے۔ گیارہ ڈایاگرام قسم کے پری سیٹ بلٹ ان ہیں: ERD، UML کلاس، سیکوئنس، C4، آرکیٹیکچر، ML/ڈیپ لرننگ، فلو چارٹ، SysML، BPMN، نیٹ ورک ٹوپولوجی، اور کراس فنکشنل سوئم لین۔ Mermaid ٹیکسٹ (28 معیاری اقسام بشمول mindmap، gantt، timeline، journey، pie، sankey، kanban) draw.io ≥ 30 پر مقامی قابل تدوین .drawio میں تبدیل ہوتی ہے، اور raster2drawio.py ٹول وائٹ بورڈ تصاویر یا پرانے PNGs کو قابل تدوین ڈایاگرام میں دوبارہ بناتا ہے۔ سورس سے ڈایاگرام امپورٹرز Python، JS/TS، Go، اور Rust امپورٹ گراف کے علاوہ Python کلاس ہائیرارکیز کا احاطہ کرتے ہیں؛ Terraform، Kubernetes، اور docker-compose کنفیگریشنز سرکاری AWS/Azure/GCP/K8s آئیکونز کے ساتھ؛ لائیو انفراسٹرکچر سنیپ شاٹس `terraform show -json`، `docker inspect`، اور `kubectl get -o json` سے؛ SQL DDL سے ERD؛ OpenAPI/Swagger سے API ڈایاگرام HTTP طریقہ کے مطابق رنگین؛ AsyncAPI سے ایونٹ سے چلنے والے آرکیٹیکچر ڈایاگرام؛ Protocol Buffers سے میسج/سروس ڈایاگرام؛ GraphQL SDL سے انٹیٹی ٹائپ ڈایاگرام؛ اور GitHub Actions / GitLab CI سے پائپ لائن DAGs۔ سیکوئنس ڈایاگرام حسابی لائف لائنز اور ایکٹیویشن بارز استعمال کرتے ہیں؛ C4 ماڈلز ملٹی پیج ہوتے ہیں جن میں کلک ٹو ڈرل ڈاؤن ہوتا ہے۔ طویل مدتی دیکھ بھال ایک Diagram IR کے ذریعے کی جاتی ہے جو معنی، ماخذ اور جیومیٹری کو الگ کرتا ہے، تاکہ ایگزیکٹو، سسٹم، ڈیپلائمنٹ، ڈیٹا فلو اور سیکیورٹی ویوز ایک ماڈل سے پیش کیے جا سکیں۔ `diagramctl sync` انکریمنٹل اپڈیٹس انجام دیتا ہے جو دستی طور پر ٹیون کردہ کوآرڈینیٹس، اسٹائلز اور تشریحات کو محفوظ رکھتا ہے، جس میں ہٹائے گئے آئٹمز قابل جائزہ رہتے ہیں۔ ڈایاگرام-ایز-ٹیسٹ قواعد YAML/JSON میں (انٹرنیٹ سے ڈیٹا بیس تک رسائی، سائیکل، یتیم، ٹرسٹ باؤنڈریز، کنٹراسٹ) ہر PR پر ایک سرکاری GitHub Action کے ذریعے نافذ کیے جاتے ہیں، ساتھ ہی ایک PR ایکشن جو بصری ڈفیوز رینڈر کرتا ہے۔ اضافی ٹولنگ اجزاء، مالکان اور راستے تلاش کرتی ہے؛ آرٹیکولیشن پوائنٹس اور زیادہ کپلنگ کو پہچانتی ہے؛ ناکامی کے پھیلاؤ کی نقل کرتی ہے؛ اور قابل رسائی اسٹوری واک تھرو شائع کرتی ہے۔ ڈرافٹ کو دو ڈایاگرام یا دو لائیو سنیپ شاٹس کے درمیان رنگ کوڈڈ ڈفیوز کے طور پر دکھایا جاتا ہے، اور ایک ٹائم لیس پلیئر دوبارہ چلاتا ہے کہ کوڈ بیس کی آرکیٹیکچر گٹ ہسٹری کے ذریعے کیسے بڑھی۔ شیئرنگ اور ری اسٹائلنگ ایک کمانڈ والے آپریشن ہیں: انٹرایکٹو HTML ویور پین/زوم/سرچ کے ساتھ، پاورپوائنٹ ڈیک، اینیمیٹڈ ڈیٹا فلو SVG، Mermaid یا Markdown ایکسپورٹ، کلک تھرو رن بک، اور ایگزیکٹو سمری کمپریشن۔ اسٹائل پری سیٹس (ڈیفالٹ، کارپوریٹ، ہینڈ ڈراؤن، کلر بلائنڈ سیف Okabe-Ito، ڈارک) صارف کی اپنی .drawio فائل سے سیکھے جا سکتے ہیں؛ دو لسانی لیبل مختلف حالتوں میں لے آؤٹ محفوظ رہتا ہے؛ ڈیٹا سے چلنے والے ہیٹ میپس CSV/JSON سے نوڈس کو شیڈ کرتے ہیں؛ اور ٹیوب میپ موڈ پائپ لائنز کو لندن انڈر گراؤنڈ طرز کے میٹرو نقشوں میں تبدیل کرتا ہے۔ ایک shapesearch.py ٹول 10,000+ سرکاری draw.io شکلوں (AWS، Azure، GCP، Cisco، Kubernetes، UML، BPMN، ER، الیکٹریکل، P&ID) میں درست اسٹائل اسٹرنگز تلاش کرتا ہے، جبکہ aiicons.py 321 AI/LLM برانڈ لوگو (OpenAI، Claude، Gemini، Mistral، Llama، Cohere، DeepSeek، Qwen، Ollama، LangChain، HuggingFace، وغیرہ) کے علاوہ 18 ڈیٹا اسٹور برانڈز (Redis، Postgres، MongoDB، Qdrant، Milvus، Supabase) کو حل کرتا ہے جو خود draw.io میں موجود نہیں ہیں۔ سب کچھ ایک واحد `diagramctl` CLI (doctor/build/sync/views/query/test/review/whatif/story/publish/transform) سے چلتا ہے جس میں بنیادی ورک فلو صرف stdlib اور آف لائن ہیں؛ ایک اختیاری MCP سرور وہی کمانڈز Claude Desktop، Cursor، VS Code، Codex اور کسی بھی MCP ہوسٹ کو فراہم کرتا ہے۔ لے آؤٹ Graphviz (اختیاری) کو پلیسمنٹ، آرتھوگونل روٹنگ، ٹرانزٹیو ریڈکشن اور نیسٹڈ ماڈیول کنٹینرز کے لیے استعمال کرتا ہے؛ ایک ڈیٹرمینسٹک validate.py لِنٹر CI کے لیے `--score` اور `--strict` گیٹ فراہم کرتا ہے۔ انسٹالیشن کے لیے draw.io ڈیسک ٹاپ CLI (≥ 30 تجویز کردہ) اور `npx skills add Agents365-ai/drawio-skill -g`، یا ایجنٹ کی اسکل ڈائریکٹری میں دستی کلون درکار ہے۔ یہ پروجیکٹ Agents365-ai ڈایاگرام اسکل فیملی کا حصہ ہے جس میں excalidraw-skill، mermaid-skill، plantuml-skill اور tldraw-skill شامل ہیں، ہر ایک مختلف ڈایاگرام اسٹائل کو نشانہ بناتا ہے۔