piv-validate

検証

このプロジェクトにあるすべてのチェックを実行し、PASS／FAIL の判定を1つ報告します。

⚠️ まずは自分のプロジェクトに合わせてください

このスキルはテンプレートです。以下のコマンド一覧はプレースホルダーです。実際にあなたのプロジェクトで使っているコマンドに置き換えてください。 カスタムチェッカーの要点はここにあります。スタックの CLI を呼び出すため、汎用化できない唯一のスキルです。

実際のコマンドは、package.json のスクリプト、pyproject.toml、Makefile、justfile、docker-compose.yml、CI ワークフロー、または README で確認してから、以下を削除して貼り付けてください。

チェッカーが気付かれないまま誤った結果を報告する主な原因なので、次の2点に注意してください。

1. 作業ディレクトリ。 多くのツールは現在のディレクトリから設定を検出します。設定が backend/pyproject.toml にある場合、コマンドはリポジトリのルートからの uv run pytest ではなく、cd backend && uv run pytest です。
2. クロスプラットフォーム対応。 チームに Windows ユーザーがいる場合は、POSIX 専用の書き方を避けてください。よくある問題は lsof、python3、バックグラウンドで実行してから kill する方法です。

チェックは順番に実行してください。失敗しても続行し、すべての結果を報告できるようにします。失敗したコマンドの出力は記録してください。

1. テスト

# REPLACE: your test command, run from the right directory
<your test command>

期待される結果： すべてのテストが成功します。

2. 型チェック

# REPLACE: e.g. mypy, tsc --noEmit, go vet
<your type-check command>

期待される結果： 型エラーがありません。

3. リント／フォーマットチェック

# REPLACE: e.g. ruff check, biome check, eslint
<your lint command>

期待される結果： 問題がありません。

4. サーフェスごとに繰り返す

フルスタックプロジェクトには、各項目が複数あります。サーフェスごとにセクションを追加してください。たとえば、バックエンドのテスト、バックエンドの型チェック、バックエンドのリント、フロントエンドのテスト、フロントエンドの型チェック、フロントエンドのリントを追加すると、1つのコマンドでリポジトリ全体を確認できます。

5. 任意 — ライブスモークテスト

変更がルーティング、ミドルウェア、または起動処理に関係する場合にのみ実行してください。テストスイートですでにアプリをプロセス内でテストしている場合は省略します。

# REPLACE: start your app, hit one endpoint, confirm the status code, stop it
<your run command>

このスキルの中からバックグラウンドでサーバーを起動して終了するのではなく、2つ目のシェルでサーバーを起動することをおすすめします。バックグラウンドで起動して終了する方法は、すべての環境で使えるわけではありません。

6. サマリーレポート

各チェックの結果を ✅ または ❌ で示し、最後に全体の判定を報告してください。

• チェックごとに1行
• 全体：PASS または FAIL

❌ のチェックについては、失敗したコマンドと関連する出力を記載してください。ここでは何も修正しないでください。このスキルは結果を報告するものであり、修正は別の手順です。

注意事項

• このスキルは高速に保ってください。コミットの前に毎回実行します。時間がかかる手順があれば、チェッカーから削除するのではなく、その手順を高速化してください。
• 失敗を検出できないチェッカーには価値がありません。コマンドを設定したら、意図的に何かを壊し、このスキルが ❌ を報告することを確認してください。