用途
该技能用于在 Azure 上构建、部署和修改 GitHub Copilot SDK 应用。凡是代码库中出现 @github/copilot-sdk 或 CopilotClient 等标记,且用户提出构建、修改、添加功能或准备部署类需求时,都应先进入此技能,再由它编排 azure-prepare 与 azure-deploy 等子技能。
代码库检测(强制第一步)
在存在既有代码库时,必须先运行检测,再执行任何其他技能。检测方式包括:读取工作区根目录以及一层深度内的 */package.json,检查 name、dependencies 或 devDependencies 中是否出现 @github/copilot-sdk 或 copilot-sdk;若未在 package.json 中发现,则扫描 .ts 与 .js 文件中的 CopilotClient 或 createSession。命中任一标记即调用本技能作为入口。即使提示词中没有出现 copilot 关键词,只要代码库包含相关标记,构建、修改、加功能或准备类请求也必须路由到本技能。当代码库已存在 .azure/deployment-plan.md 且用户只想部署而非修改或新增功能时,应让位于 azure-deploy。
主要能力与使用方式
根据用户意图进行路由:全新空项目进入脚手架流程;为既有仓库新增 SDK 服务时,可将模板脚手架到临时目录,复制 API 服务与基础设施到用户仓库,并调整 azure.yaml 以包含既有与新增服务;为已有 SDK 应用部署到 Azure 时补充基础设施;修改或新增功能则结合代码库上下文与 SDK 参考实现;将 SDK 集成到既有应用代码时按集成方式处理;需要使用 Azure 或自有模型时走 BYOM 配置。
全新项目脚手架命令为:
azd init --template azure-samples/copilot-sdk-service
该模板已包含 API(Express/TS)、Web UI(React/Vite)、基础设施(Bicep)、Dockerfile 与令牌脚本,不应重新创建。
部署流程为:调用 azure-prepare(跳过其 Step 0 路由,因为脚手架已完成),然后依次执行 azure-validate 与 azure-deploy。
模型配置
提供三条路径:GitHub 默认模型(不传 model 参数,由 SDK 选择默认值);GitHub 指定模型(传入 model: "<name>",可用 listModels() 发现);Azure BYOM(model 加 provider,并通过 DefaultAzureCredential 获取 bearerToken)。
BYOM 认证为强制要求:Azure BYOM 配置必须使用 DefaultAzureCredential(本地开发)或 ManagedIdentityCredential(生产)来获取 bearerToken,provider 配置中唯一受支持的认证模式就是 bearerToken。
适用场景
适用于使用 @github/copilot-sdk 或 CopilotClient 的应用在 Azure 上的脚手架搭建、在既有仓库中并列新增 SDK 服务、为既有 SDK 应用补齐 Azure 基础设施、功能修改与扩展、以及自有模型接入等场景。
限制与规则
修改前需阅读用户仓库中的 AGENTS.md;需要 Docker 环境(docker info);BYOM 认证仅支持通过 DefaultAzureCredential 或 ManagedIdentityCredential 提供的 bearerToken,不支持其他认证模式。关于具体模板内容、SDK 参考、模型配置参考与认证最佳实践,资料中指向相应参考文档,未在本页展开。