testing-quality-standards

テスト品質基準

Claude Night Market エコシステムのすべてのプラグインに共通する、テスト品質の基準と指標です。

使用する場面

• テスト品質のゲートとカバレッジ目標を設定する
• 品質基準に照らしてテストスイートを検証する

使用しない場面

• 探索的テストやスパイク作業
• 要件を満たす品質ゲートがすでに確立されているプロジェクト

カバレッジのしきい値

レベル	カバレッジ	ユースケース
最低	60%	レガシーコード
標準	80%	通常の開発
高	90%	重要なシステム
詳細	95%+	セーフティクリティカルなシステム

品質指標

構成

• テストが明確に整理されている
• テスト名に意味がある
• 適切なセットアップ／ティアダウンが行われている
• テストケースが分離されている

カバレッジ

• 重要なパスがカバーされている
• エッジケースがテストされている
• エラー条件が処理されている
• 統合ポイントが検証されている

保守性

• テストコードに DRY 原則が適用されている
• フィクスチャが再利用できる
• アサーションが明確である
• モックが最小限である

信頼性

• 不安定なテストがない
• 実行結果が決定的である
• 実行順序に依存しない
• フィードバックループが速い

詳細トピック

実装パターンと例については、以下を参照してください。

• アンチパターン - よくあるテストの間違いと修正前後の例
• ベストプラクティス - テストの基本原則と終了基準
• コンテンツアサーションレベル - LLM が解釈する Markdown ファイルをテストするための L1/L2/L3 分類

プラグインテストとの統合

このスキルは、以下で参照される基礎的な基準を提供します。

• pensive:test-review - カバレッジのしきい値と品質指標を使用します
• parseltongue:python-testing - アンチパターンとベストプラクティスを使用します
• sanctum:test-* - テスト検証に品質チェックリストとコンテンツアサーションレベルを使用します
• imbue:proof-of-work - 実行 Markdown に鉄則を適用するため、コンテンツアサーションレベルを使用します

スキルのフロントマターで参照してください。

dependencies: [leyline:testing-quality-standards]

検証： pytest -v を実行し、テストがパスすることを確認します。

トラブルシューティング

よくある問題

テストが検出されない テストファイル名が test_*.py または *_test.py のパターンに一致していることを確認してください。pytest --collect-only を実行して確認します。

インポートエラー テスト対象のモジュールが PYTHONPATH に含まれていることを確認するか、pip install -e . でインストールしてください。

非同期テストが失敗する pytest-asyncio をインストールし、テスト関数に @pytest.mark.asyncio を付けてください。

終了基準

• プロジェクトの階層に応じたカバレッジのしきい値を満たしている：レガシーコードは最低 60%、通常の開発は 80%、重要なシステムは 90%、セーフティクリティカルなシステムは 95%+。pytest --cov で測定し、pyproject.toml でしきい値を適用する
• 4 つすべての品質指標チェックリストに合格している：構成（明確な整理、意味のある名前、セットアップ／ティアダウン、分離）、カバレッジ（重要なパス、エッジケース、エラー条件、統合ポイント）、保守性（DRY なフィクスチャ、明確なアサーション、最小限のモック）、信頼性（不安定なテストがない、決定的な実行、実行順序への依存がない）
• テストファイルが test_*.py または *_test.py の検出パターンに一致している。pytest --collect-only でエラーが返されないことを確認する
• 非決定的な出力（ハッシュマップ、タイムスタンプ、UUID）に対するスナップショットテストがない。見つかった場合は modules/anti-patterns.md に従ってアンチパターンとして指摘する