新型Acsimで設計成果物を技術仕様、Epic、Issueに変換し、GitHubやAI開発ツールへ連携する流れを説明します

開発連携ガイド

新型Acsimでは、要求や設計書を開発タスクへつなげるために、技術仕様書、Epic、Issueを作成できます。

要件定義で整理した情報を開発チームへ引き継ぐだけでなく、GitHub IssueやDevinなどのAI開発ツールと連携し、実装時のコンテキストとして活用できます。

開発連携でできること

開発連携の前に、要求、業務フロー、設計書の対応関係を確認します。

少なくとも以下が整理されていると、後続の技術仕様やIssueの品質が上がります。

技術仕様書作成エージェントを使い、開発チームが実装に着手できる粒度の仕様へ変換します。

依頼例:

登録済みの要求一覧、画面設計書、API設計書をもとに、受注登録機能の技術仕様書を作成してください。
対象画面、API、DB更新、バリデーション、権限、エラー処理、監査ログの観点を含めてください。

技術仕様書では、業務要件をそのまま繰り返すのではなく、実装で判断が必要になる項目を明確にします。

Epic作成エージェントを使い、要求や技術仕様を開発上の大きなまとまりに整理します。

Epicには、目的、対象範囲、関連要求、完了条件、主要なIssue候補を含めると、開発チームが全体像を把握しやすくなります。

Issue作成エージェントを使い、Epicを担当者が作業できる粒度に分解します。

Issueには、以下の情報を含めることを推奨します。

AIが作成したIssueは、開発チームがレビューし、実際のリポジトリや開発プロセスに合わせて調整します。

作成したIssueは、GitHub Issueとして開発リポジトリへ連携できます。

また、DevinなどのAI開発ツールを利用する場合は、Issue、技術仕様書、関連する設計書を作業コンテキストとして渡すことで、実装時の前提共有を減らせます。

Acsim CLI / MCP を使うことで、外部の開発リポジトリからAcsim上のEpic、Issue、設計書を取得できます。

AIコーディングツールを利用する場合、Acsim上の情報を参照させることで、開発者が手作業で仕様を転記する負担を減らせます。