Claude-skill-registry generate-design

開発作業の設計書(design.md)を生成します。このスキルは単独で使用することも、generate-working-docsから呼び出されることもあります。

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/generate-design" ~/.claude/skills/majiayu000-claude-skill-registry-generate-design && rm -rf "$T"
manifest: skills/data/generate-design/SKILL.md
source content

設計書生成スキル

概要

このスキルは、開発作業の設計書(

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
プロジェクト用語の正しい使用を確認し、型定義や変数名に反映

参照ルール

  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 移行対応表

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
    - テスト手順書生成スキル