小さな変更

文言の修正や項目の追加など、1回で終わる変更の進め方です。いちばんよく使います。

こんなときに使う

  • 画面の文言、色、並び順を変えたい
  • 入力項目や、一覧の列を1つ足したい
  • 不具合を1つ直したい

いくつかの画面にまたがる機能を作りたいときは、大きめの機能 を使います。

始める前に

  • Claude Code で 100raku-vibe-coding-platform フォルダを選んでいることを確かめます。
  • 新しい会話で始めます。前の作業と同じ会話で別の変更を頼むと、2つの変更が混ざってしまいます。
  • どのアプリの、どの画面を、どう変えたいかを決めておきます。

ステップ1:依頼する

次の依頼文の【 】の部分を書き換えて、Claude Code に送ります。

小さな変更を頼む
Claudeプロンプト
/new-minor-feature 【アプリ名】で、次の変更をしたいです。 やりたいこと: 【例:一覧画面に「担当者」の列を追加したい】 私はプログラミングの経験がありません。次の順番で進めてください。 1. まず、何をどう変えるかの計画を、専門用語を使わずに説明してください。私が「OK」と言うまで、ファイルは変更しないでください 2. データベースの構造や shared/ 配下の変更が必要な場合は、計画の中で知らせてください 3. OK のあと、main から新しいブランチを作って実装し、ビルドが通ることを確認してください 4. できあがったら、ローカルでアプリを開いて、変わった画面を見せてください 5. 私が画面を確かめて「OK」と言ったら、コミットして main へのプルリクエストを作成し、PR の URL を教えてください

アプリ名が分からないときは、App Portal に表示されている名前を書きます。Claude が該当するアプリを探します。

ステップ2:計画を確かめる

Claude が計画を説明します。次の3点を確かめます。

  • 頼んだことと合っているか
  • 頼んでいないことまで変えようとしていないか
  • 分からない言葉が残っていないか

よければ「OK」と返します。違うところがあれば、その場で伝えます。

計画が分かりにくいとき
Claudeプロンプト
今の説明を、専門用語を使わずにもう一度お願いします。画面のどこが、どう変わるのかを教えてください。
計画に「データベースの変更」が含まれるとき

データの入れ物(テーブル)を追加したり変えたりする変更は、ほかのアプリにも影響することがあります。作業は進めて構いませんが、マージする前に管理者に見てもらいます。

ステップ3:Claude が作るのを待つ

Claude が変更を作り、ビルドを確認します。ビルドは、アプリを正しく組み立てられるかの確認です。途中で質問や確認が来たら答えます。

ステップ4:画面で確かめる

できあがると、Claude が、Claude のアプリの中のブラウザでアプリを開いて見せます。あなたのパソコンの中だけで動いていて、入っているのは架空のテストデータです。実際にさわって確かめます。

  • 頼んだ変更ができているか。 計画で説明されたとおりになっているかを見ます。
  • まわりが壊れていないか。 変更した画面の前後の画面や、関係しそうな機能も動かします。

確かめ方のくわしい説明は、画面を確かめる にあります。

最初の1回は、数分かかります

はじめて画面を開くときだけ、準備に数分かかります(お試し用のデータベースを入手するためです)。2回目からは、数秒で開きます。

直したいところがあれば、同じ会話のまま Claude に伝えます。

画面を見て、直してもらう
Claudeプロンプト
画面を確認しました。次の点を直して、もう一度見せてください。 【例:「担当者」の列を、「登録日」の右に移動してほしい】

よければ「OK」と返します。Claude が PR を作り、PR の URL を教えてくれます。

「プレビュー環境でも確認しますか」と聞かれたら

プレビューは、インターネット上に用意する、お試し用の環境です。実際のデータで見たいとき、メールが届くかなどを試したいとき、ほかの人に見せたいときに使います。用意に 10〜20 分かかり、動いている間は費用がかかるので、ふだんは作りません。迷ったら「なしで進めてください」と答えます。あとからでも頼めます。

ステップ5:確認してマージする

ここからは、あなたの番です。確認してマージする の手順で、自動チェックを確かめてマージします。

PR を作ったあとで、直したいところが見つかったら

同じ会話のまま Claude に伝えます。Claude が直すと、同じ PR が更新されます。

PR を作ったあとで、直してもらう
Claudeプロンプト
次の点を直して、同じ PR に追加してください。直したら、もう一度ローカルで見せてください。 【例:「担当者」の列を、「登録日」の右に移動してほしい】

伝え方の例

伝わりにくい頼み方伝わりやすい頼み方
一覧を見やすくしてほしい一覧の文字を大きくして、行の間隔を広げてほしい
ボタンを直してほしい登録画面の「保存」ボタンを押しても、何も起きない。押したら一覧画面に戻るようにしてほしい
項目を増やしてほしい登録画面に「備考」という入力欄を足してほしい。入力は任意で、一覧にも表示してほしい

よくある失敗

  • 1回の依頼に、いくつもの変更を詰め込む
  • 計画を読まずに「OK」と返す
  • 画面を見ずにマージする
  • 前の作業と同じ会話で、別の変更を頼む

クイズ

Quiz

Claude が開いた画面を見たら、頼んだ列は追加されていましたが、並び順を変えたくなりました。どうしますか?