ln-513-regression-checker について
ln-513-regression-checkerは、変更後の回帰確認を行うテストスキルです。テストフレームワークを検出して全テストを実行し、失敗を分類してPASSまたはFAILを報告します。Linearやkanbanは変更しません。
主な機能
- 01テストフレームワークとディレクトリの検出
- 02テストスイート全体の実行
- 03エラー種別ごとの失敗分類
- 04テスト出力全体の保持
- 05PASSまたはFAILの判定報告
活用シーン
- 01実装変更による回帰の確認
- 02Story品質ゲート向けのテスト結果作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ levnikolaevich/ claude-code-skills --skill ln-513-regression-checkerインストール後、Claude Code で/ln-513-regression-checkerを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/ci_tool_detection.mdcoordinator_summary_contract.mdinput_resolution_pattern.mdoutput_normalization.mdpytest_configuration.mdquality_summary_contract.mdquality_worker_runtime_contract.mdrisk_based_testing_guide.mdreferences/scripts/coordinator-runtime/lib/artifacts.mjscli-helpers.mjscore.mjsloop-health.mjsruntime-constants.mjsschemas.mjsvalidate.mjsworker-guards.mjsworker-runtime.mjsreferences/scripts/quality-worker-runtime/cli.mjsreferences/scripts/quality-worker-runtime/lib/guards.mjsphases.mjsstore.mjs詳細
パス: ファイルパス(
references/、../ln-*)は、このスキルディレクトリからの相対パスです。
回帰チェッカー
タイプ: L3 ワーカー カテゴリ: 5XX 品質
実装変更後に回帰がないことを確認するため、既存のテストスイートを実行します。
入力
| 入力 | 必須 | ソース | 説明 |
|---|---|---|---|
storyId | はい | args、git branch、kanban、ユーザー | 処理するストーリー |
解決方法: ストーリー解決チェーン。 ステータスフィルター: レビュー待ち
目的と範囲
- テストフレームワーク(pytest/jest/vitest/go testなど)とテストディレクトリを検出します。
- テストスイート全体を実行し、ストーリー品質ゲート用にstdout/stderrを取得します。
- 件数とログ抜粋を含むPASS/FAILを返します。Linearやkanbanは変更しません。
- 後続のログ分析用に、stdout/stderrの出力全体を保持します。
使用するタイミング
- コード品質チェックの合格後
- コード品質チェックに合格した後
ワークフロー
フェーズ 0:入力の解決
必読: references/input_resolution_pattern.md、references/ci_tool_detection.mdを読み込みます
- storyIdを解決: ガイドに従ってストーリー解決チェーンを実行します(ステータスフィルター:[レビュー待ち])。
フェーズ 1:テストの実行
必読: references/output_normalization.mdを読み込みます
存在する場合は、対象プロジェクトのファイルを読み込みます:docs/project/infrastructure.md、docs/project/runbook.md
- ci_tool_detection.mdのコマンドレジストリ(テストフレームワークのセクション)に従って、テストフレームワークを自動検出します。
- infrastructure.mdからサービスエンドポイントとポート割り当てを取得します。runbook.mdから正確なテストコマンド、Dockerのセットアップ、環境変数を取得します(ci_tool_detection.mdの検出階層に従い、runbookのコマンドを優先します)。
- 適切なテストコマンドを組み立て、タイムアウト(ci_tool_detection.mdに従って5分)を設定して実行し、stdout/stderrを取得します。
- 結果を解析し、成功・失敗の件数と主な失敗テストを特定します。
- 失敗を正規化してグループ化: テスト出力に
references/output_normalization.mdの§1~§3を適用します。失敗したテストをエラーカテゴリ(Import/Module、Assertion、Timeout、Type、Connection、Runtime)別にグループ化します。グループごとに報告します。例:「auth/でImportエラーが3件、payment/でAssertionの不一致が2件」。 - verdict JSON(PASSまたはFAILと、グループ化した失敗のリスト)を出力し、Linearにコメントを追加します。
重要なルール
- テストを選択的に実行しないでください。スイート全体を実行します。
- テストの修正やステータスの変更は行わず、報告のみ行います。
- コメントでは言語を維持します(EN/RU)。
ランタイムサマリー成果物
必読: references/quality_summary_contract.md、references/quality_worker_runtime_contract.mdを読み込みます
ランタイムプロファイル:
- family:
quality-worker - worker:
ln-513 - summary kind:
quality-worker - コーディネーターが使用するペイロードフィールド:
worker、status、verdict、issues、warnings、artifact_path
呼び出しルール:
- 単独実行:
runIdとsummaryArtifactPathを省略します - 管理実行:
runIdと正確なsummaryArtifactPathの両方を渡します - 終了結果を返す前に、必ず検証済みのサマリーを書き込みます
モニター(2.1.98+): 30秒を超えることが予想されるテストスイートコマンドには、Monitorを使用します。フォールバック:Bash(run_in_background=true)。
完了の定義
- フレームワークを検出し、コマンドを実行した
- 結果を解析し、失敗したテスト(該当する場合)を含む判定を出した
- 概要を含むトラッカーコメントを投稿した
参照ファイル
- 後続で使用するリスクベースの制限:
references/risk_based_testing_guide.md - CIツールの検出:
references/ci_tool_detection.md - 出力の正規化:
references/output_normalization.md - Pytestのパターン:
references/pytest_configuration.md
バージョン: 3.1.0 最終更新日: 2026-01-09