次の方法で共有


プロジェクトの要約ページを表示および更新する

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

各プロジェクトには、情報を共有し、最新のプロジェクト アクティビティを紹介するための要約またはホーム ページが用意されています。 このページは、チーム メンバーがプロジェクトの進捗状況に関する最新情報を常に把握するための中心的なハブとして機能します。 このページは、次のタスクに使用します。

  • 重要なプロジェクトの更新情報とお知らせを共有する
  • 最近のアクティビティとマイルストーンを強調表示する
  • 主要なプロジェクト リソースとドキュメントへの迅速なアクセスを提供する
  • チームのコラボレーションとコミュニケーションを促進する

プロジェクトの要約ページを使用して、より具体的なタスクも実行します。

プロジェクト管理者のタスク

プロジェクト メンバーのタスク

  • 簡略なプロジェクトの説明を追加する
  • プロジェクト情報の README ファイルまたは Wiki を選択する
  • プロジェクトを共同作成するユーザーを招待する
  • プロジェクト タグを設定する
  • プロジェクト情報を表示する
  • プロジェクト アクティビティを表示する
  • プロジェクトをお気に入りに追加する
  • チーム メンバーにメールを送信またはチャットを開始する
  • プロジェクト全体で検索を開始する
  • プロジェクト情報を表示する
  • チーム メンバーにメールを送信またはチャットを開始する
  • プロジェクト アクティビティを表示する

Note

ホストされているプロジェクトを [非公開] または [公開] と指定できます。 パブリック プロジェクトの場合、匿名ユーザーは メンバー セクションを除き、プロジェクト 要約 を表示できます。 また、[いいね!] と [お気に入り] アイコンは匿名ユーザーには表示されません。 詳細については、「公開プロジェクトとは」を参照してください。

要約ページのスクリーンショット。

ヒント

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

前提条件

カテゴリ 必要条件
Permissions [プロジェクト管理者] グループのメンバーまたは [プロジェクト レベルの情報の編集] 権限が [許可] に設定されている必要があります。これにより、次のタスクを実行できます。
- プロジェクト ページの情報を編集します。
- プロジェクト情報の共有に使用するリポジトリを変更します。
- プロジェクト メンバーシップを管理します。
特定のタスク:
- プロジェクト ページを編集するには: リポジトリまたはブランチの寄稿者であるか、投稿アクセス権が[許可]に設定されている必要があります。
- プロジェクトの概要を表示するには: プロジェクトの有効なメンバーである必要があります。
- プロジェクト タグを追加または編集するには:プロジェクト レベルの [プロパティの管理] 権限を [許可] に設定します。 このアクセス許可により、プロジェクトのプロパティ REST API を制御します。

ヒント

ページの編集や機能の使用に必要なアクセス許可がない場合、対応するアイコンとリンクは表示されません。

プロジェクトの要約を開く

Web ブラウザーで、[概要] または [サマリー] を選択します。 プロジェクトがまだない場合は、プロジェクトを作成します。

プロジェクトの要約がまだ設定されていない場合は、ウェルカム ページが表示されます。

スクリーンショットは、プロジェクトのウェルカム ページを示しています。

作業を開始するには、次のいずれかを選択してください。

  • プロジェクトへの他のユーザーの追加を開始するように招待します。 組織に追加された ユーザーのみを招待できます。
  • 作業項目の追加を開始するためのボード。
  • リポジトリを複製またはインポートすることができるリポジトリファイルページを開くか、プロジェクト概要ページのためにREADMEファイルを初期化します。
  • パイプラインを定義するためのパイプライン。
  • テスト計画とテストスイートの定義を開始します。
  • [サービスの管理]。1 つ以上のサービスの可視性を無効にします。

要約ページを更新する

要約ページには、プロジェクト リポジトリで定義されている README ファイルまたはプロジェクト Wiki のホーム ページが表示されます。 プロジェクト Wiki ホーム ページを使用するには、プロジェクトの wiki を作成し、プロジェクトの要約ページが Wiki を指すように変更できます。

  1. ページを編集します。

    • 初めてページを編集する場合は、[プロジェクトの説明の追加] を選択します。
      初回編集時の要約ページのスクリーンショット。

    • ページを初めて編集しない場合は、プロジェクト情報の編集 を選択します。 このアイコンは、プロジェクトの [概要] ページを編集する権限を持つメンバーにのみ表示されます。

  2. プロジェクトの目的の簡単な説明を [説明] ボックスに入力します。

    [このプロジェクトについて] ダイアログ。

  3. (省略可能)プロジェクトに 1 つ以上のタグを追加します。 これらのタグは、作業項目タグに似ています。 コンマ区切り記号またはセミコロン区切り記号を使用して、一度に複数のタグを追加できます。 タグは、次の規則に準拠している必要があります。

    • タグは 40 文字以下にする必要があります
    • タグにスラッシュ (/) 文字または末尾にハイフン文字 (-) を含めることはできません。
    • プロジェクトに追加できるタグは 15 個以下です
    • タグでは大文字と小文字が区別されず、重複するタグや空のタグは使用できません。

    Note

    検索関数とフィルター関数を使用して、プロジェクト タグの検索やフィルター処理をすることはできません。

  4. [概要] ページの残りのコンテンツについて、README ファイルまたはプロジェクト Wiki ホーム ページを参照するかどうかを選択します。

    ヒント

    既定の README は、プロジェクトの作成時に追加されたリポジトリ内に作成されます。 この README を選択するか、この目的で別のリポジトリと README ファイルを作成できます。

    Readme ファイルを選択する場合は、README のリポジトリを選択します。 README ファイルの現在のテキストのプレビューが表示されます。

    このプロジェクト ダイアログについて、README リポジトリを選択します。

    Wiki を選択した場合、Wiki ホーム ページが参照され、Wiki TOC 内の最初のファイルである必要があります。 その参照を変更することはできません。

  5. 参照先の README ファイルまたは wiki の内容を更新するには、対応するファイルを編集します。 詳細については、「リポジトリの README を作成する」または「wiki ページを追加および編集する」を参照してください。

    概要ページには、次の種類の情報を含めてみてください。

    • ユーザーがプロジェクトに貢献できる方法
    • アクセス許可を昇格する、または拡張機能を追加する際の連絡先
    • ロードマップ情報
    • 開発環境とテスト環境を設定するための手順へのリンク
    • コードでの共同作業、作業の追跡、パイプラインの構築、リリースのデプロイに関する手順へのリンク
    • バグ、問題、または要求を提出するためのテンプレートへのリンク
    • Slack または Teams チャネルに質問をメールで送信したり、質問を投稿したりするための配信リストへのリンク。

プロジェクトに共同作成者を招待する

[招待] を選択して、プロジェクトに投稿するユーザーを招待する電子メールを送信します。 詳細については、「ユーザーまたはグループをチームまたはプロジェクトに追加する、要約ページからユーザーを招待する」を参照してください。

[要約] ページ、[招待] ボタンのスクリーンショット。

Note

Azure DevOps Serverでは、すべての電子メール アクションで、SMTP サーバーを構成する必要があります

プロジェクト アクティビティを表示する

[プロジェクトの統計] または [アクティビティ] セクションでは、過去 1 日、7 日間、または 30 日間にプロジェクトに対して行われた更新を表示できます。 次の画像に示すように、表示オプションを選択します。

[要約] ページの [統計] セクションのスクリーンショット。

プロジェクト メンバーとチャットするか、メールを送信する

[メンバー] セクションでは、プロジェクトに追加されたメンバーの一部を確認し、メールまたはメンバーとのチャットを介してメンバーに接続できます。

[要約] ページの [メンバー] セクションのスクリーンショット。

Note

100 以上は、100 以上のメンバーがプロジェクトに追加されることを示します。

チャット セッションをメールで送信または開始するには、表示されているチーム メンバーを選択し、オプションを選択します。

[要約] ページ、[メンバー] セクション、チーム メンバーとつながるために使用できるオプションのスクリーンショット。

Note

オンプレミスのAzure DevOpsでは、すべての電子メール アクションに SMTP サーバーを構成する必要があります

プロジェクトを検索する

[概要] ページから、コード、作業項目、Wiki の検索を開始できます。 詳細については、「AzCopy の概要」を参照してください。

[要約] ページの検索ボックスのスクリーンショット。

Git リポジトリの README ファイルを初期化する

プロジェクトと目標、チーム メンバーがプロジェクト README ファイルを使用してプロジェクトを共同作成する方法を共有できます。 Git プロジェクトの場合、README.md ファイルは、既定のブランチ内の各リポジトリのルートにある必要があります。 Git ベースのプロジェクトの場合、左側のウィンドウでは他のリポジトリへのナビゲーションがサポートされています。 リポジトリごとに個別のウェルカム ページと README.md ファイルを作成できます。

  1. Repos>Files を開きます。 このページでは、リポジトリのクローン、プッシュ、インポート、初期化のいずれかのオプションを選択するときに、リポジトリにコードを追加して、すぐに作業を開始する方法について説明します。

  2. [README の追加] チェック ボックスがオンになっている状態で、[初期化] を選択します。

    最新バージョンの README ファイルの [初期化] のスクリーンショット

    既定の README ファイルがプロジェクト リポジトリ (この場合は Fabrikam テスト リポジトリ) に追加されます。

  3. 概要に戻り、プロジェクトページのREADMEファイルを選択します。 「編集」を選択します。

    README ファイルを選択したときのスクリーンショット。

  4. README ファイルを初期化したプロジェクト リポジトリを選択します。

    README ファイルが存在する [リポジトリを選択する] のスクリーンショット。

  5. README ファイルを編集するには、README ファイルのリンクを選択します。

    [README ファイルを編集する] のスクリーンショット。

    README ファイルの Repos>Files ページに移動します。 README Markdown ファイルは、Git リポジトリ内の他のファイルと同様に編集および変更できます。 Markdown 言語を使用して README ファイルの書式を設定し、画像を追加できます。 詳細については、「リポジトリの README を作成する」と「Markdown ガイダンス」を参照してください。

TFVC リポジトリの README ファイルを初期化する

バージョン管理用に TFVC を選択したプロジェクトの場合、README.md ファイルはチーム プロジェクト フォルダーのルート ($/TeamProject/README.md など) にある必要があります。

  1. Repos > Files を開きます。

  2. [プロジェクトの説明の追加] を選択します。

    ウェルカム ページ、TFVC の新しいプロジェクト、readme の作成のスクリーンショット。

  3. TFVC リポジトリを選択し、[保存] を選択します。 リポジトリに README ファイルがない場合は、次のメッセージが表示されます。

    [このプロジェクトについて] のダイアログのスクリーンショット。

  4. README ファイルを作成するには、Repos>Files を選択し、新しいファイルを選択してプロジェクト リポジトリにファイルを追加します。

  5. ファイルに README.md という名前を付けます。

    [新しいファイルを追加する] のダイアログのスクリーンショット。

  6. README ファイルの内容を Markdown 形式で追加し、[チェックイン...] を選択します。

    [README ファイルの内容を入力する] のスクリーンショット。

  7. [チェックイン] を選択して、README ファイルのチェックイン プロセスを完了します。

    [README ファイルをチェックインする] のダイアログのスクリーンショット。

  8. [概要]を選択して、README ファイルを表示し、プロジェクトの概要ページを見直します。

    README ファイルが表示されたプロジェクトの要約ページのスクリーンショット。

AI を使用してプロジェクトの概要ページを管理する

ヒント

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

GitHub Copilotを使用する場合、Azure DevOps MCP Server は、自然言語プロンプトを使用してプロジェクトの概要ページを設定および管理するのに役立ちます。

プロジェクトの概要管理のプロンプトの例

Task プロンプトの例
プロジェクト README を作成する Generate a README for my Azure DevOps project that includes sections for project overview, architecture diagram placeholder, getting started guide, team contacts, and links to our wiki and CI/CD pipelines
プロジェクト アクティビティの監査 Show me the recent activity for my project including the latest commits, pull requests, and work item changes so I can prepare a status update for our weekly standup
新メンバーを迎え入れる I need to invite 5 new developers to my Azure DevOps project with Contributor access. Walk me through adding them and point me to the key resources they should review on the summary page
プロジェクト タグとメタデータを設定する Configure project tags for our microservices project so it's discoverable by other teams. Add tags for the technology stack, team name, and business domain
プロジェクト間でプロジェクトの正常性を比較する I manage four Azure DevOps projects. Help me check the summary pages and recent activity for each to identify which ones are active and which might need attention
プロジェクトの検出可能性を向上させる Our organization has 30+ projects and teams can't find what they need. Help me update project descriptions, README files, and tags to make projects easier to discover and understand

ヒント

最適な結果を得るには、Azure DevOps MCP サーバーが接続されているエージェント モードでこれらのプロンプトを使用します。 特定のプロジェクト名、チームの詳細、またはドキュメントの目標を使用してプロンプトをカスタマイズします。

REST API

  • プロジェクト プロパティを取得する
  • プロジェクト プロパティを設定する