いまこそ「良い仕様書」がチームの生産性の鍵となる。ので、仕様書に含めたい 14 のポイントについてまとめました。｜Fritz | Lead Product Manager @ Mercari
いまこそ「良い仕様書」がチームの生産性の鍵となる。ので、仕様書に含めたい 14 のポイントについてまとめました。 こんにちは、フリッツ です。今回はプロダクトマネージャーの日課とも言える「仕様書」について。自分にとっては PM 業の施策実行フェーズにおいて最も重要な仕事のひとつであり、最も心躍り、最も興奮する瞬間です。 PM になってかなりの時間が経ちましたが、「仕様書」への力の入れようは減るどころか、「もっと気合を入れなければ。」と感じる一方。在宅勤務が（たぶん） IT 業界のニュースタンダードとなっていくいま、なおさら「仕様書」の重要性を訴えたい今日この頃です。 ということで、今回は ・ 良い仕様書がもたらす 5 つの効果 ・ 仕様書の重要性が増していく 2 つの理由 ・ 仕様書に含めたい 14 の項目・実戦編 ・ 仕様書作成時に心に留めたい 3 つのこと ・ 具体的な仕様書サンプル（
カトウヒカル@バナーデザインのきほん著者 @design_hikaru ［デザインが苦手なあなたへ］ デザインの四大原則で、あなたの制作物はもっ〜と良くなる。 ➀近接 → 仲間ごとにグルーピング ➁整列 → 透明な線に揃える ➂強弱 → メリハリを付ける ➃反復 → 見やすい統一感 デザインで迷子になったら四大原則を思い出して、基本に立ち戻ろう！！ pic.twitter.com/VMQbAVdeiT
よく、仕様書を書いていなくて、書いてみたいけど、具体的な仕様書がネット上に落ちてなくってこまってるって相談を受けるので 「仕様書の記載内容のイメージ」を作りました！ ※前提として「現在仕様書を書いていない、自社開発のMVP検証前後のフェーズのスタートアップ向け」に書いています。PMが仕様書、エンジニアがDesign Docを書く分担です。 ついでに、システム開発の基礎である「システム開発のV字モデルをベースにした設計書の紹介」も含めてまとめてみましたー！ 大規模開発に使われたり、古くからあるフレームワークなので、スタートアップの方だと、システム開発のV字モデルの概念やそれにあわせた成果物を知らない人が多いけど、「要件定義書」と「設計書」を全てドキュメント化するとどうなるかを理解した上で、「仕様書」として情報を削る方が、考慮漏れ防止やエンジニアがやっている設計内容の理解につながるので、全体を
先日、経済産業省向けの仕事をしている知り合いと食事をしたのだが、彼によると経済産業省の今の悩みは、「IT産業の階層化の弊害によっておこる下流のプログラマーの収入の低下」だそうである。「プライムベンダー」と呼ばれる「上流コンサルタント」たちがインドや中国にも仕事を発注できることを理由に、激しく値切り始めたために、今やわずか一人月３０万円というケースもあるという。 こんな話を聞くと本当に悲しくなる。まず第一に「プログラムを書く」という仕事は簡単な仕事ではない。数学的な頭を持っていないとかなり辛いし、基礎がしっかりと出来ていないとろくなソフトウェアは作れない。物価の安いインドや中国なら許せるが、米国よりも生活費の高い日本で一人月３０万円とはあまりにも低すぎる。 「彼らは下流のエンジニアで、詳細仕様書に従った通りのプログラムを書くだけの簡単な仕事をしているから給料が安い」という説明を聞いたことがあ
私は、昨年度、工業標準化事業に対する貢献により経済産業大臣から表彰を受けました。編集委員会から私に与えられたテーマは、それについて解説せよというものです。しかし、その技術的な内容については既に本ニュースの2004年6月号において「宇宙開発における標準化と情報化」という題名で執筆しています。そこで、今回は、私が標準規格などの文書の作成に力を入れている理由についてお話ししたいと思います。なぜならば、その理由をお話しすることは、「人工衛星のような複雑なシステムをいかに効率的に開発するか」という私のシステム工学的な研究の成果を解説することになるからです。 人工衛星のような複雑なシステムの開発は、必然的に大人数のチームで行うことになるのですが、効率的に開発を行うための一つの原則は、「チーム構成員の誰もが何かしら具体的な作業を担当し、その作業結果を文書などにまとめ、プロジェクトの中で機能させること」だ
経済産業省は11月22日、システム開発時に使う設計書・仕様書などの「作業生産物」のレビュー工程についてJIS規格を制定したと発表した。仕様書などの見直し方や観点などを規格化し、ソフトウェアの品質向上や開発の効率化を促す。 「JIS X 20246」は、設計書・仕様書の見直し作業を「計画作業」「レビューの立ち上げ」「個々人のレビュー」「要検討項目の共有および分析」「修正作業および報告作業」の順に整理し、実行するべきタスクや手順を規定するもの。システム開発や試験、保守などの場面で作るあらゆる仕様書に適用可能。 レビューの曖昧さをなくすため、「目的」「役割」などのレビューの観点10種、「執筆者確認」「同僚との机上確認」などのレビュー手法9種を定めた。JIS制定により、組織や個人のノウハウに依存することなく一定水準のレビューができるようになり、ソフトウェアなどの制作物の品質向上につながるとしている
テスト仕様書で絶対に必要な項目リスト テスト仕様書に記述すべきものとして、以下の事項があります。 テストを実施した環境 実施するテストの内容 テストを実施するためのシステムの操作手順 テストの実行結果 個々のテスト項目を識別するための番号や記号（通し番号など） テストを実施した年月日 テストを実行した担当者 障害報告票番号（発生した障害の詳細を開発グループに報告する帳票の識別番号） まずはテスト環境について明記する テスト仕様書の先頭には、「テストを実施した環境」を記述します。ここでは、ハードウェア環境やソフトウェア環境、ネットワーク環境など、「どのような環境でテストを行ったか」を説明します。 ただし、テストを実施した環境を記述するだけでは十分ではありません。「顧客にとって必要な情報は何か」を考えるのです。ここで必要なのは、「要件定義書で規定した環境」との関係が分かることです。 なぜなら、
[要旨] Twitter API 仕様書の勝手翻訳をしてみました。 [キーワード] Twitter,API
Twitter API 仕様書 日本語訳
WebAPIの仕様を記述する方法はいくつかあると思う。 普通に日本語で記述する JSON Hyper-Schema、WADL、RAML、Swaggerなどを使う 仕様書の代わりにプログラムを書く HTTPメッセージそのものを記述しておく でも、文法にばらつきがあったり、読みにくかったり、ツールのセットアップが面倒だったり、どれもイマイチな所があって、手軽な方法が欲しいと思っていた。 何気なくcurlコマンドのオプションを調べていたら、「もうこれでAPIドキュメント扱いにしちゃえばいいんじゃね？」と思えてきたのでメモしておく。 curlコマンドのおさらい curlコマンドはlibcurlの付属コマンドで、最近のUnix系OSなら大抵最初から入っていると思う。コマンドの詳細はmanを読んでいただければ。 cURL - How To Use （マニュアルページ日本語訳） curlコマンドのオプシ
個人でWebサービスを作る際の考察に関する以下の記事が、とても興味深く面白かった。ここに書いてあることはだいたい同意で、自分も実践したいと思うことばかり。 個人でWebサービスを超高速でつくる人たちの作り方を考察。 │ モノづくりブログ 株式会社8bitのスタッフブログです で、記事の最後に執筆者が聞いてみたいこととして「個人Webサービスの場合、仕様書はどうしてるの？」と呼びかけていたので、僭越ながら自分が過去に作ったWebサービスの仕様書（Evernoteに書いたメモ）を公開してみる。公開するのはNekostagramとはてなスターカウンターのもの。 仕様書（TODOリスト）の書き方 自分の場合、Webサービスを作るときに書くものは「仕様書」などと呼べるようなちゃんとしたシロモノではなく、Evernoteに思いついたことをどんどんリストアップしていくだけ。いわゆるTODOリストですね。
8. デザイン完了！ デザインガイド作成！ 開発完了！事前に打ち合わせ！ （設計段階） 開発者と、 A から Z まで事前にとことん話し合うこと 可能な限り、毎回確認（開発社 ( 者 ) ごとに、スタイルは違う！） 全てのデータを表記する考えは、捨てること（互いに疲れるだけ） 何だ、いいヤツ じゃないか デザインガイド ? おすすめのプロセスとは…
こんにちは、QAエンジニアの井上恵一です。好きな飲み物は一番搾りと韃靼そば茶です。 初回からニッチなネタではありますが、昨年入社した直後に行った、 iPad アプリのテスト仕様書の管理方法を見直したときの話を紹介しようと思います。 見直しのきっかけ トレタは飲食店向けの予約/顧客台帳アプリです。だれでもかんたんに使いこなせるシンプルさを追求してはいますが、製品の進化に伴ってそのテストケース数はすでに数千という単位にまで膨れあがっています。 製品の品質を安定させるためには、テストの内容自体をブラッシュアップすることが重要なのは言うまでもありません。ただ、安定した製品を永続的に提供していくためには、それに加えて、膨大なテストケースを効率よくメンテナンスし続けるためのプロセス作りも欠かせません。 入社のタイミングでトレタのテスト設計を担当することになったので、テストケースの管理方法についてもいち
デザイナーがWebサイトのUIを実装する際にデベロッパーに渡すデザイン仕様書・指示書の作り方を紹介します。 仕様書を作成する基本ツール、指示に適したフォントやカラー、グリッドや要素間の距離を自動的に計算するツールをはじめ、レイアウトや各UIコンポーネントのデザイン仕様の記述例まで、デザインを仕様化する解説記事です。 ブレイクポイントの説明、スティッキー要素の仕様説明、相対サイズの要素の説明方法、ボタンの文字数の説明、アニメーションする要素の説明方法など、デベロッパーに分かりやすく、デザイナー自身も見直せるデザイン仕様書を作成します。 The Art of Design Spec'ing by Mahdi Farra 🍉 下記は各ポイントを意訳したものです。 ※当ブログでの翻訳記事は、元サイト様にライセンスを得て翻訳しています。 デザイン仕様書とは デザイン仕様書に使用するツール デザイン
本誌入手のアベノマスク「仕様書」でわかった“欠陥”と国内生産の謎 「命取りになる」と自民党幹部 | AERA dot. (アエラドット)
布マスクを装着した安倍首相(C)朝日新聞社この記事の写真をすべて見る 本誌が入手したアベノマスクの「仕様書」 本誌が入手したアベノマスクの「仕様書」 政府が新型コロナウイルス対策として、日本の全世帯約5000万世帯を対象に1住所あたり2枚の布製マスクを配布している「アベノマスク」が、物議を醸している。 【本誌が入手したアベノマスクの「仕様書」はこちら】 安倍首相が国会での答弁で、「布製マスクは使い捨てではなく、再利用可能であることから、急激に拡大しているマスク需要に対応するうえで非常に有効であり、また、サージカルマスク等を医療現場に優先して供給するためにも家庭向け布マスクの配布を行うことは理に適った方策と考えています」と自賛する肝いりの政策だったが、早くもつまずいた。 4月17日から全戸配布が始まったが、これに先行して配布が始まっていた妊婦向けの布マスクについて、虫や髪の毛の混入、カビの付
サンプル例に見る機能仕様書の基本的な書き方＆読みやすくする7つのテクニック (1/3)：プロジェクト成功確率向上の近道とは？（2） - ＠IT
サンプル例に見る機能仕様書の基本的な書き方＆読みやすくする7つのテクニック：プロジェクト成功確率向上の近道とは？（2）（1/3 ページ） ITシステム開発の問題点の一つであるコミュニケーションの失敗。本連載では、これを防ぐ方法としてお勧めしたい3つのドキュメントを紹介していく。今回は、Joelの機能仕様書を日本人向けにカスタマイズされたものを例に、機能仕様書の基本的な書き方、読みやすくする7つのテクニック、仕様書作成ツールは何を使うべきか、誰が書くべきかなども解説します。 連載目次 連載の第1回の前回「ドキュメントは最強のコミュニケーションツールである――Joelの機能仕様書入門」では、ITシステム開発がビジネスに貢献していくためには、まずは開発の成功が出発点になること、そしてITシステム開発におけるコミュニケーションの重要性、そしてコミュニケーションにおけるドキュメントの重要性について説
『パックマン』最終仕様書、全ページが学会誌に掲載。AI研究の三宅氏らによる開発者・岩谷氏インタビューも
人工知能学会が発刊している学会誌の最新号にあたる「人工知能 Vol.34 No.1」にて、『パックマン』の生みの親である岩谷徹氏のインタビューと共に、同作の仕様書が全面公開される。発売日は1月10日、価格は2592円。Amazonで販売されるほか、1月中旬以降はKindleでも購入できるようになる。また同学会が運営するAI書庫でも閲覧可能だ。 （画像はAmazon | 人工知能 Vol.34 No.1 (2019年1月号)より） 人工知能学会は、人工知能に関する研究の進展と知識の普及を図り、学術・技術ならびに産業・社会の発展に寄与することを目的とした団体。学会誌「人工知能」を定期的に発行している。その最新号では『パックマン』とAIの関係にフォーカスを当てた特集記事が組まれている。 そのなかには『パックマン』の生みの親である岩谷徹氏のインタビューが掲載されている。聞き手はスクウェア・エニック
GT Nitro: Car Game Drag Raceは、典型的なカーゲームではありません。これはスピード、パワー、スキル全開のカーレースゲームです。ブレーキは忘れて、これはドラッグレース、ベイビー！古典的なクラシックから未来的なビーストまで、最もクールで速い車とカーレースできます。スティックシフトをマスターし、ニトロを賢く使って競争を打ち破る必要があります。このカーレースゲームはそのリアルな物理学と素晴らしいグラフィックスであなたの心を爆発させます。これまでプレイしたことのないようなものです。 GT Nitroは、リフレックスとタイミングを試すカーレースゲームです。正しい瞬間にギアをシフトし、ガスを思い切り踏む必要があります。また、大物たちと競いつつ、車のチューニングとアップグレードも行わなければなりません。世界中で最高のドライバーと車とカーレースに挑むことになり、ドラッグレースの王冠
田村智子 on Twitter: "内閣府が民間業者に示した桜を見る会招待状の封入作業仕様書。「総理・長官等の推薦者(60,61,62,63)」とある。 Q 招待区分60は総理、少なくとも総理・長官等の推薦者ですよね。 A(内閣府)そう書いてあるが、意味するところが… https://t.co/OSEAJgBJ6g"
内閣府が民間業者に示した桜を見る会招待状の封入作業仕様書。「総理・長官等の推薦者(60,61,62,63)」とある。 Q 招待区分60は総理、少なくとも総理・長官等の推薦者ですよね。 A(内閣府)そう書いてあるが、意味するところが… https://t.co/OSEAJgBJ6g
最近の開発で仕様書等のドキュメント類を書くことが少なくなりました。 私は主に業務系のWebサービスを作成してましたが、最近はオープン系のサービスも受け持つことも多いのですが、仕様書やテストのエビデンスがオープン系のお客様の場合は求められることが少ない・・・ というかほぼない。 何故、お客様は仕様書を求めないのか？ 予算を削りたい お客様にとって仕様書なんて見てもわからないもの貰ってもしょうがない。 貰ってもしょうがないものなら作ってもらわないで、削ってしまおうって考えがあります。 テストのエビデンスも同様です。 これは仕様書の作成やエビデンスの作成に工数が掛かるため、工数の削減を計って予算を削りたいという考えがあります。 例えば、おおまかに計算しますが以下のようなシステムがあります。 開発工数：1人月 検証工数：0.5人月 設計工数：0.5人月 ドキュメント作成工数：0.5人月 管理工数：
昨年末にOpenIDファウンデーション・ジャパン参加企業の有志数名で翻訳・教育 Working Groupというのを立ち上げて、現在は主にドキュメントの翻訳を行っています。 現在4本のドキュメントの日本語版を翻訳・教育 Working Group のサイトで公開しています。（この記事の末尾にリンクあり） 翻訳後のドキュメント以外に、githubレポジトリも公開しています。forkもpull requestも大歓迎！原文との比較がしやすいように、各翻訳版のXMLファイルにはコメントアウトの形で原文も残されています。 翻訳版ドキュメントへのコメント・質問は翻訳・教育 Working Group のサイトのコメント欄にどうぞ。 OpenID Authentication 2.0 OpenID Attribute Exchange 1.0 OpenID Simple Registration Ex
「バグ数には興味ないのだよ」――顧客が喜ぶテスト仕様書とは？：誰にでも分かるSEのための文章術（11）（1/2 ページ） 「提案書」や「要件定義書」は書くのが難しい。読む人がITの専門家ではないからだ。専門用語を使わず、高度な内容を的確に伝えるにはどうすればいいか。「提案書」「要件定義書」の書き方を通じて、「誰にでも伝わる」文章術を伝授する。 メーカーが機械を納入する際は、耐久試験や性能試験などの結果を添付して、問題がないことを顧客に確認してもらいます。同様にシステム開発においても、テスト結果を顧客に提示してシステムに問題がないことを確認してもらう必要があります。 今回と次回の2回にわたって、「テスト仕様書」の書き方と表現のポイントを説明します。 今回は、「顧客にとって良いテスト仕様書」とは何か、「顧客にとって良いテスト仕様書」にするためには何を記述すればよいのか、テスト仕様書のおおまかな
はじめまして！ 株式会社 Aiming の土井です！ エンジニアをやっております！ 今回の開発者ブログでは、情報共有ツールとしての UML の活用方法について、現場での取り組みをご紹介させていただければと思います！ 技術仕様書の“図” どうやって書いてますか？ 株式会社 Aiming では、プロジェクトの Wiki やバグトラッキングに Redmine をメインに使っています。みなさんも既にご存知だったり、実際にバリバリ活用されていることとおもいます。 また、企画仕様書、技術仕様書などは Redmine の Wiki やエクセルに代表されるオフィススイート等を活用して作成しますが… 図の表現を求められるような仕様書を作る時に、どうやって作成しようか悩んだことはありませんか？ 標準ペイントソフトで頑張って作成 オフィススイートに含まれる、ドローツールを使って図を作成、画像吐き出し というケー
上段左からティーアンドエフカンパニー 事業推進統括責任者 情報化戦略コンサルタント 西岡祐弥氏，ティーアンドエフカンパニー 代表取締役社長 佐藤裕司氏，パフ 代表取締役社長 釘崎清秀氏，下段左よりティーアンドエフカンパニー 最高技術責任者 出羽健一氏，パフ 取締役兼株式会社プロシンクワーク代表取締役社長大場京子氏，パフ 事業サポートグループ グループマネージャー 保坂光江氏 Webシステムを開発する際にはほとんどの場合，ユーザーとの打ち合わせのためにHTMLによるモックアップを作る。「このHTMLがそのまま仕様書になれば」と思ったことはないだろうか。就職情報サイトPuffの再構築プロジェクトでは，まさにモックアップをそのまま仕様書した。「十数人の開発者で，5カ月で1000画面のシステムを開発する」必要に迫られたからだ。 HTMLに仕様とメモを埋め込み，CSSで切り替え 「この未体験のスピー
検査仕様書なしでシステム開発するとどうなるか？
検査仕様書なしでシステムを開発するとどうなるのか? ある炎上プロジェクトの建て直しを通じて嫌と言うほど思い知らされた。 そのプロジェクトの顧客が一番怒っていたのは「一体どういうテストをしてリリースしてるんだ?」という点だった。 プロジェクトの建て直しはやり慣れているのでまずは検査仕様書をレビューして検査項目の強化だな、とか軽く考えていた。 でもプロマネに検査仕様書を見せてくれと言っても整理できてないから待ってくれ、の一点張り。 まずは社内の人間で見るだけだから整理なんていらないよ、と説得しても頑固に出さない。 なんとそいつは検査仕様書なしでテスト(うちの会社の定義ではそんなもんはテストと言わないけど)して顧客にリリースしてた。 全く動かないシステムをリリース顧客は「全く動かない」と怒っていたが僕はいくらそれはないだろ、顧客が話を盛っているんだろうと甘く考えていた。 しかし、プロジェクトの自
デザイナーが作ったデザインをエンジニアがコードに落としこむ工程，コミュニケーションコストも大きくなかなか大変ですよね．そんな課題を解決してくれる，ビジュアル仕様書共有ツール Zeplin を使ってみたところ非常に好感触で，アプリ開発がかなり効率化されたように思うので，普及もかねてまとめてみようと想います． Zeplin は何を解決してくれるのか これまでアプリ開発の際，デザイナーさんに以下の様なビジュアル仕様書を Google Drive で共有してもらっていました． 自分はデザイナーさんみたいに 1px の細かい差異など分からなかったりするので，このようなビジュアル仕様書を作成してもらえると，正しく実装することができ非常に助かります．しかし，これには例えば以下のような課題がありました． (1) デザイナーさんのコストが大きい．上図の例はアプリの 1 画面に過ぎませんが，これが 10 枚，
W3C - W3Cの仕様書等の文書の日本語訳集
注意 日本語翻訳集は w3c-translators@w3.org メーリングリスト上で報告された日本語翻訳文書へのリンクを集めたものです． リンクされた翻訳はボランティアによって行われたものです． またこれらの翻訳には誤りが含まれる可能性もあります． 正式なものはあくまでも英語版ですので， この点をご理解頂いた上でご利用下さい． またコピーライトに関する情報を含め，W3Cの文書の翻訳に関しての一般的な情報や， 翻訳の際のヘルプは， http://www.w3.org/Consortium/Translation/にあるW3C翻訳ページ(英語版) をご覧下さい． TR集 勧告 ・ 勧告案 ・ 勧告候補 ・ 草案 ・ 技術ノート その他の文書等 FAQ集 ・ その他 TR集 勧告 HTML 4 (勧告) http://www.asahi-net.or.jp/~bd9y-ktu/html4re
“世界最古”にして現代ゲームAIの先駆。21世紀に『パックマン』が再評価される理由を、作者・岩谷徹氏×AI開発者・三宅陽一郎氏が解説【仕様書も一部公開！】
歴史の話にくわえて、海外と日本のゲームAIを巡る「認識の落差」についても、三宅氏に語っていただいているので、ぜひ未読の方はご一読いただければと思う。 ところで、この「ゲームAI」史の記事の中で、1980年に発売されたアーケードゲームの名作『パックマン』が、どうやら「ゲームAI」の起源らしいという話が、三宅氏によって語られている。 「世界一売れたアーケードゲーム機」としてギネス記録にも載っている、この40年も昔の名作が「世界最古のゲームAI」でもある――それは一体、どういうことなのか。しかも、『パックマン』の開発人数は、たった7〜8人。どのような経緯で、当時のナムコは21世紀のゲーム開発にも通じる「ゲームAI」の発想を必要としたというのか。 ――実は、その謎を解き明かすイベントが、去る2016年12月12日に開催されている。 『人工知能の作り方 ―「おもしろい」ゲームAIはいかにして動くのか
こんにちは。ライブドアでブログを更新しているキツネハンターです。 今回はソフトウェア開発に必要となる「仕様書」を書く際のポイントについて紹介したいと思います。あと、このテイストはlivedoor ディレクター Blogのパクリです。 さて、仕様書と言っても、大別して２種類あることをご存知でしょうか？１つはユーザー側から見た外部仕様（機能仕様）、もう１つは開発者側から見た内部仕様（技術仕様）です。 例えば、「0〜100までの素数を全て求めたい、素数を数えて落ち着くんだ」というのが外部仕様。これに対して、「ある数Ｘ（Ｘは0以上、100以下）を２からＸまで順に割ってアレする」というのが内部仕様。 外部仕様を書くのはカンタンです。たぶん、誰でも書けます。でも、内部仕様を書くのはプログラミングのスキルがないと書けません。内部仕様を書けるのは、プログラマーかスーパープランナーだけです。 ボク
FigmaとNotionでUML・経理処理・デザインまでAll in oneな仕様書を書いて、更新・共有を楽にしてる話 - Qiita
前提としての情報 単に「Figmaで要件定義のためのUMLも、外部設計のためのデザインも、内部設計のためのERDも全部つくるよ〜〜」という話をすると、ERD書くならデザインツールなんて使わないで、DBMSから自動生成できるツールとか使った方がいいじゃん、みたいな疑問が出るのは重々承知なので、そもそもこの形式に落ち着いた前提事項を書いておきたいと思います。 ご興味がなければ読み飛ばしてください。 筆者の仕事範囲 さて、冒頭で「事業会社でデザイナーとPMの狭間みたいな仕事をしてます」と書きました。キャリアの背景的には受託のPMっぽい仕事（厳密には違うんですが、本旨ではないので割愛します）→事業会社のインハウスデザイナー→現職という感じで、外渉から手を動かす所まで、必要ならなんでもします。 ざっくりいうと、機能の起案をして、経理などの関連部署に相談して、WBS引いて、UML書いて、画面遷移図書い
仕様書とテストを用いた「AI駆動開発」
数年前にAIを離れ現在はフロントエンドをやっているのですが、半年くらい前に思い切り引き戻されました。画像生成AIにおけるmidjourneyとstable diffusionの登場です。noteのCTO深津さんが記事を出したと思ったのも束の間、急速に進化を果たしました。 絵柄の固定・ポーズの指定・マシンスペックなど、日々さまざまな問題を解決しながら新たな技を身につけています。 しかし、同等かそれ以上に話題になっているのは大規模言語モデル(Large Language Model)かもしれません。ChatGPTが話題になった思ったら、BingやPerplexity,You.comなど大規模言語モデルを交えたサービスが次々と登場しました。 活用方法もたくさん見つけられており、私は特に以下の二つの記事が好きです。 「感情回路」の記事に入力(プロンプト)でここまで変わるのかと感動したことを覚えてい
【この記事の対象者】 仕様書の書き方が分からなくて、困っているゲームプランナー ゲームプランナーの素養を身に付けたい人 ゲーム開発に興味がある人 【この記事で学べること】 仕様の考え方 仕様書の作成方法 ゲームデザインに関する基礎知識 前回の記事 前回の記事では、なぜ人によって仕様書作成の能力に差が出るのかを解説しました。今回は仕様書作成の能力を身に付けるための方法を紹介します。 はじめに仕様書が書けない人は、次のどちらかに当てはまると思います。 やりたいことがはっきりしていない やりたいことがはっきりしているが、何を書けばいいのか分からない 『2』に関しては「仕様書の書き方」を調べていけば、答えにたどり着く可能性があります。 しかし、『1』の場合は「仕様書の書き方」を調べても、答えにたどり着けません。なぜなら、「仕様書の書き方」でつまづいているのではなく、「仕様の考え方」の部分でつまづい
突然ですが，読者諸兄姉は，仕様書の書き方って，教わったことはおありでしょうか。あるいは，部下に教えたことはおありでしょうか。 日経エレクトロニクス 2007年2月12日号のGuest Paper（pp. 133-152）では，「仕様書の記述力を鍛える」と題して，フェリカネットワークスのソフトウエア・エンジニアの栗田太郎氏に，「形式仕様記述」という手法を使ったプロジェクトの体験記を執筆していただきました。 同社は「おサイフケータイ」などとして知られる携帯電話機向けの「モバイルFeliCa」の開発元で，そのICチップのファームウエア開発に当たって，「仕様をキッチリ書けるところは，書こう。実装者任せにしないようにしよう」という意識を徹底，高品質なソフトウエアの開発に成功しました。成果物は，NTTドコモの携帯電話機「903iシリーズ」の全機種に採用されるなど出荷数も多く，責任の重いプロジェクトです
以前、手紙の書き方についてリクエストがあったので書く。 「大人の手紙」について、「昔からこうなっているのだから守っておればいいのだ」といった礼儀作法的なお小言を繰り返すのではなく、何を目的にしてどのように構造化されているかについて説明を行う。 理解したからすぐに手紙が書ける訳ではないのは、英文法を学んでもすぐに英会話ができないのと同じである。 しかし、英文法を学んでない人の英語力がやがて頭打ちするように、「大人の手紙」の構造を理解しない人まま墨守していては形骸化が避けられない。 何より意味を理解したものは応用が効く。例文集を使うにしても、要素ごと分解・再統合ができ、相手や状況に合わせたアレンジも可能になる。 また、意味を理解した方が、意味が分からぬものよりもずっと、記憶に残りやすい。 「大人の手紙」は大きく分けて３＋１個の領域からなる。 ・head領域 ・body領域 ・foot領域 ・a
Goの言語仕様書精読のススメ & 英語彙集
この記事について Go言語公式から提供されているThe Go Programming Language Specificationという文章があります。 実際のThe Go Programming Language Specificationのページ画面 この文章、個人的にはじっくり読んでみると結構得るものが大きいな、と感じるものです。本記事では The Go Programming Language Specificationって何が書いてあるの？ 読んだら何がわかるの？ 読むときにはどういうところに注目したらいいの？ 英語難しいから単語教えて！ という疑問に答えながら、The Go Programming Language Specification精読の布教を行います。 The Go Programming Language Specification とは？ The Go Prog
グループ共有機能仕様書の公開に踏み切ったのは、10Xのプロダクトがどうやって作られているか、について部分的に触れてもらえると思ったから。 10Xでは「細かな実装・デザインの白兵戦」・「認知と理解を獲得していく空中戦」を一緒に戦えるプロダクト・マネージャーを育てていきたいと思っているので、この仕様書を読んで「10Xで力を試してみたい！」という方はぜひ以下のフォームから応募してほしい。ユーザーの感情を科学できる人が10XのPMにはフィットすると思う。 仕様書の前提となる考え仕様書は「チームのワーキングスタイル」によってその役割をかえるものだ。今の10Xは「ユーザーの前に積まれた膨大な課題の山に優先度を付け、とにかく早くプロダクトをプッシュしていくこと」が最優先のチーム。 そのため、「膝を突き合わせて瞬発力の高いコミュニケーション」を重視している。リモートはしない。 この環境では議論のすべてが口
プログラマが欲しい仕様書とは
3. ソフトウェア工学とは • ソフトウェアの開発・運用・保守に ついて体系化、分析、研究する分野 • 高度で安全なソフトウェアを短期間 で設計するための研究を行う
@ITの「業務用途でRubyを使う上での課題 」を読んでなんだか悲しくなった。 チーム開発でRubyを使ったときに今後起こりえる問題として、サン・マイクロシステムズ システム技術統括本部 チーフテクノロジストの下道高志氏は、こう指摘する。「他人の書いたPHPコードのメンテナンスはできない。Rubyはどうかといえば、現状はいい。しかし今後“職業プログラマ”ではなく、渡された仕様書を実装する“サラリーマンプログラマ”が増えてくると、コードのスパゲッティ化は避けられないだろう」。 【業務用途でRubyを使う上での課題 − ＠ITより引用】 これは言語の問題ではなく、日本のソフトウェア産業全体が抱える問題。以前にも「ソフトウェアの仕様書は料理のレシピに似ている」というエントリーで書いたが、本来のソフトウェア作りとは、絵を描いたり、音楽を作ったり、建物をデザインするのと同じ「創作活動」である。ドラッ
"Excelenium"（エクセレニウム）で，快適な自動回帰テストを （Seleniumのテストスクリプトとテスト仕様書を自動生成） - 主に言語とシステム開発に関して
テスト仕様を書くだけで，仕様書自身がテストを自動でやってくれる。 それがExcelenium（エクセレニウム）。 Excelenium ＝ Excel ＋ Selenium 左側で，操作のステップを日本語で書くと， 右側で，テスト仕様書風のフォーマットの文章をリアルタイムで自動生成してくれる。 ※画像中で「確認」と書いてあるのは，チェックポイントの部分。これは自動的にオレンジ色のセルになる。 書く必要があるのは，青い線より左側だけ。 そして， 「この仕様書の全テストを実行」 というボタンを押すと・・・ Seleniumのテストケースが自動生成され， ブラウザが立ち上がり， テスト仕様書に書いてあった全テストが実行される。 （※ついでに，シート上の全テストケースに自動で番号が振られる。） Webアプリケーションの結合テスト / 回帰テストが大幅に楽になる。 従来のような「テスト仕様書」と称し
プロパティ -> CSS 仕様書（邦訳）へのリンク 各プロパティから仕様書（邦訳）の当該箇所へのリンクです。( en | ja )
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
デザインが苦手な人へ。デザインの四大原則を押さえれば格段にクオリティ上がるよ→素人が作るチラシや仕様書などにも有益
仕様書の参考例と、こんな内容を仕様書に最低書くといいというお話｜田辺めぐみ
Life is beautiful: ソフトウェアの仕様書は料理のレシピに似ている
技術者よ、設計しよう、仕様書を書こう | 宇宙科学研究所
設計書・仕様書のレビュー方法を定めたJIS規格登場 チェック体制を標準化しやすく
知るだけで天地の差が出る、テスト仕様書の必須項目＆表現方法
[観] Twitter API 仕様書 (勝手に日本語訳シリーズ)
WebAPIリクエスト仕様書としてcurlコマンドのご提案 - Qiita
個人で作ったWebサービスの仕様書（Evernoteのメモ）を2つ公開してみる - アインシュタインの電話番号
デザイン仕様書(ガイド) の書き方(初歩用)
Excelなテスト仕様書をMarkdown/GitHub/CircleCIに移行した話 - トレタ開発者ブログ
これなら分かりやすい！Webサイトのデザイン仕様書・指示書の作り方
ウノウラボ Unoh Labs: ブラウザから使用できる仕様書を書くツールまとめ
仕様書がない開発が増えた理由 | ScrapEngineer
OpenID & OAuth 仕様書を日本語に翻訳しました - 京の路
「バグ数には興味ないのだよ」――顧客が喜ぶテスト仕様書とは？
Redmine で技術仕様書を書こう
「HTML画面をそのまま仕様書に」，5カ月で1000画面を構築した就職サイトPuffの高速開発手法：ITpro
ビジュアル仕様書共有ツール Zeplin でアプリ開発が爆速になった - Qiita
最低限知っておきたい仕様書を書くときの３つのポイント 【ボクバイＺ the blog】
ゲームプランナーが仕様書を書き始める前に考えておくべきこと｜panke
仕様書の書き方って，習いました？ - 日経エレクトロニクス - Tech-On!
「大人の手紙」の仕様書－何を目的にしてどのように構造化されているか
タベリー | とある仕様書 – Yamotty – Medium
「渡された仕様書を実装するサラリーマンプログラマ」の悲哀
Lucky bag::blog: プロパティから CSS 仕様書（邦訳）へのリンク