いまこそ「良い仕様書」がチームの生産性の鍵となる。ので、仕様書に含めたい 14 のポイントについてまとめました。｜Fritz | Lead Product Manager @ Mercari

いまこそ「良い仕様書」がチームの生産性の鍵となる。ので、仕様書に含めたい 14 のポイントについてまとめました。 こんにちは、フリッツ です。今回はプロダクトマネージャーの日課とも言える「仕様書」について。自分にとっては PM 業の施策実行フェーズにおいて最も重要な仕事のひとつであり、最も心躍り、最も興奮する瞬間です。 PM になってかなりの時間が経ちましたが、「仕様書」への力の入れようは減るどころか、「もっと気合を入れなければ。」と感じる一方。在宅勤務が（たぶん） IT 業界のニュースタンダードとなっていくいま、なおさら「仕様書」の重要性を訴えたい今日この頃です。 ということで、今回は ・ 良い仕様書がもたらす 5 つの効果 ・ 仕様書の重要性が増していく 2 つの理由 ・ 仕様書に含めたい 14 の項目・実戦編 ・ 仕様書作成時に心に留めたい 3 つのこと ・ 具体的な仕様書サンプル（

[puyop]

残念ながらほとんどの仕事は、「仕様が決まらない」ことが問題で、それは単純に仕様書の手を抜いているわけではないんですよ。特に日本は「現物見ないと分からない」人が多くて困ります。

[mayumayu_nimolove]

仕様書検定とかあったら需要あるだろ

[dazz_2001]

まず、きちんとしたマニュアル、契約書、仕様書を整備することは、物凄く工数がかかることなんだよなぁ。理想論では分かってはいるが、誰もやりたがらない

[manimoto]

"「Slack / 口頭で仕様を変更したら、すぐに仕様書のページを開いて変更を反映し、その旨をまたチームチャンネルに投げる」くらいのルーチーン" 大事。

[Falky]

一番大事な成果物サンプルが未公開なのでなんもわからん。このあと猛烈に炎上したりでもしない限り、私は更新に気付くこともないまま一生を終えることだろう……（完）

[t-murachi]

??? issue 単位でやり取りされる開発関連情報を纏めたものを「仕様書」と呼んでおられる? プロジェクトの全容を見渡すものではなく? でもそれってそれこそ ITS の役割じゃね?

[su_zu_ki_1010]

色々な会社の実際の仕様書が読みたい。とはいえ、仕様書は各社（プロジェクト）の重要情報なのでそう気軽に公開できるものでもない。ジレンマである。

[nishi1231chang]

新規開発だとweb系でも最初にプロダクトできるまではウォーターフォール的なプロセスでやっぱり作ること多いので、不可逆的なリスクとか認識して定義していくのが結局チームを助ける

[kiwi0120]

ワード1枚の紙を前に「えっとこれは?」「仕様書」「えっ…」「要求仕様ってやりたいことでしょ。」「えっ…」「とにかくこれで見積もりを」「要件定義の見積もり、ですよね？」「えっ？」ここからが長かった…。

[masayoshinym]

でも問題が起こってるような現場で仕様書を書いてる人はこのページを見ないので何も変わらない。

[dmr]

仕様書

[naglfar]

長いんだけど「ほんとそれ」が詰まってた。コミュニケーションコスト、削減したい。

[hsato2011]

仕様書の書き方について記載。なぜ仕様書をわかりやすく書かねばならないのか、かくとどんないいことがあるか記載されている

[ken1028-kufc]

仕事のメリットやったことの効果を可視化説明できるようになる。

[to4iki]

"One True Source （ここに行けばすべての真実が書かれている）"

[kei_blue_opal]

メモ：仕様書

[d4-1977]

身に沁みる話。こうした仕様書にまで話を持っていくことがエンジニア側に必要とされる職場もあるなあ、って思います。

[tiamointer]

“いいよ。」とアドバイスする仕様書。所属する会社の社員がまだ 10 名程度しかいなかった頃に僕が書いていた仕様書。チームメンバーが 20 人の場合に書く仕様書。さらには、チームメンバー全員が会社に通勤できていた

[raitu]

「状況に応じて理想の仕様書フォーマットは異なる」

[ttono]

読む

[FunnyBunnyDizzy]

仕様についての同期コストを吸収できて、答え合わせ(テスト)に使えること、の2点が一番重要なポイント。

[sawarabi0130]

それは仕様書ではなくポータルサイトとかそういう類のものでは／受託開発の場合、仕様書は開発のためのものでなく納品のために作られるものなので、生産性は完全度外視される。

[braitom]

よい仕様書について。よい仕様書がもたらす効果、仕様書に含めたい項目、作成するときに心がけたいポイントなどがまとめられている。

[mather314]

完成品としての仕様書を目指すのではなくて、目的に応じてドキュメントを書く範囲や粒度を決めるのも大事。

[asa_ca3]

いかにすんなり府落ちさせて無駄に考えることなく開発できるかなんだけど、チームがまとまるために議論する種も少し置いておきたい気がする。

[bmonoral]

たとえ途中で仕様がかわっても、そもそも実現してほしい要求は変わってないので、仕様変更は仕方がない。実現方法はいくらでもある。と教えられてから気が楽になった。相手の要求を把握することに集中するので

[dlive1]

・良い仕様書がもたらす 5 つの効果 ・仕様書の重要性が増していく 2 つの理由 ・仕様書に含めたい 14 の項目・実戦編 ・仕様書作成時に心に留めたい 3 つ ・具体的な仕様書サンプル（後日追加公開予定） などを復習

[shag]

いい話だ。

[osakan]

一言で終わる事を延々と書き、完成形イメージがなく（ぼくの考えた さいきょうロボ的ならまだマシ）、気を利かせて形にすると勝手にやるなと叫び、今すぐ作れと言うおばけ、なーんだ？こたえ:弊社経営陣です。

[Byucky]

仕様書のフォーマットを先方が作って「書き込め」っていうから、手間で時間掛かるけど、しっかりと節々まで書いて提出したのに電話掛かってきて、書いてあること聞かれたり、納品されたら指示と違ってたり…

[hase0831]

これは分かりみが深い “良い仕様書を書けるかどうかは、「ちゃんとしっかり面倒臭がらずにやるかどうか」＋「定石の項目を抑えているかどうか」”

[omron]

“04# 仕様書に含めたい 14 の項目・実践編”

[robo_pitcher]

仕様書は管理部門の作る書類でも結構必要になる事を最近自覚させられた

[Lat]

これは社内でサービスを作りリリースする会社の良い仕様書なのかな？外部に発注する仕様書では品質管理や工数管理の関係で契約後に仕様書がわかるのはあり得ないので新鮮に感じた。

[Bryntsalov]

これは大事なことを言っている。

[lainof]

プロジェクト計画書とかに書くべきことが含まれてない？何の仕様書なのかを明確にしないと話が噛み合わないと思う。

[hatest]

ょぃιょぅιょ

[Soraneko]

👀👀

[Eiichiro]

こないだ初めてオフショアに出したんだけど、画面をfigmaで作り込んで、機能一覧とDB設計を合わせて仕様として渡した。QAは大量に来たけど、手違いのようなミスはなかった。そこまで作り込むのに骨が折れる。。。

[evil07]

"ということで、「Slack / 口頭で仕様を変更したら、すぐに仕様書のページを開いて変更を反映し、その旨をまたチームチャンネルに投げる」くらいのルーティンを形作れるように最近は意識しています。"