はじめに
正直に言うと、仕様書を書き終えた瞬間がいちばん気が重いんです。
やっと要件がまとまった、と思ったのも束の間、次は「これをタスクに分解する」作業が待っています。ひとつの要件を、画面・API・テスト・影響範囲まで洗い出して、着手できる粒度の課題に割っていきます。この工程が、地味にいちばん時間を食っていました。
しかも厄介なのが、分解のたびに仕様書と課題の登録画面を行ったり来たりすることです。「あの画面の権限まわり、どう書いたっけ」と仕様書に戻り、また課題に戻って入力します。この往復で集中が切れて、気づけば午前中がまるごと消えている、なんてこともざらでした。
分解そのものは、そんなに難しくありません。ただ抜け漏れが怖くて何度も見返すし、単純に量が多い。頭はそこまで使わないのに時間だけ持っていかれる作業って、いちばんもったいないと思いませんか。
この記事では、その仕様書からのタスク分解を、下書きだけAIに任せて楽にした方法を紹介します。使うのは、ONES.comの次の2つです。
- ONES Wiki：仕様書や設計書などのドキュメントを書いて貯めておける、ナレッジベース管理のツールです。
- ONES Assistant：ONESの画面に組み込まれたAIアシスタントです。今開いているページを読み取って、質問に答えたり、課題を作ったりしてくれます。
💬 仕様書を開いたまま、そのまま下書きを頼む
やり方は、拍子抜けするほど単純です。
ONES Wikiで仕様書のページを開いたまま、ONES Assistantに「このページの内容を、着手できる粒度のタスクに分解して」と伝えるだけ。すると要件を読み取ったうえで、画面実装・API・テストといった単位までタスクの案を並べて返してくれます。
いいのは、このやりとりが1つの会話の中で完結することです。仕様書を別画面で開き直したり、内容をコピーして貼り直したりする必要がありません。ONES Assistantは今開いているページを見てくれるので、そのまま「分解して」で通じるんですよね。
納得できたら、その案をそのままONES Projectの課題として登録できます。要件を親に、分解したタスクを子課題としてぶら下げる構造もまとめてくれます。仕様書を見る場所と課題を作る場所を往復しなくていい。それだけで、体感の負担がかなり減りました。
そのままコピペで使える、依頼のテンプレート
ただ「分解して」だけだと粒度がバラつくことがあります。そこで、実際に使っている依頼文を置いておきます。頭の一文だけ自分の状況に変えれば、そのまま使えます。
このページの仕様をもとに、開発タスクに分解してください。
条件は次の通りです。
- 1タスクは半日〜1日で終わる粒度にする
- 画面・API・テスト・影響範囲の観点で漏れがないか確認する
- それぞれに、なぜ必要か一言添える
- 仕様に書かれていない前提は、別枠で「要確認」として出す
ポイントは、粒度と観点を最初に指定してしまうことです。「半日〜1日で」と粒度を決め、「画面・API・テスト」と観点を渡すと、返ってくる案のばらつきがぐっと減ります。逆に、この指定なしに漠然と頼むと、ざっくりした案がざっくり返るだけなんですよね。ここはAIに任せるときの勘どころだと思っています。
⏱ 半日が30分になった
いちばん変わったのは、単純に時間です。
これまで中くらいの要件を分解しきるのに、見返しも含めて半日ほどかかっていました。それが今は、下書きが数十秒で出てくるので、わたしがやるのは中身の確認と手直しだけ。30分もあれば、課題として登録できる状態まで持っていけます。
もうひとつ嬉しかったのが、抜け漏れが減ったことです。「テストの観点、また書き忘れてた」みたいなうっかりを、依頼文の観点リストが毎回すくってくれます。ひとりで気を張って洗い出すより、むしろ漏れが少ないくらいなんです。
⚠️ 任せきりにせず、ここだけは自分で見る
便利なんですが、丸投げはしていません。出てきた案は必ず自分で読みます。ONES Assistantが返すのはあくまで下書きで、粒度が合わなかったり、プロジェクト特有の事情が抜けていたりはします。最終的にどう課題を切るかは、自分で決めるものだと思っています。
それと、元の仕様書が雑だと、返ってくる分解も雑になります。曖昧なことしか書いていないページからは、曖昧なタスクしか出てきません。結局、元の仕様書をちゃんと書いておくのがいちばんの近道なんですよね。
あと地味に大事なのが権限です。ONES Assistantは自分が見られる範囲しか読み取らないので、参照させたいページにアクセスできていないと、その内容は分解に反映されません。「なんか薄いな」と思ったら、まず権限を疑うようにしています。
おわりに
タスク分解は、頭を使うわりに時間だけ持っていかれる、地味に損な工程でした。そこを「下書きはAI、判断は自分」と割り切ってからは、着手までの助走がずいぶん軽くなった気がします。
あなたの手元にも、書き終えた仕様書のあとで、分解に半日かかっている要件はありませんか。まずは今日の依頼テンプレートを1つ、手元の仕様書で試してみてください。返ってくる案の具体さで、任せられそうか判断できるはずです。
ドキュメントを貯める場所から整えてみたい方は、ONES.com を覗いてみてください。