最終更新 11月8日 18:55

社内SE・開発リーダー|クロード Codeに任せる4つの業務と人間による確認

社内SEや開発リーダーがクロード Codeに仕事を渡すとき、候補は実装・修正・テスト・説明の四つに集まります。必要なのは機能一覧ではなく、どの仕事を渡し、どこで人が止めるかです。

クロード Codeは、プログラムのフォルダを読んで、ファイルを直し、コマンドを実行する開発用の画面です。ブラウザやアプリのクロードは会話が主で、手元のフォルダまでは直しません。

先に確認するのは、触ってよい枝(ブランチ)と、やらない範囲です。次の手続は、4つのうち一つに絞って依頼し、差分を見る担当を固定することです。効果は、自チームの課題処理件数と、差分を見る時間で測ってください。

4つの仕事のうち、実装とテストの止めどころ

目次

4つの仕事のうち、実装とテストの止めどころ

実装を渡すときは、触ってよい枝(ブランチ)と、やらない範囲を一文で書きます。「共有ライブラリは触らない」「本番設定は変えない」のように、止めどころを先に固定します。

テストを渡すときは、漏れているケースを人が洗い、環境依存の失敗を切り分けます。公式はテスト作成を作業例に含みますが、「全部のケースを自動で保証する」とは書いていません。落ちた理由の説明を読み、再現手順を自分でも走らせてください。

クロード Codeに任せる4つの仕事

4つの仕事と、人が見ること

仕事 公式の位置づけ 人が見ること
実装 フォルダ全体を読んで、複数ファイルを扱える 触ってよい対象と、やらない範囲
修正 不具合修正を典型例として挙げる 再現手順と、影響する範囲
テスト テスト作成を作業例に含む 漏れているケースと、環境依存の失敗
説明 フォルダを読んで説明する 古いコメントとの食い違い

説明だけを頼む日と、実装まで進める日を分けると、確認画面の読み方が安定します。説明で食い違いが見つかったら、実装の前に仕様のメモを直してください。

大きな作り直しはどちらが現実的か

大きな作り直しは、塊に分ける

公式は作り直しも用途の一つに挙げています。成功率は個人の体験談では判断しないでください。自チームでは課題件数と差し戻しで見ます。人が差分を見られる大きさに分けてください。一度に全部任せ、差分を見ないまま記録へ載せる進め方は避けます。

各塊ごとに、確認画面と差分を見ます。塊の境目は、「画面の表示だけ」「保存処理だけ」「テストだけ」のように、レビュー担当が一日で見切れる単位が扱いやすいです。

リーダーが先に決めること

リーダーが先に決めること

  • 触ってよい枝(ブランチ)
  • 秘密情報の置き場
  • 本番向けコマンドの禁止
  • 差分を見る担当

人が決めるのは触る範囲です。ツールが手伝うのは、提案・修正案・テスト案です。最終判断は人に残します。公式には、変更前の確認画面があります。組織として止めたいことは、プロジェクト用の指示ファイル(CLAUDE.md)か、設定に書いてください。書き方は公式の案内を見てください。

人が止めるときの確認点

人が止めるときの確認点

  • 対象が、今の作業フォルダと依頼した範囲と一致するか
  • 共有ライブラリや本番設定まで触っていないか
  • 差分を見る人と、記録に残す人が決まっているか

公式の確認画面を、チームの安全装置として使います。確認を「全部許可」で消す運用は、リーダーが例外として認めた場合だけにしてください。

現場での進め方

1. 仕事の種類を一つに絞る

同じ会話で、実装と大規模な作り直しと本番調査を混ぜないでください。まず説明、次に修正、最後にテスト、の順が追いやすいです。

2. 依頼文に止めどころを書く

不具合の再現手順は次のとおりです。1. 画面Aを開く 2. 操作Bをする 3. エラー文が出る。影響してよいのはこのサービス内だけです。共有ライブラリと本番設定は変更しないでください。修正案を出し、確認画面の前で一度止めてください。

3. 差分を見る担当を固定する

作った人と見る人が同じでも構いません。ただし「見ずに載せる」を禁止してください。自動検査の流れに載せる場合も、権限と秘密情報を情報システムと合意してからにしてください。公式の始め方は、GitHub や GitLab との連携に触れています。

4. 指示ファイルにチームの禁止事項を書く

本番向けコマンド、顧客データの持ち出し、外部への送信などを、プロジェクト用の指示ファイルへ残します。個人の好みだけなら、個人用の設定に分けます。

5. 週次で見直す

差し戻しが多い仕事の種類を一つ選び、依頼文の型を直します。効果の%ではなく、差し戻し理由の件数で見ます。

よくあるつまずき

  • 機能一覧を集めて終わり、止めどころが決まっていない
  • 大きな作り直しを一度に任せ、差分レビューが追いつかない
  • テスト作成だけ任せて、漏れているケースを人が洗わない
  • 説明結果を仕様書に転記し、古いコメントとの差を残したまま進める
  • 用途別の料金表を探して止まり、料金ページを見ない

つまずいたときは、4つの仕事のどれかを選び直し、やらない範囲を一文足すのが早いです。

最初の二週間でやること

一週目は、説明と小さな修正だけを許可し、確認画面を残します。二週目は、テスト作成を1件だけ追加し、漏れているケースの洗い方をチームで合わせます。自動検査への接続は、二週目以降でも構いません。先に人の確認が回ることを優先してください。

新しい担当者には、4つの仕事の表と、リーダーが決める四点(枝・秘密情報・本番コマンド・差分担当)だけを渡します。個人ブログの操作ログは、公式の概要と始め方の補助にとどめます。

他部門へ説明するときの言い方

経営や企画へ説明するときは、「開発用の画面に任せる仕事は四つあるが、最終判断と差分確認は人」と伝えてください。効果を聞かれたら、共通指標ではなく、自チームでは課題件数と差し戻しで測ることを答えます。

4つの仕事ごとの依頼文サンプル

実装の例です。

目的は、管理画面に検索欄を追加することです。触ってよいのはこのサービスのフロントとAPIだけです。共有ライブラリと本番設定は変更しないでください。実装案を小さな差分に分け、各差分の前で確認画面を出してください。

修正の例です。

再現手順は次のとおりです。1. 前提データ 2. 操作 3. 表示される結果。期待結果と実際の結果も書きます。影響範囲の仮説を先に出し、修正はその範囲に限定してください。関係ないリファクタはしないでください。

テストの例です。

既存の失敗ケースに加えて、境界値のテストを追加してください。追加したテストを実行し、失敗理由を短く残してください。本番データは使わず、試験用の入力だけを使ってください。

説明の例です。

このモジュールの責務と、呼び出し元を箇条書きで説明してください。コメントと実装が食い違っている箇所があれば、食い違いだけを別リストにしてください。ファイルは変更しないでください。

レビュー担当のチェックリスト

  • 依頼文の「やらない範囲」が、実際の差分でも守られているか
  • テストが通っていても、漏れている業務ケースがないか
  • 説明用の出力を、仕様書へ転記する前に古さを確認したか
  • 秘密情報や本番向けコマンドが、差分や会話に残っていないか
  • 記録に残す単位が、戻せる大きさか

この五点は公式の必須項目ではありません。ただし、リーダーが止めどころを文章にしたあと、現場で同じ観点を共有するための型です。差し戻し理由をこの五点に寄せると、週次の改善がしやすくなります。

指示ファイルと設定の使い分け

チーム全体で止めたいことは、プロジェクト用の指示ファイルへ書きます。個人の表示や一時的な好みは、個人用の設定へ分けます。混ぜると、レビューで「誰のルールか」が分からなくなります。

書いてよい内容の例は、触ってよい枝、禁止コマンド、テストの動かし方、秘密情報を置かない場所です。書いてはいけない例は、本番の鍵そのものです。鍵は指示ファイルではなく、情報システムの配布手順で扱います。

指示ファイルを置いたら、初任者には「ここを読めば止めどころが分かる」と伝えてください。口頭ルールだけだと、人が変わるたびに全部許可へ戻りがちです。

自動検査へ載せる前の合意

公式の始め方は、GitHub や GitLab との連携に触れています。社内の自動検査へ載せるときは、次を情報システムと合意してください。使う鍵の種類、動いてよい枝、書き込みの可否、失敗時の通知先、ログの保存期間です。

合意前に個人の端末だけつなぐと、後からチーム標準へ移すときに権限が残りやすいです。試験は個人の狭い権限、本番相当はチーム共有、のように段階を分けます。

自動検査は、人の差分確認を消す装置ではありません。人が見る単位を保ったまま、繰り返し作業を減らすのが目的です。確認画面を消す設定と、検査の自動化を混同しないでください。

部門をまたぐときの説明

企画や経営へは、「任せる仕事は四つ。最終判断は人。効果の共通%は公式にない」と短く伝えます。情シスへは、枝・秘密情報・本番コマンド・差分担当の四点を先に見せます。現場メンバーへは、依頼文の型と確認画面の読み方を渡します。

説明資料に個人ブログの操作ログを載せる必要はありません。公式の概要と始め方、自チームの四点があれば足りることが多いです。

FAQ

大きな作り直しを一度に任せてよいですか?

公式は作り直しも用途の一つに挙げています。成功率は個人の体験談では判断しないでください。人が差分を見られる大きさに分けてください。

自動検査の流れに載せられますか?

公式の始め方は、GitHub や GitLab との連携に触れています。社内の検査への接続は、権限と秘密情報を情報システムと合意してからにしてください。

用途で料金は変わりますか?

用途別の単価は料金ページで確認してください。

ブラウザやアプリのクロードで足りる仕事はありますか?

仕様の下書きや、貼り付けたコード片の説明だけなら、ブラウザやアプリのクロードでも進められます。フォルダ全体の読み書きとコマンド実行が必要になったら、開発用の画面へ移してください。

指示ファイルは必須ですか?

必須とは限りません。ただし、組織として止めたいことが増えたら、プロジェクト用の指示ファイルか設定に書く方が、口頭だけより残ります。書き方は公式案内を見てください。

リーダーの仕事は、道具を増やすことより、止めどころを文章に残すことです。公式の確認画面は、その文章を現場で実行する装置だと考えてください。

4つの仕事のうち、最初の一か月は説明と修正に絞るチームが多いです。テストと大きな作り直しは、差分を見る担当が回ってから広げてください。

週次レビューで見る指標

見る指標は三つに絞ります。差し戻し件数、差分確認を省略した件数、確認画面を全部許可にした件数です。改善率の%ではなく、課題件数と差し戻しで振り返ります。件数の増減と、差し戻し理由の内訳があれば、次の依頼文の型を直せます。

4つの仕事のうち、どの仕事で差し戻しが多いかも記録します。説明で食い違いが多いなら、実装の前に仕様メモを直す週にします。テスト漏れが多いなら、境界値の洗い方を先に揃えます。

指標を増やしすぎると、現場が数字作りに寄り、確認画面の読み方が雑になります。少ない指標を、毎週同じ定義で見てください。

リーダー交代のときは、四点(枝・秘密情報・本番コマンド・差分担当)と、依頼文サンプルだけを引き継げば足ります。個人の操作ログは必須ではありません。

公式の製品名やプレビュー項目が変わっても、止めどころの文章は残りやすいです。名称の追跡より、範囲の文章を保守してください。

小さな塊に分ける具体例

画面の検索機能を足す案件なら、次のように分けます。一回目はAPIの読み取りだけ。二回目は画面の入力欄だけ。三回目はテストだけ。四回目は説明文の更新だけ。各回のあとに差分確認を入れます。

一度に四回分を任せる方が速く見えることもありますが、差し戻しが一塊だと原因の切り分けが遅くなります。公式に最適な分割サイズはないため、レビュー担当が三十から六十分で見切れる単位を自チームの目安にしてください。

分け方を依頼文に書くときは、「次の塊まで進めてはいけない」と明示します。明示がないと、確認画面のたびに連打され、塊の境界が消えます。

まとめ

社内SE・開発リーダーが決めるのは、実装・修正・テスト・説明のどれを渡すかと、人がどこで止めるかです。大きな作り直しは塊に分け、確認画面と差分確認を残してください。効果を語るときは、自チームで測ったデータ・期間・担当をそろえて残します。

迷ったら、触る枝を狭くし、やらない範囲を一文足してからやり直してください。

参考文献

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

コメント

コメントする

目次