AgentSkillsCN

code-quality-review

代码质量评审——综合评估架构设计、代码异味、性能表现以及类型安全性

SKILL.md
--- frontmatter
name: code-quality-review
description: コード品質レビュー - アーキテクチャ、コード臭、パフォーマンス、型安全性を統合評価
requires-guidelines:
  - common
  - typescript

コード品質レビュー(統合版)

統合スコープ

  1. アーキテクチャ - クリーンアーキテクチャ、DDD、依存関係
  2. コード臭 - 長すぎる関数、重複、マジックナンバー、複雑度
  3. パフォーマンス - N+1問題、メモリリーク、非効率アルゴリズム
  4. 型安全性 - any/as使用、null安全性、型ガード

使用タイミング

  • コードレビュー時 / リファクタリング時 / /review コマンド実行時

レビュー観点

🔴 Critical(修正必須)

カテゴリ観点検出パターン対策
アーキ依存逆転Domain→Infrastructure参照Interface分離
アーキロジック配置Controller内ビジネスロジックUseCase/Domainに移動
コード臭長い関数100行超責務分離で分割
コード臭マジックナンバーif (age > 18)定数化
パフォN+1問題ループ内クエリバッチ取得
パフォメモリリークcleanup未実装useEffect cleanup
型安全any使用data: anyunknown + 型ガード
型安全無検証asdata as User型ガード関数

🟡 Warning(要改善)

カテゴリ観点検出パターン対策
アーキFat Service500行超/複数責務責務分離
コード臭深いネスト3階層以上早期リターン
パフォ非効率O(n²)アルゴリズムMap使用でO(n)
型安全冗長注釈推論可能な型指定型推論活用

コード例が必要な場合: Context7で「clean architecture」「TypeScript type guard」を検索


チェックリスト

アーキテクチャ: Domain外部依存なし / ロジックがDomain/UseCaseに / 循環依存なし

コード臭: 関数50行以内 / マジックナンバーなし / 重複3回未満

パフォーマンス: N+1なし / cleanup実装 / O(n²)以上なし

型安全: any未使用 / as使用時型ガード / strictNullChecks有効


出力形式

code
## コード品質レビュー結果

### アーキテクチャ
🔴 Critical: `ファイル:行` - 問題 - 修正案

### コード臭 / パフォーマンス / 型安全性
🔴 Critical: `ファイル:行` - 問題 - 修正案

📊 Summary: Critical X件 / Warning Y件

外部リソース

  • Context7: DDD、クリーンアーキテクチャ、SOLID原則、TypeScript公式
  • Serena memory: プロジェクト固有のレイヤー構成・コーディング規約