明日から使える日常ワークフロー

このレッスンで学ぶこと

Claude Codeを使ってコミットメッセージやPRを効率的に作成する方法
コードレビューやバグ修正をClaude Codeに依頼するパターン
リファクタリングを安全に進めるための指示の出し方

Claude Codeを日常の「開発パートナー」にしよう

Lesson 3では基本コマンド、Lesson 4ではCLAUDE.mdによるプロジェクト設定を学びました。ここまでの知識があれば、Claude Codeを日常業務に組み込む準備は整っています。

このレッスンでは、開発者が毎日のように繰り返す5つの作業パターンを紹介します。コミットメッセージの作成、PRの準備、コードレビュー、バグ修正、リファクタリング。これらはどれも「やるべきだけど面倒」な作業です。Claude Codeに任せることで、あなたはより創造的な作業に集中できるようになります。

ワークフロー1: コミットメッセージの自動生成

コードを書き終えた後、変更内容を正確に要約するコミットメッセージを考えるのは意外と時間がかかります。Claude Codeなら、差分を読み取って適切なメッセージを生成してくれます。

変更をステージングする

まず、通常通りコミットしたいファイルをステージングします。

git add src/components/UserProfile.tsx src/hooks/useAuth.ts

Claude Codeにコミットメッセージを生成させる

Claude Codeに変更内容を確認させ、コミットメッセージの作成を依頼します。

ステージングされた変更を確認して、適切なコミットメッセージを付けてコミットして

Claude Codeは git diff --staged の内容を自動的に読み取り、変更の意図を汲み取ったメッセージを生成します。

言語やスタイルを指定する

チームの規約に合わせて、メッセージの言語やフォーマットを指定できます。

ステージングされた変更をコミットして。コミットメッセージは日本語で、1行目に要約、3行目以降に詳細を書いて

英語で書きたい場合は次のように指示します。

commit the staged changes with a conventional commit message in English

CLAUDE.mdにコミット規約を書いておこう

コミットメッセージのルール（言語、フォーマット、文字数制限など）をCLAUDE.mdに記載しておくと、毎回指定しなくてもルールに沿ったメッセージが生成されます。

ワークフロー2: PRの作成支援

コミットが終わったら、次はプルリクエストの作成です。変更内容の要約、レビュアーへの説明、テスト計画の記述など、PRの準備には意外と手間がかかります。

変更内容を要約させる

まず、ブランチの変更全体をClaude Codeに把握させます。

このブランチの変更内容を要約して

Claude Codeはコミット履歴と差分を分析し、変更の全体像をまとめてくれます。

PRを作成させる

要約に問題がなければ、そのままPR作成を依頼します。

この変更内容でPRを作成して

Claude Codeは gh pr create コマンドを使って、タイトルと説明文を自動生成し、PRを作成します。

テンプレートに合わせた形式を指定する

チームのPRテンプレートがある場合は、それに合わせるよう指示できます。

PRを作成して。説明文は「概要」「変更内容」「テスト計画」のセクションに分けて書いて

PRの内容は送信前に確認しよう

Claude Codeが生成したPRの説明文は、送信前に必ず目を通しましょう。変更の意図や背景情報が不足していないか、チームのメンバーが理解できる内容になっているかを確認することが大切です。

ワークフロー3: コードレビューの依頼

自分の変更を他の人にレビューしてもらう前に、Claude Codeでセルフレビューを行うと、品質を一段上げることができます。

/code-review コマンドを使う

Claude Codeには、現在の差分をレビューするための /code-review コマンドが組み込まれています。

/code-review

このコマンドを実行すると、ブランチの変更点をもとに、正確性のバグや改善点を報告してくれます。

レビュー観点を指定する

汎用的なレビューだけでなく、特定の観点に絞ったレビューも依頼できます。

このブランチの変更をレビューして。特にセキュリティの観点で問題がないか確認して

この変更でパフォーマンスに悪影響がないかレビューして

セルフレビューの習慣をつけよう

PRを出す前にClaude Codeでレビューを実行する習慣をつけると、レビュアーの負担が減り、指摘事項も少なくなります。チームの開発速度向上にもつながります。

ワークフロー4: バグ修正のフロー

エラーメッセージが出た、テストが落ちた。そんなときはエラー情報をそのままClaude Codeに渡して、原因調査から修正、テストまでを一気に進められます。

エラー情報を共有する

エラーメッセージやスタックトレースをそのまま伝えます。

npm testを実行したら以下のエラーが出た。原因を調査して修正して
 
TypeError: Cannot read properties of undefined (reading 'map')
    at UserList (src/components/UserList.tsx:15:23)
    at renderWithHooks (node_modules/react-dom/...)

修正と検証を依頼する

Claude Codeは該当ファイルを読み取り、原因を特定して修正を提案します。修正後にテストの実行まで任せましょう。

修正したら、テストを実行して問題が解決したことを確認して

根本原因を理解する

修正が完了したら、再発防止のために原因を確認します。

今回のバグの根本原因を説明して。同じ問題が他の箇所でも起きていないか確認して

エラーを握りつぶす修正に注意

Claude Codeがエラーを抑制するだけの修正（try-catchで何もしない、型アサーションで黙らせるなど）を提案した場合は、根本原因に対処するよう指示し直しましょう。「エラーを抑制するのではなく、根本原因を修正して」と伝えると効果的です。

ワークフロー5: リファクタリングの依頼

「このファイルをリファクタリングして」と伝えるだけでも動きますが、スコープを限定することでより安全で的確な結果が得られます。

効果的な指示の出し方

リファクタリングでは、何を変えるか と 何を変えないか を明確にすることが重要です。

src/utils/helpers.tsのvalidateEmail関数をリファクタリングして。
正規表現を使った実装から、段階的なバリデーションに変更して。
外部インターフェースは変えないで。

漠然と「リファクタリングして」と伝えた場合、Claude Codeはファイル全体を大幅に書き換えてしまう可能性があります。対象範囲と方針を指定しましょう。

段階的に進める

大規模なリファクタリングは、小さなステップに分けて進めるのが安全です。

このファイルのリファクタリングを計画して。
ステップごとに分けて、各ステップの後にテストが通ることを確認しながら進めて。

リファクタリング前にテストを確認しよう

リファクタリング対象にテストがない場合は、まずテストを書いてからリファクタリングを始めましょう。「この関数のテストを書いてから、リファクタリングして」と一度に依頼できます。

まとめ: 明日から試せるチェックリスト

入門コース全5レッスンを通じて、Claude Codeの基本をひと通り学びました。このレッスンで紹介した5つのワークフローは、どれも明日からすぐに使えるものです。

まずは以下のチェックリストから、できそうなものを1つ選んで試してみましょう。

コミット時に、メッセージの作成をClaude Codeに任せてみる
次のPR作成で、説明文の下書きをClaude Codeに生成させてみる
PRを出す前に /code-review でセルフレビューを実行してみる
バグに遭遇したら、エラーメッセージをそのまま貼り付けて調査を依頼してみる
リファクタリングしたいコードがあれば、対象と方針を明確にして依頼してみる

入門コース完了おめでとうございます

ここまで学んだ内容で、Claude Codeを日常の開発業務に十分活用できます。使い続けるうちに、自分なりの効果的な指示の出し方が身についていくはずです。

次のステップ

入門コースを修了したあなたには、さらにスキルを磨く道が開かれています。

実践コース: コードレビューの自動化、テスト生成、プロンプト設計のテクニックなど、より高度な活用法を体系的に学べます
実践レシピ集: 「PRレビューを効率化したい」「レガシーコードをリファクタリングしたい」など、具体的な課題を解決する逆引きガイドです。すぐに使えるプロンプトパターンが見つかります

日常業務でClaude Codeを使いながら、少しずつ活用の幅を広げていきましょう。