| name | quality-scan |
| description | コードベース全体の品質スキャンを実行し、autoFixable / judgment-required に分類されたレポートを出力する。 |
| user_invocable | true |
Quality Scan
コードベース全体をスキャンし、問題をautoFixable(機械的に修正可能)とjudgment-required(判断が必要)に分類する。
実行手順
Step 1: スキャン実行
node scripts/quality-scan.js
node scripts/quality-scan.js | node scripts/quality-scan-recurring.js docs/report/quality-scan-prev.md
レポートを保存する場合: 出力を docs/report/quality-scan-prev.md にリダイレクトし、次回比較に使う。
Step 2: レポート確認
出力されたMarkdownレポー���を読み、以下の順で対応する:
- Summary — 全体の件数を確認
- AutoFixable — 機械的に修正可能な項目。ユ��ザーに「これらを修正しますか?」と確認してから対応
console.log 残存 → 削除
as any → unknown + 型ガード or Record<string, unknown> に変更
- Judgment Required — ユーザーに提示し判断を仰ぐ
- 200行超ファイル → 分割候補の提案
as unknown as X → 根本的な型設計の見直しが必要か検討
- 陳腐化ドキュメント参照 → 該当ドキュメントの更新 or 参照削除
- Instruction Surface — AGENTS.md + rulesの総行数・指示数を確認。肥大化傾向があれば棚卸しを提案
- Recurring Issues — 前回レポートとの比較で継続出現している問題。3回以上繰り返す場合はhook/linterへの昇格を検討
Step 3: 修正の実施
- autoFixableの修正は並列エージェントで実施可能(ファイル重複なし)
- judgment-requiredは1件ずつユーザーと相談
- 修正後
pnpm run ci-check で全体確認
定期実行
週次で /quality-scan を実行し、レポートをユーザーに共有する。
トレンド(前回比)の把握は git diff で前回レポートと比較。