Azure DevOps工作项插件
用于使用Azure CLI管理Azure DevOps工作项、板、积压和冲刺的Claude Code插件(az devops).
为什么是这个插件？
此插件使用官方Azure CLI azure-devops 扩展而不是Microsoft MCP服务器，后者存在已知的稳定性问题。Azure CLI为Azure DevOps API提供了一个可靠、记录良好的接口。
先决条件
1.Azure命令行界面
安装Azure CLI：
2.Azure DevOps扩展
为Azure CLI安装Azure DevOps扩展：
az extension add --name azure-devops3.身份验证
登录到Azure：
az login或者使用个人访问令牌（PAT）：
az devops login4.配置默认值
设置默认组织和项目：
az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG project=YOUR_PROJECT验证配置：
az devops configure --list安装
来自克劳德插件市场
claude plugin marketplace add ms-ado-az来自当地来源
claude plugin install /path/to/ado可用命令
设置和状态
| 命令 | 描述 |
|---|---|
/ado:setup | 配置Azure DevOps CLI身份验证和默认值 |
/ado:status | 检查当前配置并测试连接 |
工作项
| 命令 | 描述 |
|---|---|
/ado:items:show | 按ID显示工作项的详细信息 |
/ado:items:create | 创建新的工作项（bug、任务、用户故事等） |
/ado:items:update | 更新现有工作项 |
/ado:items:query | 使用WIQL查询工作项 |
/ado:items:search | 跨工作项的全文搜索 |
/ado:items:link | 将工作项链接在一起（父/子、相关等） |
/ado:items:comments | 查看工作项并添加注释 |
板子
| 命令 | 描述 |
|---|---|
/ado:boards:list | 列出团队的公告板 |
/ado:boards:columns | 获取板列配置 |
/ado:boards:card-rules | 查看板卡样式规则 |
积压工作
| 命令 | 描述 |
|---|---|
/ado:backlogs:list | 列出团队的待办事项 |
/ado:backlogs:items | 获取待办事项列表中的项目 |
短跑
| 命令 | 描述 |
|---|---|
/ado:sprints:list | 列出团队迭代/冲刺 |
/ado:sprints:capacity | 查看团队冲刺能力 |
/ado:sprints:days-off | 查看团队冲刺休息日 |
区域和迭代
| 命令 | 描述 |
|---|---|
/ado:areas-iterations:list-areas | 列出项目区域路径 |
/ado:areas-iterations:list-iterations | 列出项目迭代路径 |
/ado:areas-iterations:assign-team | 为团队分配区域或迭代 |
可用技能
技能为复杂操作提供参考文件和指导：
| 技能 | 描述 |
|---|---|
wiql-queries | 构建并执行WIQL（工作项查询语言）查询 |
wit-invoke | 通过以下方式调用Azure DevOps REST API az devops invoke |
hierarchy-tree | 从父/子工作项数据构建ASCII树可视化 |
work-item-fields | 工作项字段、链接类型和状态的参考 |
代理
该插件包括一个用于交互式工作项管理的AI代理：
ado-work-items 代理
Azure DevOps工作项助手，可以：
- 查询和搜索工作项
- 创建和更新工作项
- 管理董事会和待办事项
- 处理冲刺和容量
- 与区域和迭代合作
使用以下命令启动代理：
/agent ado-work-items例子
查询我的未完成任务
/ado:items:query然后要求：“显示分配给我的所有未完成的任务”
创建Bug
/ado:items:create然后提供：键入“Bug”，标题“登录按钮无响应”，优先级1
查看Sprint容量
/ado:sprints:capacity然后指定团队和冲刺迭代。
故障排除
检查状态
跑 /ado:status 验证：
- 已安装Azure CLI
- Azure DevOps扩展已存在
- 已配置默认组织和项目
- 与Azure DevOps的连接正在发挥作用
常见问题
- “az：找不到命令” -Azure CLI未安装或未在PATH中
- “未安装以下扩展：azure devops” -快跑
az extension add --name azure-devops - “请运行‘az login’来设置帐户” -快跑
az login鉴定 - “TF401019:项目不存在” -检查项目名称是否正确（区分大小写）
- “TF400813:资源不可用” -验证组织URL格式是否为
https://dev.azure.com/orgname
重新验证
az account clear
az login
az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG project=YOUR_PROJECT许可证
MIT许可证-请参阅 许可证 了解详情。
作者
约书亚·拉米雷斯