refactor-audit

name	refactor-audit
description	Rustプロジェクト全体を網羅的に検査し、発見した問題をIssueとして起票するリファクタリング監査スキル。 crate単位でサブエージェントを並列起動し、10の検査次元×具体的チェックリストで検査。 トリガー: "refactor-audit", "監査", "全体レビュー", "コード監査", "audit" 使用場面: コード品質の網羅的検査、リファクタリング前の問題洗い出し、仕様適合確認

refactor-audit

Rustプロジェクトの全crateを網羅的に検査し、発見した問題をIssue（GitHub or ローカルmd）として起票する監査スキル。コードは一切変更しない（read-only）。

---

実行フロー概要

1. スキャン対象の決定（引数 or 全crate）
2. Issue起票先の選択（GH Issue / ローカル md / 両方）
3. cargo clippy + cargo test を実行、結果を取得
4. crate↔仕様マッピングを構築、関連仕様を要約
5. crate単位でサブエージェントを並列起動（検査実行）
6. 各サブエージェントの結果（JSON）を集約
7. Issue起票（選択された起票先へ）
8. SUMMARY.md 生成 + ターミナル出力

---

ステップ 1: スキャン対象の決定

引数の解釈:

• 引数なし: crates/ 配下の全crateを走査
• crate名を指定: 例 valen-parser → そのcrateのみ
• ファイルパスを指定: 例 crates/valen-codegen/src/emit.rs → そのファイルのみ
• 複数指定: スペース区切りで複数crate/ファイルを指定可能

crateの一覧は以下のコマンドで取得:

ls -d crates/*/

---

ステップ 2: Issue起票先の選択

スキャン開始前にユーザーに1回だけ確認する:

選択肢:

1. ローカル md — ./issues/{seq}_{scope}_{title}.md に起票
2. GitHub Issue — gh issue create で起票、severity:* + dimension:* ラベル自動付与
3. 両方 — ローカル md + GitHub Issue の両方に起票

ローカル md の連番ルール

# 既存の最大連番を取得（なければ0）
max_seq=$(ls ./issues/*.md 2>/dev/null | grep -oP '^\d{3}' |  -rn |  -1)
next_seq=$((max_seq + ))