pg-aiguide

pg-aiguide

Keahlian PostgreSQL yang dioptimalkan untuk AI bagi asisten pengkodean

pg-aiguide membantu alat pengkodean AI menulis kode PostgreSQL yang jauh lebih baik. Ini menyediakan:

• Pencarian semantik di seluruh manual resmi PostgreSQL (sesuai versi)
• "Keahlian" yang dioptimalkan untuk AI — praktik terbaik Postgres yang dikurasi dan opiniated yang digunakan secara otomatis oleh agen AI
• Dokumentasi ekosistem ekstensi, dimulai dengan TimescaleDB, dan lebih banyak lagi segera hadir

Gunakan sebagai:

• Agent Skills melalui npx skills — bekerja dengan Claude Code, Cursor, Codex, Gemini CLI, dan 40+ agen lainnya
• server MCP publik yang dapat digunakan dengan agen pengkodean AI apa pun, atau
• plugin Claude Code yang dioptimalkan untuk digunakan dengan dukungan skill bawaan Claude.

⭐ Mengapa pg-aiguide?

Alat pengkodean AI sering menghasilkan kode Postgres yang:

• sudah usang
• kurang constraint dan index
• tidak menyadari fitur PG modern
• tidak konsisten dengan praktik terbaik dunia nyata

pg-aiguide memperbaikinya dengan memberikan agen AI pengetahuan PostgreSQL yang mendalam, sesuai versi, dan pola yang terbukti.

Lihat perbedaannya

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

🚀 Memulai dengan Cepat

Agent Skills

Instal keahlian praktik terbaik PostgreSQL yang dikurasi untuk agen pengkodean AI Anda:

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

Atau instal keahlian eksplorasi skema untuk menyelidiki database PostgreSQL yang ada:

npx skills add timescale/pg-aiguide --skill schema-exploration

Atau pilih keahlian individual secara interaktif:

npx skills add timescale/pg-aiguide

Bekerja dengan Claude Code, Cursor, Codex, Gemini CLI, VS Code, dan 40+ agen lainnya.

Untuk pengetahuan PostgreSQL yang lebih dalam, tambahkan juga server MCP untuk memberikan agen Anda pencarian semantik di manual resmi PostgreSQL, TimescaleDB, dan PostGIS.

Server MCP

Untuk pencarian semantik di dokumentasi PostgreSQL, TimescaleDB, dan PostGIS, tambahkan server MCP publik:

https://mcp.tigerdata.com/docs

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

Atau dapat digunakan sebagai Plugin Claude Code:

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

Instal berdasarkan lingkungan

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pg-aiguide": {
      "type": "remote",
      "url": "https://mcp.tigerdata.com/docs"
    }
  }
}

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"
    }
  }
}

💡 Prompt Pertama Anda

Setelah terinstal, pg-aiguide dapat menjawab pertanyaan Postgres atau merancang skema.

Contoh prompt skema sederhana

Buat skema tabel Postgres untuk menyimpan nama pengguna dan alamat email unik.

Contoh prompt skema kompleks

Anda adalah seorang insinyur perangkat lunak senior. Anda diberi tugas untuk membuat skema Postgres untuk perusahaan perangkat IoT. Perangkat mengumpulkan data lingkungan di lantai pabrik. Data tersebut mencakup suhu, kelembapan, tekanan, sebagai titik data utama serta pengukuran lain yang bervariasi dari perangkat ke perangkat. Setiap perangkat memiliki id unik dan nama yang dapat dibaca manusia. Kami ingin mencatat waktu data dikumpulkan juga. Analisis untuk data terbaru mencakup menemukan outlier dan anomali berdasarkan pengukuran, serta menganalisis data perangkat tertentu untuk analisis ad-hoc. Analisis data historis mencakup menganalisis riwayat data untuk satu perangkat atau mendapatkan statistik untuk semua perangkat selama periode waktu yang lama.

Fitur

Pencarian Dokumentasi (Alat MCP)

• search_docs Alat pencarian terpadu yang mendukung pencarian semantik (kemiripan vektor) dan kata kunci (BM25) di berbagai sumber dokumentasi:
  • postgres - Manual resmi PostgreSQL, dibatasi berdasarkan versi
  • tiger - Dokumentasi Tiger Data (TimescaleDB dan ekosistem)
  • postgis - Dokumentasi ekstensi spasial PostGIS

Keahlian (Praktik Terbaik yang Dioptimalkan untuk AI)

• view_skill
  Mengekspos keahlian praktik terbaik PostgreSQL yang dikurasi dan opiniated yang digunakan secara otomatis oleh asisten pengkodean AI.

  Keahlian ini memberikan panduan tentang:

  • Menjelajahi skema dan objek PostgreSQL yang ada
  • Desain skema
  • Strategi indexing
  • Tipe data
  • Integritas data dan constraint
  • Konvensi penamaan
  • Penyetelan kinerja
  • Fitur PostgreSQL modern

🔌 Dokumentasi Ekosistem

Didukung saat ini:

• TimescaleDB (dokumen + keahlian)
• PostGIS (dokumen)

Segera hadir:

• pgvector

Kami menyambut kontribusi untuk ekstensi dan alat tambahan.

🛠 Pengembangan

Lihat DEVELOPMENT.md untuk:

• menjalankan server MCP secara lokal
• menambahkan keahlian baru
• menambahkan dokumen baru

🤝 Berkontribusi

Kami menyambut:

• keahlian praktik terbaik Postgres baru
• korpus dokumentasi tambahan
• peningkatan kualitas pencarian
• laporan bug dan ide fitur

📄 Lisensi

Apache 2.0