用途
该技能面向 Azure Database for PostgreSQL 的开发与运维场景，为智能体提供专家级指导。内容按类别组织，涵盖故障排查、最佳实践、决策、架构与设计模式、限制与配额、安全、配置、集成与编码模式以及部署。技能结合本地快速参考内容与远程文档获取能力，便于在需要时拉取官方文档。
主要能力
技能通过类别索引组织内容，每个类别标注行号范围或引用文件链接，便于智能体使用 read_file 定位相关章节。类别包括：
- 故障排查：诊断和修复 Azure 上 PostgreSQL 的连接/TLS、高可用与副本、性能（CPU、IOPS、内存、慢查询、autovacuum）、迁移、扩展、CLI 等问题。
- 最佳实践：查询优化、连接池、扩展、升级、Oracle 到 Postgres 迁移、批量加载、副本与维护等。
- 决策：Flexible Server 的规格与扩展（计算、存储、Ultra Disk）、网络/Private Link、托管选择、副本提升以及 PostgreSQL 版本、升级与支持。
- 架构与设计模式：微服务、多租户、分片、表设计、Redis 缓存，以及使用 OpenAI 做推荐和语义搜索。
- 限制与配额：备份、还原、PITR、异地还原、SSD/SSDv2 限制、配额、弹性集群限制、连接上限、迁移/转换限制以及存储性能/自动增长设置。
- 安全：标识（托管/Entra）、认证（SCRAM、角色）、网络（防火墙、Private Link、TLS）、加密、审计、Defender 以及基于策略的加固。
- 配置：维护窗口、扩展、调优（autovacuum、Query Store、planner）、日志/指标、网络、高可用、复制、VS Code 工具以及基于 CLI 的管理。
- 集成与编码模式：与 AI/ML（Language、AML、LangChain、Foundry、MCP）集成、向量搜索（pgvector、DiskANN）、SDK 自动化、Data Factory、CLI 以及 VS Code/Copilot 工具。
- 部署：使用 Azure Pipelines 的 CI/CD、从 Aurora/RDS/本地/VM 的离线迁移、VNet 到私有终结点迁移以及时间点还原。
使用方式
智能体应使用类别索引定位相关章节。对于带行号范围的类别（如 L35-L120），使用 read_file 读取指定行；对于带文件链接的类别（如 security.md），对链接的引用文件使用 read_file。
若 metadata.generated_at 超过三个月，建议用户从仓库拉取最新版本。若 mcp_microsoftdocs 工具不可用，建议用户安装（见安装指南）。
该技能需要网络访问以获取文档内容：
- 首选：使用 mcp_microsoftdocs:microsoft_docs_fetch，查询字符串为 from=learn-agent-skill，返回 Markdown。
- 回退：使用 fetch_webpage，查询字符串为 from=learn-agent-skill&accept=text/markdown，返回 Markdown。
适用场景
适用于在 Azure 上开发、迁移、调优、保护或部署 PostgreSQL 数据库的各类任务，包括性能问题诊断、架构设计、安全加固、版本升级、数据迁移以及 AI/ML 集成等。
限制
该技能需要网络访问以获取远程文档内容。使用前需确认 mcp_microsoftdocs 工具可用，否则需安装或使用回退方案。元数据生成时间超过三个月时，内容可能不是最新，建议拉取最新版本。