postgres-skills — плагин для GitHub Copilot
Плагин даёт GitHub Copilot рекомендации по PostgreSQL и подключает инструменты для работы с живой базой данных.
copilot plugin install postgres-skills@awesome-copilotЧто делает postgres-skills
postgres-skills объединяет скилл с рекомендациями по PostgreSQL и MCP-сервер postgres-mcp. Скилл направляет агента к материалам по индексам, векторному поиску и RAG, JSONB, секционированию, безопасности, репликации и графам знаний.
Плагин содержит манифесты GitHub Copilot, конфигурацию MCP и руководство SETUP.md. postgres-mcp запускается локально через npx, читает и изменяет базу в пределах прав выбранной роли, а CSV-инструменты получают доступ только к явно разрешённым локальным путям.
Записи в базу, импорт файлов, изменения графа и Azure-ресурсов требуют подтверждения. Для исследования нужен отдельный пользователь PostgreSQL с минимальными правами; возвращённые данные базы попадут в диалог с AI-ассистентом.
Какие задачи решает
- подобрать индексы для PostgreSQL
- спроектировать поиск по векторам и RAG
- разобрать данные в JSONB
- настроить секционирование и репликацию
- проверить права доступа к базе
Примеры запросов агенту
- Проверь схему PostgreSQL и предложи индексы для частых запросов.
- Спроектируй поиск по векторам и RAG для этой базы.
- Покажи, какие права нужны роли для безопасного исследования базы.
Как установить postgres-skills
Команда из источника
copilot plugin install postgres-skills@awesome-copilotПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о postgres-skills
Как установить postgres-skills в GitHub Copilot?
Выполните copilot plugin install postgres-skills@awesome-copilot.
Что делает postgres-skills?
Плагин добавляет скилл с рекомендациями по PostgreSQL и MCP-сервер postgres-mcp для работы с подключённой базой данных.
Какие права нужны postgres-skills?
Сервер действует с правами выбранной роли PostgreSQL. Для исследования рекомендуется отдельная роль с минимальными правами и доступом только для чтения.
Исходный текст
plugin · MIT
# postgres-skills plugin The installable plugin payload for the `postgres-skills` marketplace. It bundles the PostgreSQL skill and the `postgres-mcp` MCP server so AI-agent CLIs (GitHub Copilot CLI, Claude Code, Codex) can route PostgreSQL work to the right guidance and tools. ## Contents | Path | Purpose | | --- | --- | | `skills/postgresql-best-practices/` | The skill (SKILL.md routing table + reference docs). | | `plugin.json` | Agent Plugins v1.0 manifest used by GitHub Copilot. | | `mcp.json` | Agent Plugins v1.0 declaration for the `postgres-mcp` server. | | `.mcp.json` | Declares the `postgres-mcp` MCP server (local stdio through `npx`, with optional telemetry disabled). | | `SETUP.md` | Connection, permissions, data-access, privacy, and removal guidance. | | `.claude-plugin/plugin.json` | Plugin identity and display metadata for Claude Code. | | `.codex-plugin/plugin.json` | Plugin manifest required by Codex. | ## Plugin manifests Codex requires a manifest at **`.codex-plugin/plugin.json`** inside the plugin folder. Without it, `codex plugin add postgres-skills@postgres-skills` fails with `Error: missing plugin.json`. Claude Code reads plugin metadata from **`.claude-plugin/plugin.json`**. GitHub Copilot reads the Agent Plugins v1.0 **`plugin.json`** and **`mcp.json`** files at the plugin root. Keep the host manifests and marketplace metadata in `.github/plugin/marketplace.json` at the same release version. ## Security and privacy The plugin launches [`@microsoft/postgres-mcp`](https://github.com/microsoft/postgres-mcp) locally through `npx`. It can read from and write to the database permitted by the selected PostgreSQL role, and its CSV tools can read explicitly approved local paths. Database information returned by the MCP server becomes part of the user's AI-assistant interaction. The bundled configuration disables postgres-mcp telemetry. Use a dedicated, least-privilege role and a read-only profile for exploration. The skills require confirmation before database writes, file imports, graph writes, or Azure resource changes. See [SETUP.md](SETUP.md) for the complete access and data-use disclosure.
© Microsoft · MIT · microsoft/postgres-skills
