Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 問題を使用して作業を追跡する
問題を使用して、プロジェクトでの作業を計画および追跡できます。各問題は、作業の一部であり、個別のレコードに保持されています。問題はタスクに分割され、その問題の作業をさらに整理して追跡できます。また、問題間のリンクを作成して、関連する作業の追跡、作業の整理と分類に役立つラベルの追加、問題のグループ化、作業の優先順位の割り当て、作業がブロックされているかどうかの表示に役立てることもできます。
問題や一連の問題に取り組む準備ができたら、作業を見積もってユーザーに割り当て、作業とその進行状況を他のユーザーが理解できるようなコメントを追加することができます。問題はエクスポートして、含まれる情報を他の形式に取り込むこともできます。
# CodeCatalyst で問題を作成する
開発チームは、作業を追跡および管理するために問題を作成します。プロジェクト内で、必要に応じて問題を作成できます。例えば、コード内の変数の更新を追跡する問題を作成できます。プロジェクト内の他のユーザーに問題を割り当てる、作業の追跡に役立つラベルを使用するなどが可能です。
CodeCatalyst で問題を作成する手順は次のとおりです。
**問題を作成するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. 問題を作成するプロジェクトに移動します。
1. プロジェクトのホームページで、**[問題の作成]** を選択します。または、ナビゲーションペインで **[問題]** を選択します。
1. **[問題の作成]** を選択します。
**注記**
グリッドビューを使用している場合は、問題をインラインで追加することもできます。
1. 問題のタイトルを入力します。
1. (オプション) **[説明]** を入力します。Markdown を使用して書式を追加できます。
1. (オプション) 問題の **[ステータス]**、**[優先度]**、**[見積もり]** を選択します。
**注記**
プロジェクトの見積り設定が **[見積りを非表示]** に設定されている場合、**[見積り]** フィールドは表示されません。
1. (オプション) 問題にタスクを追加します。タスクは、問題の作業を小さな目標に分解するために使用できます。タスクを追加するには、**[\$1 タスクの追加]** を選択します。次に、テキストフィールドにタスク名を入力し、Enter キーを押します。タスクを追加したら、チェックボックスをオンにして完了としてマークするか、チェックボックスの左側でタスクをクリックしてドラッグすることで順序を変更できます。
1. (オプション) 既存のラベルを追加するか、新しいラベルを作成し、**[\$1 ラベルを追加]** を選択して追加します。
1. 既存のラベルを追加するには、リストからラベルを選択します。フィールドに検索語を入力して、プロジェクト内のその語句を含むすべてのラベルを検索できます。
1. 新しいラベルを作成して追加するには、作成するラベルの名前を検索フィールドに入力し、Enter キーを押します。
1. (オプション) **[\$1 担当者を追加]** を選択して、担当者を追加します。**[\$1 自分を追加]** を選択すると、自分を担当者としてすばやく追加できます。
**ヒント**
**Amazon Q** に問題を割り当てることで、Amazon Q で問題の解決を試みることができます。詳細については、「[チュートリアル: CodeCatalyst の生成 AI 機能を使用して開発作業を高速化する](getting-started-project-assistance.md)」を参照してください。この機能は、米国西部 (オレゴン) リージョンでのみ利用可能です。
この機能を使用するには、スペースに対して生成 AI 機能を有効にする必要があります。詳細については、「[Managing generative AI features](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)」を参照してください。
1. (オプション) 既存の **[カスタムフィールド]** を追加するか、新しいカスタムフィールドを作成します。問題には、複数のカスタムフィールドを含めることができます。
1. 既存のカスタムフィールドを追加するには、リストからカスタムフィールドを選択します。フィールドに検索語を入力して、プロジェクト内のその語句を含むすべてのカスタムフィールドを検索できます。
1. 新しいカスタムフィールドを作成して追加するには、作成するカスタムフィールドの名前を検索フィールドに入力し、Enter キーを押します。次に、作成するカスタムフィールドのタイプを選択し、値を設定します。
1. **[問題の作成]** を選択します。右下隅に通知が表示されます。問題が正常に作成された場合、問題が正常に作成されたことを示す確認メッセージが表示されます。問題が正常に作成されなかった場合、失敗の理由を示すエラーメッセージが表示されます。その後、**[再試行]** を選択して問題を編集し、作成を再試行するか、**[破棄]** を選択して問題を破棄できます。どちらのオプションを選択した場合も、通知は解除されます。
**注記**
プルリクエストの作成時に、プルリクエストを問題にリンクすることはできません。ただし、作成した後に[問題を編集](issues-edit-issue.md)して、プルリクエストへのリンクを追加できます。
## Amazon Q に割り当てた問題を作成および処理する際のベストプラクティス
問題を作成すると、問題がなかなか解決されない場合があります。その原因は複雑でさまざまです。誰がその問題に取り組むべきかが明確でないことが原因である場合があります。また、問題によっては、コードベースの特定の部分に関する調査や専門知識が必要で、その作業に最適な担当者が他の問題で忙しいこともあります。他の緊急の作業が優先される場合もあります。こうした原因の 1 つまたはすべてが要因となり、問題が取り組まれない事態を招く可能性があります。CodeCatalyst には、Amazon Q と呼ばれる生成 AI アシスタントとの統合機能が組み込まれています。Amazon Q は、問題のタイトルとその説明に基づいて問題を分析できます。Amazon Q に問題を割り当てると、評価用のソリューションの試案を作成しようとします。これにより、すぐにリソースを割くことができない問題の解決には Amazon Q を活用しながら、自分やチームは注意が必要な問題に集中して取り組むことで最適化を図ることができます。
**注記**
**Amazon Bedrock を利用**: [自動不正検出](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html) AWS を実装します。Amazon Q Developer Agent for Software Development の「**説明を記述する**」、「**内容の要約を作成する**」、「**タスクを推奨する**」、「**Amazon Qを使用してプロジェクトに機能を作成または追加する**」、「**Amazon Q に問題を割り当てる**」機能は Amazon Bedrock を基盤に構築されているため、ユーザーは Amazon Bedrock に実装されている統制を最大限に活用して、AI の安全性、セキュリティ、責任ある使用を徹底することができます。
Amazon Q は、単純な課題や簡単な問題で優れたパフォーマンスを発揮します。最良の結果を得るには、何をしてもらいたいかを明確に説明する簡潔な表現を使用してください。以下は、Amazon Q が取り組むために最適化された問題を作成するためのベストプラクティスです。
**重要**
生成 AI 機能は、米国西部 (オレゴン) リージョンでのみ使用できます。
+ **シンプルにまとめる**。Amazon Q は、問題のタイトルと説明を見れば理解できる単純なコード変更や修正に最適です。あいまいなタイトルや飾りすぎた表現、矛盾する説明を含む問題を割り当てないでください。
+ **具体的に記述する**。問題を解決するために必要な変更についてより正確に多くの情報を提供できればできるほど、Amazon Q が問題の解決策を考案できる可能性が高くなります。可能であれば、変更する API の名前、更新するメソッド、変更が必要なテスト、その他考えられる詳細など、具体的な詳細を含めます。
+ **Amazon Q に割り当てる前に、問題のタイトルと説明にすべての詳細が含まれていることを確認してください**。Amazon Q に割り当てた後、問題のタイトルや説明を変更することはできません。そのため、Amazon Q に割り当てる前に、問題に必要なすべての情報が提供されていることを確認してください。
+ **1 つのソースリポジトリでのコード変更が必要な問題のみを割り当てる**。Amazon Q は、CodeCatalyst の 1 つのソースリポジトリのコードのみを処理できます。リンクされたリポジトリはサポートされていません。Amazon Q にその問題を割り当てる前に、問題が 1 つのソースリポジトリでの変更のみを必要とすることを確認してください。
+ **各ステップを承認するために、Amazon Q が推奨するデフォルトを使用する**。デフォルトでは、Amazon Q は実行する各ステップに対してユーザーの承認を必要とします。これにより、問題に関するコメントだけでなく、Amazon Q が作成するプルリクエストでも Amazon Q とやりとりできます。これにより、Amazon Q をよりインタラクティブに操作することができ、問題解決に向けた Amazon Q のアプローチを調整し、Amazon Q が作成したコードを改良できます。
**注記**
Amazon Q は、問題やプルリクエストに関する個々のコメントには応答しませんが、アプローチを再検討したり、リビジョンを作成したりするように求められると、レビューを行います。
+ **Amazon Q が提案するアプローチを必ず慎重にレビューする**。アプローチを承認すると、Amazon Q はそのアプローチに基づいてコードの生成作業を開始します。作業を進めるように Amazon Q に指示する前に、アプローチが適切かどうか、想定されるすべての詳細が含まれていることを確認してください。
+ **Amazon Q がワークフローで作業させる場合は、そのワークフローをレビューする前にデプロイする可能性のある既存のワークフローがないことを確認してください**。プロジェクトで、プルリクエストのイベントで実行を開始するようにワークフローが設定されている場合があります。その場合、Amazon Q が作成する、ワークフロー YAML の作成または更新を含むプルリクエストは、プルリクエストに含まれるワークフローの実行を開始する可能性があります。ベストプラクティスとして、Amazon Q がワークフローファイルを操作することを許可しないでください。許可する場合は、Amazon Q が作成したプルリクエストをレビューして承認する前に、これらのワークフローを自動的に実行するワークフローがプロジェクトにないことを確認してください。
詳細については、「[チュートリアル: CodeCatalyst の生成 AI 機能を使用して開発作業を高速化する](getting-started-project-assistance.md)」および「[Managing generative AI features](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)」を参照してください。
## 問題を見積もる
アジャイル開発では、*見積り*はストーリーポイントと呼ばれます。問題の見積もりを使用して、問題のあいまいさと複雑さのほかにも、必要な工数を表すことができます。リスク、難易度、不明点が多い問題については、見積りを高く設定することを検討してください。
問題の見積もりを開始する前に、まずプロジェクトに使用する見積りのタイプを選択する必要があります。デフォルトで、次の 2 つのタイプから選択できます。**[T シャツサイズ]** または **[フィボナッチ数列]** を効果的に使用するには、各サイズが何を表すのかについて、チーム内で合意する必要があります。各見積りがチームにとって何を表すかを一緒に決めた後、その見積りを各問題に適用し始めます。定期的なレビューを検討する
CodeCatalyst の問題にかかる工数の見積もりの設定を行う手順は次のとおりです。
**問題の工数の見積もりを設定するには**
1. ナビゲーションペインで、**[問題]** を選択します。
1. **[アクティブな問題]** を選択して **[問題ビューのスイッチャー]** ドロップダウンメニューを開き、**[設定]** を選択します。
1. **[基本設定]** セクションの **[見積もり]** で、見積もり値の表示方法を選択します。利用可能な見積りのタイプは、**[T シャツサイズ]**、**[フィボナッチ数列]**、または **[見積りの非表示]** です。プロジェクトの見積り設定が **[見積りを非表示]** に設定されている場合、プロジェクトの問題に **[見積り]** フィールドは表示されません。
見積もりタイプを更新すると、データは失われず、すべての問題の見積もり値が自動的に変換されます。次の表は、変換対応表です。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/issues-tracking-work.html)
問題の見積りを追加または変更するには、[問題を編集](issues-edit-issue.md)します。
# CodeCatalyst で問題の編集および共同作業を行う
**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)
# 問題を編集する
問題のタイトル、説明、ステータス、担当者、優先度、見積り、ラベルを編集する手順は次のとおりです。
**問題を編集するには**
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]** アイコンをクリックします。すべての問題からカスタムフィールドを削除すると、カスタムフィールドは削除され、フィルタリング時に表示されなくなります。
# 添付ファイルの使用
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. 添付ファイルを削除するには、削除する添付ファイルの横にある省略形メニューをクリックし、**[削除]** を選択します。
# 添付ファイルを表示および管理する
問題設定で、プロジェクトの問題に追加されたすべての添付ファイルを含む表を表示できます。この表には、各添付ファイルについて、コンテンツタイプ、追加日時、追加した問題とそのステータス、ファイルサイズなどの詳細が記載されています。
この表を使用すると、完了済みまたはアーカイブ済みの問題に添付された大きなファイルを簡単に特定して削除し、スペースのストレージ容量を解放できます。
**重要**
問題への添付ファイルは、Amazon CodeCatalyst によってスキャンも分析もされません。どのユーザーでも、悪意のあるコードやコンテンツが含まれている可能性がある添付ファイルを問題に追加することができます。添付ファイルの管理、そして悪意のあるコード、コンテンツ、ウイルスからの保護に関するベストプラクティスをユーザーに周知徹底してください。
**プロジェクト内のすべての問題の添付ファイルを表示および管理するには**
1. ナビゲーションペインで、**[問題]** を選択します。
1. 省略記号アイコンをクリックし、**[設定]** を選択します。
1. **[添付ファイル]** タブを選択します。
# 問題のタスクを管理する
*タスク*を問題に追加することで、その問題の作業をさらに分類、整理、トラッキングできます。タスクは自分で作成することも、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. タスクを削除するには、タスクの省略記号メニューを選択し、**[削除]** を選択します。
# 問題を別の問題にリンクする
問題が別の問題での作業に関連する場合は、リンクできます。これは、作業項目間の依存関係を理解し、追跡するための簡単な方法です。
問題をリンクする場合、次の 4 つの状態から選択できます。
+ 関連: この状態を使用して、リンクされた問題に関連する作業を示します。
+ ブロック元: この状態を使用して、問題がリンクされた問題によって進行を妨げられていることを示します。
+ ブロック先: この状態を使用して、問題がリンクされた問題の進行を妨げていることを示します。
+ 重複: この状態を使用して、問題が別の問題でキャプチャされた作業と重複していることを示します。
リンクを作成した後にその状態を変更することはできません。リンクとそのリンク状態は、リンクの作成元の問題とリンク先の問題の両方の **[リンクされた問題]** に表示されます。リンクは、作成後に削除することもできます。
**問題を別の問題またはタスクにリンクするには**
1. 別の問題にリンクする問題を開きます。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。
1. **[問題のリンク]** を選択します。
1. **[次としてマーク]** で、リンクの状態を選択します。
**[問題番号]** で、問題の番号を入力するか、ドロップダウンリストから選択します。
1. 別のリンクを追加するには、**[リンクされた問題の追加]** を選択します。
1. 完了したら、**[更新]** を選択して、問題とリンクされた関係を持つすべての問題を更新します。
# 問題をブロック状態またはブロック状態解除としてマークする
何かが原因で問題に取り組めない場合は、*ブロック状態*としてマークすることをお勧めします。例えば、問題が、まだマージされていないコードベースの別の部分への変更に依存している場合、問題がブロック状態に陥る可能性があります。
問題をブロック状態としてマークすると、バックログやアーカイブ、またはボードで目立つように、赤色の **[ブロック状態]** ラベルが問題に追加されます。
外部要因が解決されたら、問題のブロック状態を解除できます。
**問題をブロック状態としてマークするには**
1. ブロック状態としてマークする問題を開きます。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。
1. **[アクション]** を選択し、**[ブロック状態としてマーク]** を選択します。
**問題のブロック状態を解除するには**
1. ブロック状態を解除する問題を開きます。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。
1. **[アクション]** を選択し、**[ブロック状態解除済みとしてマーク]** を選択します。
# コメントを追加、編集、削除する
問題にコメントを残すことができます。コメントでは、他のスペースメンバー、スペース内の他のプロジェクト、関連する問題、コードをタグ付けできます。
**問題にコメントを追加するには**
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. 省略記号アイコンをクリックして **[削除]** を選択し、**[確認]** を選択します。
# コメントでメンションを使用する
スペースメンバー、スペース内の他のプロジェクト、関連する問題、コードをコメントでメンションできます。これにより、メンションしたユーザーまたはリソースへのクイックリンクが作成されます。
**コメントで @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. コメントを入力し終えたら、**[送信]** を選択します。
# 問題を検出して表示する
以下のセクションでは、CodeCatalyst プロジェクト内の問題を効果的に検索して表示する方法を説明します。
## 問題を検索する
特定のパラメータを検索することで、問題を見つけることができます。検索の絞り込みに関する詳細については、「[CodeCatalyst でコード、問題、プロジェクト、ユーザーを検索するコード、問題、プロジェクト、ユーザーを検索する](search.md)」を参照してください。
**問題を検索するには**
1. プロジェクトに移動します。
1. 検索バーを使用して、問題または問題に関連する情報を検索します。クエリパラメータを使用して検索を絞り込むことができます。詳細については、「[CodeCatalyst でコード、問題、プロジェクト、ユーザーを検索するコード、問題、プロジェクト、ユーザーを検索する](search.md)」を参照してください。
# 問題をソートする
デフォルトでは、CodeCatalyst の問題は **[手動順序]** でソートされます。手動順序では、問題がユーザーによって移動された順序で表示されます。手動順序でソートすると、問題をドラッグアンドドロップして順序を変更できます。このソートオプションは、問題のバックログを整理し、問題に優先順序を付ける際に役立ちます。
次の表は、グリッドビューとボードビューの両方で問題をソートする方法を示しています。
| グリッドビューのソートオプション | ボードビューのソートオプション |
| --- | --- |
| 手動順序 | 手動順序 |
| 最終更新日 | 最終更新日 |
| Priority | 優先度 |
| Estimate | 見積り |
| タイトル | タイトル |
| ID | |
| ステータス | |
| ブロック | |
| カスタム フィールド | |
問題のソート方法を変更する手順は次のとおりです。
**問題をソートするには**
1. プロジェクトに移動します。
1. ナビゲーションペインで、**[問題]** を選択します。デフォルトのビューは **[ボード]** です。
1. (オプション) **[アクティブな問題]** を選択して、**[問題ビューのスイッチャー]** ドロップダウンメニューを開き、別の問題ビューに移動します。
1. グリッドビューをソートするには、次の 2 つのオプションがあります。
1. ソート基準にするフィールドの **[ヘッダー]** を選択します。**[ヘッダー]** を選択すると、昇順と降順が切り替わります。
1. **[ソート基準]** ドロップダウンメニューを選択し、ソート基準として使用するパラメータを選択します。問題は昇順にソートされます。
1. ボードビューをソートするには、**[ソート基準]** ドロップダウンメニューを選択し、ソート基準として使用するパラメータを選択します。問題は昇順にソートされます。
# 問題をグループ化する
グループ化を使用すると、担当者、ラベル、優先度などの複数のパラメータによってボード上の問題を整理できます。
**問題をグループ化するには**
1. プロジェクトに移動します。
1. ナビゲーションペインで、**[問題]** を選択します。デフォルトのビューは **[ボード]** です。
1. (オプション) **[アクティブな問題]** を選択して、**[問題ビューのスイッチャー]** ドロップダウンメニューを開き、別の問題ビューに移動します。
1. **[グループ]** を選択します。
1. **[グループ化の基準]** で、グループ化の基準として使用するパラメータを選択します。
+ **[担当者]** または **[優先度]** を選択した場合は、**[グループ順序]** を選択します。
+ **[ラベル]** を選択した場合は、ラベルを選択して **[グループ順序]** を選択します。
1. (オプション) **[空のグループを表示]** トグルを選択すると、現在割り当てられている問題のないグループを表示または非表示にできます。
1. 選択を行うと、ビューが更新されます。問題は、設定されたパラメータに一致するグループにのみ表示されます。
# 問題をフィルタリングする
フィルタリングを使用すると、指定された名前、優先度、ラベル、カスタムフィールド、または担当者を含む問題を検索できます。
**問題をフィルタリングするには**
1. プロジェクトに移動します。
1. ナビゲーションペインで、**[問題]** を選択します。
1. (オプション) **[アクティブな問題]** を選択して、**[問題ビューのスイッチャー]** ドロップダウンメニューを開き、別の問題ビューに移動します。
**注記**
問題名または説明の文字列に基づいてフィルタリングするには、問題検索バーに文字列を入力します。
1. **[フィルター]** を選択し、**[\$1 フィルターを追加]** を選択します。
1. フィルター基準として使用するパラメータを選択します。複数のフィルターとパラメータを選択できます。フィルターを設定して、すべてのフィルターまたは個々のフィルターに一致する問題を表示するには、**[and]** または **[or]** を選択します。ビューが更新され、フィルターに一致する問題が表示されます。
# 問題を進行させる
どの問題にもライフサイクルがあります。CodeCatalyst では、問題は通常、バックログの下書きとして始まります。その問題に取り組み始めると、別のステータスカテゴリに移動し、完了するまでさまざまなステータスを経て、その後アーカイブされます。ライフサイクルを通じて問題を移動または進行させるには、次の方法があります。
+ バックログとボード間で問題を移動できます。
+ 進行中の問題を、さまざまな完了ステージに移動できます。
+ 完了した問題をアーカイブできます。
# バックログとボード間で問題を移動する
問題に取り組み始めたら、バックログからボードに問題を移動できます。作業が延期された場合は、問題をバックログに戻すこともできます。
**バックログとボード間で問題を移動するには**
1. プロジェクトに移動します。
1. ナビゲーションペインで、**[問題]** を選択します。デフォルトのビューは **[ボード]** です。
1. 問題をボードからバックログに移動するには:
1. 移動する問題を選択します。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。
1. ドロップダウンの **[ステータス]** メニューから **[バックログ]** を選択します。
1. 問題をバックログからボードに移動するには:
1. バックログに移動するには、**[ボード]** を選択し、**[バックログ]** を選択します。
1. 移動する問題を選択します。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。
1. **[ボードに追加]** を選択するか、**[バックログ]** 以外の**[ステータス]**を選択します。
# ボードでライフサイクルのステージを通じて問題を進行させる
ボード内の問題を、完了までさまざまなステータスに移動できます。
**ボード内で問題を移動するには**
1. ナビゲーションペインで、**[問題]** を選択します。デフォルトのビューは **[ボード]** です。
1. 次のいずれかを行います。
+ 問題を別のステータスにドラッグアンドドロップします。
+ 問題を選択し、ステータスドロップダウンメニューから **[ステータス]** を選択します。
+ 問題を選択し、**[*next-status* に移動]** を選択します。
問題のアーカイブについては、「[問題をアーカイブする](issues-archive-issues.md)」を参照してください。
# グループ間で問題を移動する
**[すべての問題]** ビューと **[ボード]** ビューで[問題をさまざまなパラメータでグループ化](issues-grouping.md)できます。問題がグループ化されている場合、あるグループから別のグループに移動できます。あるグループから別のグループへ問題を移動すると、ターゲットグループに一致するように問題のグループ化の基準となっているフィールドが自動的に編集されます。
シナリオの例として、CodeCatalyst を使用している会社で、Wang Xiulan と Saanvi Sarkar の 2 人に問題が割り当てられているとします。ボードは `Assignee` でグループ化されており、各担当者ごとに 1 つのグループ、つまり 2 つのグループがあります。Wang Xiulan グループから Saanvi Sarkar グループに問題を移行すると、問題の担当者が Saanvi Sarkar に更新されます。
# 問題をアーカイブする
**注記**
問題はプロジェクト内で削除されず、アーカイブされます。問題を削除するには、プロジェクトを削除する必要があります。
プロジェクトで不要になった問題はアーカイブできます。問題をアーカイブすると、アーカイブされた問題をフィルタリングするすべてのビューからその問題を削除します。アーカイブされた問題は、**[アーカイブされた問題]** のデフォルトビューで表示でき、必要に応じてアーカイブを解除できます。
次の場合に問題をアーカイブします。
+ 問題が完了し、**[完了]** 列に表示する必要がなくなった。
+ 取り組む予定がない。
+ 誤って作成した。
+ アクティブな問題の最大数に達した。
**問題をアーカイブするには**
1. アーカイブする問題を開きます。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。
1. **[アクション]**、**[アーカイブ]** の順に選択します。
1. (オプション) **[完了]** ステータスにある複数の問題をすばやくアーカイブするには、ボード上の **[完了]** ステータスの上部にある縦の省略記号をクリックし、**[問題をアーカイブ]** を選択します。
**問題をアーカイブ解除するには**
1. アーカイブを解除する問題を開きます。アーカイブされた問題のリストを表示するには、**[問題ビューのスイッチャー]** ドロップダウンメニューから **[アーカイブされた問題]** ビューを開きます。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。
1. **[アーカイブを解除]** を選択します。
# 問題をエクスポートする
現在のビューの問題を .xlsx ファイルにエクスポートできます。問題をエクスポートするには、次の手順を実行します。
**問題をエクスポートするには**
1. プロジェクトに移動します。
1. ナビゲーションバーで、**[問題]** を選択します。
1. **[アクティブな問題]** を選択して、**[問題ビューのスイッチャー]** ドロップダウンメニューを開き、エクスポートする問題を含むビューに移動します。ビューに表示される問題のみがエクスポートされます。
1. 省略記号メニューを選択し、**[Excel にエクスポート]** を選択します。
1. .xlsx ファイルをダウンロードします。デフォルトでは、プロジェクトの名前とエクスポートが完了した日付がタイトルになります。