10章. 実習の課題 — 最初から最後まで一周
必須 この段階を進めるなら、必ず読んでください。一言まとめ: 1〜9章の流れを、ひと続きでやってみます。計画 → 作る → 確認 → レビュー → 公開 → 運用 → 安全点検です。 最後の課題は、自分の問題を最初から作ることです。チェックリストで自分で確認してください。
この章は、前の章の内容をまとめた課題の章です。根拠は、各章の脚注にあります。最初から完璧である必要はありません。 詰まったら、その章に戻って読み直してください。
課題1 — やることボードで一周
前の章の「やってみよう」のとおりに進めてきたなら、すでに終わっている課題です。飛ばしていたなら、順番にやってみてください。
| 順番 | やること | 章 |
|---|---|---|
| 1 | GitHubに公開リポジトリ cafe-todo-board を作って、自分のパソコンに複製する | 2 |
| 2 | Claudeにインタビューされて、SPEC.mdを書く | 3 |
| 3 | 新しいセッション・計画モードで計画をもらい、ブランチで最初の画面を作る | 4 |
| 4 | SPEC.mdの基準を検査する仕組みを作って、証拠をもらう | 5 |
| 5 | PRを作って、SPEC.mdと照らし合わせたレビューのあとにマージする | 6 |
| 6 | 公開前チェックリストで、シークレット(秘密の値)と個人情報を確認する | 9 |
| 7 | GitHub Pagesで公開して、スマートフォンで開く | 7 |
| 8 | 改善をイシューに書いて、fixes #イシュー番号 でもう一周 | 8 |
出典: このガイドの整理
完成形が気になるときは、この課題を実際にたどって作ったサンプルページとリポジトリを見てください。自分の結果と見た目が違っていてもかまいません。
理解度チェック
やること一覧ボードの 1 周の順序として正しいものはどれでしょうか?
課題2 — 自分の問題で最初から
自分の生活や仕事の中から 小さな困りごと をひとつ選んで、同じ流れでウェブページを作ってみましょう。たとえば、こんなものです。
- 私たちのサークルの今月の予定を見る
- 自分が読んだ本と、ひとこと感想のリスト
- お店のメニューと営業時間の案内
最初の依頼は、3章のようにインタビューから始めます。
<自分の困りごと>を解決する小さなウェブページを作りたいんだ。まだ深くは考えていないよ。スペックを書けるようになるまで私にインタビューして、終わったらSPEC.mdに書いて。公開リポジトリにアップするから、個人情報は入れないつもりだよ。注意: お店の案内のように、実際の事業で使うなら、7章で見たGitHub Pagesの禁止事項(事業・ネットショップ・商用サービスの運営)を先に確認してください。練習として作ることと、実際の営業に使うことは別です。
理解度チェック
自分の問題のために作ったお店の案内ページを、実際の営業に使おうとしています。先に確認することは何でしょうか?
チェックリスト
課題を終えたら、下を1つずつ確認してください。すべて「はい」なら、一周をきちんと回ったことになります。
計画
- ☐ SPEC.mdの行ごとに、はい/いいえで確認できる。
- ☐ SPEC.mdに「やらないこと」が1行以上ある。
作る
- ☐ 計画モードで計画を読んで承認してから作った。
- ☐
mainではなくブランチで作り、コミットひとつにつき変更ひとつになっている。
確認
- ☐ 確認の仕組みがあり、実行したコマンドと出力という証拠をもらった。
- ☐ わざと間違えたときに、チェックが失敗するのを見た。
レビュー
- ☐ PRの説明に、何をなぜ変えたかを書いた。
- ☐ 新しいセッションで、SPEC.mdと照らし合わせたレビューを受けた。指摘がなくても、自分でざっと目を通した。
公開・運用
- ☐ 公開アドレスがスマートフォンでも開く。
- ☐ 次の改善がイシューとして書かれている。
安全
- ☐ リポジトリとページに、シークレット・実名・連絡先がない。
- ☐
.gitignoreがあり、シークレットが入りそうなファイルが書かれている。
出典: このガイドの整理
ほかのツールでやってみる
この節は選択です。ステップ3でClaude Codeだけを使ったなら、飛ばしてもかまいません。
ステップ3には、Claude Codeのほかに、Codex(OpenAIのコーディングツール)とAntigravity(Googleのコーディングツール)のガイドもあります。この2つのツールにも対応する機能があるので、同じ流れをたどれます。表の名前は、それぞれのツールでその作業をするコマンド・画面・ファイルです。
| やること | Codex | Antigravity |
|---|---|---|
| 先に計画 | /plan | Planning mode |
| 変更内容を見る | レビューウィンドウ | Reviewウィンドウ |
| ルールファイル | AGENTS.md | AGENTS.md・GEMINI.md |
出典: Codex 第4章・Antigravity 2・第3章
同じSPEC.mdを2つのツールに渡して、結果を比べてみるのもよい練習です。ステップ3で見たように、同じ指示でも、ツールによって抜け落ちるものが違うことがあります。
まとめ
- 課題1は、やることボードで、計画から安全点検まで一周を回る。
- 課題2は、自分の小さな困りごとを、最初から作る。実際の事業に使う前には、Pagesの禁止事項を確認する。
- チェックリストのすべての欄が「はい」なら、一周をきちんと回ったことになる。
この章は読み終わりましたか?
学習の記録はこのブラウザにのみ保存されます。全体の進み具合は 全体目次で確認できます。
次の章: ステップ4 AI-SDLCガイドは終わりました。これでhello-aiのステップ1〜4をすべて終えました。ステップ4 · AI-SDLC 目次から、もう一度見たい章を選ぶか、AI知識レベル試験で、ここまで学んだことを確認してみてください。