sakamotchi/generate-requirements

要件定義書生成スキル

概要

このスキルは、開発作業の要件定義書（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-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 を参照してください。

関連スキル

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