AI PR 分类工具 - 自动化代码审查分析与成本优化 | pr-triage

pr-triage by xtone/ai_development_tools

458 周安装量

3 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/xtone/ai_development_tools --skill pr-triage

AI/机器学习开发自动化

🇨🇳中文介绍

PR 分类

分析 PR 的变更内容，并结构化输出后续代码审查阶段所需信息的技能。它设计为在轻量模型（Haiku）上运行，有助于优化 CI 环境中的成本。

步骤

使用 gh pr view <PR编号> --json title,body,headRefName,baseRefName,changedFiles 获取 PR 信息
使用 gh pr diff <PR编号> --name-only 获取变更文件列表
获取差异（如果 changedFiles 大于等于 15，则跳过步骤 3，仅基于文件名和 PR 描述进行分析）：
- 仅当 changedFiles 小于 15 时，使用 gh pr diff <PR编号> 获取代码差异
- 如果需要表面检查的文件（.ts, .js, .tsx, .jsx）较多，则使用 gh pr diff <PR编号> -- <file> 单独获取
检查 .pr-review-state.json 是否存在（上次审查状态）
执行以下分析：
- 变更文件的分类（added/modified/deleted）
- 检测使用的语言/框架
- 判断变更类别（授权变更、数据库变更、RLS 变更、API 变更、测试变更、配置变更、技能变更）
- 判断所需的参考文件
- 检测 Minor/Suggestion 级别的表面问题（增量模式下仅检查变更文件）

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

增量模式（当 .pr-review-state.json 存在时）

利用上次的审查状态优化检查范围：

获取 .pr-review-state.json 中的 last_reviewed_commit
使用 git diff <last_reviewed_commit>..HEAD --name-only 识别自上次审查以来发生变更的文件
未发生变更的文件 的 surface_issues 直接从上次状态继承（添加 "carried_over": true 标记）。不重新检查。
仅对发生变更的文件执行表面检查
将上次的 surface_issues 和 review_comments 中，对应位置已修复的问题包含到 resolved_issues 中
在输出的 .pr-triage.json 中添加 "incremental": true、"base_commit"、"changed_since_last_review"、"unchanged_since_last_review"、"resolved_issues" 字段

resolved_issues 的格式：

{
  "comment_id": 12345678,
  "file": "<文件路径>",
  "line": 42,
  "issue": "<原始问题描述>",
  "resolution": "fixed"
}

如果 .pr-review-state.json 不存在，则执行完整的分类流程。如果 .pr-review-state.json 格式无效（如 JSON 解析错误等），则输出警告并执行完整的分类流程。不得基于损坏的状态文件执行增量模式。

所需参考文件的判断标准

仅在满足以下条件时，将对应的参考文件包含到 required_references 中：

存在 TypeScript/JavaScript 文件变更 → typescript-best-practices.md
存在涉及认证/授权的代码变更（包含 auth, permission, role, session, token 等关键词） → authorization-review-general.md
存在涉及 PostgreSQL RLS 的变更（包含 RLS, row level security, policy 等关键词） → authorization-review-postgres-rls.md
存在 SKILL.md 文件变更 → skill-review.md
需要在 CI 环境中发布到 GitHub → github-pr-review-actions.md（始终包含）

表面检查项目（Minor/Suggestion）

检查差异，并检测以下问题（仅列出相关项）：

使用 any 类型（TypeScript）
使用 var 关键字（TypeScript/JavaScript）
空接口定义
使用魔术数字
违反命名约定（camelCase/PascalCase/UPPER_CASE）
未添加测试（存在新文件但没有对应的测试文件）

以以下 JSON 结构输出到 .pr-triage.json：

{
  "pr_number": 123,
  "incremental": false,
  "base_commit": "<上次审查时的提交 SHA（仅在增量模式下）>",
  "summary": "<变更摘要（1-2 句话）>",
  "files": {
    "added": ["<新增文件路径>"],
    "modified": ["<修改文件路径>"],
    "deleted": ["<删除文件路径>"]
  },
  "changed_since_last_review": ["<自上次审查以来发生变更的文件（仅在增量模式下）>"],
  "unchanged_since_last_review": ["<自上次审查以来未发生变更的文件（仅在增量模式下）>"],
  "languages": ["<检测到的语言>"],
  "frameworks": ["<检测到的框架>"],
  "change_categories": {
    "has_auth_changes": false,
    "has_db_changes": false,
    "has_rls_changes": false,
    "has_api_changes": false,
    "has_test_changes": false,
    "has_config_changes": true,
    "has_skill_changes": true
  },
  "required_references": ["<所需的参考文件名>"],
  "surface_issues": [
    {
      "severity": "Minor|Suggestion",
      "file": "<文件路径>",
      "line": 15,
      "issue": "<问题描述>",
      "suggestion": "<改进建议>",
      "carried_over": true
    }
  ],
  "resolved_issues": [
    {
      "comment_id": 12345678,
      "file": "<文件路径>",
      "line": 42,
      "issue": "<原始问题描述>",
      "resolution": "fixed"
    }
  ],
  "diff_summary": "<差异摘要（200 字符以内）>",
  "estimated_complexity": "low|medium|high",
  "focus_areas": ["<审查时的关注点>"]
}

尽量减少文本输出，专注于 .pr-triage.json 的输出。

🇺🇸English

PRトリアージ

PRの変更内容を分析し、後続のコードレビューフェーズに必要な情報を構造化して出力するスキルです。軽量モデル（Haiku）での実行を想定しており、CI環境でのコスト最適化に寄与します。

手順

gh pr view <PR番号> --json title,body,headRefName,baseRefName,changedFiles でPR情報を取得
gh pr diff <PR番号> --name-only で変更ファイル一覧を取得
差分の取得（changedFilesが15以上の場合、手順3はスキップしてファイル名とPR説明のみで分析する ）：
- changedFilesが15未満の場合のみ gh pr diff <PR番号> でコード差分を取得
- 表層チェックが必要なファイル（.ts, .js, .tsx, .jsx）が多い場合は個別に gh pr diff <PR番号> -- <file> で取得
.pr-review-state.json が存在するか確認する（前回レビュー状態）
以下の分析を行う：
- 変更ファイルのカテゴリ分類（added/modified/deleted）
- 使用言語・フレームワークの検出
- 変更カテゴリの判定（認可変更、DB変更、RLS変更、API変更、テスト変更、設定変更、スキル変更）
- 必要なリファレンスファイルの判定
- Minor/Suggestionレベルの表層的問題の検出（インクリメンタルモード時は変更ファイルのみ）
- 差分の要約（200文字以内）
- レビュー時に注目すべきポイント
分析結果を .pr-triage.json ファイルに出力する

インクリメンタルモード（.pr-review-state.json が存在する場合）

前回のレビュー状態を活用してチェック範囲を最適化する：

.pr-review-state.json の last_reviewed_commit を取得する
git diff <last_reviewed_commit>..HEAD --name-only で前回レビュー以降に変更されたファイルを特定する
変更のないファイル の surface_issues は前回の状態からそのまま引き継ぐ（"carried_over": true を付与）。再チェックしない。
変更があったファイル のみ表層チェックを実行する
前回の surface_issues と review_comments のうち、該当箇所が修正されたものを resolved_issues に含める
出力の .pr-triage.json に、、、、フィールドを追加する

resolved_issues のフォーマット：

{
  "comment_id": 12345678,
  "file": "<ファイルパス>",
  "line": 42,
  "issue": "<元の問題の説明>",
  "resolution": "fixed"
}

.pr-review-state.json が存在しない場合は、通常のフルトリアージを実行する。 .pr-review-state.json が不正な形式（JSONパースエラー等）の場合は、警告を出力してフルトリアージを実行する。破損した状態ファイルに基づいてインクリメンタルモードを実行してはならない。

必要なリファレンスの判定基準

以下の条件に該当する場合のみ、対応するリファレンスを required_references に含める：

TypeScript/JavaScript ファイルの変更あり → typescript-best-practices.md
認証・認可に関わるコード変更あり（auth, permission, role, session, token等のキーワード） → authorization-review-general.md
PostgreSQL RLS に関わる変更あり（RLS, row level security, policy等のキーワード） → authorization-review-postgres-rls.md
SKILL.md ファイルの変更あり → skill-review.md
CI環境でのGitHub投稿が必要 → github-pr-review-actions.md（常に含める）

表層チェック項目（Minor/Suggestion）

差分を確認し、以下の問題を検出する（該当するもののみ）：

any 型の使用（TypeScript）
var キーワードの使用（TypeScript/JavaScript）
空のインターフェイス定義
マジックナンバーの使用
命名規則違反（camelCase/PascalCase/UPPER_CASE）
テストの未追加（新規ファイルがあるのにテストファイルがない）

出力フォーマット

.pr-triage.json に以下のJSON構造で出力すること：

{
  "pr_number": 123,
  "incremental": false,
  "base_commit": "<前回レビュー時のコミットSHA（インクリメンタル時のみ）>",
  "summary": "<変更の概要（1-2文）>",
  "files": {
    "added": ["<追加ファイルパス>"],
    "modified": ["<変更ファイルパス>"],
    "deleted": ["<削除ファイルパス>"]
  },
  "changed_since_last_review": ["<前回から変更があったファイル（インクリメンタル時のみ）>"],
  "unchanged_since_last_review": ["<前回から変更がないファイル（インクリメンタル時のみ）>"],
  "languages": ["<検出された言語>"],
  "frameworks": ["<検出されたフレームワーク>"],
  "change_categories": {
    "has_auth_changes": false,
    "has_db_changes": false,
    "has_rls_changes": false,
    "has_api_changes": false,
    "has_test_changes": false,
    "has_config_changes": true,
    "has_skill_changes": true
  },
  "required_references": ["<必要なリファレンスファイル名>"],
  "surface_issues": [
    {
      "severity": "Minor|Suggestion",
      "file": "<ファイルパス>",
      "line": 15,
      "issue": "<問題の説明>",
      "suggestion": "<改善案>",
      "carried_over": true
    }
  ],
  "resolved_issues": [
    {
      "comment_id": 12345678,
      "file": "<ファイルパス>",
      "line": 42,
      "issue": "<元の問題の説明>",
      "resolution": "fixed"
    }
  ],
  "diff_summary": "<差分の要約（200文字以内）>",
  "estimated_complexity": "low|medium|high",
  "focus_areas": ["<レビュー時の注目ポイント>"]
}

重要:

テキスト出力は最小限にし、.pr-triage.json の出力に集中してください。

Weekly Installs

458

Repository

xtone/ai_develo…nt_tools

GitHub Stars

First Seen

Mar 6, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

claude-code458

opencode4

gemini-cli4

github-copilot4

codex4

kimi-cli4

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

138,300 周安装

"incremental": true

"changed_since_last_review"

"unchanged_since_last_review"