> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/autofix-to/configure/autofix-pr-configuration.md). # AutoFix PRの設定 ## プルリクエスト設定 AutoFix のプルリクエストは、必要に応じて次の設定でカスタマイズできます。 [「PR Configuration」設定](https://app.aikido.dev/issues/fix/settings)。次の項目を変更できます： * **タイトルプレフィックス：** タイトルを社内プロセスに合わせてカスタマイズします * **ラベル：** PR に特定のラベルを追加して、整理と追跡をしやすくします * **ブランチ名：** AutoFix が作成するブランチのプレフィックスをカスタマイズします * **コミットメッセージ：** PR 内のコミットメッセージのプレフィックスをカスタマイズします * **概要：** 必要に応じて、各 PR に追加メッセージを含められます。たとえば、エンジニア向けのカスタム指示や追加のコンテキストを追加できます。 * **ドラフト PR を作成：** レビュー可能な状態ではなく、ドラフト PR を作成します。 * **PR を自動マージ：** Aikido はこの機能に GitHub、GitLab、Azure DevOps の標準の自動マージ機能を使用します。詳細はこちら [こちら](/docs/docs-ja/autofix-to/automation-and-merging/auto-merge-autofix-pull-requests.md). * **PR 用のタスクを作成：** コンプライアンス上重要です。これにより、接続済みのタスクトラッカーに新しいタスクが自動作成され、作成された PR にリンクされます。 {% hint style="info" %} Aikido は AutoFix PR のデフォルトレビュー担当者の設定をサポートしていません。適切な人がレビューするようにするには、リポジトリで CODEOWNERS と必須レビューを使用してください。See [AutoFix PR のデフォルトレビュー担当者の割り当て](/docs/docs-ja/autofix-to/faq/assigning-default-reviewers-for-autofix-prs.md). {% endhint %} ### プルリクエストとタスクのリンク AutoFix のプルリクエストをタスクにリンクする方法は 2 つあり、両方を同時に使用できます。
1. **既存タスクのリンク** PR で修正された issue のタスク識別子は、既定でブランチ名に含まれます。ワークスペースがタスクトラッカーと統合されている場合、PR はタスクトラッカーによって対応するタスクに自動的にリンクされます。 タスク参照プレースホルダー（`$TASK_REF` ）は次の [プルリクエスト設定](#pull-request-configuration) 項目で使用できます： * ブランチプレフィックス * コミットメッセージ * PR タイトル
2. **PR ごとに新しいタスクを作成** 各 AutoFix PR にタスクを作成すると、AutoFix PR のレビューやマージ担当者を割り当てるのに使えます。「*PR 用のタスクを作成*」を AutoFix 設定で有効にしてください。既存タスクとリンクされているかどうかにかかわらず、各 AutoFix PR ごとにタスクが作成されます。 **注意：** このオプションは現在、Jira と Jira DC でのみ利用できます。
## リポジトリ固有の設定 Aikido UI のグローバル AutoFix 設定は、Aikido ワークスペース内のすべてのリポジトリに適用されます。リポジトリ固有の設定を行うには、 `.aikido` リポジトリのルートにあるファイルを使用します。このファイルで指定した設定は、グローバル設定を上書きします。 たとえば、次の設定では： {% code title=".aikido" %} ```yaml autofix: single_pr_for_repo: true pr_config: branch_prefix: "aikido-" title_prefix: "Aikido " commit_prefix: "[fix] " labels: "security" draft_pr: false auto_merge: true create_task_for_pr: true task_title_prefix: "[AIK] " disable_codeowners_as_reviewers: true ``` {% endcode %} * リポジトリ内のすべての lockfile に対して 1 つの PR を作成します * ブランチ名は次で始まります `aikido-` * PR タイトルは次で始まります `Aikido` * コミットは次で始まります `[fix]` * PR にラベルがあります `security` * PR はドラフト PR ではありません * 必要な承認がそろうと、PR は SCM（例：GitHub）によって自動マージされます * PR 用のタスク（例：Jira）が作成されます * タスク（例：Jira）のタイトルは次で始まります `[AIK]` * *GitLab 固有：* CODEOWNERS は PR のレビュー担当者として追加されません 以下のセクションで各設定パラメータを詳しく説明します。 ### **ブランチプレフィックス** ブランチプレフィックスは、リポジトリごとに次を追加することで設定できます： `.aikido` リポジトリのルートにあるファイルに、次の内容を記述します： {% code title=".aikido" %} ```yaml autofix: pr_config: branch_prefix: "prefix-for-branch-" ``` {% endcode %} AutoFix は `branch_prefix` の値を、そのリポジトリのブランチ作成時に使用します。この例では、AutoFix は次のようなブランチを作成します： `prefix-for-branch-update-dependency-xyz`. で定義されたブランチプレフィックスは `.aikido` ファイルが、UI で設定したブランチプレフィックスより優先されます。 ### ブランチテンプレート AutoFix は、ブランチ名にランダムな識別子を追加して一意のブランチ名を作成します。このランダム識別子は、ブランチ命名規則に合わない場合があります。その場合は、ブランチテンプレートを使用してブランチ名の形式を完全に定義できます。 多くの組織では、これらのブランチ命名規則を使ってタスクとブランチのリンクを強制しています。次の設定により、AutoFix は特定のブランチ名を作成します： {% code title=".aikido" %} ``` autofix: pr_config: branch_template: fix/$TASK_REF ``` {% endcode %} その `$TASK_REF` は、プルリクエストで修正された issue にリンクされたタスクに置き換えられます。たとえば： `fix/AIK-1234` 単一タスクの場合、または `fix/AIK-1234-AIK-4567` 複数タスクの場合です。 もし `プルリクエスト用のタスクを作成` を有効にしている場合、自動作成されるタスク識別子がブランチ名で使用されます。 ブランチ形式が非常に厳格で、1 件のチケットしか許可しない場合は、 `$TASK_REF_0` を使用して、単一のタスク識別子のみを含めることができます。 ### プルリクエストタイトルのプレフィックス プルリクエストのタイトルプレフィックスは、リポジトリごとに次を追加することで設定できます： `.aikido` リポジトリのルートにあるファイルに、次の内容を記述します： {% code title=".aikido" %} ```yaml autofix: pr_config: title_prefix: "Title Prefix" ``` {% endcode %} AutoFix はプルリクエストのタイトルを次で始めます `Title Prefix` 。で定義されたタイトルプレフィックスは `.aikido` ファイルが、UI で設定したブランチプレフィックスより優先されます。 ### **コミットプレフィックス** コミットプレフィックスは、リポジトリごとに次を追加することで設定できます： `.aikido` リポジトリのルートにあるファイルに、次の内容を記述します： {% code title=".aikido" %} ```yaml autofix: pr_config: commit_prefix: "fix: " ``` {% endcode %} AutoFix は `commit_prefix` の値を、そのリポジトリのコミット作成時に使用します。この例では、AutoFix は次のようなコミットを作成します： `fix: package uuid を更新` で定義されたコミットプレフィックスは `.aikido` ファイルが、UI で設定したコミットプレフィックスより優先されます。 ### ラベル ラベルは、リポジトリごとに次を追加することで設定できます： `.aikido` リポジトリのルートにあるファイルに、次の内容を記述します： {% code title=".aikido" %} ```yaml autofix: pr_config: labels: "aikido,security" ``` {% endcode %} AutoFix は `labels` の値を、そのリポジトリのプルリクエスト作成時に使用します。この例では、AutoFix は両方の `aikido` および `security` ラベルをプルリクエストに追加します。 で定義されたラベルは `.aikido` ファイルが、UI で設定したラベルより優先されます。で定義された場合、 `.aikido` ファイルで定義した場合、UI で設定したラベルは省略されます。 ### ドラフト PR ドラフト PR は、リポジトリごとに次を追加することで設定できます： `.aikido` リポジトリのルートにあるファイルに、次の内容を記述します： {% code title=".aikido" %} ```yaml autofix: pr_config: draft_pr: true ``` {% endcode %} 上の例では、そのリポジトリのプルリクエストをドラフトとして作成します。 でのドラフト PR 設定は `.aikido` ファイルが、UI でのドラフト PR 設定より優先されます。 ### 自動マージ 自動マージは、リポジトリごとに次を追加することで設定できます： `.aikido` リポジトリのルートにあるファイルに、次の内容を記述します： {% code title=".aikido" %} ```yaml autofix: pr_config: auto_merge: true ``` {% endcode %} 上の例では、そのリポジトリでの自動マージを有効にします。 での自動マージ設定は `.aikido` ファイルが、UI での自動マージ設定より優先されます。 ### PR 用のタスクを作成 Aikido でプルリクエストが開かれると、AutoFix は issue トラッカーにタスクを自動作成します。\ これは、コンプライアンス基準で求められる是正の追跡可能性を維持するのに役立ちます。 タスク作成は、リポジトリごとに次を追加することで有効化または無効化できます： `.aikido` リポジトリのルートにあるファイルに、次の内容を記述します： {% code title=".aikido" %} ```yaml autofix: pr_config: create_task_for_pr: true ``` {% endcode %} 上の例では、そのリポジトリでのタスク作成が有効になります。での設定は `.aikido` ファイルが、UI の設定より優先されます。 ### タスクタイトルのプレフィックス 「PR 用のタスクを作成」を有効にすると、タスクタイトルのプレフィックスをリポジトリごとに次を追加して設定できます： `.aikido` リポジトリのルートにあるファイルに、次の内容を記述します： {% code title=".aikido" %} ```yaml autofix: pr_config: task_title_prefix: "[AIK] " ``` {% endcode %} この例では、PR 用に作成されたタスクが次で始まるようにします `[AIK]` そのリポジトリ内で。 での設定は `.aikido` ファイルが、UI の設定より優先されます。 ### レビュアーとしての CODEOWNERS を無効にする GitLab では、Aikido AutoFix は `CODEOWNERS` をマージリクエストのレビュー担当者として追加します（lockfile に対する CODEOWNERS が 10 人未満の場合）。この動作は、次を追加することで無効にできます： `.aikido` リポジトリのルートにあるファイルに、次の内容を記述します： {% code title=".aikido" %} ```yaml autofix: pr_config: disable_codeowners_as_reviewers: true ``` {% endcode %} ### lockfile ごとまたはリポジトリごとの AutoFix のグループ化 既定では、Aikido AutoFix は別々のプルリクエストを作成します **lockfile ごとに** リポジトリ内で。これにより、変更が分離され、標準的なプロジェクトではレビューしやすくなります。 1 つのチームが所有する lockfile が多いリポジトリでは、多数の個別 PR を受け取ると煩雑になることがあります。リポジトリごとに 1 つのプルリクエストを有効にすると、管理負荷と CI/CD の使用量を削減できます。 この動作を変更するには、次を追加します： `.aikido` リポジトリのルートにあるファイルに、次の内容を記述します： {% code title=".aikido" %} ```yaml autofix: single_pr_for_repo: true ``` {% endcode %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.aikido.dev/docs/docs-ja/autofix-to/configure/autofix-pr-configuration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.