次の方法で共有


Azure Boardsの作業項目から Git 開発を推進する

Azure DevOps サービス |Azure DevOps Server |Azure DevOps Server 2022

ブランチ、コミット、プル要求、ビルドなどの開発オブジェクトに作業項目をリンクすることは、開発を推進し、チームの同期を維持するための強力な方法です。 作業項目から直接ブランチを作成することで、タスクとコード変更の間に明確な接続を確立できます。 開発が進むにつれて、プル要求とコミットをこれらの作業項目に関連付け、特定の作業を完了するために実行された操作の包括的な記録を確保できます。

ヒント

この記事の後半でAIを使用してこのタスクを支援することができます。また、作業を開始するには、Azure DevOps MCP ServerでAIサポートを有効にする方法を参照してください。

この記事では、新しいブランチを作成し、コミットへのリンクを追加し、Azure DevOpsでホストされている Git リポジトリでプル要求を管理する方法について説明します。 GitHubコミットと pull request を作業項目にリンクする手順については、「作業項目への GitHubコミットと pull request のリンクを参照してください。

ヒント

作業項目を Git コミット、pull request、ビルドなどにリンクする、自動リンクやその他の設定を行うことができます。 詳細については、次のリソースを参照してください。

開発コントロール

Development コントロールは、作業項目の完了に寄与するすべての Git 開発アクティビティを追跡します。 次の開発手順を実行するために必要な情報をチームに提供し、一般的なタスクを実行するための複数のナビゲーション アクションの必要性を最小限に抑えます。 さらに、作業項目に関連付けられているすべての関連ブランチ、コミット、プル要求、ビルドを表示して、開発プロセスを包括的に可視化することで、追跡可能性を高めます。

作業項目フォーム、[開発] コントロールのスクリーンショット。

Development コントロールから、作業項目にリンクされているブランチ、プル要求、コミットにすばやくアクセスできます。 また、作業項目から直接作成またはリンクしたブランチのプル要求を開始することもできます。

注記

Development コントロールは、Web ポータルの作業項目フォーム内でのみ使用できます。 Visual Studioまたはその他のサポートされているクライアントの作業項目追跡エクスペリエンスとフォームには、Web ポータルで使用できるいくつかの機能が表示されません。

前提条件

カテゴリ 必要条件
プロジェクトへのアクセス権 プロジェクト メンバー
Permissions 共同作成者 または プロジェクト管理者 グループのメンバー。
アクセス レベル - 作業項目を表示または変更するには、[このノードの作業項目を表示] と、[このノードの作業項目を編集] のアクセス許可を [許可]に設定します。 既定では、共同作成者グループにはこのアクセス許可が設定されています。 詳細については、「作業追跡のアクセス許可とアクセスを設定する」を参照してください。
アクセス レベル バックログを並べ替えるか予測ツールを使用するには、最低でも 基本 アクセスが必要です。 Stakeholderアクセス権を持つユーザーは、バックログ項目の順序を変更したり、予測ツールを使用したりすることはできません。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。
カテゴリ 必要条件
プロジェクトへのアクセス権 プロジェクト メンバー
Permissions 共同作成者 または プロジェクト管理者 グループのメンバー。
アクセス レベル - 作業項目を表示または変更するには、[このノードの作業項目を表示] と、[このノードの作業項目を編集] のアクセス許可を [許可]に設定します。 既定では、共同作成者グループにはこのアクセス許可が設定されています。 詳細については、「作業追跡のアクセス許可とアクセスを設定する」を参照してください。

ワークフロー プロセス

リンクされたコード成果物がない場合は、新しいブランチを作成することを検討してください。 ブランチが存在するが、pull request がない場合は、pull request の作成を検討してください。 Git リポジトリを使用する場合の一般的なワークフロー シーケンスを次に示します。

  1. ブランチを作成して作業項目の作業を開始します。 新しい Git ブランチは [開発] セクションから追加できます。

    開発コントロールのスクリーンショット、ブランチ作成リンク。

    ...または、フォームの [アクション] メニューから。

    スクリーンショットは、ユーザー ストーリー作業項目フォーム、アクション メニュー、新しいブランチの追加を示しています。

    ブランチに名前を付け、リポジトリを選択します。

    [ブランチの作成] ダイアログ ボックスを示すスクリーンショット。

    作成したブランチは作業項目に自動的にリンクされます。

    注記

    ブランチは、メイン ブランチにファイルを追加した後にのみ作成できます。main やその他の固有のラベルを付けることをお勧めします。 システムは、新しいプロジェクトごとに作成される初期リポジトリに、README ファイルを自動的に追加します。

    システムが作成したリポジトリとブランチを開きます。

  2. ファイルの編集は Web ポータル内で行えます。

    または、広範なファイル編集がある場合や、ファイルを追加する必要がある場合は、Visual Studioまたはその他のサポートされている IDE から作業します。 作成したブランチから新しいローカル ブランチを追加します。 詳細については、「fetch と pull を使用してコードを更新する」の「フェッチを使用して変更をダウンロードする」を参照してください。 (コードの編集とコミットプロセスは機能しますが、Visual Studioのエディションで最適に動作します)。

  3. 作成したブランチ内のファイルを追加または変更します。

    Visual Studioまたはその他のサポートされている IDE から、ローカル ブランチからリポジトリに変更をコミットしてプッシュします。

    変更のコミットとプッシュを示すスクリーンショット。

    新しいブランチから初めて変更をプッシュする場合、変更をプッシュする前にブランチを公開します。 詳細については、「push を使用してコードを共有する」を参照してください。

  4. 作業項目フォームから pull request を作成します。

    他のメンバーからレビューを受けるために、自分が加えた変更をメインブランチにマージするプルリクエストを作成してください。

    [開発コントロール] の [プル要求の作成] リンクを示すスクリーンショット。

  5. ビューがコードやプルリクエストページに切り替わります。 次に示すように、pull request の作成を完了します。

    コード ビューの Pull Request ページ。

    注記

    pull request を作成したら、前の pull request を完了するまで、同じブランチに対して新しい pull request を作成することはできません。

    [Pull Request]\(プル要求\) ページの [Create pull request]\(プル要求の作成\) を示すスクリーンショット。

    「マージ時に変更をスカッシュする」のチェックボックスをオンにし、マージを完了します。

    スクリーンショットは、[Pull Request の完了] ダイアログ ボックスを示しています。スカッシュ マージをオンにします。

  6. 完了すると、次のような画面が表示されます。

    プルリクエストが完了した通知を示すスクリーンショット。

  7. 作業項目フォームを開くか、フォームを更新し、[ 開発 ] セクションを展開します ( Maximize Development を選択します)。完了した操作をサポートするために追加されたリンクが表示されます。

作業項目フォーム、[開発] セクション、追加されたリンクのスクリーンショット。

複数の作業項目のブランチを作成する

作業項目を開かなくても、バックログまたはボードに一覧表示されている作業項目から新しい分岐を追加することもできます。 複数選択を使用すると、複数の作業項目を選択し、新しいブランチを作成できます。項目はすべてブランチにリンクされます。

たとえば、この例では、新しいブランチにリンクする最初の 5 つの項目を選択しています。

バックログから複数の項目を選択する画面のスクリーンショット (ブランチの作成リンク)。

さらに、ブランチの名前を指定します。

[新しいブランチの作成] ダイアログを示すスクリーンショット。

[開発] セクションに一覧表示されているすべての項目は、[ Links ] タブにも表示されます。[開発] セクションから開始されたすべての開発アクションは、 History タブにも記録されます。

[リンク] タブと開発リンクを示すスクリーンショット。

作業項目を既存のオブジェクトにリンクするには、[リンクの追加] [リンクの追加] アイコンを選択し、リンクの種類を選択します。

[リンクの追加] アイコンを選択し、リンクの種類を選択するスクリーンショット。

リンクを削除する場合は、 Development セクションでリンクを強調表示してから、[リンクの削除 ] を選択

[開発] セクション、リンクの削除を示すスクリーンショット。

または、 Links タブからそれを選択し、リンクの Actions を選択し、 Remove link オプションを選択します。

ビルド内の関連する作業項目

Git コミットでは、コミットにリンクされているすべての作業項目が、ビルドの概要ページの [関連付けられた作業項目] の下に一覧表示されます。

ビルドの概要ページの [関連付けられた作業項目] の下に表示される、リンクされた作業項目。

このセクションに示すリンクは、次のアクションのために表示されます。

  • 作業項目から、ブランチ、コミット、または pull request を作成する
  • コミット、pull request、またはその他のサポートされている Git または TFVC 操作中に、作業項目 ID を指定する
  • 具体的には、 Development セクションまたは Links タブから、ソース コードブランチ、ビルド、またはその他のサポートされている Git または TFVC 操作に作業項目をリンクします。

[開発] セクションの下に一覧表示されているエントリにカーソルを合わせると、関連付けられているオブジェクトへのハイパーリンクがアクティブになります。

開発セクション内で追加できるリンクの種類は、ブランチ、ビルド、変更セット、コミット、ビルドで発見、ビルドに統合、プルリクエスト、バージョン項目です。

ヒント

GitHubリポジトリでもYAMLパイプラインを使用する場合、「ビルドに統合」リンクの種類は機能します。 詳細については、「 YAML パイプラインのビルド状態を表示する」を参照してください。

アーティファクト間リンクの種類を示すスクリーンショット。

エージェント モードで Azure Boards MCP Server が AI エージェントに接続されている場合は、自然言語プロンプトを使用して、作業項目と開発オブジェクト間のリンクを管理できます。

Task プロンプトの例
作業項目を PR にリンクする Add a pull request link from user story #234 to pull request #567
リンクされた作業項目を検索する Show me all work items that have pull request links in the current sprint
開発の状態を確認する List all user stories in the 'Active' state that don't have any development links
作業項目のリンクを表示する Show me all links for work item #890, including commits and pull requests

注記

エージェント モードと MCP サーバーでは自然言語が使用されるため、これらのプロンプトを調整したり、フォローアップの質問をして結果を絞り込むことができます。