Azure DevOps 技能

列出项目、仓库、分支；创建拉取请求（Pull Request）；管理工作项；检查构建状态。

运行前请校验配置有效性，若缺少必要值则向用户询问！

必需配置项：

• AZURE_DEVOPS_PAT：个人访问令牌（Personal Access Token）
• AZURE_DEVOPS_ORG：组织名称

若 ~/.openclaw/openclaw.json 中缺失对应值，Agent 应执行以下操作：

1. 向用户询问 缺失的 PAT 和/或组织名称
2. 将它们存入 ~/.openclaw/openclaw.json 的 skills.entries["azure-devops"] 节点下

配置示例

{
  skills: {
    entries: {
      "azure-devops": {
        apiKey: "YOUR_PERSONAL_ACCESS_TOKEN",  // AZURE_DEVOPS_PAT
        env: {
          AZURE_DEVOPS_ORG: "YourOrganizationName"
        }
      }
    }
  }
}

命令

列出项目

curl -s -u ":${AZURE_DEVOPS_PAT}" \
  "https://dev.azure.com/${AZURE_DEVOPS_ORG}/_apis/projects?api-version=7.1" \
  | jq -r '.value[] | "(.name) - (.description // "No description")"'

列出项目中的仓库

PROJECT="YourProject"
curl -s -u ":${AZURE_DEVOPS_PAT}" \
  "https://dev.azure.com/${AZURE_DEVOPS_ORG}/${PROJECT}/_apis/git/repositories?api-version=7.1" \
  | jq -r '.value[] | "(.name) - (.webUrl)"'

列出仓库中的分支

PROJECT="YourProject"
REPO="YourRepo"
curl -s -u ":${AZURE_DEVOPS_PAT}" \
  "https://dev.azure.com/${AZURE_DEVOPS_ORG}/${PROJECT}/_apis/git/repositories/${REPO}/refs?filter=heads/&api-version=7.1" \
  | jq -r '.value[] | .name | sub("refs/heads/"; "")'

创建拉取请求

PROJECT="YourProject"
REPO_ID="repo-id-here"
SOURCE_BRANCH="feature/my-branch"
TARGET_BRANCH="main"
TITLE="PR Title"
DESCRIPTION="PR Description"

curl -s -u ":${AZURE_DEVOPS_PAT}" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "sourceRefName": "refs/heads/'"${SOURCE_BRANCH}"'",
    "targetRefName": "refs/heads/'"${TARGET_BRANCH}"'",
    "title": "'"${TITLE}"'",
    "description": "'"${DESCRIPTION}"'"
  }' \
  "https://dev.azure.com/${AZURE_DEVOPS_ORG}/${PROJECT}/_apis/git/repositories/${REPO_ID}/pullrequests?api-version=7.1"

获取仓库 ID

PROJECT="YourProject"
REPO_NAME="YourRepo"
curl -s -u ":${AZURE_DEVOPS_PAT}" \
  "https://dev.azure.com/${AZURE_DEVOPS_ORG}/${PROJECT}/_apis/git/repositories/${REPO_NAME}?api-version=7.1" \
  | jq -r '.id'

列出拉取请求

PROJECT="YourProject"
REPO_ID="repo-id"
curl -s -u ":${AZURE_DEVOPS_PAT}" \
  "https://dev.azure.com/${AZURE_DEVOPS_ORG}/${PROJECT}/_apis/git/repositories/${REPO_ID}/pullrequests?api-version=7.1" \
  | jq -r '.value[] | "#(.pullRequestId): (.title) [(.sourceRefName | sub("refs/heads/"; ""))] -> [(.targetRefName | sub("refs/heads/"; ""))] - (.createdBy.displayName)"'

注意事项

• 基础 URL：https://dev.azure.com/${AZURE_DEVOPS_ORG}
• API 版本：7.1
• 认证方式：使用空用户名 + PAT 作为密码的 Basic Auth
• 切勿在响应中记录或暴露 PAT
• 官方文档：https://learn.microsoft.com/en-us/rest/api/azure/devops/