tomevault-io Code Metrics
コード品質を定量的に評価するためのメトリクス分析スキル。複雑度、結合度、テストカバレッジなどの指標を測定し、改善優先度を特定する。
サイクロマティック複雑度
概念
- 1-10: シンプル（低リスク）
- 11-20: 中程度（中リスク）
- 21-50: 複雑（高リスク）
- 50+: テスト不可能（リファクタリング必須）
測定ツール
JavaScript/TypeScript
# eslint複雑度ルール
npx eslint --rule 'complexity: ["error", 10]' src/
# 詳細分析
npx eslint --rule 'complexity: ["warn", 5]' src/ -f json | jq '.[] | .messages[] | select(.ruleId == "complexity")'
Python
# radonで複雑度測定
pip install radon
radon cc src/ -a
# McCabe複雑度
radon cc src/ -mc
Java
# PMD
pmd -d src/ -R category/design.xml/CyclomaticComplexity -f text
認知的複雑度（Cognitive Complexity）
人間がコードを理解する難易度を測定。ネスト、論理演算子の連続などが加算される。
# SonarQube/SonarLint
# ESLint cognitiv complexity plugin
npm install eslint-plugin-cognitive-complexity --save-dev
// .eslintrc
{
"plugins": ["cognitive-complexity"],
"rules": {
"cognitive-complexity": ["error", 15]
}
}
結合度分析
ファンイン・ファンアウト
- ファンイン: 他から参照される数（高い=安定）
- ファンアウト: 他を参照する数（高い=不安定）
測定方法
# 依存関係数をカウント
rg "^import|^require" -c src/
# 被参照数をカウント
for file in src/**/*.ts; do
name=$(basename "$file" .ts)
count=$(rg "$name" src/ -l | wc -l)
echo "$name: $count"
done
凝集度
# クラス内のメソッド呼び出し関係を分析
# LCOM (Lack of Cohesion of Methods) が高い=凝集度が低い
コードカバレッジ
JavaScript/TypeScript
# Jest
npm test -- --coverage
# Istanbul/nyc
nyc npm test
# カバレッジレポート
npm test -- --coverage --coverageReporters=text --coverageReporters=html
Python
# coverage.py
pip install coverage
coverage run -m pytest
coverage report
coverage html
# pytest-cov
pytest --cov=src --cov-report=html
カバレッジ基準
- 80%+: 良好
- 70-80%: 改善余地あり
- 70%未満: 優先的にテスト追加
コード重複（DRY原則）
# CPD (Copy-Paste Detector)
pmd cpd --directory src/ --minimum-tokens 100
#jscpd
npx jscpd src/
# 結果の解釈
# 5%未満: 良好
# 5-10%: 注意
# 10%+: 要リファクタリング
メンテナビリティインデックス
0-100のスコアで保守性を評価。複雑度、コード行数、Halsteadボリュームを組み合わせ。
# radon（Python）
radon mi src/ -s
# スコア基準
# 20-100: 良好
# 10-19: 中程度
# 0-9: 低い
技術的負債
SQALE（Software Quality Assessment based on Lifecycle Expectations）
# SonarQubeでの測定
# 技術的負債 = 修正にかかる推定時間
負債比率
負債比率 = 技術的負債 / コード規模
- 0-5%: 優秀
- 5-10%: 許容範囲
- 10%+: 優先対応必要
メトリクス統合レポート
#!/bin/bash
echo "=== Code Metrics Report ==="
echo ""
echo "=== Cyclomatic Complexity ==="
radon cc src/ -s -a
echo ""
echo "=== Maintainability Index ==="
radon mi src/ -s
echo ""
echo "=== Test Coverage ==="
coverage report
echo ""
echo "=== Code Duplication ==="
npx jscpd src/ --reporters consoleSummary
改善優先順位の決定
- 複雑度が高く、カバレッジが低い → 最優先でリファクタリング+テスト追加
- 結合度が高い → インターフェース導入、DI検討
- 重複コード → 共通関数/モジュールに抽出
- 低凝集度 → クラス分割検討
Converted and distributed by TomeVault — claim your Tome and manage your conversions.