用途:为 Azure MCP 工具集新增命令/工具,提供从脚手架到 PR 提交的分阶段工作流,每个阶段设有必须通过的检查点。
主要能力:区分新增到现有工具集与创建新工具集(Phase 0);按顺序创建 Options、Command、Service、测试等文件;区分需要订阅的 Azure 服务命令与不需要订阅的命令(CLI 包装、文档、最佳实践工具),前者需继承 SubscriptionCommand 并注入 ISubscriptionResolver,后者继承 BaseCommand。
安全要求:所有工具输入视为不可信。需按目标 Azure 资源的具体命名规则校验输入(如存储账户名 3–24 位小写字母数字),使用 ValidateOptions 处理长度、格式、互斥与允许值;禁止记录 {@Options} 等原始选项对象,只记录已知安全字段;禁止将未校验输入拼接进 URL、shell 命令或查询;端点校验优先使用 IAzureService 或注入 IEndpointValidator,外部已知主机用 EndpointValidator.ValidateExternalUrl,任意用户目标用 ValidatePublicTargetUrl;创建资源时显式设置安全默认值(禁用公网访问、强制 HTTPS 与 TLS 1.2+、优先托管标识与 RBAC),降级行为需具名选项显式开启;异步调用须传递 CancellationToken;上下文不明确时失败关闭。
使用方式:按 Phase 0 创建目录结构并注册项目与工具集,运行 pwsh eng/scripts/Update-Solutions.ps1 -All,在 {Toolset}Setup.cs 注册单例,随后实现命令并满足各阶段检查点。
限制:资料未提供具体安装命令、收费与平台信息;部分内容(如 Phase 1 后续步骤)在给定资料中被截断,暂未提供完整细节。