pr-triage について
toss/es-toolkit のコントリビューター向け PR トリアージスキルです。変更ファイルに基づいてプルリクエストを分類し、レビューの観点をまとめます。分類に応じた簡易チェックも実行します。
主な機能
- 01PR 情報と変更ファイルの取得
- 02レビューラベルによる変更の分類
- 03分類に応じた簡易チェックの選択
- 04変更ファイルとチェック項目の要約
活用シーン
- 01プルリクエストのレビュー準備
- 02変更内容に応じたチェックの特定
- 03PR の範囲と分類の整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ toss/ es-toolkit --skill pr-triageインストール後、Claude Code で/pr-triageを入力して読み込まれたか確認します。
詳細
PR のトリアージ
レビューに向けて PR を分類し、要約します。
入力
$ARGUMENTS — PR 番号(例:1234)
ワークフロー
1. PR 情報を取得する
gh pr view {number} --repo toss/es-toolkit --json title,body,author,files,labels
2. PR を分類する
変更されたファイルに基づいて、1 つ以上のラベルを割り当てます。
| パターン | ラベル | レビューの観点 |
|---|---|---|
src/compat/**/*.ts(spec を除く) | compat-fix | lodash との実際の不整合か?確認には /compat-review を使用します。 |
src/{category}/*.ts(新規ファイル) | new-function | 設計原則に沿っているか?チェックリスト:実装 + spec + 再エクスポート + ドキュメント。 |
src/{category}/*.ts(変更あり) | core-change | 意図的な動作変更か?破壊的変更はあるか? |
src/**/*.spec.ts | test | エッジケースをカバーしているか? |
docs/**/*.md | docs | 4 言語すべてが更新されているか?翻訳の品質はどうか? |
.ts の型のみの変更 | types | 後方互換性があるか? |
benchmarks/** | perf | 公平なベンチマークか?手法は妥当か? |
.github/**、設定ファイル | infra | CI/ビルドへの影響はあるか? |
3. ラベルごとの簡易チェックを実行する
- compat-fix:
yarn vitest run src/compat/{category}/{fn}.spec.ts - new-function:すべてのチェックリスト項目(実装、spec、再エクスポート、4 言語のドキュメント)が存在することを確認します
- core-change:
yarn vitest run src/{category}/{fn}.spec.ts+tsc --noEmit - docs:4 言語すべてのファイルがあり、内容に一貫性があることを確認します
- types:
tsc --noEmit
4. 報告する
## PR #{number} — {title}
### Classification: {labels}
### Changed Files
- {file list grouped by label}
### Quick Checks
- [ ] Tests pass
- [ ] Types pass
- [ ] {label-specific checks}
### Review Suggestions
{What to focus on based on the classification}
コメント
Markdown 対応