jpskill.com
🛠️ 開発・MCP コミュニティ

qodo-merge

Qodo Merge（旧PR-Agent）を活用し、AIがプルリクエストのレビュー、説明文作成、インライン提案、ラベル付与、ドキュメント生成、チケットチェックなどを自動化し、開発効率を向上させるSkill。

📜 元の英語説明(参考)

Configure and use Qodo Merge, formerly PR-Agent, for AI-powered pull request reviews, descriptions, inline suggestions, labels, docs, and ticket checks across GitHub, GitLab, Bitbucket, and Azure DevOps. Use this skill whenever the user mentions Qodo Merge, PR-Agent, `.pr_agent.toml`, `pr_agent`, PR review bots, `/describe`, `/review`, `/improve`, GitHub App or Action setup, model configuration, or debugging PR-Agent automation.

🇯🇵 日本人クリエイター向け解説

一言でいうと

Qodo Merge（旧PR-Agent）を活用し、AIがプルリクエストのレビュー、説明文作成、インライン提案、ラベル付与、ドキュメント生成、チケットチェックなどを自動化し、開発効率を向上させるSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o qodo-merge.zip https://jpskill.com/download/8686.zip && unzip -o qodo-merge.zip && rm qodo-merge.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/8686.zip -OutFile "$d\qodo-merge.zip"; Expand-Archive "$d\qodo-merge.zip" -DestinationPath $d -Force; ri "$d\qodo-merge.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して qodo-merge.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → qodo-merge フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Qodo Merge

このスキルを使用すると、製品ドキュメントの大きな塊をアクティブなコンテキストに取り込むことなく、Qodo Merge / PR-Agent をインストール、設定、およびトラブルシューティングできます。

はじめに

  1. プラットフォームを特定します: GitHub Action/App、GitLab、Bitbucket、Azure DevOps、Docker、AWS Lambda、またはセルフホスト。
  2. ジョブを特定します: インストール、設定、ツールコマンドの使用、モデルの切り替え、またはエラーのデバッグ。
  3. 安定した設定にはリポジトリローカルの .pr_agent.toml を、シークレットまたは1回限りのオーバーライドには環境変数のみを使用することを推奨します。
  4. すべてをロードするのではなく、タスクに一致する参照ファイルのみを読みます。

コアコマンド

コマンド 用途
/describe PRのタイトル、概要、ウォークスルー、ラベル、およびオプションの図を生成します
/review PRの品質、正確性、セキュリティ、およびチケットとの整合性をレビューします
/improve インラインのコード提案を生成し、信頼度でランク付けします
/ask "..." PRの差分、ファイル、または意図について質問します
/add_docs 変更されたコードに不足しているドキュメントを追加します
/generate_labels PRのコンテンツからラベルを推測します
/help_docs "..." プロジェクトドキュメントからリポジトリの質問に答えます

価値の高いルール

  • 設定の優先順位は、CLI引数 -> 環境変数 -> .pr_agent.toml -> デフォルトです。
  • 環境変数によるオーバーライドの場合、設定キーは二重アンダースコアでマップされます。例: PR_REVIEWER__REQUIRE_TESTS_REVIEW=false。
  • AWS Lambda の環境変数に . を含めることはできません。代わりに __ を使用してください。
  • OpenAI 以外のプロバイダーは、独自の API キーを使用します。Claude、Gemini、または同様のプロバイダーには OPENAI_KEY は不要です。
  • suggestions_score_threshold は /improve の積極性を制御します。値を上げて、価値の低い提案を減らしてください。
  • allow_dynamic_context = true は、周囲のコードコンテキストを拡張することで、より大きな差分を処理するのに役立ちます。
  • ユーザーが生成された PR 本文をリポジトリテンプレートにきれいに適合させたい場合は、description markers を使用します。
  • ローカルの Ollama セットアップでは、通常、セルフホストランナーが必要です。ホストされた CI はローカルサービスに到達できません。

トラブルシューティングのショートカット

症状 最初に確認すること
モデルが見つからない プロバイダー固有のモデル名形式
APIキーが見つからない 選択したプロバイダーに対応するシークレット/環境変数名
許可が拒否された 統合における PR、issue、およびコンテンツの書き込み権限
プロバイダー設定の JSON が無効 litellm.extra_body のフォーマット
大規模な PR でのコンテキストの弱さ 動的コンテキストとパッチサイズ設定

ルーティングガイド

  • インストールとプラットフォーム固有の設定: references/installation.md
  • ツールの動作とツールごとの設定: references/tools.md
  • .pr_agent.toml、CLI フラグ、環境変数、モデルの配線: references/usage-guide.md
  • 自己反省、圧縮、動的コンテキスト、メタデータ: references/core-abilities.md
  • 製品の概要、FAQ、およびその他の詳細: references/other.md
  • ミラーリングされたドキュメントインデックス: references/documentation/index.md

作業スタイル

  • 回答は実装に焦点を当ててください: 適切なプラットフォームパスを選択し、最小限の設定を示し、ユーザーのケースにとって重要なオプションのみを説明します。
  • ユーザーがすぐに貼り付けられるワークフローまたは設定ブロックを必要としない限り、ドキュメントから長い例をダンプすることは避けてください。
  • https://qodo-merge-docs.qodo.ai/ を、正確なオプション名と現在の動作に関する信頼できる情報源として扱ってください。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Qodo Merge

Use this skill to install, configure, and troubleshoot Qodo Merge / PR-Agent without pulling large chunks of product docs into the active context.

Start here

  1. Identify the platform: GitHub Action/App, GitLab, Bitbucket, Azure DevOps, Docker, AWS Lambda, or self-hosted.
  2. Identify the job: install, configure, use a tool command, switch models, or debug a failure.
  3. Prefer repo-local .pr_agent.toml for stable settings and env vars only for secrets or one-off overrides.
  4. Read only the reference file that matches the task instead of loading everything.

Core commands

Command Use it for
/describe Generate PR title, summary, walkthrough, labels, and optional diagram
/review Review the PR for quality, correctness, security, and ticket alignment
/improve Generate inline code suggestions and rank them by confidence
/ask "..." Ask questions about the diff, files, or intent of the PR
/add_docs Add missing docs for changed code
/generate_labels Infer labels from PR content
/help_docs "..." Answer repo questions from project documentation

High-value rules

  • Config precedence is: CLI args -> env vars -> .pr_agent.toml -> defaults.
  • For env var overrides, config keys map with double underscores, for example PR_REVIEWER__REQUIRE_TESTS_REVIEW=false.
  • AWS Lambda env vars cannot contain .; use __ instead.
  • Non-OpenAI providers use their own API keys. Do not require OPENAI_KEY for Claude, Gemini, or similar providers.
  • suggestions_score_threshold controls how aggressive /improve is; raise it to reduce low-value suggestions.
  • allow_dynamic_context = true helps larger diffs by expanding surrounding code context.
  • Use description markers when the user wants generated PR bodies to fit a repo template cleanly.
  • Local Ollama setups generally require a self-hosted runner; hosted CI cannot reach local services.

Troubleshooting shortcuts

Symptom First check
Model not found Provider-specific model name format
API key missing Matching secret/env var name for the selected provider
Permission denied PR, issue, and contents write permissions in the integration
Bad JSON in provider config litellm.extra_body formatting
Weak context on large PRs Dynamic context and patch sizing settings

Routing guide

  • Installation and platform-specific setup: references/installation.md
  • Tool behavior and per-tool config: references/tools.md
  • .pr_agent.toml, CLI flags, env vars, model wiring: references/usage-guide.md
  • Self-reflection, compression, dynamic context, metadata: references/core-abilities.md
  • Product overview, FAQ, and miscellaneous details: references/other.md
  • Mirrored documentation index: references/documentation/index.md

Working style

  • Keep answers implementation-focused: pick the right platform path, show the minimal config, and explain only the options that matter to the user's case.
  • Avoid dumping long examples from docs unless the user needs a ready-to-paste workflow or config block.
  • Treat https://qodo-merge-docs.qodo.ai/ as the source of truth for exact option names and current behavior.