issue-review について
toss/es-toolkit のメンテナー向けに、最近の未解決 Issue を調査し、ラベル付けや関連報告の検索を行うスキルです。Issue の内容にソースコードやテストの情報を加え、個別の分析と全体の概要をまとめます。
主な機能
- 01最近の未解決 Issue の取得
- 02Issue 内容・コード・テストの確認
- 03ラベルのない Issue への分類付与
- 04重複候補の検索
- 05個別分析と概要の作成
活用シーン
- 01最近のリポジトリ Issue のトリアージ
- 02報告された不具合と現在の動作の照合
- 03要望の検討前に関連報告を検索
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ toss/ es-toolkit --skill issue-reviewインストール後、Claude Code で/issue-reviewを入力して読み込まれたか確認します。
詳細
イシューのレビュー
最近のイシューを取得し、背景情報をもとにラベルのないイシューにラベルを付け、重複を検出します。
入力
$ARGUMENTS — イシューの件数(デフォルト:10)
例:
/issue-review— 最近のオープンイシュー 10 件/issue-review 20— イシュー 20 件
ワークフロー
1. 最近のイシューを取得する
gh issue list --repo toss/es-toolkit --state open --limit {count} --json number,title,author,labels,createdAt
2. 各イシューを詳しくレビューする
各イシューについて:
a. イシューの内容を読む
gh issue view {number} --repo toss/es-toolkit --json title,body,labels,comments
b. 関連するソースコードを読む
イシューで特定の関数に言及している場合:
- 関数のソースを読み、現在の動作を把握する
- 既存のテストを読み、どの範囲がカバーされているか確認する
- 互換版がすでに存在するか確認する
c. 背景情報を示す
- バグ報告:報告された動作は実際にバグですか? それとも仕様どおりですか? lodash では異なる動作をしますか?
- 機能リクエスト:設計原則に合っていますか? 最新の JS で代替できますか? TC39 Stage 3 以上ですか?
- 型に関する問題:現在の型シグネチャを読み、提案された変更を評価する
- ドキュメント:現在記載されている内容と、リクエストされている内容を確認する
d. ラベルがない場合はラベルを付ける
ラベルがない場合は、/issue-label {number} を実行します。
3. 重複を検出する
gh issue list --repo toss/es-toolkit --state all --search "{function name}" --limit 10 --json number,title,state,labels
以下の項目ごとにグループ化します:
- タイトル内の同じ関数名
- 類似したエラーの説明
- 同じ機能に対するリクエスト
4. イシューごとに報告する
### Issue #{number} — {title}
**Label**: {existing or newly applied}
**Context**: {what the function currently does, relevant code snippet}
**Analysis**: {is the request valid? design principle alignment?}
**Duplicates**: {similar issues if any}
**Action**: {label applied / needs discussion / close as wontfix / link to existing PR}
5. まとめ
## Issue Review — {date}
| # | Title | Label | Duplicate? | Action |
|---|-------|-------|------------|--------|
- {N} issues reviewed
- {N} newly labeled
- {N} potential duplicates
- {N} actionable bugs
- {N} feature requests
コメント
Markdown 対応