इस प्रोजेक्ट के बारे में

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 Class, Sequence, C4, Architecture, ML/Deep Learning, Flowchart, SysML, BPMN, Network Topology, और Cross-Functional Swimlane। Mermaid टेक्स्ट (28 मानक प्रकार जिनमें mindmap, gantt, timeline, journey, pie, sankey, kanban शामिल हैं) draw.io ≥ 30 पर नेटिव संपादन योग्य .drawio में परिवर्तित होता है, और raster2drawio.py टूल व्हाइटबोर्ड फ़ोटो या पुराने PNG को संपादन योग्य आरेख के रूप में पुनर्निर्मित करता है। स्रोत-से-आरेख इम्पोर्टर में 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 से HTTP विधि द्वारा रंगीन API आरेख; AsyncAPI से इवेंट-संचालित आर्किटेक्चर आरेख; Protocol Buffers से संदेश/सेवा आरेख; GraphQL SDL से एंटिटी टाइप आरेख; और GitHub Actions / GitLab CI से पाइपलाइन DAG। सीक्वेंस आरेख गणना किए गए लाइफलाइन और एक्टिवेशन बार का उपयोग करते हैं; C4 मॉडल क्लिक-टू-ड्रिल-डाउन के साथ बहु-पृष्ठ होते हैं। दीर्घकालिक रखरखाव एक Diagram IR के माध्यम से संभाला जाता है जो अर्थ, उत्पत्ति और ज्यामिति को अलग करता है, ताकि कार्यकारी, सिस्टम, परिनियोजन, डेटा-प्रवाह और सुरक्षा दृश्य एक मॉडल से प्रोजेक्ट किए जा सकें। `diagramctl sync` वृद्धिशील अपडेट करता है जो मैन्युअल रूप से ट्यून किए गए निर्देशांक, शैलियों और एनोटेशन को संरक्षित करता है, हटाने की समीक्षा योग्य रहती है। YAML/JSON में Diagram-as-Test नियम (इंटरनेट-से-डेटाबेस एक्सेस, चक्र, अनाथ, ट्रस्ट सीमाएँ, कंट्रास्ट) हर PR पर आधिकारिक GitHub Action द्वारा लागू किए जाते हैं, साथ ही एक PR एक्शन जो विज़ुअल डिफ़ प्रस्तुत करता है। अतिरिक्त टूलिंग घटकों, स्वामियों और पथों की पूछताछ करती है; आर्टिक्यूलेशन पॉइंट और उच्च युग्मन का पता लगाती है; विफलता प्रसार का अनुकरण करती है; और सुलभ Story वॉकथ्रू प्रकाशित करती है। ड्रिफ्ट को दो आरेखों या दो लाइव स्नैपशॉट के बीच रंग-कोडित डिफ़ के रूप में देखा जाता है, और एक टाइम-लैप्स प्लेयर git इतिहास के माध्यम से कोडबेस के आर्किटेक्चर के विकास को फिर से चलाता है। साझा करना और पुनः-स्टाइल करना एक-कमांड संचालन है: पैन/ज़ूम/खोज के साथ इंटरैक्टिव HTML व्यूअर, PowerPoint डेक, एनिमेटेड डेटा-फ़्लो 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-only और ऑफ़लाइन होते हैं; एक वैकल्पिक 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`, या एजेंट की skills निर्देशिका में मैन्युअल क्लोन की आवश्यकता होती है। परियोजना Agents365-ai diagram-skill परिवार का हिस्सा है, साथ ही excalidraw-skill, mermaid-skill, plantuml-skill और tldraw-skill, प्रत्येक एक अलग आरेख शैली को लक्षित करता है।