name: generate-design description: 開発作業の設計書(design.md)を生成します。このスキルは単独で使用することも、generate-working-docsから呼び出されることもあります。
設計書生成スキル
概要
このスキルは、開発作業の設計書(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/ ディレクトリにある永続化ドキュメントを参照して、既存のアーキテクチャやコーディング規約に準拠した設計にしてください。
参照すべきドキュメント
| ドキュメント | 参照目的 |
|---|---|
docs/steering/03_architecture_specifications.md | 技術スタック・アーキテクチャを確認し、設計が技術方針に準拠するか検証 |
docs/steering/04_repository_structure.md | ディレクトリ構造・命名規則を確認し、適切なファイル配置を決定 |
docs/steering/05_development_guidelines.md | コーディング規約を確認し、設計例が規約に準拠するか検証 |
docs/steering/06_ubiquitous_language.md | プロジェクト用語の正しい使用を確認し、型定義や変数名に反映 |
参照ルール
- データ構造設計時: ユビキタス言語定義書で正しい用語を使用し、型定義を作成
- ファイル配置設計時: リポジトリ構造定義書で正しいディレクトリ構造を確認
- コード例記載時: 開発ガイドラインとアーキテクチャ仕様書を確認し、規約に準拠したコードを記載
- API設計時: 技術仕様書で既存のAPIパターンを確認し、一貫性のある設計を行う
- 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 移行対応表
| v3(使用禁止) | v4(使用必須) | 説明 |
|---|---|---|
UFormGroup | UFormField | フォームフィールドラッパー |
options 属性 | items 属性 | USelect, USelectMenu等の選択肢 |
正しい記法例(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- テスト手順書生成スキル