用途:ado-sync 是 SpecWeave 中面向 Azure DevOps(ADO)同步的帮助与指导技能,用于解答如何设置 ADO 同步、配置凭据以及排查同步问题。它本身不执行同步,实际同步需直接使用 /sw-ado:sync 等命令,且该技能不应在命令被调用时自动激活。
主要能力:默认双向同步 SpecWeave 增量与 ADO 工作项;从增量创建 ADO 工作项;将任务进度同步为 ADO 评论;根据 ADO 状态变更更新增量状态;拉取 ADO 评论与字段更新;增量完成时关闭工作项;支持 Epic、Feature、User Story 类型。
使用方式:需先安装 ADO 插件,可用 /plugin list --installed | grep sw-ado 检查,用 /plugin install sw-ado@specweave 安装。创建 Azure DevOps 个人访问令牌(PAT),作用域为 Work Items(读写)与 Comments(读写),并设置环境变量 export AZURE_DEVOPS_PAT="your-token-here"。在 .specweave/config.json 中配置 externalPM,包含 tool、enabled、organization、project、workItemType、areaPath、syncOnTaskComplete 等字段。可用命令包括 /sw-ado:create-workitem <increment-id>、/sw-ado:sync <increment-id>、/sw-ado:close-workitem <increment-id>、/sw-ado:status <increment-id>。任务完成钩子与 /sw:done 可触发自动同步。
适用场景:需要将 SpecWeave 增量与 Azure DevOps 工作项统一跟踪的团队,包括手动同步、状态查询与自动进度更新。
限制:双向同步需配置 webhook 或轮询;ADO 存在速率限制(每 PAT 每分钟 200 请求、每小时突发 5000 请求),建议在配置中启用限流。PAT 应存放于环境变量或 gitignore 的 .env 文件,避免提交到 git 或通过聊天工具共享。资料未提供价格、平台支持范围等更多信息。