Spec Compliance Auto Skill

Spec Compliance Auto Skill

概要

このSkillは、実装が仕様書に準拠しているかを自動的にチェックし、仕様逸脱リスクを特定します。仕様準拠率95%以上を維持するための手順・チェックリスト・判断基準を提供します。

使用タイミング

Claudeは以下の状況でこのSkillを自律的に使用すべきです：

1. 新機能実装前

   • 仕様書の該当セクション特定時
   • 実装要件理解時
   • テスト設計時

2. 実装中

   • 仕様書参照が必要な判断時
   • ビジネスルール実装時
   • バリデーションロジック実装時

3. 実装後

   • Step完了時の仕様準拠確認
   • Phase完了時の仕様準拠監査
   • spec-compliance-check Command実行時

4. 仕様変更時

   • 仕様書更新後の影響範囲確認
   • 既存実装の仕様準拠性再確認

spec-compliance-check Command活用パターン

Command実行タイミング

必須実行:

• Step完了時（step-end-review Command内で自動実行）
• Phase完了時（phase-end Command内で自動実行）
• 仕様書更新直後

推奨実行:

• 新機能実装完了時
• バグ修正完了時
• リファクタリング完了時

Command実行方法

# spec-compliance-check Command実行
/​spec-compliance-check

# 実行内容:
# 1. Doc/​01_Requirements/配下の仕様書全ファイル読み込み
# 2. 実装コードと仕様書の照合
# 3. 仕様逸脱リスクの特定
# 4. 仕様準拠率算出
# 5. 改善提案レポート作成

仕様準拠率の目標値

• 全体: 95%以上（必達）
• 機能要件: 100%（最優先）
• 非機能要件: 90%以上
• データ整合性: 100%（最優先）
• UI/​UX要件: 85%以上

---

仕様書参照方法

仕様書の構成（Doc/​01_Requirements/）

Doc/​01_Requirements/
├── 機能仕様書.md           # 機能要件（最重要）
├── 非機能要件定義書.md      # 非機能要件
├── データベース設計書.md    # データ整合性要件
└── UI_UX仕様書.md          # UI/​UX要件

仕様書の読み方

詳細: rules/​functional-requirements-check.md

手順:

1. ✅ 機能特定: 実装する機能の仕様書項番を特定
2. ✅ 仕様精読: 肯定的仕様・否定的仕様を抽出
3. ✅ ビジネスルール理解: 制約条件・バリデーションルールを理解
4. ✅ テストケース設計: 仕様に基づくテストケース洗い出し

仕様書項番の記録ルール:

// 仕様書2.1.1準拠: ログイン機能
// ビジネスルール: ログイン失敗によるロックアウト機構は設けない
public async Task<IActionResult> Login(LoginModel model)
{
    // 実装内容
}

// 仕様書3.2.1準拠: プロジェクト作成機能
// 必須項目: プロジェクト名、説明
let createProject (name: ProjectName) (description: Description) =
    // 実装内容

---

仕様準拠チェック項目

1. 機能要件準拠チェック

詳細: rules/​functional-requirements-check.md

チェックポイント:

• ✅ 実装すべき機能が全て実装されている
• ✅ 実装してはいけない機能が実装されていない
• ✅ ビジネスルールが正確に実装されている
• ✅ バリデーションロジックが仕様通りである

典型的な問題: 仕様書に記載のない独自機能を追加してしまう

---

2. 非機能要件準拠チェック

詳細: rules/​non-functional-requirements-check.md

チェックポイント:

• ✅ パフォーマンス要件達成（レスポンスタイム3秒以内）
• ✅ セキュリティ要件達成（パスワードハッシュ化・SQL Injection対策）
• ✅ 可用性要件達成（エラーハンドリング・ログ記録）
• ✅ 保守性要件達成（コメント・ドキュメント整備）

典型的な問題: パスワードを平文で保存してしまう

---

3. データ整合性準拠チェック

詳細: rules/​data-integrity-check.md

チェックポイント:

• ✅ 主キー・外部キー制約が正しい
• ✅ NULL許容・NOT NULL制約が仕様通り
• ✅ 一意制約が仕様通り
• ✅ データ型・長さが仕様通り

典型的な問題: 仕様書で必須項目なのにNULL許容にしてしまう

---

4. UI/​UX要件準拠チェック

詳細: rules/​ui-ux-requirements-check.md

チェックポイント:

• ✅ 画面レイアウトが仕様通り
• ✅ 入力フォームのバリデーションメッセージが仕様通り
• ✅ エラーメッセージが仕様通り
• ✅ ボタン配置・ラベルが仕様通り

典型的な問題: エラーメッセージを勝手に変更してしまう

---

仕様準拠率95%維持手順

仕様準拠率算出方法

仕様準拠率 = (実装済み仕様項目数 / 全仕様項目数) × 100

例:
- 全仕様項目数: 100項目
- 実装済み仕様項目数: 97項目
- 仕様準拠率: 97%

仕様準拠率低下時の対応

95%未満の場合:

1. 🔴 緊急対応: 即座に仕様逸脱箇所を特定
2. 🔴 修正実施: 仕様に準拠するよう修正
3. 🔴 再測定: 仕様準拠率が95%以上になることを確認

90%未満の場合:

1. 🔴 重大: Phase進行停止
2. 🔴 全面見直し: 全実装を仕様書と照合
3. 🔴 再設計検討: 必要に応じて再設計

仕様準拠率維持のベストプラクティス

1. 実装前の仕様精読（最重要）

   • 仕様書を3回読む
   • 肯定的仕様・否定的仕様を明確化
   • 不明点は即座に質問

2. 仕様書項番の記録

   • すべての実装に仕様書項番をコメント
   • トレーサビリティ確保

3. 定期的な仕様準拠確認

   • Step完了時に必ず確認
   • Phase完了時に監査

---

仕様逸脱リスク特定方法

仕様逸脱の典型パターン

パターン1: 仕様書に記載のない独自機能追加

例:

// ❌ 仕様逸脱: 仕様書に記載のないキャッシュ機能を追加
public async Task<User?> GetUserByIdAsync(Guid userId)
{
    // 仕様書に記載なし
    if (_cache.TryGetValue(userId, out User cachedUser))
    {
        return cachedUser;
    }

    var user = await _userRepository.GetByIdAsync(userId);
    _cache.Set(userId, user);
    return user;
}

対策:

• 仕様書を再確認
• キャッシュ機能が本当に必要か検討
• 必要であれば仕様書を更新してから実装

パターン2: 否定的仕様の無視

例:

// ❌ 仕様逸脱: 「ログイン失敗によるロックアウト機構は設けない」を無視
public async Task<LoginResult> LoginAsync(string email, string password)
{
    var user = await _userRepository.GetByEmailAsync(email);

    if (user.FailedLoginCount >= 5) // 仕様書で禁止されている
    {
        return LoginResult.LockedOut();
    }

    // ...
}

対策:

• 否定的仕様を明確に理解
• テストで否定的仕様違反を検出

パターン3: ビジネスルールの誤実装

例:

// ❌ 仕様逸脱: パスワード最小長が仕様と異なる
public bool IsPasswordValid(string password)
{
    return password.Length >= 6; // 仕様書では8文字以上
}

対策:

• ビジネスルールを定数化
• 仕様書項番をコメントで明記

---

仕様準拠チェックリスト

Step開始時

• 該当機能の仕様書項番を特定した
• 仕様書を3回精読した
• 肯定的仕様を抽出した
• 否定的仕様を抽出した
• ビジネスルールを理解した
• テストケースを仕様に基づいて設計した

実装中

• 仕様書項番をコメントで記録した
• ビジネスルールを定数化した
• 仕様に記載のない独自機能を追加していない
• 否定的仕様を遵守している

Step完了時

• spec-compliance-check Command実行完了
• 仕様準拠率95%以上達成
• 仕様逸脱箇所を全て修正
• 全テストが成功している

---

参照元ADR・Rules

• 仕様準拠ガイド.md: 仕様ファースト開発思想・仕様準拠の3つの柱
• spec-compliance-check Command: 仕様準拠自動チェック機能

---

関連Skills

• spec-compliance Skill: 仕様準拠監査（SubAgent）
• tdd-red-green-refactor Skill: TDDサイクルでの仕様準拠テスト設計

---

作成日: 2025-11-01 Phase B-F2 Step2: Agent Skills Phase 2展開 参照Rules: 仕様準拠ガイド.md