name	.claude/skills/static-analysis/SKILL.md
description	静的解析メトリクスと品質指標の専門知識。 📚 リソース参照: このスキルには以下のリソースが含まれています。必要に応じて該当するリソースを参照してください: - `.claude/skills/static-analysis/resources/code-smells.md`: Code Smellsリソース - `.claude/skills/static-analysis/resources/complexity-metrics.md`: Complexity Metricsリソース - `.claude/skills/static-analysis/resources/threshold-guidelines.md`: Threshold Guidelinesリソース - `.claude/skills/static-analysis/templates/basic-metrics.json`: Basic Metricsテンプレート - `.claude/skills/static-analysis/templates/strict-metrics.json`: Strict Metricsテンプレート - `.claude/skills/static-analysis/scripts/analyze-complexity.mjs`: Analyze Complexityスクリプト
version	1.0.0

Static Analysis Skill

概要

このスキルは、Evan Burchard『Refactoring JavaScript』に基づく、コード複雑度測定と品質メトリクス設定を支援します。

メトリクス種別

1. 複雑度指標

循環的複雑度（Cyclomatic Complexity）:

定義: コード内の独立した経路数
測定: if, for, while, case 等の分岐点をカウント
ESLint ルール: complexity
推奨閾値:
- 低: ≤5（単純な関数）
- 中: 6-10（標準的な関数）
- 高: 11-20（複雑、リファクタリング推奨）
- 非常に高: >20（テスト困難、即座にリファクタリング）

認知的複雑度（Cognitive Complexity）:

定義: 人間が理解するコストを測定
循環的複雑度との違い: ネストを重視
ESLint プラグイン: eslint-plugin-sonarjs
推奨閾値: ≤15

ネスト深度（Nesting Depth）:

定義: コードブロックの入れ子レベル
ESLint ルール: max-depth
推奨閾値: ≤4

2. 規模指標

関数長（Lines per Function）:

ESLint ルール: max-lines-per-function
推奨閾値: ≤50 行
根拠: Robert C. Martin『Clean Code』- 小さな関数原則

ファイル行数（Lines per File）:

ESLint ルール: max-lines
推奨閾値: ≤300 行
例外: 設定ファイル、型定義

パラメータ数（Parameters per Function）:

ESLint ルール: max-params
推奨閾値: ≤3
超過時: オブジェクトパラメータ化を検討

3. 保守性指標

重複コード率:

ESLint プラグイン: eslint-plugin-sonarjs
ルール: no-duplicate-string, no-identical-functions

コメント率:

目標: 10-20%（過度なコメントは自己説明性の欠如を示唆）

命名規約遵守率:

ESLint ルール: camelcase, @typescript-eslint/naming-convention

4. 技術的負債指標

コード臭（Code Smells）:

長すぎるメソッド: max-lines-per-function
長すぎるパラメータリスト: max-params
重複コード: no-duplicate-string
深いネスト: max-depth

閾値設定戦略

チームスキルレベル考慮

初級者多数:

{
  "rules": {
    "complexity": ["error", 15],
    "max-lines-per-function": ["warn", 80],
    "max-depth": ["error", 5]
  }
}

上級者チーム:

{
  "rules": {
    "complexity": ["error", 8],
    "max-lines-per-function": ["error", 40],
    "max-depth": ["error", 3]
  }
}

コードベース特性

レガシー移行中:

段階的厳格化
初期はwarn、目標はerror

新規開発:

厳格な閾値を最初から設定
品質を最初から作り込む

詳細リソース

# 複雑度メトリクス詳細
cat .claude/skills/static-analysis/resources/complexity-metrics.md

# 閾値設定ガイド
cat .claude/skills/static-analysis/resources/threshold-guidelines.md

# Code Smells検出
cat .claude/skills/static-analysis/resources/code-smells.md

テンプレート

# 基本メトリクス設定
cat .claude/skills/static-analysis/templates/basic-metrics.json

# 厳格メトリクス設定
cat .claude/skills/static-analysis/templates/strict-metrics.json

スクリプト

# 複雑度分析
node .claude/skills/static-analysis/scripts/analyze-complexity.mjs [src-directory]

参考文献

『Refactoring JavaScript』 Evan Burchard 著
- Chapter 3: Complexity and Decomposition
- Chapter 5: Code Smells
『Clean Code』 Robert C. Martin 著
- Chapter 3: Functions
- Chapter 10: Classes

.claude/skills/static-analysis/SKILL.md

Install Skill

SKILL.md