关于 ado
ado 是通过 ado CLI 执行 Azure DevOps 任务的技能，涵盖拉取请求、工作项和配置档案；变更前必须先检查状态，并先查询信息而非猜测标识符。
主要功能
- 01检查拉取请求和差异
- 02创建和管理拉取请求
- 03检查和管理工作项
- 04选择并查看配置档案
- 05变更前先读取状态
适用场景
- 01审查或评论拉取请求
- 02创建或更新工作项
- 03处理 CLI 配置档案或设置问题
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/ado确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/commands.mdsetup.mdworkflows.md详细介绍
激活契约
当任务涉及 Azure DevOps 时加载：拉取请求（审查、投票、评论、差异、创建、串联）、工作项（列出、获取、更新、创建）或配置文件。所有操作都使用 ado CLI。
硬性规则
- 每项操作都通过
adoCLI（ado <group> <sub>）执行。每个操作使用一条命令。 - 修改前先检查：在执行
vote、comment、update、create、chain前，先读取 PR/WI 状态。 - 切勿臆造 ID、仓库或分支名称——先通过读取命令查明。
[repo]为可选参数；省略后可按 ID 自动查找 PR。指定仓库会选择列出该仓库的配置文件；--profile <name>可覆盖此设置。- 只传入命令列出的标志：未知标志会报错（并给出“你是不是想用”提示）。使用
ado <group> <cmd> --help检查。 - 对于较长或多行正文：将其写入文件，并传入
--comment-file <path>（pr comment、pr reply、wi comment、wi update）。
决策关卡
| 需求 | 命令组 |
|---|---|
| 配置／尚未设置／“no profile” 或身份验证错误 | ado init、ado config、ado show → 参阅 references/setup.md |
| 启用／禁用或限制工作项创建 | 编辑 .adoconfig.toml 中的 [work_item.create] → 参阅 references/setup.md |
| 查看或切换配置文件 | ado profile · ado profile use <name> |
| 检查 PR | ado pr get/context/threads/diff/file |
| 操作 PR | ado pr vote/comment/reply/create/chain |
| 检查工作项 | ado wi get/list/related/types |
| 操作工作项 | ado wi update/comment/create/create-child |
执行
- 确认上下文：运行
ado profile（如果当前配置文件有误，则运行ado profile use）。 - 读取目标：例如
ado pr context <prId>或ado wi get <id>。 - 使用一条修改命令执行操作；将
--comment/--state/等作为标志传入。 - 原样报告 CLI 输出；向用户指出任何错误行。
参考资料
references/commands.md— 完整命令列表、标志、示例和错误处理。references/workflows.md— 任务指南：审查 PR、创建／更新工作项、创建 PR 或串联 PR、查找待处理工作。references/setup.md— 安装、ado init、配置文件／PAT，以及.adoconfig.toml规则（包括是否启用ado wi create、允许的类型和必填字段）。
对于设置相关请求（“配置 ado”、“设置 CLI”、“no profile／身份验证失败”、“允许／禁止创建工作项”）：先阅读 references/setup.md。
评论
支持 Markdown