outside-to-issue

外部ファイルから Issue へ

差分外レビューのファイルを、PR レビュー追跡用の適切な形式の Issue ファイルに変換します。

概要

このスキルは、outside/ ディレクトリにあるレビュー ファイルを、プロジェクトの Issue テンプレート形式に従って issues/ ディレクトリ内の標準化された Issue ファイルに変換します。変換時にはすべてのメタデータが保持され、Issue 番号も自動的に処理されます。

使用方法

特定の PR に対して変換スクリプトを実行します。

scripts/transform-outside-to-issues.sh --pr <PR_NUMBER>

例：

scripts/transform-outside-to-issues.sh --pr 90

実行内容

1. すべての外部ファイルを検索：ai-docs/reviews-pr-<PR>/outside/ ディレクトリからすべての .md ファイルを読み込みます
2. 開始する Issue 番号を決定：既存の Issue 番号の最大値を自動的に取得し、次に使用可能な番号から採番します
3. 各ファイルを変換：外部レビュー ファイルを次の内容を含む Issue 形式に変換します。
   • Issue 番号とタイトル
   • レビュー対象のファイルパス
   • 日付とステータス
   • レビューの詳細を含む本文セクション
   • 差分外レビューに由来することを示すフッター

ファイル構成

スクリプトは次のディレクトリ構成を想定しています。

ai-docs/reviews-pr-<PR>/
├── outside/
│   ├── 002-outside_01_<file-path>.md
│   ├── 002-outside_02_<file-path>.md
│   └── ...
└── issues/
    ├── 001-issue.md
    ├── 002-issue.md
    └── ...

出力形式

変換された各 Issue ファイルは、次の形式になります。

# Issue <NUMBER> - Outside-of-diff

**File:** `<file-path>`
**Date:** <date>
**Status:** <status>

## Body

<review-details-content>

---

_Generated from outside-of-diff review_

例

PR 90 に外部ファイルが 18 個ある場合：

scripts/transform-outside-to-issues.sh --pr 90

出力：

Created: issues/026-issue.md
Created: issues/027-issue.md
...
Created: issues/043-issue.md
Transformation complete! Created issues starting from 26

注意事項

• スクリプトは既存の Issue に基づいて、開始する Issue 番号を自動的に決定します
• ファイルはファイル名のアルファベット順に並べ替えて処理されます
• すべてのメタデータ（ファイルパス、日付、ステータス）は元の外部ファイルから保持されます
• Details セクションの内容は、Issue ファイルの Body セクションになります
• スクリプトは issues/ ディレクトリが存在しない場合に作成します

関連コマンド

• read_pr_issues.sh - PR レビューの Issue を読み取り、表示します
• resolve_pr_issues.py - Issue を解決済みにして、GitHub のスレッドを更新します
• pr-fix コマンド - 指定した PR の Issue を修正します