連載「業務SEのための仕様駆動開発」第8回(最終回)
AIは便利なのに、自分の仕事が思ったほど減らない
Claude CodeなどのAIエージェントを使い始めると、文書もコードも速く出てきます。便利だと感じます。
ところが、実際の案件では、AIを使い始めても自分の作業が思ったほど減らないことがあります。
道具としては使えている。でも、頼んでいるのは個別の質問や単発の作業ばかりです。まとまった仕事を任せるところまでは進んでいません。
人が抱え続ける部分が多く、AIが増えても、自分の手元の作業は減りにくい。そんな状態になっていないでしょうか。
結論:任せるなら、指示書が先
私は、AIを単なる道具ではなく、仕事を任せる部下のような存在として扱っています。しかも、人間の部下と違って、必要に応じて複数のAIに同時に仕事を頼めます。
ただし、仕事を任せるには、何をしてほしいのかを明確にした指示が必要です。この記事では、それを指示書と呼びます(簡単な依頼メモでも構いません)。
指示書には、目的、完了条件、制約、報告の形などを書きます。一方、仕様は「何を作るか・どう動くべきか」を定めたものです。仕様をもとに、AIに渡す指示書を作ります。
これがないまま「いい感じにお願い」と頼むと、作業は速く進んでも、期待とは違う成果物ができあがります。
人間の部下に仕事を任せるときも、何を頼むか、どこまでやれば完了か、やってはいけないこと、どう報告するかを伝えます。AIでも同じです。
ただし、AIは曖昧な指示を、人が思うほど補ってくれるとは限りません。だからこそ、指示書が先になります。
仕様駆動開発(SDD)では、目的を確定し、設計書やテスト仕様書を先に作成してから実装に進みます。工程としては、目的確定→設計→テスト作成→実装→テストという流れです。
工程を順番に進める点では、従来のウォーターフォールに近い部分があります。
複数の作業を並行して進める場合は、こうした文書が特に重要になります。会話の中で指示を管理していると、作業ごとの前提や目的が混ざり、混乱しやすくなるからです。
型:部下に渡す指示書のチェック項目
コピーして使ってください。AIエージェントにまとまった作業を渡す前に、指示書をこの項目で確認します。
# 部下(AI)に渡す指示書のチェック項目
対象の作業:____________
- [ ] 1. 目的:何のための作業かを、一文で書いているか
- [ ] 2. 完了条件:何ができたら終わりかを、判定できる形で書いているか
- [ ] 3. 制約・禁止事項:変更してよい範囲、AIに渡してよい情報、変更してはいけないものを明記しているか
- [ ] 4. 報告・成果物の形式:途中経過や最終結果を、どのような形式で報告してほしいか決めているか
- [ ] 5. 参照資料:使用する文書・データを指定し、どれを正として参照するか明確にしているか
- [ ] 6. 作業範囲:今回対応することと、次の担当者や別のAIに引き継ぐことを明確にしているか
重要なのは、6項目について自分の中で整理し、必要な情報を指示書に書いておくことです。「なんとなく分かっている」だけでは、AIには伝わりません。
決まっていない項目があれば、人が先に決めるのか、AIに調査・提案させるのかを明確にしておきます。
単純な作業では、全項目を長く書く必要はありません。短くても、必要な答えが出ていれば渡せます。
複数の作業を同時に進めるときは、作業ごとに指示書を分けます。一つの長い会話に複数の案件を混ぜない。
指示書が分かれていれば、切り替えのたびに文脈を頭の中で組み立て直さずに済みます。
使い方:道具として使う段階から、任せる段階へ
判断のコツは、いま自分が「答えを聞いている」のか、「作業を任せている」のかを区別することです。
答えを聞いているだけなら、短い質問で足ります。
一方、設計書の下書きやテスト観点の洗い出し、部品の実装候補づくりなど、ある程度まとまった作業を任せるなら、上のチェック項目を使って指示を整理します。
第1回で紹介した「目的・合格ライン・制約」の考え方は、ここでも使えます。今回のチェック項目にある「目的」「完了条件」「制約・禁止事項」は、その考え方をAIへの指示に具体化したものです。
報告・成果物の形式を決めておくと、レビューが楽になります。第5回で書いたように、書くのはAI、判断とダメ出しは人です。
報告の形式が決まっていないと、AIから成果物が返ってきても、何を確認すればよいのか分かりません。結果として、次の工程に進めてよいか判断できなくなります。
成果物のどこに問題があるのかを指摘するにも、あらかじめ完了条件が決まっていなければ、修正の方向を明確にできません。
たとえば、連載で使っている「受注CSVを取り込む」という作業なら、「取り込み処理をいい感じに作って」では不十分です。
何のために取り込むのか。どのような結果になれば合格なのか。本番データを使ってよいのか。何を成果物として提出するのか。こうした点を指示書に明記してから作業を依頼します。
第6回のとおり部品を分けているなら、部品ごとに指示書を切ることもできます。
第7回で説明したように、たたき台を作るための探索と、納品物を作る場合では、指示に求められる具体性も変わります。探索なら完了条件をゆるくしてよく、納品物なら完了条件と制約・禁止事項を先に固定します。
Claude Codeに頼むときも、「全体を進めて」と丸投げするのではなく、作業範囲と完了条件を明確にしたうえで、担当する部分だけを任せます。
指示書を長くすればよい、という話ではありません。長くても目的や完了条件が曖昧なら、AIに何をしてほしいのかが伝わらず、実質的には丸投げと変わりません。
短くても、必要な項目に答えが出ていれば渡せます。決まっていない項目があるときは、人の側で決めるか、決めるためのやり取りを先にします。いきなり実装を並べて走らせない、が基本です。
私の場合:複数のAIに、指示書を分けて渡す
私は実務で、複数のAIに仕事を任せています。会話の勢いだけで同時進行させるのではなく、作業ごとに目的と完了条件が書かれた指示書を渡します。
設計書やコードの下書きをすべて自分で作っていると、それだけで時間と労力を使います。結果として、本来時間をかけたいレビューや判断がおろそかになりがちです。
一方、指示書を用意して作業を任せれば、自分の役割は変わります。「指示を出す」「成果物を確認する」「必要な修正を指示する」「次の工程に進めるか判断する」。こうした仕事に集中しやすくなります。
AIエージェントが増えても、基本的な管理の考え方は変わりません。作業ごとに指示を出し、成果物を確認し、必要な修正を指示する。その一連の作業を、複数のAIに対して並行して行えるようになります。
前提は、ツールの数を増やすことではありません。作業ごとに指示書を分けて渡せる状態にすることです。
指示書がないまま複数の作業を並行すると、それぞれの目的や進捗が分からなくなりがちです。指示書があれば、作業が混乱しても、何をどこまで進める予定だったのかを確認できます。
AIを使うことと、指示なしで完成まで任せることは、分けています。前者は案件でもやる。後者はしません。
部下のような相手が増えても、指示書なしでは回りません。一見うまく進んでいるように見えても、仕様が曖昧なままでは、後になって認識の違いや作り直しが発生します。
まとめ:連載で紹介してきた型
この連載では、仕様駆動開発の進め方を、毎回一つずつ紹介してきました。
- 目的・合格ライン・制約の決め方
- 文書を使った開発の進め方
- テスト仕様書の作成
- 業務でAIを使う際の確認事項
- 設計書のレビュー観点
- 部品分割の判断基準
- バイブコーディングの使い分け
- AIエージェントに仕事を任せるための指示書
これらに共通しているのは、AIに仕事を任せる前に、人が目的や条件を決め、それを文書として残しておくという考え方です。
AIを単なる便利な道具として使う段階から、まとまった仕事を任せる段階に進みたいなら、まず指示書を用意することです。
操作方法を覚えるだけでは足りません。人に仕事を任せるときと同じように、何を任せるのかを整理し、指示書として残すことです。
一覧はこちら → https://qiita.com/sha44444/stocks/3c9167054a4a82837bb3
この連載では、仕様駆動開発の「型」を1回に1つずつ紹介してきました。
5つの工程を実案件でどう回しているか(各工程でAIに渡す依頼文、変更が入ったときの回し方、通しの実例)に加え、複数の作業を並行して回すときの考え方も、1冊の本にまとめました。第1章は無料で読めます。
連載でつかんだ型を、現場の通し方まで進めたい方は、こちらをどうぞ。
→ https://zenn.dev/shin4/books/31499dd20de8ac/viewer