> 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 設定

## プルリクエストの設定 <a href="#pull-request-configuration" id="pull-request-configuration"></a>

AutoFix のプルリクエストは、ニーズに合わせて設定できます。 [「PR Configuration」設定](https://app.aikido.dev/issues/fix/settings)。次の項目を変更できます:

* **タイトルのプレフィックス:** タイトルを社内のプロセスに合うようにカスタマイズします
* **ラベル:** PR に特定のラベルを追加して、分類と追跡をしやすくします
* **ブランチ名:** AutoFix が作成するブランチのプレフィックスをカスタマイズします
* **コミットメッセージ:** PR 内のコミットメッセージのプレフィックスをカスタマイズします
* **概要:** 各 PR に追加メッセージを任意で含められます。たとえば、エンジニア向けのカスタム指示や追加の背景情報を追加できます。
* **ドラフト PR を作成:** レビュー準備済みではなく、ドラフト PR を作成します。
* **PR を自動マージ:** この機能は、組み込みの GitHub、GitLab、Azure DevOps の自動マージ機能に依存します。詳しくはこちら [こちら](/docs/docs-ja/autofix-to/automation-and-merging/auto-merge-autofix-pull-requests.md).
* **PR のタスクを作成:** コンプライアンス上の理由で重要です。これにより、接続済みのタスクトラッカーに新しいタスクが自動作成され、作成された PR にリンクされます。

その `$TASK_REF` プレースホルダーは、PR のタイトル、ブランチ名、コミットメッセージで使用して [タスクを PR にリンクする](/docs/docs-ja/autofix-to/configure/linking-tasks-and-prs.md).

{% hint style="info" %}
AutoFix は PR のデフォルトレビュワーの設定をサポートしていません。適切な人がレビューするように、CODEOWNERS とリポジトリ上の必須レビューを使用してください。こちらを参照: [AutoFix PR にデフォルトレビュワーを割り当てる](/docs/docs-ja/autofix-to/faq/assigning-default-reviewers-for-autofix-prs.md).
{% endhint %}

## リポジトリ固有の設定

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
    self_approve_pr: true
```

{% endcode %}

* リポジトリ内のすべてのロックファイルに対して 1 つの PR を作成します
* ブランチ名は次で始まります `aikido-`
* PR のタイトルは次で始まります `Aikido`
* コミットは次で始まります `[fix]`
* PR にラベルが付いています `security`
* PR はドラフト PR ではありません
* 必要な承認がそろうと、PR は SCM（例: GitHub）によって自動マージされます
* PR 用のタスク（例: Jira）が作成されます
* タスク（例: Jira）のタイトルは次で始まります `[AIK]`
* *GitLab 固有:* CODEOWNERS は PR のレビュワーとして追加されません
* *Bitbucket 固有:* AutoFix は自分自身の 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` は、Pull Request で修正された issue にリンクされたタスクに置き換えられます。たとえば: `fix/AIK-1234` 単一のタスクの場合、または `fix/AIK-1234-AIK-4567` 複数のタスクの場合。

もし `PR 用のタスクを作成` が有効になっている場合、自動作成されたタスク識別子がブランチ名に使用されます。

ブランチ形式が非常に厳格で、チケットを 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" %}

```json
autofix:
  pr_config:
    title_template: "Aikido: $MSG - security"
```

{% endcode %}

AutoFix は次を埋め込みます `$MSG` プルリクエスト作成時に。これにより、Aikido AutoFix の PR にプレフィックス、サフィックス、または固定タイトルを設定できます。両方の `title_prefix` および `title_template` が指定されている場合、テンプレートが優先されます。

### **コミットのプレフィックス**

コミットのプレフィックスは、リポジトリごとに次を追加して設定できます `.aikido` リポジトリのルートに次の内容のファイルを配置します:

{% code title=".aikido" %}

```yaml
autofix:
  pr_config:
    commit_prefix: "fix: "
```

{% endcode %}

AutoFix は `commit_prefix` を、その特定のリポジトリのコミットを作成するときの値として使用します。この例では、AutoFix は次のようなコミットを作成します `fix: updating package uuid`

で定義されたコミットプレフィックスは `.aikido` ファイルは UI で設定されたコミットプレフィックスより優先されます。

### コミットテンプレート

コミットメッセージは、リポジトリのルートにコミットメッセージテンプレートを追加することで、さらにカスタマイズできます。次の内容を含めます: `.aikido` リポジトリのルートに次の内容を含むファイルを配置します:

{% code title=".aikido" %}

```json
autofix:
  pr_config:
    commit_template: "fix: $MSG - security"
```

{% endcode %}

AutoFix は次を埋め込みます `$MSG` コミットメッセージ作成時に。これにより、プレフィックス、サフィックス、または固定のコミットメッセージを設定できます。両方の `commit_prefix` および `commit_template` が指定されている場合、テンプレートが優先されます。

### ラベル

ラベルは、リポジトリごとに次を追加して設定できます `.aikido` リポジトリのルートに次の内容のファイルを配置します:

{% code title=".aikido" %}

```yaml
autofix:
  pr_config:
    labels: "aikido,security"
```

{% endcode %}

AutoFix は `labels` を、その特定のリポジトリの Pull Request を作成するときの値として使用します。この例では、AutoFix は両方の `aikido` および `security` ラベルを PR に追加します。

で定義されたラベルは `.aikido` ファイルは UI で設定されたラベルより優先されます。で定義された場合、 `.aikido` ファイル

### ドラフト PR

ドラフト PR は、リポジトリごとに次を追加して設定できます `.aikido` リポジトリのルートに次の内容のファイルを配置します:

{% code title=".aikido" %}

```yaml
autofix:
  pr_config:
    draft_pr: true
```

{% endcode %}

上の例では、特定のリポジトリの Pull Request をドラフトとして作成します。

でのドラフト PR 設定は `.aikido` ファイルは UI でのドラフト PR 設定より優先されます。

### 自動マージ

自動マージは、リポジトリごとに次を追加して設定できます `.aikido` リポジトリのルートに次の内容のファイルを配置します:

{% code title=".aikido" %}

```yaml
autofix:
  pr_config:
    auto_merge: true
```

{% endcode %}

上の例では、特定のリポジトリで自動マージが有効になります。

での自動マージ設定は `.aikido` ファイルは UI での自動マージ設定より優先されます。

### PR 用のタスクを作成

AutoFix は、Aikido でプルリクエストが開かれると、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` を Merge Request のレビュワーとして追加します（ロックファイルに対する CODEOWNERS が 10 人未満の場合）。この動作は次を追加することで無効にできます `.aikido` リポジトリのルートに次の内容のファイルを配置します:

{% code title=".aikido" %}

```yaml
autofix:
  pr_config:
    disable_codeowners_as_reviewers: true
```

{% endcode %}

### Bitbucket の PR を自己承認する

Bitbucket では、Aikido AutoFix は自分が作成した PR を承認できます。PR の作成者が PR を承認する必要があるワークフローの場合は、この設定を有効にしてください。

{% code title=".aikido" %}

```yaml
autofix:
  pr_config:
    self_approve_pr: true
```

{% endcode %}

### ロックファイルごと、またはリポジトリごとの AutoFix のグループ化

デフォルトでは、Aikido AutoFix はリポジトリ内のロックファイルごとに個別の Pull Request **ごとに** を作成します。これにより、標準的なプロジェクトでは変更が分離され、レビューしやすくなります。

1 つのチームが所有するロックファイルが多いリポジトリでは、個別の PR が大量に届くと煩雑になることがあります。リポジトリごとに 1 つの Pull Request を有効にすると、管理の手間と 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=<question>&goal=<endgoal>
```

`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.
