設計書生成スキル

設計書生成スキル

概要

このスキルは、開発作業の設計書（design.md）を生成します。

使用シーン

• 要件定義書を元に設計を開始するとき
• パフォーマンス改善作業の最適化設計を開始するとき
• 既存の開発作業ディレクトリに設計書を追加するとき
• 設計書を再生成するとき

必要な情報

• ディレクトリパス: 設計書を配置する docs/​working/​{YYYYMMDD}_{要件名}/ のパス
• 要件名: 英語のケバブケース（例：query-execution, export-csv, optimize-rendering）
• 作業タイプ (オプション): "feature" (新規機能開発) または "performance" (パフォーマンス改善)

前提条件

• requirements.md が存在すること（推奨）
  • 設計は要件定義を元に作成されるため

実行手順

1. ディレクトリパスと作業タイプの確認

ユーザーまたは親スキルから以下を取得します：

• 開発作業ディレクトリパス
• 作業タイプ（指定がない場合は "feature" をデフォルトとする）

2. テンプレートの選択

作業タイプに応じてテンプレートを選択します：

• work_type = "feature": 新規機能開発用テンプレート
• work_type = "performance": パフォーマンス改善用テンプレート

3. design.md の生成

template.md または template-performance.md のテンプレートを使用して、design.md を生成します。

重要: Nuxt UI v4 の記法を使用してください。

• UFormField を使用（UFormGroup は使用禁止）
• items 属性を使用（options 属性は使用禁止）

3. 完了報告

生成したファイルのパスをユーザーに報告します。

永続化ドキュメントの参照

重要: 設計書生成時は、docs/​steering/ ディレクトリにある永続化ドキュメントを参照して、既存のアーキテクチャやコーディング規約に準拠した設計にしてください。

参照すべきドキュメント

参照ルール

1. データ構造設計時: ユビキタス言語定義書で正しい用語を使用し、型定義を作成
2. ファイル配置設計時: リポジトリ構造定義書で正しいディレクトリ構造を確認
3. コード例記載時: 開発ガイドラインとアーキテクチャ仕様書を確認し、規約に準拠したコードを記載
4. API設計時: 技術仕様書で既存のAPIパターンを確認し、一貫性のある設計を行う
5. UI設計時: docs/​steering/​05_development_guidelines.md の「2.4 多言語対応（i18n）」セクションを確認し、全ての表示文字列を翻訳キーで管理する設計とする

テンプレート

詳細は template.md を参照してください。

技術仕様の注意事項

多言語対応（i18n）

重要: 全てのUI要素は多言語対応が必須です。

設計書作成時は以下を必ず確認してください：

• コード例にハードコードされた文字列がないこと
• 翻訳キー構造を設計し、ja.json と en.json への追加内容を明記すること
• 動的な値はプレースホルダー（{name}, {count} 等）で対応すること

詳細は docs/​steering/​05_development_guidelines.md の「2.4 多言語対応（i18n）」セクションを参照してください。

Nuxt UI v4 コンポーネント記法

重要: このプロジェクトは Nuxt UI v4 を使用しています。コード例では必ず以下の記法を使用してください。

v3 → v4 移行対応表

正しい記法例（v4）

<template>
  <!-- ✅ 正しい: UFormField + items -->
  <UFormField label="データベース" name="database">
    <USelect v-model="selected" :items="databases" />
  </​UFormField>

  <!-- ✅ 正しい: USelectMenu + items -->
  <USelectMenu v-model="selected" :items="options" />
</​template>

誤った記法例（v3）

<template>
  <!-- ❌ 間違い: UFormGroup（v3） -->
  <UFormGroup label="データベース">
    <USelect v-model="selected" :options="databases" />
  </​UFormGroup>

  <!-- ❌ 間違い: options 属性（v3） -->
  <USelectMenu v-model="selected" :options="options" />
</​template>

関連スキル

• generate-working-docs - 全ドキュメントを生成するメインスキル
• generate-requirements - 要件定義書生成スキル
• generate-tasklist - タスクリスト生成スキル
• generate-testing - テスト手順書生成スキル