正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

カスタムルール

  • プラン: Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

GitLab Duo Agent Platformでカスタムルールを使用すると、生成された出力（例えば、コードやドキュメント）が特定の指示や、開発スタイルガイドなどのその他の要件に合致していることを確認できます。

次のAgent Platform機能はカスタムルールをサポートしています:

カスタムルールを作成する

GitLab Duoの使用方法に応じて、カスタムルールは2つのレベルで作成できます:

レベルGitLab UIでのAgentic Chatエディター拡張機能GitLab Duo CLI
ユーザーレベル: すべてのプロジェクトとワークスペースに適用いいえcheck-smcheck-sm
ワークスペースレベル: 特定のプロジェクトまたはワークスペースにのみ適用check-smcheck-smcheck-sm

ユーザーレベルとワークスペースレベルの両方のルールが存在する場合、GitLab Duo Chatは両方を会話に適用します。

前提条件:

カスタムルールを作成する前に存在していた会話は、これらのルールに従いません。

ユーザーレベルのカスタムルールを作成する

ユーザーレベルのカスタムルールは、ローカル環境（IDE）のすべてのプロジェクトとワークスペースに適用されます。

  1. ホームディレクトリにカスタムルールファイルを作成します:

    • LinuxまたはmacOSでは、~/.gitlab/duo/chat-rules.mdにファイルを作成します。
    • Windowsでは、%APPDATA%\GitLab\duo\chat-rules.mdにファイルを作成します。

  2. カスタムルールをファイルに追加します。例:

    - Don't put comments in the generated code
- Be brief in your explanations
- Always use single quotes for JavaScript strings

  3. ファイルを保存します。

  4. 新しいカスタムルールを適用するには、状況に応じて次のいずれかを実行します:

    • 新しいGitLab Duo Chatのディスカッションを開始します。
    • Chatのディスカッション、イシュー、またはマージリクエストでエージェントを使用します。
    • フローをトリガーします。

特定の環境変数を設定している場合、カスタムルールファイルは別の場所に作成します:

  • GLAB_CONFIG_DIR環境変数を設定している場合、$GLAB_CONFIG_DIR/chat-rules.mdにファイルを作成します。
  • XDG_CONFIG_HOME環境変数を設定している場合、$XDG_CONFIG_HOME/gitlab/duo/chat-rules.mdにファイルを作成します。

ワークスペースレベルのカスタムルールを作成する

ワークスペースレベルのカスタムルールは、特定のプロジェクトまたはワークスペースにのみ適用されます。この方法を使用すると、チームのプロジェクトに一連のカスタムルールを適用できます。例えば、チームが使用する開発スタイルガイドのセットを適用できます。

  1. IDEワークスペースで、カスタムルールファイル.gitlab/duo/chat-rules.mdを作成します。

  2. カスタムルールをファイルに追加します。例:

    - Don't put comments in the generated code
- Be brief in your explanations
- Always use single quotes for JavaScript strings

  3. ファイルを保存します。

  4. プロジェクトの場合: .gitlab/duo/chat-rules.mdファイルをGitリポジトリに追加します。Chat、エージェント、およびフローは、リポジトリからコンテキストにカスタムルールを自動的に読み込みます。

  5. 新しいカスタムルールを適用するには、GitLab Duoの新しい会話を開始します。

    カスタムルールを変更するたびに、これを行う必要があります。

詳細については、GitLab Duo Chatでのカスタムルールチュートリアルブログを参照してください。

カスタムルールを更新する

カスタムルールを更新するには、カスタムルールファイルを編集して保存します。次に、新しいGitLab Duoの会話を開始して、更新されたルールを適用します。

Chatを使用してカスタムルールファイルを直接編集することはできません。

カスタムルールへの変更を承認する必要があるユーザーを管理するには、コードオーナーを使用します。