home / skills / ntaksh42 / agents / azure-test-plans

azure-test-plans skill

/.claude/skills/azure-test-plans

This skill helps you manage Azure Test Plans by creating test cases, suites, and executions to streamline QA workflows.

npx playbooks add skill ntaksh42/agents --skill azure-test-plans

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
2.5 KB
---
name: azure-test-plans
description: Create and manage Azure Test Plans including test cases, suites, and execution. Use when setting up test plans or managing QA processes.
---

# Azure Test Plans Skill

Azure Test Plansでテスト管理を行うスキルです。

## 主な機能

- **テストケース作成**: 手動・自動テスト
- **テストスイート**: グループ化
- **テスト実行**: 結果記録
- **バグ報告**: テスト失敗からバグ作成

## テストケース作成

### REST API (Python)

```python
import requests
import json

organization = "myorg"
project = "MyProject"
pat = "your-pat"

url = f"https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/$Test Case?api-version=7.0"

headers = {
    "Content-Type": "application/json-patch+json",
    "Authorization": f"Basic {pat}"
}

test_case = [
    {
        "op": "add",
        "path": "/fields/System.Title",
        "value": "ログイン機能のテスト"
    },
    {
        "op": "add",
        "path": "/fields/Microsoft.VSTS.TCM.Steps",
        "value": "<steps><step id='1'><parameterizedString>1. ログインページを開く</parameterizedString><expectedResult>ログインフォームが表示される</expectedResult></step><step id='2'><parameterizedString>2. メールアドレスとパスワードを入力</parameterizedString></step><step id='3'><parameterizedString>3. ログインボタンをクリック</parameterizedString><expectedResult>ダッシュボードにリダイレクトされる</expectedResult></step></steps>"
    },
    {
        "op": "add",
        "path": "/fields/Microsoft.VSTS.TCM.AutomatedTestName",
        "value": "LoginTests.TestSuccessfulLogin"
    }
]

response = requests.post(url, headers=headers, data=json.dumps(test_case))
print(response.json())
```

## テストスイート作成

```bash
# テストプラン作成
az boards test-plan create \
  --name "Sprint 1 Tests" \
  --area-path "MyProject" \
  --iteration "MyProject\\Sprint 1"

# テストスイート作成
az boards test-suite create \
  --plan-id 1 \
  --name "Login Tests" \
  --suite-type "StaticTestSuite"
```

## 自動テスト統合

```yaml
# Azure Pipeline with Test Results
steps:
  - task: VSTest@2
    inputs:
      testSelector: 'testAssemblies'
      testAssemblyVer2: |
        **\*test*.dll
        !**\*TestAdapter.dll
        !**\obj\**
      searchFolder: '$(System.DefaultWorkingDirectory)'
      codeCoverageEnabled: true
      testRunTitle: 'Automated Tests'
      publishRunAttachments: true
```

## バージョン情報
- Version: 1.0.0

Overview

This skill helps create and manage Azure Test Plans including test cases, suites, and test execution. It supports creating manual and automated test cases, organizing suites, running tests, and creating bug work items from failures. Use it to standardize QA workflows and integrate automated test results into Azure DevOps pipelines.

How this skill works

The skill interacts with Azure DevOps REST APIs and Azure CLI to create test plans, suites, and work items. It can post JSON-patch payloads to create Test Case work items, provision static or requirement-based test suites, and trigger test runs or publish results via pipeline tasks. It also maps failing test results to bug creation for triage and tracking.

When to use it

  • Setting up test plans and suites for a new sprint or release
  • Creating or importing manual and automated test cases programmatically
  • Integrating automated test runs and publishing results from pipelines
  • Generating bug work items automatically from failed test executions
  • Standardizing QA processes across teams using Azure DevOps

Best practices

  • Define clear, reusable test steps and expected results in each test case
  • Group related cases into static or requirement suites to reflect scope
  • Use PATs (personal access tokens) with least privileges for API calls
  • Publish test run attachments and code coverage from pipelines for traceability
  • Automate bug creation only when failure context is sufficient to reproduce

Example use cases

  • Create a test plan and multiple static suites for Sprint 1 via az CLI
  • Programmatically add manual test cases with step definitions using REST API
  • Wire automated test assemblies into an Azure Pipeline to publish results
  • Automatically open bug work items when smoke tests fail in CI
  • Export test cases for review or migrate cases between projects

FAQ

Can I create automated test cases via the API?

Yes. Include automated test metadata fields (for example AutomatedTestName) when creating Test Case work items so they map to your automation framework.

How do I publish test results from pipelines?

Use the VSTest or Publish Test Results tasks in Azure Pipelines to run tests and publish TRX results and attachments back to Azure Test Plans.