# アイテムを自動的に追加する

プロジェクトの組み込みワークフローを構成して、フィルターに一致するリポジトリからアイテムを自動的に追加できます。

## アイテムの自動追加について

プロジェクトの組み込みワークフローを構成して、リポジトリで作成または更新された新しいアイテムを自動的に追加するようにすることができます。 フィルターを定義して、条件を満たすアイテムのみを追加することができます。 また、複数の自動追加ワークフローを作成することもできます。各ワークフローには固有のフィルターを設定し、異なるリポジトリをターゲットにすることができます。

自動追加ワークフローを有効にするときに、条件に一致する既存のアイテムは追加されません。 このワークフローでは、作成または更新されたアイテムがフィルターと一致する場合に、そのアイテムを追加します。 アイテムの手動での追加の詳細については、「[アイテムをプロジェクトに追加する](/ja/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project#bulk-adding-issues-and-pull-requests)」を参照してください。

自動追加ワークフローでは、フィルターのサブセットがサポートされています。 ワークフローを構成するときに、次のフィルターを使用できます。

| 修飾子        | 指定できる値                            |
| ---------- | --------------------------------- |
| `is`       | open、closed、merged、draft、issue、pr |
| `label`    | "ラベル名"                            |
| `reason`   | 完了、再開、｢未計画｣                       |
| `assignee` | GitHub ユーザー名                      |
| `no`       | ラベル、担当者、理由                        |

`no` 以外のすべてのフィルターでは、否定がサポートされます。 たとえば、`-label:bug` を使用して、"bug" ラベルのないイシューを追加できます。

自動追加ワークフローはプランごとで制限されています。

| 製品                       | 自動追加ワークフローの最大数 |
| ------------------------ | -------------- |
| GitHub Free              | 1              |
| GitHub Pro               | 5              |
| GitHub Team              | 5              |
| GitHub Enterprise Cloud  | 20             |
| GitHub Enterprise Server | 20             |

## プロジェクトでの自動追加ワークフローの構成

1. プロジェクトにアクセスします。

2. 右上の <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="The menu icon" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg> をクリックして、メニューを開きます。

   ![プロジェクトのメニュー バーを示すスクリーンショット。 メニュー アイコンがオレンジ色の枠線で囲まれています。](/assets/images/help/projects-v2/open-menu.png)

3. メニューで、**\[<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-workflow" aria-label="workflow" role="img"><path d="M0 1.75C0 .784.784 0 1.75 0h3.5C6.216 0 7 .784 7 1.75v3.5A1.75 1.75 0 0 1 5.25 7H4v4a1 1 0 0 0 1 1h4v-1.25C9 9.784 9.784 9 10.75 9h3.5c.966 0 1.75.784 1.75 1.75v3.5A1.75 1.75 0 0 1 14.25 16h-3.5A1.75 1.75 0 0 1 9 14.25v-.75H5A2.5 2.5 0 0 1 2.5 11V7h-.75A1.75 1.75 0 0 1 0 5.25Zm1.75-.25a.25.25 0 0 0-.25.25v3.5c0 .138.112.25.25.25h3.5a.25.25 0 0 0 .25-.25v-3.5a.25.25 0 0 0-.25-.25Zm9 9a.25.25 0 0 0-.25.25v3.5c0 .138.112.25.25.25h3.5a.25.25 0 0 0 .25-.25v-3.5a.25.25 0 0 0-.25-.25Z"></path></svg> Workflows]** をクリックします。

4. \[既定のワークフロー] リストで、 **\[プロジェクトへの自動追加]** または以前に複製した自動追加ワークフローのいずれかをクリックします。

5. ワークフローの編集を開始するには、右上にある **\[Edit]** をクリックします。

   ![ワークフロー メニュー バーを示すスクリーンショット。 \[編集\] ボタンがオレンジ色の四角形で強調表示されています。](/assets/images/help/projects-v2/workflow-start-editing.png)

6. \[Filters] で、そこから項目を追加するリポジトリを選択します。

7. 項目が自動的にプロジェクトに追加される前に一致させたいフィルター条件を、リポジトリの選択の横に入力します。

8. 新しいワークフローを有効にするには、 **\[Save and turn on workflow]** をクリックします。

## 自動追加ワークフローの複製

プランで定義されている最大数まで、自動追加ワークフローの複製をさらに作成できます (この記事の前出の表を参照)。 ワークフローごとに異なるリポジトリを対象にできます。 各ワークフローのフィルターが一意である場合、複数のワークフローで同じリポジトリをターゲットにすることができます。

ワークフローを複製したら、 **\[編集]** をクリックして変更を開始できます。 詳細については、「[プロジェクトでの自動追加ワークフローの構成](#configuring-the-auto-add-workflow-in-your-project)」を参照してください。

1. プロジェクトにアクセスします。

2. 右上の <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="The menu icon" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg> をクリックして、メニューを開きます。

   ![プロジェクトのメニュー バーを示すスクリーンショット。 メニュー アイコンがオレンジ色の枠線で囲まれています。](/assets/images/help/projects-v2/open-menu.png)

3. メニューで、**\[<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-workflow" aria-label="workflow" role="img"><path d="M0 1.75C0 .784.784 0 1.75 0h3.5C6.216 0 7 .784 7 1.75v3.5A1.75 1.75 0 0 1 5.25 7H4v4a1 1 0 0 0 1 1h4v-1.25C9 9.784 9.784 9 10.75 9h3.5c.966 0 1.75.784 1.75 1.75v3.5A1.75 1.75 0 0 1 14.25 16h-3.5A1.75 1.75 0 0 1 9 14.25v-.75H5A2.5 2.5 0 0 1 2.5 11V7h-.75A1.75 1.75 0 0 1 0 5.25Zm1.75-.25a.25.25 0 0 0-.25.25v3.5c0 .138.112.25.25.25h3.5a.25.25 0 0 0 .25-.25v-3.5a.25.25 0 0 0-.25-.25Zm9 9a.25.25 0 0 0-.25.25v3.5c0 .138.112.25.25.25h3.5a.25.25 0 0 0 .25-.25v-3.5a.25.25 0 0 0-.25-.25Z"></path></svg> Workflows]** をクリックします。

4. ワークフローの一覧で \[プロジェクトへの自動追加] の横にある \[<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="kebab-horizontal" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>] をクリックします。

   ![ワークフローの一覧を示すスクリーンショット。 自動追加ワークフローの横にある省略記号ボタンがオレンジ色の四角形で強調表示されています。](/assets/images/help/projects-v2/workflow-add-menu.png)

5. メニューで **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-copy" aria-label="duplicate" role="img"><path d="M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z"></path><path d="M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z"></path></svg> ワークフローを複製** をクリックします。

6. 新しいワークフローを保存するには、プロンプトが表示されたときに、新しいワークフローに使う名前を入力します。

## 参考資料

* [プロジェクト からのアイテムのアーカイブ](/ja/issues/planning-and-tracking-with-projects/managing-items-in-your-project/archiving-items-from-your-project)
* [組み込みの自動化機能を使用する](/ja/issues/planning-and-tracking-with-projects/automating-your-project/using-the-built-in-automations)