---
title: "開発に参加する"
language: "ja"
documentation_version: "3.x"
channel: "development"
release_context: null
source_revision: "2072a900b0d0eae8e61fafb06e4c0129bc43c245"
working_tree_clean: true
source_path: "docs/ja/contributing/README.md"
source_sha256: "d6818d04ebbf0b114b5e5da1d9304c13e40bcad2b2aae5cb13947d5ba11ff3b6"
source_at_revision: true
source_url: "https://github.com/matsumotory/ngx_mruby/blob/2072a900b0d0eae8e61fafb06e4c0129bc43c245/docs/ja/contributing/README.md"
html_url: "https://ngx.mruby.org/ja/contributing/"
markdown_url: "https://ngx.mruby.org/markdown/ja/contributing.md"
last_updated: "2026-11-01"
---

# 開発に参加する

ngx_mrubyへの変更はGitHubのプルリクエストで受け付けています。人もコーディングエージェントも手順は同じです。このページでは、変更の対象ブランチとPRに必要なものを説明します。ルールの全体は[AGENTS.md](https://github.com/matsumotory/ngx_mruby/blob/next/AGENTS.md)にあります。エージェントは作業の前にAGENTS.mdを読みます。人が作業するときも、ルールの基準はAGENTS.mdです。

## 変更の対象ブランチ

| 変更 | ベースブランチ |
|---|---|
| 2.xのクラッシュ、ハング、リーク、ビルド失敗の修正 | v3.0.0でv3が`master`になるまでは`master` |
| 新しい挙動、ディレクティブやメソッドの追加、APIの整理、その他v3の作業 | `next` |

2.xでは互換性を最優先にし、設定、スクリプト、ビルドから見える挙動は不具合の修正に必要な範囲だけ変えます。v3にも必要な修正は`master`へ送り、`master`から`next`へのマージで取り込みます。各ブランチの役割は、[Branch strategy](https://github.com/matsumotory/ngx_mruby/blob/next/README.md#branch-strategy)の説明を参照してください。

セキュリティの脆弱性は公開のissueやPRに書かず、[SECURITY.md](/ja/security/)の手順で非公開で報告してください。修正も非公開で準備します。

## PRに必要なもの

- [PRテンプレート](https://github.com/matsumotory/ngx_mruby/blob/next/.github/PULL_REQUEST_TEMPLATE.md)の全項目を記入し、該当しない項目には「n/a」と書きます。
- コードを変える場合は、実際のレスポンスを検証するテストを`test/`に追加します。できれば`test/conf/conf.d/`にserverのフラグメント、`test/html/`にスクリプト、`test/t/cases/`にケースを置いてください。書き方は[テスト](/ja/contributing/test/)を参照し、`sh test.sh`でスイートを実行します。ドキュメントだけの変更にはテストの追加は不要です。
- 不具合の修正は2コミットに分けます。最初のコミットで回帰テストを追加し、失敗することを確認します。次のコミットで修正を加え、テストを通します。各コミットでのスイートの結果をPRに記載してください。
- 設定、スクリプト、ビルドから見える変更には、`docs/releases/<version>.md`の「Behavior changes: read before upgrading」と、日本語版の`docs/releases/<version>.ja.md`に同じエントリーを追加します。詳細は[リリースノート](/ja/releases/)を参照してください。
- ディレクティブ、Rubyのメソッド、ビルドオプション、テストハーネスを変える場合は、`docs/`の説明も更新します。
- `src/`、`mrbgems/`、ビルドを変える場合は、AGENTS.mdの「Design principles」に従って性能を比較します。

## レビューとマージ

PRの作者以外が、AGENTS.mdの「Review and merge」のチェックリストに沿ってレビューし、指摘をコメントに残します。headのコミットでCIが通り、レビューの「must fix」の項目がすべて解決し、その他の条件もすべて満たしてから、マージコミットで取り込みます。タグ、リリース、セキュリティアドバイザリはオーナーが管理します。

## 質問と提案

質問、セキュリティ以外の不具合、提案はGitHubのissueに投稿してください。v3の大きな計画は[docs/proposals/](https://github.com/matsumotory/ngx_mruby/tree/next/docs/proposals)、作業状況は[docs/HANDOFF.md](/ja/contributing/handoff/)にあります。
