並び順

ブックマーク数

期間指定

  • から
  • まで

1 - 40 件 / 140件

新着順 人気順

仕様書の検索結果1 - 40 件 / 140件

タグ検索の該当結果が少ないため、タイトル検索結果を表示しています。

仕様書に関するエントリは140件あります。 開発AI設計 などが関連タグです。 人気エントリには 『いまこそ「良い仕様書」がチームの生産性の鍵となる。ので、仕様書に含めたい 14 のポイントについてまとめました。|Fritz | Lead Product Manager @ Mercari』などがあります。
  • いまこそ「良い仕様書」がチームの生産性の鍵となる。ので、仕様書に含めたい 14 のポイントについてまとめました。|Fritz | Lead Product Manager @ Mercari

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

      いまこそ「良い仕様書」がチームの生産性の鍵となる。ので、仕様書に含めたい 14 のポイントについてまとめました。|Fritz | Lead Product Manager @ Mercari
    • 仕様書の参考例と、こんな内容を仕様書に最低書くといいというお話|田辺めぐみ

      よく、仕様書を書いていなくて、書いてみたいけど、具体的な仕様書がネット上に落ちてなくってこまってるって相談を受けるので 「仕様書の記載内容のイメージ」を作りました! ※前提として「現在仕様書を書いていない、自社開発のMVP検証前後のフェーズのスタートアップ向け」に書いています。PMが仕様書、エンジニアがDesign Docを書く分担です。 ついでに、システム開発の基礎である「システム開発のV字モデルをベースにした設計書の紹介」も含めてまとめてみましたー! 大規模開発に使われたり、古くからあるフレームワークなので、スタートアップの方だと、システム開発のV字モデルの概念やそれにあわせた成果物を知らない人が多いけど、「要件定義書」と「設計書」を全てドキュメント化するとどうなるかを理解した上で、「仕様書」として情報を削る方が、考慮漏れ防止やエンジニアがやっている設計内容の理解につながるので、全体を

        仕様書の参考例と、こんな内容を仕様書に最低書くといいというお話|田辺めぐみ
      • NHKに提訴された日本IBMの反論が生々しい…仕様書に記載ない仕様が満載

        日本IBM(「Wikipedia」より/Yoshi Canopus) NHKがシステム開発を委託していた日本IBMに対し、開発の遅延による契約解除に伴い計約55億円の代金の返還と損害賠償を求めて東京地裁に提訴した係争事案。NHKは、日本IBMが開発の途中で突然、NHKに対して大幅な開発方式の見直しと納期遅延を要求したと主張しているが、これに対し日本IBMは7日、以下のリリースを発表して反論したことがIT業界内で注目されている。 <現行システムの解析を進める中で、提案時に(編集部追記:NHKから)取得した要求仕様書では把握できない、長年の利用の中で複雑に作り込まれた構造となっていることが判明したため、当社はNHKに対し、解析の進捗状況、課題およびそれに対する対応策を随時報告し、共にその対応を検討してまいりました。こうした中で当社は、同システムを利用する業務の重要性も鑑みて、NHK指定の移行方

          NHKに提訴された日本IBMの反論が生々しい…仕様書に記載ない仕様が満載
        • 設計書・仕様書のレビュー方法を定めたJIS規格登場 チェック体制を標準化しやすく

          経済産業省は11月22日、システム開発時に使う設計書・仕様書などの「作業生産物」のレビュー工程についてJIS規格を制定したと発表した。仕様書などの見直し方や観点などを規格化し、ソフトウェアの品質向上や開発の効率化を促す。 「JIS X 20246」は、設計書・仕様書の見直し作業を「計画作業」「レビューの立ち上げ」「個々人のレビュー」「要検討項目の共有および分析」「修正作業および報告作業」の順に整理し、実行するべきタスクや手順を規定するもの。システム開発や試験、保守などの場面で作るあらゆる仕様書に適用可能。 レビューの曖昧さをなくすため、「目的」「役割」などのレビューの観点10種、「執筆者確認」「同僚との机上確認」などのレビュー手法9種を定めた。JIS制定により、組織や個人のノウハウに依存することなく一定水準のレビューができるようになり、ソフトウェアなどの制作物の品質向上につながるとしている

            設計書・仕様書のレビュー方法を定めたJIS規格登場 チェック体制を標準化しやすく
          • 画面仕様書への静的検査器を実装したらたくさんの欠陥を発見できた話 - DeNA Testing Blog

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

              画面仕様書への静的検査器を実装したらたくさんの欠陥を発見できた話 - DeNA Testing Blog
            • これなら分かりやすい!Webサイトのデザイン仕様書・指示書の作り方

              デザイナーがWebサイトのUIを実装する際にデベロッパーに渡すデザイン仕様書・指示書の作り方を紹介します。 仕様書を作成する基本ツール、指示に適したフォントやカラー、グリッドや要素間の距離を自動的に計算するツールをはじめ、レイアウトや各UIコンポーネントのデザイン仕様の記述例まで、デザインを仕様化する解説記事です。 ブレイクポイントの説明、スティッキー要素の仕様説明、相対サイズの要素の説明方法、ボタンの文字数の説明、アニメーションする要素の説明方法など、デベロッパーに分かりやすく、デザイナー自身も見直せるデザイン仕様書を作成します。 The Art of Design Spec'ing by Mahdi Farra 🍉 下記は各ポイントを意訳したものです。 ※当ブログでの翻訳記事は、元サイト様にライセンスを得て翻訳しています。 デザイン仕様書とは デザイン仕様書に使用するツール デザイン

                これなら分かりやすい!Webサイトのデザイン仕様書・指示書の作り方
              • API仕様書を読み取れるMCPサーバーを自作したら開発が爆速になった

                タイトルでもうオチてる感じがしますが、API仕様書を読み込むMCPサーバーを自作したところ、開発が爆速になったので紹介します。普段Androidのアプリ開発をしている人間です。 MCPとは? LLMに対してコンテキストを与えるためのプロトコルです。 今回はAPI仕様書を読み込むMCPを作るので、ざっくり言うとClineやClaude for Desktop、GitHub Copilot Agentなど、MCPに対応したツールがAPI仕様書に基づいてコードを書いてくれるようになります。 何が嬉しいのか? 例えば、以下のような質問・指示ができるようになります。 決済に関連するAPIを列挙し、Markdown記法でまとめて ドメインクラスを作りたいので、User をKotlinのdata classで出力して Androidアプリの NotificationRepository.kt に書いてあ

                  API仕様書を読み取れるMCPサーバーを自作したら開発が爆速になった
                • 検査仕様書なしでシステム開発するとどうなるか?

                  検査仕様書なしでシステムを開発するとどうなるのか? ある炎上プロジェクトの建て直しを通じて嫌と言うほど思い知らされた。 そのプロジェクトの顧客が一番怒っていたのは「一体どういうテストをしてリリースしてるんだ?」という点だった。 プロジェクトの建て直しはやり慣れているのでまずは検査仕様書をレビューして検査項目の強化だな、とか軽く考えていた。 でもプロマネに検査仕様書を見せてくれと言っても整理できてないから待ってくれ、の一点張り。 まずは社内の人間で見るだけだから整理なんていらないよ、と説得しても頑固に出さない。 なんとそいつは検査仕様書なしでテスト(うちの会社の定義ではそんなもんはテストと言わないけど)して顧客にリリースしてた。 全く動かないシステムをリリース顧客は「全く動かない」と怒っていたが僕はいくらそれはないだろ、顧客が話を盛っているんだろうと甘く考えていた。 しかし、プロジェクトの自

                    検査仕様書なしでシステム開発するとどうなるか?
                  • CursorからMCPで社内のドキュメントや仕様書を参照する方法

                    はじめに CursorやGithub Copilot、Clineなど、コーディングに生成AIを使うのは当たり前になりました。AIにコードを書かせているとき、この仕様どおりに書いてくれないかなあ、と思う場面があります。Cursorには外部ドキュメントを読み込む機能があるので、指定しておけば、公開されているリファレンスなどをAIが読み込むことができるのですが、社内にある仕様書や開発標準などのドキュメントを参照したいケースもあるでしょう。この記事ではRunbookのMCPサーバーを使って、社内ドキュメントをAIに読み込ませる方法を紹介します。 Runbookについて Runbookはマニュアルや手順書を作成するためのWebサービスです。マニュアルを社内で共有したり、インターネットに公開したりできます。あと手順を組み合わせてワークフローのように実行できるらしいです。有料サービスですが、今回の方法で

                      CursorからMCPで社内のドキュメントや仕様書を参照する方法
                    • FigmaとNotionでUML・経理処理・デザインまでAll in oneな仕様書を書いて、更新・共有を楽にしてる話 - Qiita

                      本記事は Figma Advent Calendar 2022 16日目の投稿です。 仕様書を作るとき、あの情報はこのツールで書いたほうが楽、みたいな感じで、あっちこっちに情報が散逸することがありますよね。 かくいう私も、事業会社でデザイナーとPMの狭間みたいな仕事をしていまして、UMLだのデザインだの、複数のツールを跨いで作業をすることが多かったのですが、最近は安定してFigma+Notionで作業をしています。 これはデザイナーなのでFigmaの使い方に慣れている、ということもあるんですが、Figmaの自由度の高さや、Notionの情報統合性の高さ(この辺は後述します)が筆者の仕事範囲と大変に相性が良く、今の所ここがベストという形に落ち着いているので、軽く紹介してみようと筆を取りました。ご興味があれば読んでください。 TL;DR(この記事のあらすじ) エンジニア・非エンジニア・社内外い

                        FigmaとNotionでUML・経理処理・デザインまでAll in oneな仕様書を書いて、更新・共有を楽にしてる話 - Qiita
                      • 仕様書とテストを用いた「AI駆動開発」

                        数年前にAIを離れ現在はフロントエンドをやっているのですが、半年くらい前に思い切り引き戻されました。画像生成AIにおけるmidjourneyとstable diffusionの登場です。noteのCTO深津さんが記事を出したと思ったのも束の間、急速に進化を果たしました。 絵柄の固定・ポーズの指定・マシンスペックなど、日々さまざまな問題を解決しながら新たな技を身につけています。 しかし、同等かそれ以上に話題になっているのは大規模言語モデル(Large Language Model)かもしれません。ChatGPTが話題になった思ったら、BingやPerplexity,You.comなど大規模言語モデルを交えたサービスが次々と登場しました。 活用方法もたくさん見つけられており、私は特に以下の二つの記事が好きです。 「感情回路」の記事に入力(プロンプト)でここまで変わるのかと感動したことを覚えてい

                          仕様書とテストを用いた「AI駆動開発」
                        • ゲームプランナーが仕様書を書き始める前に考えておくべきこと|panke

                          【この記事の対象者】 仕様書の書き方が分からなくて、困っているゲームプランナー ゲームプランナーの素養を身に付けたい人 ゲーム開発に興味がある人 【この記事で学べること】 仕様の考え方 仕様書の作成方法 ゲームデザインに関する基礎知識 前回の記事 前回の記事では、なぜ人によって仕様書作成の能力に差が出るのかを解説しました。今回は仕様書作成の能力を身に付けるための方法を紹介します。 はじめに仕様書が書けない人は、次のどちらかに当てはまると思います。 やりたいことがはっきりしていない やりたいことがはっきりしているが、何を書けばいいのか分からない 『2』に関しては「仕様書の書き方」を調べていけば、答えにたどり着く可能性があります。 しかし、『1』の場合は「仕様書の書き方」を調べても、答えにたどり着けません。なぜなら、「仕様書の書き方」でつまづいているのではなく、「仕様の考え方」の部分でつまづい

                            ゲームプランナーが仕様書を書き始める前に考えておくべきこと|panke
                          • 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

                              Goの言語仕様書精読のススメ & 英語彙集
                            • 三菱電機がClaude 3活用で「工数4割減」、仕様書の図表解析にマルチモーダルが威力

                              三菱電機が組み込みソフトウエア開発への生成AI(人工知能)活用を進めている。ソフトウエア開発に関連する過去数十年分のドキュメントの要約文を生成AIにより作成。これを検索用のインデックスとして使うことで、エンジニアの作業工数を最大40%削減できると見込む。 2024年6月20日に開催されたアマゾン ウェブ サービス ジャパン(AWSジャパン)の年次イベント「AWS Summit Japan」で、PoC(概念実証)の成果として明らかにした。今後は実用上必要最小の機能を備えたサービスであるMVP(Minimum Viable Product)として、従業員向けのアプリケーションを開発する予定だ。 三菱電機の組み込みソフトの開発部門では、製品開発部門から改修依頼を受けると、改修対象のソフトウエアの仕様書を検索して改修内容に関連する記述を確認。それを基にソフトウエアのソースコードを確認し、ソースコー

                                三菱電機がClaude 3活用で「工数4割減」、仕様書の図表解析にマルチモーダルが威力
                              • データベースのテーブル定義の仕様書を自動生成しよう | CyberAgent Developers Blog

                                AI事業本部 DX本部の黒崎(@kuro_m88)です。 社外(取引先など)向けに作成する仕様書を自動生成する取り組みを試しているので、アイデアを紹介します。今回はSnowflakeで構築されているデータ分析基盤のテーブル定義の仕様書を例に紹介していきます。ツールはGoを使って開発しました。 仕様書の運用コストを減らしたい DX本部でのプロジェクトは、開発環境を社内向けに別途用意することが大半なので、取引先に許可を取らないと何かを試すことができないということは今のところほとんどありません。 そのため、実際の開発フローとしては詳細な仕様書を書き起こしてから実装することはあまりなく、大まかな方針を決めてから軽く実装してみて、うまくいきそうであればそれを仕様としてまとめつつ実装することが多いです。 データベースのテーブル定義であれば、それらの定義はGitHub上で管理されており、リリース時に自動

                                  データベースのテーブル定義の仕様書を自動生成しよう | CyberAgent Developers Blog
                                • NHKがシステム開発を委託した日本IBMを提訴→日本IBMの反論が生々しい「仕様書にない仕様が満載」「やはり議事録...議事録は全てを解決する」

                                  ヤマダ @yamada_sier やはり議事録…議事録は全てを解決する 冗談はさておき、現行ベンダの富士通がこれまで色々な無理難題を全部うまいこと飲み込んでやってきたんやろなと想像。 NHKに提訴された日本IBMの反論が生々しい…仕様書に記載ない仕様が満載 biz-journal.jp/company/post_3… @biz_journalより 2025-02-17 09:13:30 リンク ビジネスジャーナル/Business Journal | ポジティブ視点の考察で企業活動を応援 企業とともに歩む「共創型メディア」 NHKに提訴された日本IBMの反論が生々しい…仕様書に記載ない仕様が満載 NHKがシステム開発を委託していた日本IBMに対し、開発の遅延による契約解除に伴い損害賠償などを求めて提訴。日本IBMはリリースを発表して反論。その内容が事実ならNHKはベンダーに対して内容的に不

                                    NHKがシステム開発を委託した日本IBMを提訴→日本IBMの反論が生々しい「仕様書にない仕様が満載」「やはり議事録...議事録は全てを解決する」
                                  • 原子力規制庁で不適切入札手続き 企業に仕様書案の作成を依頼、その企業が1者応札 本紙の情報公開請求受け発覚:東京新聞 TOKYO Web

                                    使用済み核燃料の保管方法を巡る調査の一般競争入札で、原子力規制庁は29日、職員が仕様書案の作成を三菱重工に依頼する内規違反があったと明らかにした。入札では同社の案がほぼそのまま仕様書となり、入札予定価格は同社が示した見積額とほぼ同額だった。同社が1者応札で落札した。

                                      原子力規制庁で不適切入札手続き 企業に仕様書案の作成を依頼、その企業が1者応札 本紙の情報公開請求受け発覚:東京新聞 TOKYO Web
                                    • AIが「理解」するから、API仕様書のコピペでアプリができあがるローコード開発環境「Flowise」を試す【イニシャルB】

                                        AIが「理解」するから、API仕様書のコピペでアプリができあがるローコード開発環境「Flowise」を試す【イニシャルB】
                                      • Notion AIを用いて機能仕様書からテストケースを自動で作成した話 - Commune Engineer Blog

                                        はじめに コミューンでQAをしています金丸です。 最近QA界隈でAIを用いたソフトウェア開発が注目を集めています。 www.kzsuzuki.com 多くはChatGPTを用いたものですがちょうど先月にNotion AIがリリースされたので今回Notion AIがソフトウェア開発のテスト部分に対して有用に使うことができるかについて記事を書いていきたいと思います。 結論から言うと、実用としての運用は未だ難しいがQAの補佐的な位置付けとしては十分な働きをしてくれることがわかりました。 はじめに NotionAIとは 機能仕様から同値分割・境界値分析・フローチャートを自動で作成 機能仕様の修正もNotionAIにやっていただいた 終わりに NotionAIとは NotionAIは、Notion Labs, Inc.によって開発された人工知能モデルです。個人や仕事に関するタスクの作成、整理、管理を

                                          Notion AIを用いて機能仕様書からテストケースを自動で作成した話 - Commune Engineer Blog
                                        • [PDF]GIGAスクール構想の実現標準仕様書 令和2年3月3日 文部科学省

                                          GIGAスクール構想の実現 標準仕様書 令和2年3月3日 文部科学省 目次 はじめに ・・・・・・・ 1 1.学習者用コンピュータの標準仕様書 ・・・・・・・ 2 (1)学習者用コンピュータの標準仕様書について ・・・・・・・ 2 (2)学習者用コンピュータ等機器賃貸借標準仕様書例 ・・・・・・・ 3 (3) 「学習用ツール」について ・・・・・・・ 10 (4)LTE 通信でのネットワーク整備について ・・・・・・・ 15 2.校内 LAN 整備の標準仕様書 ・・・・・・・ 17 (1)校内 LAN 整備の標準仕様書について ・・・・・・・ 17 (2)校内 LAN 整備調達仕様書の作成方法 ・・・・・・・ 17 ① 用語の説明 ・・・・・・・ 17 ② インターネットへの接続構成 ・・・・・・・ 19 ③ 校内 LAN 配線 ・・・・・・・ 19 ④ 必要機器の数量及びスペック算定方法

                                          • HTML, CSS, JavaScriptの標準の仕様書はどこにあるのか

                                            HTML HTMLの仕様策定には複雑な歴史があります。詳細は他の解説記事に譲りますが、簡単に述べるとW3CとWHATWGのダブルスタンダード状態が長い間続いていました。2022年現在はWHATWGによってLiving Standardとしてまとめられた仕様が実質的な標準となっています。Living Standardという名前が示す通り、バージョンはなくエディターによって随時更新されています。 CSS CSSの仕様はW3Cが策定しています。現在は、CSSとして1つの標準仕様があるわけではなく、数多くのモジュールに分かれて標準仕様の策定が進められています。草案、勧告候補などを経て勧告に至るプロセスと、Levelという概念で整理されたバージョン管理が特徴です。年に1度、SnapShotとしてその時点での標準化の概況が公開されています。 JavaScript JavaScriptは主にWebブラウ

                                              HTML, CSS, JavaScriptの標準の仕様書はどこにあるのか
                                            • PMによる仕様書では補えない運用フェーズに強いドキュメント作り|さとじゅん

                                              メルペイでプロダクトマネージャをしてます、さとじゅんです。 メルペイでto B向けプロダクトの開発をしてます。なので、主にto B向けプロダクトについての話になります。 たまに思うこと突然ですがPMは新しい機能を作る時は仕様書を書くことが多いですよね。 PRD(プロダクト要求仕様書)とかですね。 「Why」とか「What」とか「How」とか書きますよね。 それでリリースして運用していくと思うのですが、運用中にいろんな課題をこなしていくうちにひとつの事に気づきます。 「もう少しビジネスとシステムとオペレーションがひとつのつながりで理解できる資料が欲しいな」と。 to C向けのプロダクトに比べ、to B向けのプロダクトにはセールスやオペレーションのチームなど1つのプロダクトに関わる人が多くなる特徴があると思います。 PLGという考え方もあると思いますが、だいたいのto B向けプロダクトがto 

                                                PMによる仕様書では補えない運用フェーズに強いドキュメント作り|さとじゅん
                                              • API仕様書をバリデーターと型と同期させて作る

                                                API Spec を書くとそれ通りのリクエストしか受け付けないようにバリデーションしてくれて、なおかつバリデーションされた値には Spec で期待した通りの型が付いて欲しいですよね。 これを TypeScript で実現しようとすると色々と壁があります。特に API Spec と TypeScript の型を揃えるのが難しいです。 この手の課題は NestJS であればクラスフィールドとデコレータを使って解決できるのですが、制約の強い FW であるため会社の事情で採用が難しかったりもします。そこで fastify を使って同様のことを達成できるか模索してみましょう。 (※ OGP は https://www.pakutaso.com/photo/75600.html です。型、バリデータ、API Spec 三銃士感があって選びました) API 仕様書はどうあるべきか まず、フロントエンドエ

                                                  API仕様書をバリデーターと型と同期させて作る
                                                • 新卒ばかりのチームがいきなりインディーゲームを作ると何が起こるのか!? ⇒「仕様書が足りない」「コンセプトがブレる」と前途多難に。“落とし穴”にハマった事例から学ぶ「縛りだらけのインディーゲーム開発」第2回

                                                  世は大インディーゲーム時代。 SteamやSwitch、それともPS5、XBOXなどに溢れんばかりにリリースされるインディーゲームに注目しているゲーマーは多いことだろう。そんなインディーゲームについて「職人的な個人、少人数の有志が個性的なゲームを作る、自由なゲーム」というイメージを抱いているのではないだろうか。 それは一面の真実だが、これは別の真実……表に出づらいインディゲームの世界をテーマとした連載である。 本連載で語られるのは、SEモバイル・アンド・オンライン株式会社(SEM&O社)の事例。同社はゲーム開発支援(SES)業務・受託開発、そしていくつかの運営、ダウンロードゲームを手がけているが、2023年に新卒中心のチームで新規にSteam向け自社ゲーム開発を行っていた。 ところが、企業がインディーゲーム開発に乗り出そうとすると個人・少数集団の開発とは異なる問題に直面する。ゲーム開発チー

                                                    新卒ばかりのチームがいきなりインディーゲームを作ると何が起こるのか!? ⇒「仕様書が足りない」「コンセプトがブレる」と前途多難に。“落とし穴”にハマった事例から学ぶ「縛りだらけのインディーゲーム開発」第2回
                                                  • 「ソフトウェア設計仕様書(SDD)」の作成方法、仕様書に含めるべき内容とは

                                                    「ソフトウェア設計仕様書(SDD)」の作成方法、仕様書に含めるべき内容とは:優れたソフトウェア設計仕様書を作成するためのヒント ソフトウェアの設計書は、DevOpsの時代になっても、ソフトウェア開発ライフサイクル(SDLC)の重要な構成要素として位置付けられることは変わらない。ソフトウェア設計書が重要な理由、作成方法を整理する。 ソフトウェアの設計仕様書は、DevOpsの時代になっても、ソフトウェア開発ライフサイクル(SDLC)の重要な構成要素として位置付けられることは変わらない。ソフトウェアプロジェクトに着手する前に、開発チームはソフトウェアの設計仕様を考える必要がある。 ソフトウェア設計仕様書(SDD:Software Design Document)は、プロジェクトのロードマップとしての役割を果たし、プロジェクトの達成目標や目標への到達方法をチームが総合的に判断するのに役立つ。 設計

                                                      「ソフトウェア設計仕様書(SDD)」の作成方法、仕様書に含めるべき内容とは
                                                    • プログラマーがクソみたいなコードを書いてしまうポスター、見つかる→21歳吸えなくて草。仕様書は正確に作りましょう

                                                      のぶᴺᵒᵇᵘ @nobunobuxxxx @woody_1227 19歳以下や21歳以上は吸えないという意味じゃない。 もし年齢が下がる可能性があるなら20歳以上じゃないと吸えないとなるけど、20歳以降は上り坂しかないから20歳じゃないとでOK! 2023-06-24 14:41:31

                                                        プログラマーがクソみたいなコードを書いてしまうポスター、見つかる→21歳吸えなくて草。仕様書は正確に作りましょう
                                                      • 仕様書を浸透させるために仕様書のあれこれを決めた - パルカワ2

                                                        仕様書を浸透させるために何が必要か? 品質の作り込みをしていきたい・仕様を把握するコストが高いので仕様書を書くことを会社全体で浸透させたいと思っていて、そのために書く・読むの負担軽減が重要だと考えて以下をやることにした。 仕様書の項目を減らす 仕様書フォーマットの統一 仕様書の命名規則を決める 統一されたフォーマットに沿ったテンプレートの作成 管理方法の明示化・単純化 仕様書作成・更新・廃止プロセスの明示化 仕様書の具体例の作成 仕様書を書くときに迷いそうなときに参照するガイドの作成または作成の依頼 実は一回シンプルなフォーマットを決めたのだが、自分の進め方が悪くそれが全く浸透しなかった。その反省を踏まえて上記を考えた。 仕様書の話は、このあたりの話に関係する。 仕様書は必要か? - パルカワ2 チームが品質を作り込むために必要なこととは - パルカワ2 ちなみに仕様書は、Notionで記

                                                          仕様書を浸透させるために仕様書のあれこれを決めた - パルカワ2
                                                        • 外部仕様書の確認を Slack ワークフローに組み込むことで、 Devin くんにサポートしてもらってみた - KAKEHASHI Tech Blog

                                                          カケハシの AI 在庫管理でソフトウェアエンジニアをしている鳥海 (@toripeeeeee) です。こちらの記事は 生成AI研究会 での取り組み記事になります。 カケハシでは、エンジニア個々のコーディング支援に留まらず、AI技術を活用して開発プロセス全体の生産性と品質を向上させることを組織的な目標としています。そこで今回は、こちらの記事で紹介した Slack のワークフローに Devin を用いて開発プロセスにAIを載せることで、リリース前の外部仕様書のチェックをAIにサポートしてもらう取り組みにトライしましたので、ご紹介したいと思います。 なぜ外部仕様書のレビューが重要なのか そもそも外部仕様書って何? ここで「外部仕様書」と呼んでいるのは、開発するシステムが外部からどのように見えるか、どのように動作するかを定義し、まとめています。具体的には、以下のような情報が含まれています。 機能の

                                                            外部仕様書の確認を Slack ワークフローに組み込むことで、 Devin くんにサポートしてもらってみた - KAKEHASHI Tech Blog
                                                          • RISC-Vのハイパーバイザー拡張の仕様書を(ほぼ)日本語化したので公開する - FPGA開発日記

                                                            RISC-Vのハイパーバイザー拡張の仕様がかなり固まってきた。現在は0.6.1が公開されている。 Hypervisor Extension, Version 0.6.1 github.com とりあえず、上記の資料を読みながらちまちまと日本語化してみた。これは別に営利目的などではなく、完全に自分の趣味で理解のために翻訳してみたかったところがある。しかし翻訳しながら「なんじゃこりゃ?」な部分はとりあえず飛ばして先に進んだりしたので、すべて理解をしているかというとそれは違う。また復習しないと。 とりあえずSpikeの実装とKVMのRISC-V移植版を勉強しながら、実際の実装を学んでいくようにしていきたい。 RISC-V ハイパーバイザー拡張 日本語版 msyksphinz-self.github.io とりえあず、Google翻訳には頼らず、99%は自力で翻訳したが、おかげてTypoやら、誤訳

                                                              RISC-Vのハイパーバイザー拡張の仕様書を(ほぼ)日本語化したので公開する - FPGA開発日記
                                                            • colaboの夜間見回りと仕様書について再検証|opp

                                                              暇空氏のcolaboのアウトリーチ活動が仕様書にある週1回を満たしていないとの指摘に対してcolabo弁護団は「常設の相談室」との合せ技で満足すると反論している。 red氏のツイートも踏まえ、弁護団の説明が成立しているか検証してみる。 Ⅰ暇空氏の指摘と弁護団の反論(1)「夜間見周り等」の仕様夜間見回り等の仕様書の規定は以下のとおりであり、「深夜の繁華街巡視を週1回」又は「常設相談所での相談を週1回」となっている。 令和3年度事業 仕様書(2)バスカフェ実施回数と双方の主張 各年度の最後にcolaboが提出した実施状況報告書に記載の「夜間見回り等」の事業実績は以下のとおりであり、週1に対して6割程度の実施率となっている。そして、夜間見回り等としてバスカフェ以外の報告はない。 なお、平成30年度は事業が半年間である 実施状況報告書のアウトリーチ事業実績暇空氏の指摘は、週1回(52回/年)を原則

                                                                colaboの夜間見回りと仕様書について再検証|opp
                                                              • デジタル庁、「デジタル認証アプリ」を6月末リリース、マイナンバーカードで本人確認/行政・民間がAPIで本人確認機能をアプリに組み込むことも、技術仕様書が先行公開

                                                                  デジタル庁、「デジタル認証アプリ」を6月末リリース、マイナンバーカードで本人確認/行政・民間がAPIで本人確認機能をアプリに組み込むことも、技術仕様書が先行公開
                                                                • Bluetooth、LE Audio新コーデック「LC3」仕様書公開。対応製品'21年以降

                                                                    Bluetooth、LE Audio新コーデック「LC3」仕様書公開。対応製品'21年以降
                                                                  • 【大原雄介の半導体業界こぼれ話】 仕様書からIntel今後のコアをちょっと想像する

                                                                      【大原雄介の半導体業界こぼれ話】 仕様書からIntel今後のコアをちょっと想像する
                                                                    • 3GPP仕様書リーディングガイド(5GS編)

                                                                      はじめに モバイル通信技術の標準化団体である3GPPでは標準化の結果を仕様書という形で公開しています。この3GPP仕様書を読み解くのは最初は非常に大変です。仕様書の数が多く、略語が多く、参照が複雑に絡み合ってどこから手を付けたらよいのかわからなくなります。 この記事では、3GPP初心者の方が仕様書の番号を理解し、興味のある仕様書をどう見つけらた良いのか、5GSを例に紹介したいと思います。 3GPP仕様書の仕組みを理解する 仕様書はどこで作られるのか? 3GPPが扱う技術は多岐にわたります。 3GPPではRAN(Radio Access Network)、SA(Service & Sytstem Aspect)、CT(Core Network & Terminals)という3つのTSG(Technical Specification Groups)を設置しています。さらにそれぞれのTSGの中

                                                                        3GPP仕様書リーディングガイド(5GS編)
                                                                      • ゲーム開発で仕様書作成の能力に差が出る原因|panke

                                                                        【この記事の対象者】 ゲーム開発者 ゲーム開発に興味がある人 【この記事で学べること】 悪い仕様書がなぜ生まれるのか はじめにゲームプランナーの求人に応募する際、ゲーム会社によっては、企画書の提出を求められます。 企画書は、主にクライアントや会社の上層部に対して提出・プレゼンし、プロジェクトをスタートさせるために必要となる資料です。また、ゲーム全体のビジョンをプロジェクト参加者のメンバーに共有する目的としても使用されます。そのため、企画書はゲーム開発で最も重要な資料です。 では、企画書作成の能力があれば、プランナーに向いているかと言われると、全然そんなことはありません。 なぜなら、新規開発の現場で働く作業者は、企画書を作成する機会よりも、仕様書を作成する機会の方が圧倒的に多いからです。そのため、現場では企画書作成の能力よりも、仕様書作成の能力が求められます。 今日は「ゲーム制作工程のはなし

                                                                          ゲーム開発で仕様書作成の能力に差が出る原因|panke
                                                                        • 仕様書通りにシステムを作りました。使えなくても知りません

                                                                          仕様書通りにシステムを作りました。使えなくても知りません:「訴えてやる!」の前に読む IT訴訟 徹底解説(113)(1/3 ページ) ユーザー企業が作った仕様書に抜け漏れがあり、その通りに作ったシステムが使いものにならなかった。悪いのは、ベンダー、ユーザー企業、どちらなのか? 連載目次 IT訴訟を例に取り、トラブルの予防策と対処法を解説する本連載。今回取り上げるのは、要件の不備についての裁判例である。ユーザーが示した要件に抜け漏れや誤りがあり、これに沿って構築したシステムはユーザーが本来望んだ動作をしなかったというものだ。 ユーザーはこれを債務不履行であると訴えるが、ベンダーは「言われた通りに作っただけで、こちらには責任はない」と反論した。 この手の紛争について、裁判所の立場はおおむね一貫しているように思われ、似たような判断が各地で示されている。今回取り上げる判決はこうした考え方の大本とな

                                                                            仕様書通りにシステムを作りました。使えなくても知りません
                                                                          • FastAPI で独自に定義した API エラーも仕様書に自動反映したかった話 - JX通信社エンジニアブログ

                                                                            こんにちは、サーバーサイドエンジニアの @kimihiro_n です。 最近は FastAPI という Python の Web フレームワークが社内で密かなブームとなっています。 今回はその FastAPI を使ったエラー定義まわりの話をしたいと思います。 FastAPI とは FastAPI の概要については先日ちょうど社内勉強会用に資料を作ったのでこちらを見てもらえるのが早いです。 ざっくり言えばシンプルなインターフェースとドキュメント(OpenAPI)の自動生成が強力なフレームワークになります。 OpenAPI でドキュメント管理 今回注目したいのはドキュメントの自動生成のほうです。 開発チームでもドキュメントとAPIの実際の仕様が一致しない問題が時々発生していて、どうドキュメントを管理していくかが課題となっています。 KPTで振り返った結果、「人がドキュメントを書くからメンテが大

                                                                              FastAPI で独自に定義した API エラーも仕様書に自動反映したかった話 - JX通信社エンジニアブログ
                                                                            • 謎水騒ぎを仕様書と契約の観点から解説【自衛隊】

                                                                              『陸自練馬駐屯地がニセ科学に騙されかけたと聞いて!』 \PR!/ 陸自練馬駐屯地にて、謎水なるニセ科学製品の入札公示と急きょ公示取消しがあったようです。 ニセ科学はともかく、役務調達要求仕様書と契約制度の問題が結構あるなあ・・・ 図1 謎水? 引用URL:https://www.irasutoya.com/2019/03/blog-post_927.html 似たようなものは私の現職時代も結構持ち込まれたりしています。 まあ大抵指揮官クラスが、トップダウンで持ち込むんですよね~! (前回記事):『KN-23がウクライナで使われるとは!【世界情勢】』 \こちらもご参考に!PR/ 2024年1月22日に、有志の手で練馬駐屯地の地方調達にて謎水の入札公告が発見されました。 図2 Twitter 引用URL:https://twitter.com/konamih/status/1749341032

                                                                                謎水騒ぎを仕様書と契約の観点から解説【自衛隊】
                                                                              • イチから全部作ってみよう(9)ジャンケンで理解する要求仕様書作成の難しさ

                                                                                イチから全部作ってみよう(9)ジャンケンで理解する要求仕様書作成の難しさ:山浦恒央の“くみこみ”な話(178)(1/3 ページ) ECサイトを題材にソフトウェア開発の全工程を学ぶ新シリーズ「イチから全部作ってみよう」がスタート。シリーズ第9回は、「ヒアリング」した内容をまとめる「要求仕様書作成」について、情報工学専攻の大学3年生でも悩む「ジャンケンの要求仕様書」を例にその難しさを解説します。

                                                                                  イチから全部作ってみよう(9)ジャンケンで理解する要求仕様書作成の難しさ
                                                                                • Nostr NIPs プロトコル仕様書斜め読み - Qiita

                                                                                  はじめに Nostrのプロトコル読もうと思った人のための補助になればと思います。 間違い等あったら編集リクエストください。 なお、発展途上のプロトコルのため、未実装やドラフトが目立ちます。 実際にデータを受信してみると謎のデータが付加されていたりします。 このあたりについては、IssueやPRを読むと謎が解決することが多いです。 関連 非常に有用な解説記事 いじって見たい人はまずnostr-toolsを触ることをお勧めします。ハマらずに済みます。 Nostr Nostrの特徴と目的 TwitterやActivityPub, Scuttlebutt(P2P)との比較と優位性 どのように既存の問題を解決するかと動作の概略 発生しうる問題とそれに対する優位性 FAQ NIPへのリンク があります。 最初に読むべき文章であり、だいたい懸念される事柄については考察済みであることがわかります。 一方で

                                                                                    Nostr NIPs プロトコル仕様書斜め読み - Qiita

                                                                                  新着記事