rootcause-mcp: Skill for Claude Code

測試生成技能

描述

為指定的程式碼自動生成完整測試套件，包含靜態分析、單元測試、整合測試及覆蓋率報告。

觸發條件

• 「生成測試」、「寫測試」、「test this」
• 「建立單元測試」、「建立整合測試」
• 「靜態分析」、「type check」
• 「覆蓋率」、「coverage」

---

測試金字塔

        /\
       /  \      E2E Tests (少量)
      /----\
     /      \    Integration Tests (中等)
    /--------\
   /          \  Unit Tests (大量)
  /------------\
 / Static Analysis (基礎)

---

Python 測試策略

1️⃣ 靜態分析 (Static Analysis)

工具配置

工具	用途	配置檔
mypy	類型檢查	pyproject.toml / mypy.ini
ruff	Linting + Formatting (取代 pylint/flake8/black)	pyproject.toml
bandit	安全性掃描	.bandit
vulture	死碼檢測 (dead code)	pyproject.toml

vulture 配置範例

# pyproject.toml
[tool.vulture]
min_confidence = 80
paths = ["src"]
exclude = ["tests/", "**/migrations/"]
ignore_names = ["visit_*", "do_*"]  # 常見動態呼叫的 patterns

vulture 執行指令

# 基本掃描
vulture src/ --min-confidence 80

# 生成白名單
vulture src/ --make-whitelist > .vulture_allowlist.py

# 使用白名單掃描
vulture src/ .vulture_allowlist.py --min-confidence 80

vulture 白名單範例

# .vulture_allowlist.py
# 此檔案用於標記 vulture 誤判的「假陽性」

# Framework callbacks (動態呼叫)
_.on_startup  # unused method
_.on_shutdown  # unused method
_.setup  # unused method

# CLI entry points
_.main  # unused function

# Test fixtures (pytest)
_.fixture_*  # unused function

# Abstract methods
_.abstract_method  # unused method

mypy 配置範例

# pyproject.toml
[tool.mypy]
python_version = "3.11"
strict = true
warn_return_any = true
warn_unused_ignores = true
disallow_untyped_defs = true
disallow_incomplete_defs = true
check_untyped_defs = true
no_implicit_optional = true

[[tool.mypy.overrides]]
module = ["tests.*"]
disallow_untyped_defs = false

ruff 配置範例

# pyproject.toml
[tool.ruff]
target-version = "py311"
line-length = 88
select = [
    "E",   # pycodestyle errors
    "W",   # pycodestyle warnings
    "F",   # pyflakes
    "I",   # isort
    "B",   # flake8-bugbear
    "C4",  # flake8-comprehensions
    "UP",  # pyupgrade
    "ARG", # flake8-unused-arguments
    "SIM", # flake8-simplify
]
ignore = ["E501"]  # line too long (handled by formatter)

[tool.ruff.isort]
known-first-party = ["src"]