azure-containerregistry-py
作者 microsoftazure-containerregistry-py 让你可以在 Python 中通过 ContainerRegistryClient 使用 Azure Container Registry。它支持后端开发场景中的仓库列表查看、镜像与 artifact 检查，以及注册表访问管理。你可以学习安装、端点配置和认证模式，适用于本地或生产环境。
该技能得分 82/100，因为它的范围清晰、可触发性强，并提供了足够的操作指导，帮助代理处理 Azure Container Registry 任务，比通用提示更少猜测。对目录用户来说，这意味着它是一个值得安装的候选项，具备实际工作流价值，但在配套资源和参考材料方面还不够完整。
- 触发线索和范围明确：frontmatter 中写明了 'azure-containerregistry'、'ContainerRegistryClient'、'container images'、'docker registry' 和 'ACR'。
- 实用的配置指导：包含安装、所需环境变量，以及使用 DefaultAzureCredential 和 ManagedIdentityCredential 的 Python 认证示例。
- 技能正文内容扎实：有效的 frontmatter、6.3k 的正文长度、多个标题和代码块都表明这不是占位内容，而是真正可执行的操作说明。
- 未包含支持文件、参考资料或脚本，因此某些工作流可能需要代理仅根据正文自行推断细节。
- 描述非常简短，而且 SKILL.md 中没有安装命令，这会略微降低即时可发现性和采用信心。
azure-containerregistry-py 技能概览
azure-containerregistry-py 的用途
azure-containerregistry-py 技能帮助你通过 Python 和 ContainerRegistryClient 操作 Azure Container Registry。它适合需要列出镜像、查看仓库、管理 artifact，或在后端服务中自动化 registry 操作的场景。
适合谁使用
如果你在围绕 ACR 构建后端开发流程、CI/CD 作业、部署工具或内部自动化，就适合使用 azure-containerregistry-py 技能。它最适合你已经明确需要 Azure SDK for Python，而不是只靠 shell 的 registry 命令的时候。
它擅长什么
这个技能的重点是实用的 registry 访问：带认证的客户端初始化、endpoint 配置，以及常见的 ACR 工作流。它最大的价值在于减少对所需 endpoint 和凭据配置的猜测，尤其是在从本地开发切换到生产环境时。
什么时候适合用
当你的任务依赖能通过 Python 代码完成 Azure 认证，并操作 container registry 资源时，选择 azure-containerregistry-py。如果你只是需要一次性的手工 registry 操作，prompt 或 CLI 可能更简单。
如何使用 azure-containerregistry-py 技能
安装技能并定位源文件
对于 azure-containerregistry-py install，先从 microsoft/skills 集合中添加这个技能，然后优先打开 SKILL.md。由于这个仓库没有 helper scripts 或参考文件夹，技能文件就是唯一的权威来源。
先收集最少但关键的输入
一条高质量的 azure-containerregistry-py usage 请求应包含：
- registry endpoint，例如
https://<registry-name>.azurecr.io - registry 是 public 还是 private
- 你的认证方式：
DefaultAzureCredential、managed identity，还是 anonymous access - 你要执行的操作，比如列出 repositories、读取 manifests，或删除 artifacts
把模糊目标改写成可用的 prompt
不要只问“ACR help”，却期待完整答案。更好的方式是说明你要完成什么后端任务，以及当前所在环境。例如：Write Python code using azure-containerregistry-pyto connect to a private Azure Container Registry in production with managed identity and list image tags inmyapp.
按正确顺序阅读技能内容
先看 SKILL.md，再重点关注 installation、environment variables 和 authentication 相关部分。最关键的实现细节是必须设置 AZURE_CONTAINERREGISTRY_ENDPOINT；最常见的落地障碍，是本地代码和生产代码使用了错误的 credential 模式。
azure-containerregistry-py 技能常见问题
azure-containerregistry-py 只适合 Azure SDK 用户吗？
是的。azure-containerregistry-py 技能是为使用 Azure Container Registry SDK 的 Python 代码准备的。如果你不是在 Python 里开发，它就不是最佳选择。
使用前需要先了解 Azure identity 吗？
不需要，但你必须选择一条认证路径。这个技能以 Entra ID 为主，并展示如何在本地使用 DefaultAzureCredential，以及如何在生产环境中使用更明确的 credential。
可以用于 public registry 吗？
可以，前提是 registry 允许匿名访问。这比默认的安全配置适用范围更窄，因此在使用 unauthenticated access 之前，先确认 registry policy。
什么时候不该用这个技能？
如果你的任务不涉及 registry 管理，只是想快速跑一个 Docker 命令，或者工作流根本不包含 Python 后端开发，就不要用 azure-containerregistry-py。
如何改进 azure-containerregistry-py 技能
先把凭据上下文说清楚
最好的结果通常来自明确说明代码运行在本地、CI 还是 Azure 中。这个信息会直接影响 azure-containerregistry-py 技能指南里该使用 DefaultAzureCredential、managed identity，还是 anonymous access。
指定具体的 registry 任务，而不只是 registry 本身
要直接说明你想处理的对象：repositories、manifests、tags、images 或 artifacts。像“列出 payments 的 repositories 和最新 tags”会比“告诉我 ACR 怎么用”产出更准确的结果。
尽早说明失败约束
如果环境禁止交互式登录、secret 不能落盘，或者 registry 只能私有访问，要提前说明。这些约束会实质性地改变代码路径，也能避免技能给出无法使用的默认方案。
先检查 endpoint 和认证方式，再逐步迭代
如果第一次答案不对，先核对 endpoint 字符串、credential 选择，以及 registry 是否要求 Entra ID。对 azure-containerregistry-py 工作流来说，这三个输入通常决定了后续方案是否正确。