pg-aiguide

pg-aiguide

कोडिंग सहायकों के लिए AI-अनुकूलित PostgreSQL विशेषज्ञता

pg-aiguide AI कोडिंग उपकरणों को नाटकीय रूप से बेहतर PostgreSQL कोड लिखने में मदद करता है। यह प्रदान करता है:

• आधिकारिक PostgreSQL मैनुअल में सिमैंटिक खोज (संस्करण-सचेत)
• AI-अनुकूलित "कौशल" — क्यूरेटेड, सुनियोजित Postgres सर्वोत्तम अभ्यास जो AI एजेंटों द्वारा स्वचालित रूप से उपयोग किए जाते हैं
• एक्सटेंशन इकोसिस्टम दस्तावेज़, TimescaleDB से शुरू, और जल्द ही और अधिक आने वाले हैं

इसका उपयोग इस प्रकार करें:

• एजेंट कौशल npx skills के माध्यम से — Claude Code, Cursor, Codex, Gemini CLI, और 40+ अन्य एजेंटों के साथ काम करता है
• एक सार्वजनिक MCP सर्वर जिसे किसी भी AI कोडिंग एजेंट के साथ उपयोग किया जा सकता है, या
• Claude के मूल कौशल समर्थन के साथ उपयोग के लिए अनुकूलित एक Claude Code प्लगइन।

⭐ क्यों pg-aiguide?

AI कोडिंग उपकरण अक्सर ऐसा Postgres कोड उत्पन्न करते हैं जो:

• पुराना होता है
• बाधाओं और अनुक्रमणिकाओं से रहित होता है
• आधुनिक PG सुविधाओं से अनभिज्ञ होता है
• वास्तविक दुनिया के सर्वोत्तम अभ्यासों के साथ असंगत होता है

pg-aiguide AI एजेंटों को गहन, संस्करणबद्ध PostgreSQL ज्ञान और सिद्ध पैटर्न देकर इसे ठीक करता है।

अंतर देखें

https://github.com/user-attachments/assets/5a426381-09b5-4635-9050-f55422253a3d

🚀 त्वरित शुरुआत

एजेंट कौशल

अपने AI कोडिंग एजेंट के लिए क्यूरेटेड PostgreSQL सर्वोत्तम-अभ्यास कौशल स्थापित करें:

npx skills add timescale/pg-aiguide --skill postgres

या अंतःक्रियात्मक रूप से अलग-अलग कौशल चुनें:

npx skills add timescale/pg-aiguide

Claude Code, Cursor, Codex, Gemini CLI, VS Code, और 40+ अन्य एजेंटों के साथ काम करता है।

और भी गहन PostgreSQL ज्ञान के लिए, अपने एजेंट को आधिकारिक PostgreSQL, TimescaleDB, और PostGIS मैनुअल पर सिमैंटिक खोज देने के लिए MCP सर्वर भी जोड़ें।

MCP सर्वर

PostgreSQL, TimescaleDB, और PostGIS दस्तावेज़ीकरण पर सिमैंटिक खोज के लिए, सार्वजनिक MCP सर्वर जोड़ें:

https://mcp.tigerdata.com/docs

{
  "mcpServers": {
    "pg-aiguide": {
      "url": "https://mcp.tigerdata.com/docs"
    }
  }
}

या इसे Claude Code प्लगइन के रूप में उपयोग किया जा सकता है:

claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide

वातावरण द्वारा स्थापित करें

claude plugin marketplace add timescale/pg-aiguide
claude plugin install pg@aiguide

codex mcp add --url "https://mcp.tigerdata.com/docs" pg-aiguide

{
  "mcpServers": {
    "pg-aiguide": {
      "url": "https://mcp.tigerdata.com/docs"
    }
  }
}

gemini mcp add -s user pg-aiguide "https://mcp.tigerdata.com/docs" -t http

code --add-mcp '{"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"}'

code-insiders --add-mcp '{"name":"pg-aiguide","type":"http","url":"https://mcp.tigerdata.com/docs"}'

{
  "mcpServers": {
    "pg-aiguide": {
      "serverUrl": "https://mcp.tigerdata.com/docs"
    }
  }
}

💡 आपका पहला संकेत

एक बार स्थापित हो जाने पर, pg-aiguide Postgres प्रश्नों का उत्तर दे सकता है या स्कीमा डिज़ाइन कर सकता है।

सरल स्कीमा उदाहरण संकेत

उपयोगकर्ता नाम और अद्वितीय ईमेल पते संग्रहीत करने के लिए एक Postgres तालिका स्कीमा बनाएं।

जटिल स्कीमा उदाहरण संकेत

आप एक वरिष्ठ सॉफ्टवेयर इंजीनियर हैं। आपको एक IoT उपकरण कंपनी के लिए Postgres स्कीमा उत्पन्न करने का कार्य दिया गया है। उपकरण एक कारखाने के फर्श पर पर्यावरणीय डेटा एकत्र करते हैं। डेटा में तापमान, आर्द्रता, दबाव मुख्य डेटा बिंदुओं के रूप में और साथ ही अन्य माप शामिल हैं जो उपकरण से उपकरण में भिन्न होते हैं। प्रत्येक उपकरण की एक अद्वितीय आईडी और एक मानव-पठनीय नाम है। हम डेटा एकत्र किए जाने का समय भी रिकॉर्ड करना चाहते हैं। हाल के डेटा के विश्लेषण में मापों के आधार पर आउटलायर्स और विसंगतियों का पता लगाना, साथ ही तदर्थ विश्लेषण के लिए विशेष उपकरणों के डेटा का विश्लेषण करना शामिल है। ऐतिहासिक डेटा विश्लेषण में एक उपकरण के लिए डेटा के इतिहास का विश्लेषण करना या लंबी अवधि में सभी उपकरणों के लिए आंकड़े प्राप्त करना शामिल है।

सुविधाएं

दस्तावेज़ीकरण खोज (MCP उपकरण)

• search_docs एकीकृत खोज उपकरण जो कई दस्तावेज़ीकरण स्रोतों में सिमैंटिक (वेक्टर समानता) और कीवर्ड (BM25) खोज का समर्थन करता है:
  • postgres - आधिकारिक PostgreSQL मैनुअल, संस्करण द्वारा स्कोप किया गया
  • tiger - Tiger Data का दस्तावेज़ीकरण (TimescaleDB और इकोसिस्टम)
  • postgis - PostGIS स्थानिक एक्सटेंशन दस्तावेज़ीकरण

कौशल (AI-अनुकूलित सर्वोत्तम अभ्यास)

• view_skill
  क्यूरेटेड, सुनियोजित PostgreSQL सर्वोत्तम-अभ्यास कौशल प्रदान करता है जो AI कोडिंग सहायकों द्वारा स्वचालित रूप से उपयोग किए जाते हैं।

  ये कौशल निम्नलिखित पर मार्गदर्शन प्रदान करते हैं:

  • स्कीमा डिज़ाइन
  • अनुक्रमण रणनीतियाँ
  • डेटा प्रकार
  • डेटा अखंडता और बाधाएं
  • नामकरण परंपराएं
  • प्रदर्शन ट्यूनिंग
  • आधुनिक PostgreSQL सुविधाएं

🔌 इकोसिस्टम दस्तावेज़ीकरण

वर्तमान में समर्थित:

• TimescaleDB (दस्तावेज़ + कौशल)
• PostGIS (दस्तावेज़)

जल्द ही आ रहा है:

• pgvector

हम अतिरिक्त एक्सटेंशन और उपकरणों के लिए योगदान का स्वागत करते हैं।

🛠 विकास

इसके लिए DEVELOPMENT.md देखें:

• MCP सर्वर को स्थानीय रूप से चलाना
• नए कौशल जोड़ना
• नए दस्तावेज़ जोड़ना

🤝 योगदान

हम स्वागत करते हैं:

• नए Postgres सर्वोत्तम-अभ्यास कौशल
• अतिरिक्त दस्तावेज़ीकरण कोष
• खोज गुणवत्ता में सुधार
• बग रिपोर्ट और सुविधा विचार

📄 लाइसेंस

Apache 2.0