SuperAPI AI 工具集

azurebackup-add-tool

编程与开发

查看项目

更新于 10-16 06:47

技能介绍

用途:为 Azure Backup MCP 工具集新增 azmcp azurebackup <group> <operation> 命令,或扩展已有命令组(vault、policy、protecteditem 等)、新增命令组(security、compliance 等),并确保通过全部校验后再提交 PR。

主要能力与流程:实现阶段需按 .github/skills/add-azure-mcp-tools/SKILL.md 操作,代码位于 tools/Azure.Mcp.Tools.AzureBackup/。依次创建选项定义(src/Options/{Group}/{Resource}{Operation}Options.cs,继承 BaseAzureBackupOptions)、在 IAzureBackupService/AzureBackupService 添加服务方法并按 vault 类型路由到 rsvOps 或 dppOps、实现命令(src/Commands/{Group}/{Resource}{Operation}Command.cs,使用 [CommandMetadata]、sealed 类、注入 ILogger<T> 与 IAzureBackupService、添加遥测标签、调用 HandleException)、在 AzureBackupSetup.cs 注册命令、在 AzureBackupJsonContext.cs 注册 JSON 序列化上下文以支持 AOT。

校验与测试:输入校验需覆盖必填参数、订阅 GUID 格式、vault 类型归一化、枚举取值、空字符串与 ARM 资源 ID 解析。单元测试放在 tests/Azure.Mcp.Tools.AzureBackup.Tests/{Group}/,实时测试在 AzureBackupCommandTests.cs 中使用 [Fact] 与 CallToolAsync,长时 E2E 用 [LiveTestOnly],测试资源来自 DeploymentOutputs。录制流程包括设置 Record 模式、运行 dotnet test、用 .proxy\Azure.Sdk.Tools.TestProxy push 推送录制并更新 assets.json,再切回 Playback 验证。

CI 校验:依次执行 dotnet build、dotnet format --verify-no-changes、完整单元与实时测试、拼写检查 Invoke-Cspell.ps1、Build-Local.ps1 -VerifyNpx 与 -BuildNative(Azure Backup 标记 IsAotCompatible=true)。

工具描述评估与文档:运行 ToolDescriptionEvaluator,目标为 Top 3 且置信度 >= 0.4,不达标则改进 [CommandMetadata] 中的 Description。文档需更新 azmcp-commands.md、e2eTestPrompts.md、CHANGELOG.md,并运行 Update-AzCommandsMetadata.ps1 重新生成命令元数据。

限制:需 .NET 10 SDK、已配置 Azure 认证、从 upstream/main 创建分支;每个 PR 只包含一个工具;具体命令行为与参数细节以仓库内权威指南为准,资料未提供其他平台或收费信息。