Spec Coding MCP

🚀 Spec Coding MCP Server

システマティックな「仕様駆動開発」により、機能アイデアを本番環境で使用可能なコードに変換します。

仕様駆動開発とは？

仕様駆動開発とは、簡単に言えば、明確で詳細な仕様書がソフトウェア開発の全プロセスを通じて核心的な駆動力となる開発手法です。これらの仕様書は、ソフトウェアシステムの機能要件、パフォーマンス指標、インターフェース定義、データ形式など様々な側面を網羅し、建設現場の設計図のように、最終的なソフトウェアの姿を開発者に明確に示します。

仕様駆動開発の核心は、曖昧な要件を標準化された仕様書を通じて実行可能で追跡可能かつ検証可能な開発プロセスに変換することです。本質的には、従来のソフトウェアエンジニアリングの厳密性をAIプログラミングに取り入れ、開発を「勘に頼ったコーディング」から管理可能なエンジニアリングプロセスに変えます。

仕様駆動開発の鍵は「Specフォルダ」です。各機能モジュールには、要件、設計、タスクを「具体化」する3つの核心ファイルが含まれるSpecフォルダが対応しています。

• 1.requirements.md (要件文書) — EARS構文 (Easy Approach to Requirements Syntax) を使用してユーザーストーリーと受け入れ基準を記述し、曖昧な表現を避けます。
• 2.design.md (技術的解決策) — アーキテクチャ設計、プロセスロジック、技術選択、潜在的なリスクなどの詳細を含みます。
• 3.tasks.md (タスクリスト) — 技術的解決策を実行可能な具体的なタスク (todolist) に分解します。

spec-coding-mcpを使った仕様駆動開発の実装

spec-coding-mcp のMCPはModel Context Protocolの略で、外部ツールとAI IDEをつなぐ重要な架け橋です。あなたのAI IDEがMCPを使用できる限り、spec-coding-mcp を使用できます。

ここでは、GitHub Copilot を例にとり、spec-coding-mcp の使い方を紹介します。

1. Vs Codeの設定

GitHub CopilotをSpec-Coding-MCPと連携させるには、まず関連する設定ファイルにMCPサーバー情報を設定する必要があります。

NuGet.org にアクセスし、SpecCodingMcpServer を検索すると、「MCP Server」タブが表示されます。

Vs Codeワークスペースに .vscode/mcp.json ファイルを追加し、「MCP Server」タブのjsonをコピーして貼り付け、保存します。その後、上の start をクリックします。

SpecCodingMcpServer は .NET 10 で実行する必要があります。ローカルに.NET 10がインストールされていることを確認してください (https://dotnet.microsoft.com/en-us/download/dotnet/10.0)

2. 仕様駆動開発プロセスの開始

• 1.機能定義：GitHub Copilotに「Start spec coding」という指示を出し、次に具体的な機能を指定します。例えば「Create a Vue to-do app」と指定し、関連する詳細を追加し、確認後に次のステップに進みます。

• 2.要件収集：Copilotは要件収集フェーズを開始し、EARS形式の要件文書を生成し、要件が正しいことを確認した後に設計フェーズに進みます。

• 3.設計文書：確認された要件に基づいて、Copilotは包括的な技術アーキテクチャ設計文書を生成します。設計が許容できることを確認した後、タスク計画に進みます。

• 4.タスク計画：Copilotは設計と要件を実行可能なタスクのリストに分解し、最終的にrequirements.md、design.md、tasks.mdを含む完全なSpecフォルダ構造を生成します。

• 5.タスク実行：タスク計画を確認した後、具体的な実行フェーズに入ります。Copilotはタスクを順次実行し、開発が完了するまで続けます。