rev-specs

rev-specs

目的

既存のコードベースから包括的なテストケースと仕様書を逆生成する。実装されたビジネスロジック、API動作、UI コンポーネントの動作を分析し、不足しているテストケースを特定・生成し、仕様書として文書化する。

前提条件

• 分析対象のコードベースが存在する
• docs/spec/{要件名}/ ディレクトリが存在する（なければ作成）
• 可能であれば事前に /tsumiki:rev-requirements, /tsumiki:rev-design を実行済み

実行内容

1. 既存テストの分析

   • 単体テスト（Unit Test）の実装状況確認
   • 統合テスト（Integration Test）の実装状況確認
   • E2Eテスト（End-to-End Test）の実装状況確認
   • テストカバレッジの測定

2. 実装コードからテストケースの逆生成

   • 関数・メソッドの引数・戻り値からのテストケース生成
   • 条件分岐からの境界値テスト生成
   • エラーハンドリングからの異常系テスト生成
   • データベース操作からのデータテスト生成

3. API仕様からテストケースの生成

   • 各エンドポイントの正常系テスト
   • 認証・認可テスト
   • バリデーションエラーテスト
   • HTTPステータスコードテスト

4. UI コンポーネントからテストケースの生成

   • コンポーネントレンダリングテスト
   • ユーザーインタラクションテスト
   • 状態変更テスト
   • プロパティ変更テスト

5. パフォーマンス・セキュリティテストケースの生成

   • 負荷テストシナリオ
   • セキュリティ脆弱性テスト
   • レスポンス時間テスト

6. テスト仕様書の生成

   • テスト計画書
   • テストケース一覧
   • テスト環境仕様
   • テスト手順書

7. ファイルの作成

   • docs/spec/{要件名}/test-specs.md - テスト仕様書
   • docs/spec/{要件名}/test-cases.md - テストケース一覧
   • docs/spec/{要件名}/tests/ - 生成されたテストコード

出力フォーマット例

test-specs.md

# {要件名} テスト仕様書（逆生成）

## 分析概要

**分析日時**: {実行日時}
**対象コードベース**: {パス}
**テストカバレッジ**: {現在のカバレッジ}%
**生成テストケース数**: {生成数}個
**実装推奨テスト数**: {推奨数}個

## 現在のテスト実装状況

### テストフレームワーク
- **単体テスト**: {Jest/Vitest/pytest等}
- **統合テスト**: {Supertest/TestContainers等}
- **E2Eテスト**: {Cypress/Playwright等}
- **コードカバレッジ**: {istanbul/c8等}

### テストカバレッジ詳細

| ファイル/ディレクトリ | 行カバレッジ | 分岐カバレッジ | 関数カバレッジ |
|---------------------|-------------|-------------|-------------|
| src/auth/ | 85% | 75% | 90% |
| src/users/ | 60% | 45% | 70% |
| src/components/ | 40% | 30% | 50% |
| **全体** | **65%** | **55%** | **75%** |

### テストカテゴリ別実装状況

#### 単体テスト
- [x] **認証サービス**: auth.service.spec.ts
- [x] **ユーザーサービス**: user.service.spec.ts
- [ ] **データ変換ユーティリティ**: 未実装
- [ ] **バリデーションヘルパー**: 未実装

#### 統合テスト
- [x] **認証API**: auth.controller.spec.ts
- [ ] **ユーザー管理API**: 未実装
- [ ] **データベース操作**: 未実装

#### E2Eテスト
- [ ] **ユーザーログインフロー**: 未実装
- [ ] **データ操作フロー**: 未実装
- [ ] **エラーハンドリング**: 未実装

## 生成されたテストケース

### API テストケース

#### POST /auth/login - ログイン認証

**正常系テスト**
```typescript
describe('POST /auth/login', () => {
  it('有効な認証情報でログイン成功', async () => {
    const response = await request(app)
      .post('/auth/login')
      .send({
        email: '[email protected]',
        password: 'password123'
      });