仕様書

エンジニアとして、仕様を読み取れないことで困っていませんか？ 「仕様がさっぱり分からない...」って頭を抱えた経験、きっとあると思います。 実は、仕様理解の問題でプロジェクトが炎上することって、めちゃくちゃ多いんです。 でも安心してください！これって決してあなた一人の能力の問題じゃないんですよ。 この記事では、実際に現場で見てきた「あるある」なトラブルと、本当に効果があった解決策をシェアしていきますね。 仕様理解で悩んでるエンジニアさん、本当に多いですよね。でも大丈夫！正しいやり方を覚えれば上達できます。 現場でよく見る「仕様理解ミス」のヤバいパターン 「聞いてない！」「言った！」の不毛なバト…

SWET第二グループのKuniwakです。本記事では画面仕様（後述）の仕様書に対する静的検査器を開発した事例について紹介します。 伝えたいこと 画面表示と画面遷移を記述する仕様書は機械可読にできる 仕様書が機械可読であれば仕様の静的検査ができる 静的検査によって自身の担当範囲の15%の画面から計40件弱の欠陥を発見した 機械可読な仕様書にはさらなる応用が見込める おさらい：仕様とは 仕様の定義はいくつかあります。 ここでは仕様とは実装の正しい振る舞いを定める基準とします。 ある実装が正しいと判定されることを、実装が仕様を満たしたといいます。 誰による判定でも実装が仕様を満たしたかどうかの判定結…

初めに ユニファでバックエンドエンジニアをしている八木です。ドキュメント作成、エンジニアでは苦手意識のある人も多いのではないでしょうか。日常的に仕様書などを書く機会があれば練習になっていいのですが、そうでない場合や、初めて仕様書や手順書を書く場合など、戸惑いながら真っ白な画面を見続けている人もいるのではないでしょうか。 本記事はエンジニアのみなさんの中でのドキュメント作成への苦手意識を少しでも減らしていけたらいいなと思っています。初めてドキュメント作成をするような初級者向けの内容です。ドキュメントの骨組み作成までの道筋を記載しています。

この記事は BASE アドベントカレンダー10日目の記事です。 はじめに はじめまして！ BASEのカートチームでバックエンドエンジニアをしている @ykagano です！ カートチームは主にBASEのショッピングカート機能の開発を担当しているチームです。 そんなカートチームでのドキュメント管理術をご紹介したいと思います！ ドキュメント管理の課題 BASEではNotionを社内Wikiとして使用しています！ 社内資料は、Notionのページやデータベースで一元管理しています！ カートチームでもドキュメントはNotionの一つの階層構造で管理していますが、使用している中で以下の課題がありました。…

画像が全てです 捏造・改ざん・誹謗中傷・暴営利目的を除き 自由にお使い下さい 残念乍ら ご質問には お答えできません 作者の一方的都合により 画像は追加・訂正・削除されます 表紙 目次 1 3-2 4 8 9 16 工事のお知らせ 表紙 目次 1 3-1 3-2 4 8 9 16 工事のお知らせ 工期の都合で 全16頁（製本）の抜粋（手抜き）となりました 裏表紙には 判読不能のメモ・・・ 今後 全頁完追投稿の予定です 。

※本記事を読む前に、修学旅行どうやって企画するのか問題（１）「企画メンバーになろう」、修学旅行どうやって企画するのか問題（２）「下調べしよう」、修学旅行どうやって企画するのか問題（３）「打診しよう」をご一読ください。 打診した結果、好感触だったのであれば、いよいよ「仕様書」（名称は学校・地域により異なるかも知れません）を策定します。これは、簡単に言うと「こんな修学旅行にしたいです」という具体的な要件・条件を明文化したもので、A4用紙片面１枚程度（いわゆるペライチ）で済む場合もあれば、数ページにわたる場合もあります。これを各学校の様式に合わせて作ります。 この仕事に携わらせてもらえるまで数年かか…

（Part5より） 実は別のプログラムソースを元に、ChatGPTにリバースエンジニアリングさせたことがありました。要は、ソースコードから「仕様書」を作らせたのです。この時はかなりの精度で”生成”できたので、今回完成したプログラムについても作らせることにしました。 以下のソースプログラムから、プログラム仕様書を作成してください。・プログラムの概要・ゲームの遊び方・メソッドの一覧・変数一覧表・仕様の拡張案 /* * イスカンダルのトーフ屋ゲーム * original copyright 1978 by N.Tsuda * convert & arrange to Java version by …