用途:在命令行中管理 Azure DevOps(VSTS)的项目、工作项与已保存查询,兼容 dev.azure.com 和 *.visualstudio.com,认证方式为以邮箱作用户名、PAT 作密码的 basic 认证。
前提条件:需已安装 orbit CLI,可通过 brew install jorgemuza/tap/orbit 或 curl -sSfL https://raw.githubusercontent.com/jorgemuza/orbit/main/install.sh | sh 安装;需在 ~/.config/orbit/config.yaml 配置 azure-devops 服务;PAT 需具备相应范围(工作项读写、项目读取)。配置中可设置 base_url、proxy: none、auth 的 method/username/password,以及 options.default_project 以省去每次传 --project。
主要能力:命令格式为 orbit -p <profile> ado <command> [flags],支持 -o json 与 -o yaml 结构化输出。命令组包括 project(列出组织项目)、work-item(简写 wi,查看、列出、创建、更新、评论工作项)、query(运行和列出已保存查询)、version(验证连通性并显示已认证用户)。工作项列表支持 --project、--type、--state、--assigned-to、--max-results 等过滤参数以自动构建 WIQL,也可用 --wiql 传入原始查询;创建和更新使用 --field Key=Value 传字段,更新内部使用 replace;评论应使用 wi comment -m "..." 而非 wi update --field "System.History=...",以避免状态被规则静默重置。常用字段包括 System.Title、System.State、System.WorkItemType、System.AssignedTo、System.Description、System.AreaPath、System.IterationPath、System.Tags、Microsoft.VSTS.Common.Priority/Severity/ResolvedReason 等。WIQL 与 SQL 类似,字段名用方括号、字符串用单引号、当前用户 @Me、不等于 <>、始终 FROM WorkItems。
限制:所有请求使用 api-version=7.1,创建和更新内部使用 application/json-patch+json 格式。PAT 可在配置中引用 1Password(op://vault/item/field)或 Infisical(infisical://<env>/<path>/<KEY>),运行时经 orbit auth 解析。资料未提供收费、价格、平台支持范围或效果数据。