開発作業ドキュメント生成スキル（新規機能開発）

概要

このスキルは、新規機能開発のドキュメント群を docs/working/{YYYYMMDD}_{要件名}/ 配下に自動生成します。

パフォーマンス改善・最適化作業には generate-performance-docs を使用してください。

使用シーン

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

生成ファイル

ファイル	内容
requirements.md	要件定義書。この開発作業で実現したいことを記載
design.md	設計書。実装方針、データ構造、テストコードを記載
tasklist.md	タスクリスト。作業項目と進捗状況を管理
testing.md	テスト手順書。操作手順で確認する方法を記載

実行手順

1. 要件名の確認

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

2. ディレクトリ作成

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

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

3. ドキュメントの生成

以下の4ファイルをすべて生成します。各テンプレートは templates.md を参照してください。

重要: テンプレートの穴埋めではなく、ユーザーが提供した要件や docs/steering/ の永続化ドキュメントを参照しながら実際の内容を記載してください。

requirements.md の生成

templates.md の「requirements.md テンプレート」を使用して生成します。

参照すべき永続化ドキュメント：

• docs/steering/01_product_requirements.md - プロダクト全体の要件・機能を確認
• docs/steering/02_functional_design.md - 既存の画面・機能設計を参照
• docs/steering/06_ubiquitous_language.md - プロジェクト用語の正しい使用
• docs/steering/features/*.md - 関連機能の詳細仕様

design.md の生成

templates.md の「design.md テンプレート」を使用して生成します。

参照すべき永続化ドキュメント：

• docs/steering/03_architecture_specifications.md - 技術スタック・アーキテクチャを確認
• docs/steering/04_repository_structure.md - ディレクトリ構造・命名規則を確認
• docs/steering/05_development_guidelines.md - コーディング規約（多言語対応含む）を確認
• docs/steering/06_ubiquitous_language.md - 型定義・変数名の用語確認

重要: コード例では Nuxt UI v4 の記法を使用してください。

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

tasklist.md の生成

templates.md の「tasklist.md テンプレート」を使用して生成します。

参照すべき永続化ドキュメント：

• docs/steering/04_repository_structure.md - ディレクトリ構造・命名規則を確認
• docs/steering/05_development_guidelines.md - 開発プロセス・レビュー手順を確認

testing.md の生成

templates.md の「testing.md テンプレート」を使用して生成します。

参照すべき永続化ドキュメント：

• docs/steering/01_product_requirements.md - プロダクトの期待される動作を確認
• docs/steering/02_functional_design.md - UI/UXの仕様を確認
• docs/steering/05_development_guidelines.md - テスト方針を確認

重要: 可能な限り手動操作で確認する手順を記載し、操作で確認できない項目のみ自動テストを記載します。

task_{タスクID}.md は初期生成せず、開発中に必要に応じて作成します。

4. 完了報告

生成したディレクトリとファイル一覧をユーザーに報告します。

使用例

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

関連スキル

• generate-performance-docs - パフォーマンス改善作業用ドキュメント生成スキル
• generate-requirements - 要件定義書のみを単体再生成するスキル
• generate-design - 設計書のみを単体再生成するスキル
• generate-tasklist - タスクリストのみを単体再生成するスキル
• generate-testing - テスト手順書のみを単体再生成するスキル

関連ドキュメント

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