Generate Working Docs

開発作業ドキュメント生成スキル

概要

このスキルは、プロジェクトの開発ガイドライン（CLAUDE.mdの開発作業ドキュメント構成）に準拠した開発作業ドキュメント群を docs/working/{YYYYMMDD}_{要件名}/ 配下に自動生成します。

対応する作業タイプ：

• 新規機能開発
• パフォーマンス改善・最適化作業

使用シーン

新規機能開発

• 新規開発作業の開始時
• 要件定義から実装までを体系的に進めたいとき
• ドキュメント構成を統一したいとき

パフォーマンス改善

• パフォーマンスボトルネックの調査・改善時
• 計測→分析→実装→検証のサイクルを進めたいとき
• ベンチマーク結果を記録したいとき

生成ファイル

実行手順

このスキルが呼び出されたら、以下の手順で実行してください：

1. 作業タイプの判定

ユーザーの要求から作業タイプを判定します：

• WBSに「パフォーマンス改善」「高速化」等のキーワードがある → パフォーマンス改善
• それ以外 → 新規機能開発

注意: ユーザーに明示的に確認する必要はありません。コンテキストから判断してください。

2. 要件名の確認

ユーザーに要件名を確認します。要件名は英語のケバブケース（例：query-execution, export-csv, optimize-rendering）を推奨します。

3. ディレクトリ作成

本日の日付（YYYYMMDD形式）と要件名を組み合わせてディレクトリを作成します：

mkdir -p docs/working/{YYYYMMDD}_{要件名}

4. サブスキルの順次実行

以下のサブスキルを順次実行します（並列実行禁止）：

1. generate-requirements - 要件定義書生成
   • パラメータ: directory_path, requirement_name, work_type（"feature" または "performance"）
   • ディレクトリパスと要件名、作業タイプを渡す
2. generate-design - 設計書生成
   • パラメータ: directory_path, requirement_name, work_type（"feature" または "performance"）
   • ディレクトリパスと要件名、作業タイプを渡す
   • requirements.md を参照して設計を作成
3. generate-tasklist - タスクリスト生成
   • パラメータ: directory_path, requirement_name, work_type（"feature" または "performance"）
   • ディレクトリパスと要件名、作業タイプを渡す
   • requirements.md と design.md を参照してタスクを作成
4. generate-testing - テスト手順書生成
   • パラメータ: directory_path, requirement_name, work_type（"feature" または "performance"）
   • ディレクトリパスと要件名、作業タイプを渡す
   • requirements.md、design.md、tasklist.md を参照してテスト手順を作成

重要: 各スキルは前のスキルの成果物に依存するため、必ず順次実行してください。

注意:

• task_{タスクID}.md は初期生成せず、開発中に必要に応じて作成します。
• work_type パラメータは、各サブスキルが適切なテンプレートを選択するために使用されます。

5. 完了報告

生成したディレクトリとファイル一覧をユーザーに報告します。 作業タイプ（新規機能開発 または パフォーマンス改善）も明示します。

使用例

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

関連スキル

• generate-requirements - 要件定義書生成スキル
• generate-design - 設計書生成スキル
• generate-tasklist - タスクリスト生成スキル
• generate-testing - テスト手順書生成スキル

関連ドキュメント

• CLAUDE.md - 開発作業ドキュメントの構成ルール
• docs/ - 永続化ドキュメント群

技術仕様の注意事項

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

重要: ドキュメント生成時は、docs/steering/ ディレクトリにある永続化ドキュメントを参照してください。

参照すべきドキュメント

参照ルール

1. 要件定義書生成時: プロダクト要求定義書と関連する機能詳細仕様を参照
2. 設計書生成時: 技術仕様書、リポジトリ構造定義書、開発ガイドラインを参照
3. コード例記載時: ユビキタス言語定義書で用語を確認
4. 全ドキュメント生成時: 既存の永続化ドキュメントとの整合性を保つ

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>

ドキュメント生成時のルール

1. コード例には必ず Nuxt UI v4 の記法を使用する
2. v3 の記法（UFormGroup, options 属性）は絶対に使用しない
3. 既存の CLAUDE.md に記載された技術スタック情報を参照する

Converted and distributed by TomeVault — claim your Tome and manage your conversions.