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-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 | 関連機能の詳細仕様を確認し、統合ポイントや影響範囲を把握 |
参照ルール
- 新規機能の要件定義時: プロダクト要求定義書で全体の方針を確認し、機能詳細仕様で既存機能との整合性を検証
- パフォーマンス改善の要件定義時: 技術仕様書で現在のアーキテクチャを確認し、最適化の方向性を検討
- 用語使用時: ユビキタス言語定義書で正しい用語を確認し、プロジェクト全体で統一された表現を使用
- 既存機能への影響がある場合: 該当する機能詳細仕様を確認し、変更による影響範囲を明記
テンプレート
詳細は template.md を参照してください。
関連スキル
generate-working-docs- 全ドキュメントを生成するメインスキルgenerate-design- 設計書生成スキルgenerate-tasklist- タスクリスト生成スキルgenerate-testing- テスト手順書生成スキル