リファクタリング候補検出コマンド

コードベースを分析し、リファクタリングが必要な箇所を検出してGitHub Issueを作成します。

入力

$ARGUMENTS（対象パス、オプション）

例:

• /find-refactoring src/

  - src配下を分析

• /find-refactoring --dry-run

  - Issue作成せずレポートのみ

• /find-refactoring src/ --min-priority=high

  - 高優先度のみ

前提条件

詳細:

refactoring-detection

skill を参照

ast-grep (sg)

jscpd

全体フロー

approval-gate

--dry-run

Phase規約:

workflow-phase-convention

skill を参照

サーキットブレーカー

--min-priority=high

Phase 0.3-0.7: 事前準備

言語検出

LANG=$(detect_language)  # typescript / rust / go / python

ツール確認

check_required_tools || exit 1
check_optional_tools

既存Issue確認

EXISTING_ISSUES=$(get_existing_refactoring_issues)

実装詳細:

refactoring-detection

skill を参照

Phase 1-2: 検出実行

検出ルール

any

 skill

console.log

言語別追加ルール

todo!

unimplemented!

unwrap()

検出パターン詳細:

refactoring-detection

skill を参照

Phase 3: 優先度・粒度判定

優先度基準

Issue粒度チェック

実装タスクは200行以下を対象

/decompose-issue

工数算出ロジック:

refactoring-detection

skill を参照

Phase 3.5: ユーザー確認

共通仕様:

approval-gate

skill を参照

## 検出されたリファクタリング候補

### サマリー
| 優先度 | 件数 |
|--------|------|
| Critical | {n} |
| High | {n} |
| Medium | {n} |

### 詳細（上位15件）

| # | ファイル | 問題 | 優先度 | 推定工数 | 備考 |
|---|---------|------|--------|---------|------|
| 1 | `src/foo.ts` | 723行（超過） | High | 1h | |
| 2 | `src/bar.ts` | any型 5箇所 | High | 25m | |
| 3 | `src/big.ts` | 1200行 | High | 3h | **要分割** |

### スキップ（既存Issue）
- `src/old.ts`: #45

---
**選択肢**:

1. 全件 → 全件Issue作成
2. High以上 → High以上のみ作成
3. 選択 → 指定番号のみ（例: `3 1,2,5`）
4. 終了 → 作成せず終了

> 番号を選択してください（1-4）:

Phase 4: Issue作成

ラベル事前作成

ensure_labels() {
    for label in refactoring automated priority/{critical,high,medium,low}; do
        gh label create "$label" --force 2>/dev/null || true
    done
}

Issueテンプレート

gh issue create \
  --title "refactor: ${TITLE}" \
  --body "## 概要
${PROBLEM}

## 対象
- **ファイル**: \`${FILE_PATH}\`

## 推奨アクション
${ACTION}

## 推定工数
${EFFORT}
${DECOMPOSE_NOTE}

---
*\`/find-refactoring\` により自動生成*" \
  --label "refactoring,automated,priority/${PRIORITY}"

出力形式

成功時

## リファクタリングIssue作成完了

| Issue | タイトル | 優先度 | 推定工数 |
|-------|---------|--------|---------|
| #101 | refactor: src/foo.ts 分割 | High | 1h |
| #102 | refactor: src/bar.ts any除去 | High | 25m |

### スキップ（既存Issue）
- `src/old.ts` → #45

### 次のステップ
1. 実装: `task #101 #102`
2. 大きなIssue分割: `/decompose-issue 103`

dry-run時

## リファクタリング候補レポート（dry-run）

| # | ファイル | 問題 | 優先度 | 推定工数 |
|---|---------|------|--------|---------|
| 1 | `src/foo.ts` | 723行超過 | High | 1h |

### Issue作成コマンド
\`/find-refactoring src/ --min-priority=high\`

完了条件

• 必須ツール（ast-grep）が利用可能
• 対象パスの分析が完了
• 既存Issueとの重複チェック済み
• 検出結果がユーザーに提示済み
• 承認されたIssueが作成済み（dry-run以外）
• 200行超Issueに分割推奨が注記済み

関連スキル

refactoring-detection

code-quality-rules

issue-size-estimation

approval-gate

変更履歴