秘書アプリ開発
機能の追加
既存のアプリに新しい機能を安全に追加する手順、ダッシュボードと連動した週次の振り返り機能の実装、機能追加に伴う不具合発生時のClaude Codeへの対処法
はじめに
ここまでで、秘書アプリの土台となる機能とデザインが整いました。今回は一歩進んで「新しい機能を追加する」ときの考え方を学びます。すでに動いているアプリに手を加えるので、これまでの機能を壊さないよう、少し丁寧な進め方が必要になります。
具体例として、1週間の活動を振り返れる「週次振り返り機能」を実際にダッシュボードへ追加しながら、機能追加の基本の流れを身につけます。あわせて、追加作業中に不具合が起きてしまったときの、落ち着いた対処法も押さえていきましょう。
既存のアプリに新しい機能を追加するシンプルな手順
まずは「今の状態」を一緒に確認してもらう
新機能の話をする前に、Claude Codeに今のアプリの状態を確認してもらうのがコツです。「今の◯◯機能はそのままに」と一言添えるだけで、既存の部分を壊さない前提で作業を進めてくれます。
新しく作る部分だけでなく、「変えたくない部分」も一緒に伝えると、意図しない変更を防ぎやすくなります。
追加したい機能を「目的」から伝える
機能の伝え方に正解はありませんが、「何のために使うか」という目的まで伝えると、Claude Codeが意図をくみ取りやすくなります。
| 伝え方 | 例 |
|---|---|
| ざっくり伝える | 「1週間の振り返りができる機能がほしい」 |
| 使う場面を添える | 「毎週日曜の夜に、今週何をやったか振り返りたい」 |
| 見たい情報を添える | 「完了したタスクの数と、書いたメモの件数を見たい」 |
今のメモ機能やタスク機能はそのまま使えるようにしてほしい。
基本の4ステップ
機能追加は、次の4つのステップで進めると迷いにくくなります。
追加したい機能の目的と、使う場面を伝えます。
Claude Codeが今のアプリの状態を確認し、実装方法を提案してくれます。内容を確認してからお願いしましょう。
提案内容に納得したら、実際に機能を作ってもらいます。
できあがった機能を操作し、気になる点があればそのまま伝えます。
大きな機能ほど、小さく分けて追加し、都度動かして確認する方が安全です。「まずは表示だけ」「次に集計処理」のように段階を分けましょう。
ダッシュボードと連動した週次の振り返り機能の実装
どんな機能か
週次振り返り機能とは、1週間の活動（完了したタスクの数や、追加したメモの件数など）をまとめて表示し、ダッシュボードの一部として振り返れるようにする機能です。
今日のタスク件数だけが表示されている状態。1週間単位の傾向は分からない。
今週の完了タスク数・追加メモ数・先週との差分がひと目で分かる。
あと、先週と比べて増えたか減ったかも分かると嬉しい。
表示するタイミングを決める
週次振り返りは、常に表示する方法と、必要なときだけ表示する方法があります。使い方に合わせて選びましょう。
| 表示のしかた | 特徴 |
|---|---|
| 常に表示 | いつ開いてもすぐ振り返れる。ただし画面の情報量は増える |
| 週の節目だけ表示 | 日曜や月曜だけ表示。振り返りに集中しやすい |
| ボタンを押した時だけ表示 | 普段はすっきり、見たい時だけ開ける |
動かして確認する
実際のデータがまだ少ない場合、Claude Codeにテスト用のデータを入れてもらうと、完成イメージを早く確認できます。
「まだタスクが少ないので、仮のデータで週次振り返りの見た目を確認したい」と伝えれば、テスト用のデータを入れて表示を確認させてもらえます。
機能追加に伴う不具合発生時のClaude Codeへの対処法
機能追加でよくある不具合
新しい機能を追加すると、まれに既存の部分に影響が出ることがあります。よくある症状を知っておくと、落ち着いて対応できます。
| 症状 | 原因の傾向 |
|---|---|
| 前まで動いていた機能が動かなくなった | 新機能と既存機能のコードが干渉している |
| 画面の一部が崩れて表示される | 新しいセクションのレイアウトが既存部分に影響している |
| 保存や更新をしてもエラーが出る | データの受け渡しの形式が合っていない |
症状を伝えるときの3点セット
原因を自分で特定する必要はありません。この3つを伝えれば、Claude Codeが原因を探して直してくれます。
振り返り機能を追加する前は普通に押せていた。
「元に戻す」という選択肢
原因がすぐに分からない場合は、無理に直そうとせず、機能を追加する前の状態に一旦戻してもらうのも有効な手段です。落ち着いてから、あらためて依頼し直せば問題ありません。
コードを自分で書き換える必要はありません。見えている状況をそのまま伝えるだけで、Claude Codeが対応してくれます。
この章の確認チェックリスト
| ☐ | 既存機能を壊さない前提で、新機能の依頼ができた |
| ☐ | 週次振り返り機能をダッシュボードに追加できた |
| ☐ | 表示するタイミング（常時／節目／ボタン）を選べた |
| ☐ | 不具合が起きたときに症状・いつから・直前の操作を伝えられた |
| ☐ | 必要なら「元に戻す」選択肢も使えると理解した |