用途:校验 Azure DevOps 配置与资源,确保 .env 中的项目、区域路径、团队真实存在,缺失时可自动创建并回写配置。
主要能力:按 AZURE_DEVOPS_STRATEGY 识别三种策略——project-per-team(校验多个项目)、area-path-based(校验一个项目下的多个区域路径)、team-based(校验一个项目下的多个团队);支持按项目分别配置区域路径与团队(如 AZURE_DEVOPS_AREA_PATHS_Backend、AZURE_DEVOPS_TEAMS_Backend)。资源缺失时提供交互选项:创建缺失资源、选择已有资源、手动修正名称或取消。创建项目时因 ADO 异步行为会轮询等待项目进入 wellFormed 状态。
使用方式:在首次配置 ADO 集成、运行 /sw-ado:sync 发现资源缺失、.env 配置无效,或提到“ado setup”“azure devops validation”时自动激活。也可手动触发校验,或通过 TypeScript 调用 validateAzureDevOpsResources()。必要配置包括 AZURE_DEVOPS_PAT、AZURE_DEVOPS_ORG、AZURE_DEVOPS_STRATEGY 及对应策略变量。
适用场景:微服务多项目组织、单体应用按区域路径划分、平台团队按团队划分,以及从单项目迁移到多项目等。
限制:资料未提供具体收费、价格与平台支持范围;部分 CLI 命令(如 specweave validate-ado)标注为计划中,尚未提供;自动创建依赖 PAT 权限与 ADO REST API v7.0,项目创建存在超时可能。