screen-spec-generator

name	screen-spec-generator
description	Flutterプロジェクトの画面定義書（screen specification）を作成・管理するスキル。 「画面定義書を作成したい」「〇〇画面の定義書を作って」などの発言で発動し、 プロジェクト構造を解析してテンプレートをセットアップし、個別の画面定義書を生成します。

画面定義書ジェネレーター スキル

このスキルは、Flutterプロジェクトにおける画面定義書の作成環境をセットアップし、個別の画面定義書を生成・更新する機能を提供します。

発動トリガー

以下のような発言で発動します：

• 「画面定義書を作成したい」「screen specを生成」「画面仕様書を書きたい」
• 「画面定義書の環境をセットアップ」「screen specを導入したい」
• 「〇〇画面の定義書を作って」「〇〇ページのspec」
• 「画面の仕様をドキュメント化したい」
• 「画面定義書を更新して」「定義書を最新化」

機能概要

このスキルは以下を行います：

1. プロジェクト構造を自動解析して確認
2. 必要なセクションを会話で選択
3. テンプレートとカスタムコマンドを生成
4. 個別の画面定義書を生成
5. 既存の画面定義書を差分検出して更新

重要: 会話の進め方

各ステップで必ずユーザーの回答を待ってから次のステップに進むこと。

• ステップ1で質問したら、ユーザーの回答を待つ
• ユーザーが回答したら、次のステップに進む
• 複数の質問を一度にしない

これにより、ユーザーが混乱せず、段階的に設定を進められます。

---

動作モード

このスキルには3つの動作モードがあります：

モード1: 初期セットアップ（環境が未構築の場合）

プロジェクトに docs/screen_specs/template.md が存在しない場合、セットアップモードで動作します。

モード2: 画面定義書生成（環境構築済み、定義書未作成の場合）

プロジェクトに docs/screen_specs/template.md が存在し、対象画面の定義書が存在しない場合、新規生成モードで動作します。

モード3: 画面定義書更新（定義書が既に存在する場合）

対象画面の定義書が既に存在する場合、更新モードで動作します。コードを再解析し、差分を検出してユーザーに提示します。

---

モード1: 初期セットアップの手順

ステップ1: プロジェクト解析

まず、プロジェクトの構造を解析します。

CLAUDE.md がある場合

1. CLAUDE.md を読み込み、以下の情報を取得：

   • フレームワーク（Flutter）
   • 状態管理（Riverpod, BLoC, Provider等）
   • ルーティングライブラリ（auto_route, go_router等）
   • アーキテクチャパターン

2. 具体的なパス構造を自動解析：

   • UI層のパス（, など）