設計書・技術仕様書・テスト仕様書を作成する
Acsim Desktopの基本設計書・技術仕様書・テスト仕様書の画面で、AIに設計書や見積、テスト仕様の初版を作らせ、確認・編集・出力する方法を説明します。
Acsim Desktop では、要件定義書、画面・機能一覧、各種設計書、見積、テスト仕様書などを、AI に初版として作らせ、人が確認・編集して仕上げます。作った設計書は、サイドバーの「仕様設計」と「テスト」にある 3 つの画面に、種類ごとに保存されます。
| 画面 | 主な内容 |
|---|---|
| 基本設計書 | 業務要件定義書、非機能要件定義書、画面一覧、機能一覧、画面設計書、機能設計書、概算見積書など |
| 技術仕様書 | プロダクト定義書、技術方針書、プロジェクト構造設計書など、開発に渡す仕様 |
| テスト仕様書 | 結合テスト、システムテスト、受入テストのテスト設計とテストケース一覧 |
どの設計書をどのエージェントが作るかは、標準カタログのエージェント・設計書フォーマット一覧で確認できます。
設計書の一覧を開く
対象のプロジェクトを開き、サイドバーの「仕様設計」から「基本設計書」または「技術仕様書」を、「テスト」から「テスト仕様書」を選択します。
左のツリーでフォルダをたどり、右の一覧で設計書を選びます。
- 左のツリーで、フォルダの作成や移動ができます。
- 右の一覧では、種類、タイトル、形式、バージョン、最終更新日、最終更新者を確認できます。
- 一覧上部のボタンで、まとめてダウンロードしたり、手元のファイルを取り込んだりできます。
- 「基本設計書を追加」(技術仕様書・テスト仕様書の画面では、それぞれの名前)で、タイトルを入力して空の設計書を作れます。
AI に作ってもらう
AIポータルで目的に合うエージェントを選び、根拠にする成果物と作成する範囲を伝えます。
| 作りたいもの | 主なエージェント | 事前にあるとよい情報 |
|---|---|---|
| 業務要件定義書、非機能要件定義書、用語一覧 | 業務・非機能要件定義書 | 要求、AsIs/ToBe 業務フロー、プロジェクト方針 |
| 画面・機能・バッチ・通知・帳票の一覧 | 画面・機能一覧 | ToBe 業務フロー、要求 |
| システム基本設計書、DB・API・アーキテクチャ設計書 | 基盤・基本設計 | 画面・機能一覧、外部連携の要件、既存システムの情報 |
| 画面・機能・バッチ・通知・帳票の設計書 | 画面・機能設計 | 画面・機能一覧、業務ルール |
| インフラ・セキュリティ設計書 | インフラ・セキュリティ設計 | 非機能要件、利用環境、認証・権限の方針 |
| 運用・移行・障害対応などの設計書 | 運用移行設計 | 現行の運用、移行対象、体制、制約 |
| 概算見積書 | 見積作成 | 要求、設計書、実装範囲 |
| テスト設計とテストケース一覧 | 結合テスト、システムテスト、受入テスト | 要求、画面・機能設計、業務フロー、受入条件 |
| 技術仕様書 | 技術仕様書作成 | 要求、設計書、業務フロー |
エージェントの名前と並びは、プロジェクトのエージェント設定によって異なることがあります。AIポータルの右側に表示されるエージェント一覧で確認してください。
依頼例:
要求管理と ToBe業務フロー「受注から請求までのあるべき業務」をもとに、業務要件定義書と非機能要件定義書を作成してください。未確定の事項は「要確認」として残してください。
画面一覧と機能一覧をもとに、受注登録と承認の画面設計書を作成してください。既存の受注一覧の画面設計書は変更しないでください。
初回は、いきなり個別の詳細設計に入るより、次の順に進めると前提をそろえやすくなります。
- 業務・非機能要件定義書で、業務要件と非機能要件のたたき台を作る
- 画面・機能一覧で、対象の画面、機能、バッチ、通知、帳票を一覧にする
- 基盤・基本設計で、データ構造や外部連携の前提を整理する
- 画面・機能設計で、画面ごと・機能ごとの設計書を作る
- インフラ・セキュリティ設計と運用移行設計で、非機能・運用・移行の観点を補う
- 見積作成で、実装対象、前提条件、除外事項、リスク、概算工数を整理する
- 結合テスト、システムテスト、受入テストで、要求や設計書に対応するテストケースを作る
既存の設計書を変える依頼では、AI の結果は変更提案として表示されます。差分を確認してから適用してください(AIの変更提案を確認する)。
設計書を確認・編集する
一覧で設計書のタイトルを押すと、編集画面が開きます。見出し、箇条書き、表などを直接編集し、保存します。
編集画面の上部で、版、レビューの状況、履歴を確認できます。
- 画面上部に版と最終更新日時が表示されます。履歴のボタンから過去の版を確認できます。
- 「レビュー依頼」で関係者にレビューを依頼できます。レビュー中は画面上部に帯が表示されます(成果物をレビュー・承認する)。
- ダウンロードのボタンで、設計書を 1 件ずつ保存できます。Excel 形式の設計書の扱いはExcelと設計書の表を扱うを参照してください。
確認するときの観点
- 要求と設計書の対応関係を追えるか(要求の詳細画面の「関連設計書」で紐づけられます)
- 見積の対象とスコープ外がはっきりしているか
- 未確定の事項や顧客への確認事項が、設計書や見積の前提に残っているか
- テストケースが、要求や業務フローの重要な分岐を確認できるか
- AI が補った前提と、プロジェクトで合意済みの前提が混ざっていないか