mcpField
F
find-unplanned-issues

find-unplanned-issues

github.com/remotion-dev開発68.6k383 回インストール今日更新
リポジトリ

find-unplanned-issues について

Remotion リポジトリで、masterplan に紐づかないオープン中の GitHub issue を監査し、masterplan からクローズ済み issue を除く処理をプレビューするスキルです。付属の Bun スクリプトで読み取り専用レポートを作成でき、JSON 出力と自動化向けチェックモードにも対応します。

主な機能

  1. 01masterplan の祖先がない issue の検出
  2. 02親 issue の関連付け状況の報告
  3. 03クローズ済み issue の削除プレビュー
  4. 04JSON 出力とチェックモード

活用シーン

  1. 01オープン中の issue の計画紐付け監査
  2. 02masterplan の issue 階層確認
  3. 03自動化での計画状況チェック
  4. 04クローズ済み issue の整理プレビュー

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/remotion-dev/remotion --skill find-unplanned-issues

インストール後、Claude Code で/find-unplanned-issuesを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
scripts/
find-unplanned-issues.ts
prune-closed-masterplan-issues.ts

詳細

計画外のイシューを見つける

リポジトリのルートから、同梱の読み取り専用監査を実行します。

bun .agents/skills/find-unplanned-issues/scripts/find-unplanned-issues.ts

このスクリプトでは、タイトルに masterplan を含むイシュー、または親の階層にあるいずれかのイシューのタイトルに masterplan を含む場合、そのイシューを計画済みとして扱います。Masterplan 自体のイシューはレポートから除外されます。リポジトリ固有の例外も除外されます。現在、イシュー #8375 は例外となっています。長期にわたる CI フレークの追跡用イシューは、意図的に単独で管理されているためです。結果は次のように区別されます。

  • no parent：オープン中のイシューに親がありません。
  • no masterplan ancestor：イシューに親はありますが、親の階層をすべてたどっても masterplan に到達しません。

必要に応じて、別のリポジトリや機械可読形式の出力を指定してください。

bun .agents/skills/find-unplanned-issues/scripts/find-unplanned-issues.ts --repo owner/repo
bun .agents/skills/find-unplanned-issues/scripts/find-unplanned-issues.ts --json

自動化する場合は --check を渡してください。計画外のイシューが見つかった場合はステータス 1 で終了し、例外を除くすべてのオープン中のイシューが masterplan に属している場合はステータス 0 で終了します。

この監査には、parent JSON フィールドに対応した認証済みの gh CLI が必要です。イシューデータの読み取りのみを行います。検出された問題を修正するには、issue-management スキルを使用し、編集後に各関係を確認してください。

Masterplan からクローズ済みのイシューを削除する

ルート masterplan のクローズ済みの子孫すべてを再帰的にプレビューします。

bun .agents/skills/find-unplanned-issues/scripts/prune-closed-masterplan-issues.ts

既定のルートは https://github.com/remotion-dev/remotion/issues/9081 です。別の階層を意図的に監査する場合に限り、これを上書きしてください。

bun .agents/skills/find-unplanned-issues/scripts/prune-closed-masterplan-issues.ts \
  --root https://github.com/owner/repo/issues/123

--apply を渡さない場合、このコマンドはドライランです。適用時は、クローズ済みのイシューを階層の深い順に処理し、変更後に各関係を必ず確認してください。クローズ済みのイシューにオープン中の子イシューがある場合は、そのクローズ済みのイシューを削除する前に、子イシューをその親へ移動してください。これにより、オープン中の作業を masterplan に残せます。

bun .agents/skills/find-unplanned-issues/scripts/prune-closed-masterplan-issues.ts --apply

機械可読形式のドライランレポートには --json を使用してください。スクリプトをテストするだけの目的で --apply を渡してはいけません。GitHub のイシュー間の関係が実際に変更されます。

コメント

Markdown 対応