pg-aiguide

pg-aiguide

ความรู้ PostgreSQL ที่ปรับแต่งสำหรับ AI เพื่อช่วยเขียนโค้ดอย่างมีประสิทธิภาพ

pg-aiguide ช่วยให้เครื่องมือเขียนโค้ดด้วย AI เขียนโค้ด PostgreSQL ได้ดีขึ้นอย่างมาก โดยมีคุณสมบัติ:

• การค้นหาเชิงความหมาย ในคู่มือ PostgreSQL อย่างเป็นทางการ (รองรับการระบุเวอร์ชัน)
• "ทักษะ" ที่ปรับแต่งสำหรับ AI — แนวปฏิบัติที่ดีที่สุดของ Postgres ที่คัดสรรและมีจุดยืนชัดเจน ใช้โดยอัตโนมัติโดยตัวแทน AI
• เอกสารระบบนิเวศส่วนขยาย เริ่มต้นด้วย TimescaleDB และจะเพิ่มเติมเร็วๆ นี้

ใช้งานได้ในรูปแบบ:

• Agent Skills ผ่าน npx skills — ทำงานร่วมกับ Claude Code, Cursor, Codex, Gemini CLI และเอเจนต์อื่นๆ อีก 40+ รายการ
• เซิร์ฟเวอร์ MCP สาธารณะ ที่สามารถใช้กับเอเจนต์เขียนโค้ด AI ใดก็ได้ หรือ
• ปลั๊กอิน Claude Code ที่ปรับแต่งเพื่อใช้กับการรองรับทักษะดั้งเดิมของ Claude

⭐ ทำไมต้อง pg-aiguide?

เครื่องมือเขียนโค้ดด้วย AI มักสร้างโค้ด Postgres ที่:

• ล้าสมัย
• ขาดข้อจำกัด (constraints) และดัชนี (indexes)
• ไม่รู้จักฟีเจอร์ใหม่ๆ ของ PG
• ไม่สอดคล้องกับแนวปฏิบัติที่ดีที่สุดในโลกจริง

pg-aiguide แก้ปัญหานี้โดยให้ความรู้ PostgreSQL เชิงลึกที่ระบุเวอร์ชันได้และรูปแบบที่พิสูจน์แล้วแก่ตัวแทน AI

ดูความแตกต่าง

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

🚀 เริ่มต้นใช้งานอย่างรวดเร็ว

Agent Skills

ติดตั้งทักษะแนวปฏิบัติที่ดีที่สุดของ PostgreSQL ที่คัดสรรสำหรับเอเจนต์เขียนโค้ด AI ของคุณ:

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

หรือติดตั้งทักษะการสำรวจ schema เพื่อตรวจสอบฐานข้อมูล PostgreSQL ที่มีอยู่:

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

หรือเลือกทักษะรายบุคคลแบบโต้ตอบ:

npx skills add timescale/pg-aiguide

ทำงานร่วมกับ Claude Code, Cursor, Codex, Gemini CLI, VS Code และ เอเจนต์อื่นๆ อีก 40+ รายการ

สำหรับความรู้ PostgreSQL ที่ลึกยิ่งขึ้น ให้เพิ่ม MCP server เพื่อให้เอเจนต์ของคุณค้นหาเชิงความหมายในคู่มือ PostgreSQL, TimescaleDB และ PostGIS อย่างเป็นทางการ

MCP Server

สำหรับการค้นหาเชิงความหมายในเอกสาร PostgreSQL, TimescaleDB และ PostGIS ให้เพิ่ม MCP server สาธารณะ:

https://mcp.tigerdata.com/docs

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

หรือสามารถใช้เป็น Claude Code Plugin:

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

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

💡 พรอมป์แรกของคุณ

เมื่อติดตั้งแล้ว pg-aiguide สามารถตอบคำถามเกี่ยวกับ Postgres หรือออกแบบ schema ได้

ตัวอย่างพรอมป์ schema แบบง่าย

สร้าง schema ตาราง Postgres สำหรับจัดเก็บชื่อผู้ใช้และที่อยู่อีเมลที่ไม่ซ้ำกัน

ตัวอย่างพรอมป์ schema แบบซับซ้อน

คุณเป็นวิศวกรซอฟต์แวร์อาวุโส คุณได้รับมอบหมายให้สร้าง schema Postgres สำหรับบริษัทอุปกรณ์ IoT อุปกรณ์จะเก็บข้อมูลสภาพแวดล้อมบนพื้นที่โรงงาน ข้อมูลประกอบด้วยอุณหภูมิ ความชื้น ความดัน เป็นจุดข้อมูลหลัก รวมถึงการวัดอื่นๆ ที่แตกต่างกันไปในแต่ละอุปกรณ์ อุปกรณ์แต่ละตัวมี id ที่ไม่ซ้ำกัน และชื่อที่มนุษย์อ่านได้ เราต้องการบันทึกเวลาที่เก็บข้อมูลด้วย การวิเคราะห์ข้อมูลล่าสุด รวมถึงการค้นหาค่าผิดปกติและความผิดปกติตามการวัด รวมถึงการวิเคราะห์ข้อมูลของอุปกรณ์เฉพาะสำหรับการวิเคราะห์เฉพาะกิจ การวิเคราะห์ข้อมูลในอดีตรวมถึงการวิเคราะห์ประวัติข้อมูลสำหรับอุปกรณ์หนึ่งเครื่องหรือรับสถิติสำหรับอุปกรณ์ทั้งหมดในช่วงเวลาที่ยาวนาน

คุณสมบัติ

การค้นหาเอกสาร (เครื่องมือ MCP)

• search_docs เครื่องมือค้นหาแบบรวมที่รองรับการค้นหาเชิงความหมาย (ความคล้ายคลึงของเวกเตอร์) และการค้นหาคำสำคัญ (BM25) ในแหล่งเอกสารหลายแห่ง:
  • postgres - คู่มือ PostgreSQL อย่างเป็นทางการ จำกัดขอบเขตตามเวอร์ชัน
  • tiger - เอกสารของ Tiger Data (TimescaleDB และระบบนิเวศ)
  • postgis - เอกสารส่วนขยายเชิงพื้นที่ PostGIS

ทักษะ (แนวปฏิบัติที่ดีที่สุดที่ปรับแต่งสำหรับ AI)

• view_skill
  เปิดเผยทักษะแนวปฏิบัติที่ดีที่สุดของ PostgreSQL ที่คัดสรรและมีจุดยืนชัดเจน ซึ่งใช้โดยอัตโนมัติโดยผู้ช่วยเขียนโค้ด AI

  ทักษะเหล่านี้ให้คำแนะนำเกี่ยวกับ:

  • การสำรวจ schema และออบเจกต์ PostgreSQL ที่มีอยู่
  • การออกแบบ schema
  • กลยุทธ์การสร้างดัชนี
  • ชนิดข้อมูล
  • ความสมบูรณ์ของข้อมูลและข้อจำกัด
  • หลักการตั้งชื่อ
  • การปรับแต่งประสิทธิภาพ
  • คุณสมบัติ PostgreSQL ที่ทันสมัย

🔌 เอกสารระบบนิเวศ

รองรับในปัจจุบัน:

• TimescaleDB (เอกสาร + ทักษะ)
• PostGIS (เอกสาร)

เร็วๆ นี้:

• pgvector

เรายินดีรับการมีส่วนร่วมสำหรับส่วนขยายและเครื่องมือเพิ่มเติม

🛠 การพัฒนา

ดู DEVELOPMENT.md สำหรับ:

• การรัน MCP server ในเครื่อง
• การเพิ่มทักษะใหม่
• การเพิ่มเอกสารใหม่

🤝 การมีส่วนร่วม

เรายินดีรับ:

• ทักษะแนวปฏิบัติที่ดีที่สุดของ Postgres ใหม่
• คลังเอกสารเพิ่มเติม
• การปรับปรุงคุณภาพการค้นหา
• รายงานข้อบกพร่องและแนวคิดคุณสมบัติ

📄 สัญญาอนุญาต

Apache 2.0