要件を読み解こう
ストーリー
先輩の田中さんが、メールで要件をまとめてくれた。
「これが今回の依頼内容だよ。読んでわからないことがあったら聞いてね」
メールを開くと、いくつかの項目が書かれている。
まずはこの要件を正確に読み解こう。
先輩からの依頼メール
以下が田中さんから届いた依頼メールです。
件名: 社内ツール紹介ページの作成について
お疲れさまです。田中です。
以下の作業をお願いします。
【依頼内容】
社内で使っているツールの紹介ページをHTMLで作成し、
GitHubリポジトリで公開してください。
【成果物】
1. 社内ツール紹介Webページ（HTML/CSS）
2. プロジェクトのREADME
3. 完了報告書
【データソース】
社内ツールの情報はSQLiteデータベースに格納済みです。
SQLで必要な情報を取得してください。
【要件】
- ツール一覧をカテゴリ別に表示すること
- 各ツールの名前、説明、URLを表示すること
- レスポンシブ対応は不要（PC表示のみでOK）
- GitHubにpushする前 にセルフレビューを行うこと
【期限】
1週間後（金曜日の業務終了まで）
【報告】
- 毎日の日報で進捗を報告してください
- 最終日に週報と完了報告書を提出してください
よろしくお願いします。
要件の読み方
仕事の依頼を受けたとき、以下の3つの観点で整理します。
1. 何を（What）
| 成果物 | 詳細 |
|---|---|
| Webページ | HTML/CSSで社内ツール紹介ページ |
| README | プロジェクトの説明文書 |
| 完了報告書 | 作業内容と結果のまとめ |
| 日報 | 毎日の進捗報告（5日分） |
| 週報 | 1週間のまとめ |
2. いつまでに（When）
| マイルストーン | 期限 |
|---|---|
| 日報 | 毎日の業務終了時 |
| 全成果物 | 1週間後の金曜日 |
3. 品質基準（How Good）
| 基準 | 詳細 |
|---|---|
| 表示内容 | カテゴリ別のツール一覧 |
| 必須情報 | ツール名、説明、URL |
| レスポンシブ | 不要（PC表示のみ） |
| 品質チェック | push前 にセルフレビュー必須 |
不明点を洗い出す
要件を読んだとき、「書いていないこと」に気づくことが大切です。
確認すべきポイント
| 不明点 | なぜ確認が必要か |
|---|---|
| データベースファイルの場所 | どこにあるかわからないと作業が始められない |
| GitHubのリポジトリ名 | 既存のものを使うのか、新規作成するのか |
| デザインの方針 | 色やレイアウトの指定はあるか |
| ツールのカテゴリ一覧 | どんなカテゴリがあるのか |
質問の仕方（月6の復習）
不明点は以下のフォーマットで質問します。
件名: 【質問】社内ツール紹介ページの作成について
田中さん
お疲れさまです。
依頼いただいた件について、いくつか確認させてください。
1. データベースファイルの場所
→ 自分で新規作成してよいでしょうか？
2. GitHubのリポジトリ名
→ 「internal-tools-page」のような名前で新規作成してよいでしょうか？
3. デザインの方針
→ 特に指定がなければ、シンプルなデザインで進めてよいでしょうか？
お忙しいところ恐れ入りますが、ご確認をお願いいたします。
先輩からの回答
1. データベースは自分で作成してOK。
サンプルデータとして10個くらいツールを入れてね。
2. リポジトリ名は自由でOK。
3. シンプルでOK。見やすければ大丈夫。
要件を整理する
質問の回答を踏まえて、最終的な要件を整理します。
確定した要件一覧
| # | 要件 | 詳細 |
|---|---|---|
| R1 | データベース作成 | SQLiteで社内ツール情報DB、10件のサンプルデータ |
| R2 | データ取得 | SQLでツール情報を取得・分析 |
| R3 | Webページ作成 | HTML/CSSでカテゴリ別ツール紹介ページ |
| R4 | 必須表示項目 | ツール名、説明、URL |
| R5 | Git管理 | リポジトリ作成、コミット、プッシュ |
| R6 | セルフレビュー | push前に品質チェック |
| R7 | README | プロジェクトの説明文書 |
| R8 | 日報 | 毎日の進捗報告（5日分） |
| R9 | 週報 | 1週間のまとめ |
| R10 | 完了報告書 | 作業内容と結果のまとめ |
要件読み解きの3つのコツ
コツ1: 「書いてあること」と「書いていないこと」を分ける
書いてあること = 確定要件、書いていないこと = 確認が必要。
コツ2: 成果物を明確にリストアップする
「何を提出すればいいのか」を具体的なファイル名レベルで把握する。
コツ3: 品質基準を確認する
「どこまでやればOKなのか」のラインを明確にする。 今回は「レスポンシブ不要」「シンプルでOK」という基準が示された。
まとめ
| ポイント | 内容 |
|---|---|
| 要件の読み方 | What（何を）、When（いつ）、How Good（品質） |
| 不明点の対処 | 早めに質問する。フォーマットに沿って聞く |
| 要件の整理 | 確定した要件を一覧表にまとめる |
- 依頼メールの内容を理解した
- 不明点を洗い出す方法がわかった
- 質問の仕方を思い出した（月6の復習）
- 確定した要件を整理できた
次のステップへ
要件が明確になりました。
次のセクションでは、この要件をもとに「作業計画」を立てます。 1週間の限られた時間で、何をどの順番で進めるか考えましょう。
推定読了時間: 30分