1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | azure-developer-cli-github-awesome-copilot(子技能 azure-developer-cli) |
| 作者/维护者 | 位于 github/awesome-copilot 合集,由社区贡献者于 2026-08 提交,经合集维护者审核合并 |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/azure-developer-cli |
| 许可证 | MIT(SKILL.md 声明,与合集仓库一致) |
| GitHub Stars / Forks | 合集仓库 39,974 / 5,110(GitHub API);该数字属整个合集,不代表本技能自身热度 |
| 技能自身热度 | skills.sh 页面显示 30 次安装(网页抓取,另经站内搜索接口交叉核对一致) |
| 最新版本 | 无独立版本号,最近一次改动 2026-08-06 |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill azure-developer-cli |
2. 功能介绍与亮点
让 AI 按 Microsoft 官方指引,创建、评审、迁移或排查 Azure Developer CLI(azd)项目:azure.yaml、infra 下的 Bicep/Terraform、azd 环境与机密、hooks、azd 管理的 CI/CD。
- 先做仓库勘察:先读
azure.yaml再推断服务与 IaC 提供者,不假设默认infra路径或 Bicep - 安全护栏:禁止提交
.azure、.env、凭据与本地 Terraform 状态;优先托管身份 + RBAC,机密走azd env set-secret的 Key Vault 引用 - 破坏性命令(
azd up/provision/deploy/down/pipeline config)默认先确认目标环境、订阅、区域再执行 - 默认约定表:单根
azure.yaml、src/<服务>、薄入口 + 模块化 IaC、多命名环境、CI 用 OIDC 联合凭据 - 4 个按需读取的参考文件:项目结构、IaC 与环境、安全/CI-CD/运维、官方文档索引(带 2026-08-05 复核日期)
- 收尾要求汇报改动、检查项与“刻意没跑的云端命令”,且未真实部署验证前不得宣称部署成功
3. 适用场景
分类:DevOps 与基础设施。
- 为一个应用从零搭建 azd 项目骨架(azure.yaml + Bicep 模块 + 环境约定)
- 评审或重构既有 azd 仓库:机密外泄、环境分叉、hook 写法不当
- 把 Bicep 与 Terraform 之一接入 azd,或用
azd pipeline config生成 GitHub Actions 流水线 - 排查 azd 部署失败、环境输出不同步等问题
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md(name + description),正文无 VS Code 专属变量,放入 skills 目录即可触发 |
| Codex | 需适配 | 格式相同,但 Codex 不自动发现 ~/.codex/skills,需手动引用;实际执行 azd 命令依赖本机已装 azd 与 Azure 登录 |
| OpenClaw | 未验证 | 未找到实测记录 |
| Hermes Agent | 未验证 | 格式符合 Agent Skills 规范,Hermes 按路径扫描子目录可读取,未见该技能实测 |
5. 推荐理由
azd 项目的坑集中在“看起来能跑、实际把机密或环境状态提交进了仓库”。本技能把 Microsoft 官方指引整理成先勘察、后修改、危险命令先确认的流程,并附可直接照用的目录与 hook 示例,纯提示词、零外联,适合中级 Azure 开发者作为 azd 项目的常驻规范。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 技能自身约 30 次安装,上架不足 2 个月;合集仓库近 4 万 stars,但不计入本技能个体热度;三项第三方安全扫描均通过 |
| 可用性 | 8 | 正文 7.7KB + 4 个参考文件,含布局树、hook 示例、验证命令;2026-08 刚发布、MIT 许可;需本机已装 azd 并登录 Azure |
| 安全性 | 9 | 纯提示词,无脚本、无外联;内置禁提交机密、先确认再改云资源的护栏 |
安全检查清单:① 不自带 shell 执行,仅指引 AI 在用户环境运行 azd/az/terraform 命令,且要求破坏性命令先确认;② 技能本身不联网,参考文件仅含 Microsoft Learn 链接;③ 无需 API key,机密处理方式明确(Key Vault 引用);④ 全文及 4 个参考文件无可疑指令;⑤ 来源为 GitHub 官方合集,提交经维护者审核与 Copilot 自动评审;⑥ MIT 明确;⑦ 2026-08-06 提交,合集仓库 2026-10-13 仍在更新。
综合 = 三项均值 ≈ 7.33。
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异 |
|---|---|---|
| 本技能 | azd 项目的设计、评审、迁移与排障规范 | 聚焦 azd 项目结构、环境与机密、CI/CD;官方合集出品;安装量尚小 |
microsoft/azure-skills 的 azure-prepare |
把应用准备到可部署状态的 Azure 通用流程 | 覆盖面广、安装量远高(skills.sh 约 55 万),但不专讲 azd 项目的长期维护与评审 |
sickn33/agentic-awesome-skills 的 azd-deployment |
用 azd 部署的操作向技能(skills.sh 约 88 安装) | 偏一次性部署步骤,缺少机密、环境与流水线规范 |
| Microsoft Learn 的 azd 文档与模板 | 权威参考与官方模板库 | 内容最全,但要人自己查阅;本技能把关键约定压成 AI 可直接执行的清单 |
核心差异:把 azd 的目录、环境、机密、hook 与流水线约定打包成可评审的规范,并强制危险命令前确认;代价是安装量小、尚无社区口碑。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;skills.sh 显示约 30 次安装,Gen Agent Trust Hub、Socket、Snyk 三项第三方安全扫描均为通过。
9. 其他补充
- 参考文件的官方链接均指向 Microsoft Learn,并标注 2026-08-05 复核日期
- 贡献方式:向 github/awesome-copilot 提 PR
10. 安装使用方式
npx skills add https://github.com/github/awesome-copilot --skill azure-developer-cli
前提:本机已安装 Azure Developer CLI 并登录 Azure(azd auth login)。安装后可直接说“评审这个仓库的 azd 配置”或“为这个应用搭建 azd 项目”触发;无需重启,视客户端而定。
11. 注意事项
- 技能只给方法,不会替你创建 Azure 订阅或权限;真实部署会产生云资源费用,执行前请核对目标订阅与环境
- 对 Terraform 的流水线支持存在 azd 自身的认证限制,技能已提示但不能消除
- 涉及 beta/preview 功能时需自行确认其当前状态