仕様書整合性チェック

Use when

• •実装完了後、コミット前の仕様書更新漏れチェック
• •スキーマ変更・リネーム・機能追加の後
• •「仕様書と合ってる？」と聞かれたとき

Don't use when

• •仕様書の新規作成（→ 手動で書く）
• •コードの実装やリファクタリング（→ /implement or /tdd）

進捗管理

スキル開始時に全ステップを TaskCreate で登録し、各ステップの開始・完了時に TaskUpdate で状態を更新すること。

タスク一覧:

1. •Step 1: 変更範囲の特定（activeForm: "変更範囲を特定中"）
2. •Step 2: データモデル整合性チェック（activeForm: "データモデルをチェック中"）
3. •Step 3: Server Actions 整合性チェック（activeForm: "Server Actions をチェック中"）
4. •Step 4: 用語・その他の整合性チェック（activeForm: "用語をチェック中"）

対象

$ARGUMENTS

Step 1: 変更範囲の特定

直近の変更内容を把握する。

1. •$ARGUMENTS の内容に応じて変更範囲を特定する
   • •「直近の変更」→ git diff HEAD~1 または git diff --cached で差分を確認
   • •特定のファイル・機能が指定された場合 → そのファイルを読む
2. •変更に関連する仕様書ファイルを特定する
   • •docs/project/specification.md — データモデル、Server Actions、変動率計算、バッチ設計
   • •docs/project/requirements.md — ユースケース、機能要件、画面定義

Step 2: データモデル整合性チェック

specification.md のデータモデルと prisma/schema.prisma を突合する。

チェック項目

• • テーブル名が一致している（@@map の値）
• • カラム名が一致している（@map の値）
• • FK のリレーション先が一致している
• • UNIQUE 制約が一致している
• • 新規追加・削除されたテーブル/カラムが仕様書に反映されている

手順

1. •prisma/schema.prisma を読む
2. •docs/project/specification.md のデータモデルセクションを読む
3. •両者を突合し、差分を洗い出す

Step 3: Server Actions 整合性チェック

specification.md の Server Actions 一覧と src/actions/ 内の実装を突合する。

チェック項目

• • Action 名が一致している（関数名）
• • 入力の型/引数が一致している
• • 出力の型が一致している
• • 新規追加・削除された Action が仕様書に反映されている

手順

1. •src/actions/ 配下の全ファイルから export された関数を Grep で抽出する
2. •docs/project/specification.md の Server Actions セクションを読む
3. •両者を突合し、差分を洗い出す

Step 4: 用語・その他の整合性チェック

仕様書全体の用語とコードの命名の一貫性を確認する。

チェック項目

• • モデル名・テーブル名の用語が仕様書とコードで一致している
• • UI に表示されるラベル（ドメイン用語）が requirements.md の記述と矛盾していない
• • 変動率計算の期間一覧が実装と一致している（specification.md）
• • バッチ設計の記述が実装と矛盾していない（specification.md）

結果報告

## 仕様書整合性チェック結果

### チェック対象
- {変更範囲の概要}

### 齟齬一覧
| # | 仕様書 | セクション | 内容 | 修正案 |
|---|--------|-----------|------|--------|
| 1 | specification.md | データモデル | {差分の説明} | {修正案} |

### 総評
{整合性の全体評価}

齟齬がない場合は「齟齬なし — 仕様書は最新の実装と一致しています」と明記する。 齟齬がある場合は修正案を提示するが、自動修正はしない（ユーザーの確認を得てから修正する）。