SuperAPI AI 工具集

ado-resource-validator

部署与运维

查看项目

更新于 10-16 00:04

技能介绍

用途:在配置 Azure DevOps 集成时,校验 .env 中的项目、区域路径(area path)和团队是否存在,并对缺失资源提供自动创建或手动选择,保证配置有效。

主要能力:按策略校验资源。project-per-team 校验多个项目是否存在;area-path-based 校验单个项目及其区域路径,缺失时自动创建;team-based 校验单个项目及其团队,缺失时自动创建。支持按项目分别配置区域路径与团队(如 AZURE_DEVOPS_AREA_PATHS_Backend、AZURE_DEVOPS_TEAMS_Backend),命名约定为 {PROVIDER}{RESOURCE_TYPE}{PROJECT_NAME}。资源缺失时通过交互提示选择创建、选择已有、手动修正或取消,创建后自动更新 .env。项目创建为异步,会轮询等待状态变为 wellFormed。

必要用法:在 .env 中设置 AZURE_DEVOPS_PAT、AZURE_DEVOPS_ORG、AZURE_DEVOPS_STRATEGY 及对应策略变量。首次配置 ADO 集成、运行 /sw-ado:sync 发现资源缺失、.env 配置无效,或提到 ado setup、azure devops validation 时自动激活。也可手动触发校验,或通过 npx specweave init 在初始化时自动运行。

适用场景:微服务多项目组织、单体项目按区域路径组织、平台团队按团队组织,以及从单项目迁移到多项目等。

限制:依赖有效的 PAT 与组织权限;项目创建受 ADO 异步行为影响,存在超时可能;specweave validate-ado 为计划中的命令,暂未提供;其余未在资料中说明的功能、收费与平台信息暂未提供。