Verification Checkpoint

Verification Checkpoint Skill

検証チェックポイントスキル。完了宣言前の必須検証。

完了宣言の条件（MUST）

宣言前に必ず確認:
  □ テストが通ること
  □ 型チェックが通ること
  □ ビルドが通ること
  □ 実際に動作すること

すべて✅でないと「完了」と言わない

検証フロー

実装完了（自己申告）
    ↓
┌─────────────────────────────────────┐
│ 1. テスト実行                        │
│    npm test / pytest                 │
│    └─ 失敗 → 修正に戻る              │
├─────────────────────────────────────┤
│ 2. 型チェック                        │
│    tsc --noEmit / mypy              │
│    └─ 失敗 → 修正に戻る              │
├─────────────────────────────────────┤
│ 3. ビルド                            │
│    npm run build                     │
│    └─ 失敗 → 修正に戻る              │
├─────────────────────────────────────┤
│ 4. 動作確認                          │
│    手動 or 自動テスト                │
│    └─ 失敗 → 修正に戻る              │
└─────────────────────────────────────┘
    ↓
すべてパス
    ↓
「完了しました」✅

検証コマンド

TypeScript/JavaScript

テスト:
  command: npm test
  期待: 全テストパス

型チェック:
  command: npx tsc --noEmit
  期待: エラーなし

Lint:
  command: npm run lint
  期待: エラーなし

ビルド:
  command: npm run build
  期待: 成功

Python

テスト:
  command: pytest
  期待: 全テストパス

型チェック:
  command: mypy .
  期待: エラーなし

Lint:
  command: ruff check .
  期待: エラーなし

検証レベル

Level 1: 最小検証（小さな変更）

対象:
  - タイポ修正
  - コメント追加
  - 設定値変更

必須チェック:
  - [ ] ビルドが通る

Level 2: 標準検証（通常の変更）

対象:
  - 機能追加
  - バグ修正
  - リファクタリング

必須チェック:
  - [ ] テストが通る
  - [ ] 型チェックが通る
  - [ ] ビルドが通る

Level 3: 完全検証（重要な変更）

対象:
  - 新機能
  - セキュリティ修正
  - 破壊的変更

必須チェック:
  - [ ] テストが通る
  - [ ] 型チェックが通る
  - [ ] ビルドが通る
  - [ ] 手動動作確認
  - [ ] セキュリティレビュー

検証レポート

検証チェックポイント:
  timestamp: 2026-02-02T12:00:00Z
  level: 2

  results:
    - name: テスト
      status: PASS
      command: npm test
      duration: 5s
      details: "42 tests passed"

    - name: 型チェック
      status: PASS
      command: npx tsc --noEmit
      duration: 3s

    - name: Lint
      status: PASS
      command: npm run lint
      duration: 2s

    - name: ビルド
      status: PASS
      command: npm run build
      duration: 10s

  verdict: ✅ PASS
  message: "すべての検証に合格しました"

失敗時の対応

テスト失敗

対応フロー:
  1. 失敗したテストを特定
  2. エラーメッセージを分析
  3. systematic-debugスキルで修正
  4. 再検証

型エラー

対応フロー:
  1. エラー箇所を特定
  2. 型定義を確認
  3. 修正（型アノテーション追加等）
  4. 再検証

ビルド失敗

対応フロー:
  1. エラーログを確認
  2. 依存関係を確認
  3. 設定ファイルを確認
  4. 修正後再検証

自動実行タイミング

トリガー:
  - 「完了しました」「できました」発言前
  - 「実装しました」発言前
  - PRを作成する前
  - デプロイする前

自動チェック:
  1. 直近の変更ファイルを検出
  2. 関連テストを実行
  3. 型チェック実行
  4. ビルド実行
  5. 結果をレポート

禁止事項

❌ テスト未実行で「完了」と言う
❌ 型エラーを無視して「完了」と言う
❌ ビルド失敗を無視して「完了」と言う
❌ 「たぶん動く」で「完了」と言う
❌ 「後でテストする」で「完了」と言う

使用例

「完了しました」→ 検証チェック自動実行
「できた」→ 検証チェック自動実行
「実装終わった」→ 検証チェック自動実行

連携スキル

更新履歴

[2026-02-02] 初期作成