Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# CodeCatalyst で問題の編集および共同作業を行う
<a name="issues-edit-collaborate-issue"></a>

**Contents**
+ [問題を編集する](issues-edit-issue.md)
+ [添付ファイルの使用](issues-attachments.md)
  + [添付ファイルを表示および管理する](issues-settings-attachments.md)
+ [問題のタスクを管理する](issues-tasks.md)
+ [問題を別の問題にリンクする](issues-link-issue.md)
+ [問題をブロック状態またはブロック状態解除としてマークする](issues-mark-as-blocked.md)
+ [コメントを追加、編集、削除する](issues-comment.md)
  + [コメントでメンションを使用する](issues-mentions-comment.md)

# 問題を編集する
<a name="issues-edit-issue"></a>

問題のタイトル、説明、ステータス、担当者、優先度、見積り、ラベルを編集する手順は次のとおりです。

**問題を編集するには**

1. 編集する問題を選択して、問題の詳細を表示します。問題の検索方法については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. 問題のタイトルを編集するには、タイトルを選択し、新しいタイトルを入力して Enter キーを押します。

1. 説明を編集するには、説明を選択し、新しい説明を入力して Enter キーを押します。Markdown を使用して書式を追加できます。

1. **[タスク]** では、問題のタスクを表示および管理できます。タスクがない場合は、Amazon Q に問題を分析させ、その問題を個別のタスクに分割し、各タスクをユーザーに割り当てることができるようタスクを提案させることができます。詳細については、「[問題のタスクを管理する](issues-tasks.md)」を参照してください。

1. **[ステータス]**、**[見積り]**、**[優先度]** を編集するには、それぞれのドロップダウンメニューからオプションを選択します。

1. **[ラベル]** では、既存のラベルの追加、新しいラベルの作成、ラベルの削除を行うことができます。

   1. 既存のラベルを追加するには、**[\$1 ラベルを追加]** を選択し、リストからラベルを選択します。フィールドに検索語を入力して、プロジェクト内のその語句を含むすべてのラベルを検索できます。

   1. 新しいラベルを作成して追加するには、**[\$1 ラベルを追加]** を選択し、検索フィールドに作成するラベルの名前を入力して Enter キーを押します。

   1. ラベルを削除するには、削除するラベルの横にある **[X]** アイコンをクリックします。すべての問題からラベルを削除すると、ラベルは問題の **[設定]** の**[ラベル]** セクションの **[未使用のラベル]** セクションに表示されます。フィルターを使用したり、問題にラベルを追加したりする際に、未使用のラベルはラベルのリストの末尾に表示されます。すべてのラベル (使用済みおよび未使用) の概要と、各ラベルを含む問題は、問題の **[設定]** で確認できます。

1. 問題を割り当てるには、**[担当者]** セクションで **[\$1 担当者を追加]** を選択し、リストから担当者を検索して選択します。**[\$1 自分を追加]** を選択すると、自分を担当者としてすばやく追加できます。

1. **[添付ファイル]** では、添付ファイルを追加、ダウンロード、削除できます。詳細については、「[添付ファイルの使用](issues-attachments.md)」を参照してください。

1. プルリクエストをリンクするには、**[プルリクエストをリンク]** を選択し、リストからプルリクエストを選択するか、URL または ID を入力します。プルリクエストのリンクを解除するには、リンク解除アイコンをクリックします。
**ヒント**  
問題にプルリクエストへのリンクを追加したら、リンクされたプルリクエストのリストでその ID を選択することで、問題にすばやく移動できます。プルリクエストの URL を使用して、問題ボードとは異なるプロジェクトにあるプルリクエストをリンクできますが、そのプロジェクトのメンバーであるユーザーのみがそのプルリクエストを表示する、またはそのプルリクエストに移動することができます。

1. (オプション) 既存のカスタムフィールドの追加および設定、新しいカスタムフィールドの作成、またはカスタムフィールドの削除を行います。問題には、複数のカスタムフィールドを含めることができます。

   1. 既存のカスタムフィールドを追加するには、リストからカスタムフィールドを選択します。フィールドに検索語を入力して、プロジェクト内のその語句を含むすべてのカスタムフィールドを検索できます。

   1. 新しいカスタムフィールドを作成して追加するには、作成するカスタムフィールドの名前を検索フィールドに入力し、Enter キーを押します。次に、作成するカスタムフィールドのタイプを選択し、値を設定します。

   1. カスタムフィールドを削除するには、削除するカスタムフィールドの横にある **[X]** アイコンをクリックします。すべての問題からカスタムフィールドを削除すると、カスタムフィールドは削除され、フィルタリング時に表示されなくなります。

# 添付ファイルの使用
<a name="issues-attachments"></a>

CodeCatalyst の問題に添付ファイルを追加することで、関連ファイルに簡単にアクセスできるようになります。問題の添付ファイルを管理する手順は次のとおりです。

問題に追加された添付ファイルのサイズは、スペースのストレージクォータにカウントされます。プロジェクトの添付ファイルの表示と管理については、「[添付ファイルを表示および管理する](issues-settings-attachments.md)」を参照してください。

**重要**  
問題への添付ファイルは、Amazon CodeCatalyst によってスキャンも分析もされません。どのユーザーでも、悪意のあるコードやコンテンツが含まれている可能性がある添付ファイルを問題に追加することができます。添付ファイルの管理、そして悪意のあるコード、コンテンツ、ウイルスからの保護に関するベストプラクティスをユーザーに周知徹底してください。

**添付ファイルを追加、ダウンロード、削除するには**

1. 添付ファイルを管理する問題を選択します。問題の検索方法については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. 添付ファイルを追加するには、**[ファイルのアップロード]** を選択します。オペレーティングシステムのファイルエクスプローラーで目的のファイルに移動し、選択します。**[開く]** を選択して添付ファイルとして追加します。添付ファイルのサイズ上限などのクォータ情報については、「[CodeCatalyst の問題のクォータ](issues-quotas.md)」を参照してください。

   添付ファイルの名前とコンテンツタイプには、次の制限があります。
   + ファイル名では、次の文字は使用できません。
     + 制御文字: `0x00–0x1f` および `0x80–0x9f`
     + 予約文字: `/`、`?`、`<`、`>`、`\`、`:`、`*`、`|`、`"`
     + Unix 予約ファイル名: `.` および `..`
     + 末尾のピリオドとスペース
     + Windows 予約ファイル名: `CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, and LPT9`
   + 添付ファイルのコンテンツタイプは、次のメディアタイプのパターンに従う必要があります。

     ```
     media-type = type "/" [tree "."] subtype ["+" suffix]* [";" parameter];
     ```

     例えば、`text/html; charset=UTF-8`。

1. 添付ファイルをダウンロードするには、ダウンロードする添付ファイルの横にある省略記号メニューをクリックし、**[ダウンロード]** を選択します。

1. 添付ファイルの URL をコピーするには、URL をコピーする添付ファイルの横にある省略記号メニューをクリックし、**[URL のコピー]** を選択します。

1. 添付ファイルを削除するには、削除する添付ファイルの横にある省略形メニューをクリックし、**[削除]** を選択します。

# 添付ファイルを表示および管理する
<a name="issues-settings-attachments"></a>

問題設定で、プロジェクトの問題に追加されたすべての添付ファイルを含む表を表示できます。この表には、各添付ファイルについて、コンテンツタイプ、追加日時、追加した問題とそのステータス、ファイルサイズなどの詳細が記載されています。

この表を使用すると、完了済みまたはアーカイブ済みの問題に添付された大きなファイルを簡単に特定して削除し、スペースのストレージ容量を解放できます。

**重要**  
問題への添付ファイルは、Amazon CodeCatalyst によってスキャンも分析もされません。どのユーザーでも、悪意のあるコードやコンテンツが含まれている可能性がある添付ファイルを問題に追加することができます。添付ファイルの管理、そして悪意のあるコード、コンテンツ、ウイルスからの保護に関するベストプラクティスをユーザーに周知徹底してください。

**プロジェクト内のすべての問題の添付ファイルを表示および管理するには**

1. ナビゲーションペインで、**[問題]** を選択します。

1. 省略記号アイコンをクリックし、**[設定]** を選択します。

1. **[添付ファイル]** タブを選択します。

# 問題のタスクを管理する
<a name="issues-tasks"></a>

*タスク*を問題に追加することで、その問題の作業をさらに分類、整理、トラッキングできます。タスクは自分で作成することも、Amazon Q を使用して、問題の分析とその複雑さに基づいてタスクを提案させることもできます。

Amazon Q Developer は、生成 AI を活用した会話アシスタントであり、 AWS アプリケーションの理解、構築、拡張、運用に役立ちます。構築を加速するために AWS、Amazon Q を強化するモデルは、より完全で実用的な参照された回答を生成するために、高品質の AWS コンテンツで強化されています。詳細については、「Amazon Q Developer ユーザーガイド」の「[What is Amazon Q Developer?](https://docs.aws.amazon.com/amazonq/latest/aws-builder-use-ug/what-is.html)」を参照してください。

**問題のタスクを管理するには**

1. タスクを管理する問題を選択します。問題の検索方法については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. **[タスク]** では、問題のタスクを表示および管理できます。

   1. タスクを追加するには、テキストフィールドにタスク名を入力し、Enter キーを押します。

   1. 問題にタスクがない場合は、**[タスクを推奨する]** を選択して、Amazon Q に問題を分析させ、問題のタイトル、説明、問題の複雑さの分析とリポジトリコードに基づいてタスクを作成することができます。問題のコードを含むソースリポジトリを指定する必要があります。**[タスク推奨分析を開始する]** を選択して、タスク推奨分析を開始します。このダイアログは閉じます。推奨が完了したら、**[推奨タスクを表示]** を選択してタスクを確認し、タスクの削除やリストへの追加、推奨タスクの順序変更など、必要なアクションを実行してから、**[タスクの作成]** を選択します。

      タスクが作成されたら、ユーザーに割り当てることができ、手動で作成したタスクと同じ方法で操作できます。

   1. タスクを完了としてマークするには、タスクのチェックボックスをオンにします。

   1. タスクの詳細を表示または更新するには、リストからタスクを選択します。

   1. タスクの順序を変更するには、チェックボックスの左側でタスクを選択してドラッグします。

   1. タスクを削除するには、タスクの省略記号メニューを選択し、**[削除]** を選択します。

# 問題を別の問題にリンクする
<a name="issues-link-issue"></a>

問題が別の問題での作業に関連する場合は、リンクできます。これは、作業項目間の依存関係を理解し、追跡するための簡単な方法です。

問題をリンクする場合、次の 4 つの状態から選択できます。
+ 関連: この状態を使用して、リンクされた問題に関連する作業を示します。
+ ブロック元: この状態を使用して、問題がリンクされた問題によって進行を妨げられていることを示します。
+ ブロック先: この状態を使用して、問題がリンクされた問題の進行を妨げていることを示します。
+ 重複: この状態を使用して、問題が別の問題でキャプチャされた作業と重複していることを示します。

リンクを作成した後にその状態を変更することはできません。リンクとそのリンク状態は、リンクの作成元の問題とリンク先の問題の両方の **[リンクされた問題]** に表示されます。リンクは、作成後に削除することもできます。

**問題を別の問題またはタスクにリンクするには**

1. 別の問題にリンクする問題を開きます。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. **[問題のリンク]** を選択します。

1. **[次としてマーク]** で、リンクの状態を選択します。

   **[問題番号]** で、問題の番号を入力するか、ドロップダウンリストから選択します。

1. 別のリンクを追加するには、**[リンクされた問題の追加]** を選択します。

1. 完了したら、**[更新]** を選択して、問題とリンクされた関係を持つすべての問題を更新します。

# 問題をブロック状態またはブロック状態解除としてマークする
<a name="issues-mark-as-blocked"></a>

何かが原因で問題に取り組めない場合は、*ブロック状態*としてマークすることをお勧めします。例えば、問題が、まだマージされていないコードベースの別の部分への変更に依存している場合、問題がブロック状態に陥る可能性があります。

問題をブロック状態としてマークすると、バックログやアーカイブ、またはボードで目立つように、赤色の **[ブロック状態]** ラベルが問題に追加されます。

外部要因が解決されたら、問題のブロック状態を解除できます。

**問題をブロック状態としてマークするには**

1. ブロック状態としてマークする問題を開きます。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. **[アクション]** を選択し、**[ブロック状態としてマーク]** を選択します。

**問題のブロック状態を解除するには**

1. ブロック状態を解除する問題を開きます。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. **[アクション]** を選択し、**[ブロック状態解除済みとしてマーク]** を選択します。

# コメントを追加、編集、削除する
<a name="issues-comment"></a>

問題にコメントを残すことができます。コメントでは、他のスペースメンバー、スペース内の他のプロジェクト、関連する問題、コードをタグ付けできます。

**問題にコメントを追加するには**

1. プロジェクトに移動します。

1. ナビゲーションバーで、**[問題]** を選択します。

1. コメントを追加する問題を選択します。問題の検索方法については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. **[コメント]** フィールドにコメントを入力します。Markdown を使用して書式を追加できます。

1. **[送信]** を選択します。

**コメントを編集するには**

問題に対して行ったコメントを編集できます。編集できるのは、自分が作成したコメントのみです。

1. プロジェクトに移動します。

1. ナビゲーションバーで、**[問題]** を選択します。

1. コメントを編集する問題を選択します。問題の検索方法については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. コメントを編集するには、編集するコメントを見つけます。
**ヒント**  
コメントは、古い順または新しい順で並べ替えることができます。コメントは一度に 10 個読み込まれます。

1. 省略記号をクリックし、**[編集]** を選択します。

1. コメントを編集します。Markdown を使用して書式を追加できます。

1. **[保存]** を選択します。コメントが更新されました。

**コメントを削除するには**

問題に対して行ったコメントを削除できます。削除できるのは、自分が作成したコメントのみです。コメントを削除すると、元のコメントテキストの代わりに、*[このコメントは削除されました]* という文言と共にユーザー名が表示されます。

1. プロジェクトに移動します。

1. ナビゲーションバーで、**[問題]** を選択します。

1. コメントを削除する問題を選択します。問題の検索方法については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. 省略記号アイコンをクリックして **[削除]** を選択し、**[確認]** を選択します。

# コメントでメンションを使用する
<a name="issues-mentions-comment"></a>

スペースメンバー、スペース内の他のプロジェクト、関連する問題、コードをコメントでメンションできます。これにより、メンションしたユーザーまたはリソースへのクイックリンクが作成されます。

**コメントで @mention を使用するには**

1. プロジェクトに移動します。

1. ナビゲーションバーで、**[問題]** を選択します。

1. 編集する問題を選択して、問題の詳細を表示します。問題の検索方法については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. **[コメントの追加]** テキストボックスを選択します。

1. 他のユーザーをメンションするには、「`@user_name`」と入力します。

1. プロジェクトをメンションするには、「`@project_name`」と入力します。

1. 別の問題をメンションするには、「`@issue_name`」または「`@issue_number`」と入力します。

1. ソースリポジトリ内の特定のファイルまたはコードをメンションするには、「`@file_name`」と入力します。
**注記**  
入力時に「`@mention`」に一致する用語を含む上位 5 つの項目 (ユーザー、ソースリポジトリ、プロジェクトなど) のリストが表示されます。

1. メンションする項目を選択します。項目がどこにあるかを示す経路がコメントテキストボックスに入力されます。

1. コメントを入力し終えたら、**[送信]** を選択します。