---
name: generate-requirements
description: 開発作業の要件定義書（requirements.md）を生成します。このスキルは単独で使用することも、generate-working-docsから呼び出されることもあります。
---

# 要件定義書生成スキル

## 概要

このスキルは、開発作業の要件定義書（`requirements.md`）を生成します。

## 使用シーン

- 新規開発作業の要件定義を開始するとき
- パフォーマンス改善作業の要件定義を開始するとき
- 既存の開発作業ディレクトリに要件定義書を追加するとき
- 要件定義書を再生成するとき

## 必要な情報

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

## 実行手順

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

ユーザーまたは親スキルから以下を取得します：
- 既存の開発作業ディレクトリパス、または要件名（新規の場合は本日の日付と組み合わせてディレクトリを作成）
- 作業タイプ（指定がない場合は `"feature"` をデフォルトとする）

### 2. テンプレートの選択

作業タイプに応じてテンプレートを選択します：
- `work_type = "feature"`: 新規機能開発用テンプレート
- `work_type = "performance"`: パフォーマンス改善用テンプレート

### 3. requirements.md の生成

[template.md](template.md) または [template-performance.md](template-performance.md) のテンプレートを使用して、`requirements.md` を生成します。

### 3. 完了報告

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

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

**重要**: 要件定義書生成時は、`docs/steering/` ディレクトリにある永続化ドキュメントを参照して、既存のプロダクト仕様と矛盾のない内容にしてください。

### 参照すべきドキュメント

| ドキュメント | 参照目的 |
|------------|---------|
| `docs/steering/01_product_requirements.md` | プロダクト全体の要件・機能を確認し、新規要件が全体像に適合するか検証 |
| `docs/steering/02_functional_design.md` | 既存の画面・機能設計を参照し、UI/UXの一貫性を保つ |
| `docs/steering/06_ubiquitous_language.md` | プロジェクト用語の正しい使用を確認 |
| `docs/steering/features/*.md` | 関連機能の詳細仕様を確認し、統合ポイントや影響範囲を把握 |

### 参照ルール

1. **新規機能の要件定義時**: プロダクト要求定義書で全体の方針を確認し、機能詳細仕様で既存機能との整合性を検証
2. **パフォーマンス改善の要件定義時**: 技術仕様書で現在のアーキテクチャを確認し、最適化の方向性を検討
3. **用語使用時**: ユビキタス言語定義書で正しい用語を確認し、プロジェクト全体で統一された表現を使用
4. **既存機能への影響がある場合**: 該当する機能詳細仕様を確認し、変更による影響範囲を明記

## テンプレート

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

## 関連スキル

- `generate-working-docs` - 全ドキュメントを生成するメインスキル
- `generate-design` - 設計書生成スキル
- `generate-tasklist` - タスクリスト生成スキル
- `generate-testing` - テスト手順書生成スキル