Specs Workflow MCP

🚀 Spec Workflow MCP

このツールは構造化された 要件 → 設計 → タスク のワークフローを通じて、AIにソフトウェア開発を体系的に完了させ、コード実装がビジネスニーズに沿ったものになるように支援します。

English | 简体中文

✨ 主な機能

❌ Spec Workflowを使用しない場合

• AIがタスク間をランダムにジャンプし、体系的なアプローチが欠ける
• 要件と実際のコード実装が切り離される
• ドキュメントが散在し、プロジェクトの進捗を追跡するのが困難
• 設計上の決定記録が欠如する

✅ Spec Workflowを使用する場合

• AIが順次タスクを完了し、焦点とコンテキストを維持する
• ユーザーストーリーからコード実装まで完全なトレーサビリティがある
• 標準化されたドキュメントテンプレートで自動的な進捗管理が可能
• 各段階で確認が必要で、正しい方向で進むことを保証する
• 永続的な進捗：check を使用して中断したところから再開でき、新しい会話でも同様

最近の更新

v1.0.6

• ✨ バッチタスク完了：一度に複数のタスクを完了し、大規模プロジェクトの進捗を高速化

v1.0.5

• 🐛 エッジケースの修正：「タスクが見つからない」と「タスクが既に完了している」を区別し、ワークフローの中断を防ぐ

v1.0.4

• ✅ タスク管理：タスクの完了追跡を追加し、体系的なプロジェクト進行を可能にする

v1.0.3

• 🎉 初期リリース：要件 → 設計 → タスクのコアワークフローフレームワーク

🚀 クイックスタート

1. インストール (Claudeコード例)

claude mcp add spec-workflow-mcp -s user -- npx -y spec-workflow-mcp@latest

他のクライアントの完全なインストールガイドは インストールガイド を参照してください。

2. 新しいプロジェクトを開始

"Help me use spec workflow to create a user authentication system"

3. 既存のプロジェクトを続ける

"Use spec workflow to check ./my-project"

AIは自動的にプロジェクトの状態を検出し、中断したところから再開します。

💻 使用例

1. 要件を説明する

You: "I need to build a user authentication system"

2. AIが構造化されたドキュメントを作成する

AI: "I'll help you create spec workflow for user authentication..."

📝 requirements.md - ユーザーストーリーと機能要件
🎨 design.md - 技術アーキテクチャと設計上の決定
✅ tasks.md - 具体的な実装タスクリスト

3. 段階的にレビューして実装する

各段階の後、AIは次に進む前にあなたの確認を求め、プロジェクトが正しい軌道を維持するようにします。

📚 ドキュメントの組織化

基本構造

my-project/specs/
├── requirements.md              # 要件: ユーザーストーリー、機能仕様
├── design.md                    # 設計: アーキテクチャ、API、データモデル
├── tasks.md                     # タスク: 番号付きの実装手順
└── .workflow-confirmations.json # 状態: 自動的な進捗追跡

マルチモジュールプロジェクト

my-project/specs/
├── user-authentication/         # 認証モジュール
├── payment-system/             # 支払いモジュール
└── notification-service/       # 通知モジュール

任意のディレクトリを指定できます："Use spec workflow to create auth docs in ./src/features/auth"

🤖 AIの使用ガイド

このツールをAIにより良く使わせる方法

AIアシスタントの設定に以下のプロンプトを追加することを 強くおすすめ します。追加しない場合、AIは以下の問題を引き起こす可能性があります。

• ❌ Spec Workflowをいつ呼び出すかわからない
• ❌ タスクの進捗管理を忘れ、作業が混乱する
• ❌ Spec Workflowを体系的なドキュメント作成に利用しない
• ❌ プロジェクトの状態を継続的に追跡できない

この設定を行うと、AIはスマートにSpec Workflowを使用して開発プロセス全体を管理します。

設定に関する注意：以下を必要に応じて変更してください。

1. ./specs を好みのドキュメントディレクトリパスに変更する
2. "English" を好みのドキュメント言語 (例: "Chinese") に変更する

# Spec Workflowの使用ガイド

## 1. プロジェクトの進捗を確認する
ユーザーが前のプロジェクトを続けることを言及したり、現在の進捗が不明な場合、積極的に以下を使用します。
specs-workflow tool with action.type="check" and path="./specs"

## 2. ドキュメントの言語
すべてのspec workflowドキュメントは一貫して英語で記述する必要があります。要件、設計、タスクドキュメントのすべての内容を含みます。

## 3. ドキュメントのディレクトリ
すべてのspec workflowドキュメントは ./specsディレクトリに配置し、一貫したプロジェクトドキュメントの組織化を維持します。

## 4. タスク管理
常に以下を使用してタスクの進捗を管理します。
specs-workflow tool with action.type="complete_task" and taskNumber="current task number"
ワークフローのガイダンスに従って作業を続け、すべてのタスクが完了するまで続けます。

## 5. ベストプラクティス
- 積極的な進捗確認: ユーザーが "continue from last time" と言った場合、まずcheckを使用して現在の状態を確認する
- 言語の一貫性: すべてのプロジェクトドキュメントで同じ言語を使用する
- 柔軟な構造: プロジェクトの規模に基づいて単一モジュールまたはマルチモジュールの組織化を選択する
- タスクの粒度: 各タスクは1 - 2時間で完了できるものにする

📦 インストール

claude mcp add spec-workflow-mcp -s user -- npx -y spec-workflow-mcp@latest

{
  "mcpServers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "spec-workflow-mcp@latest"]
    }
  }
}

{
  "mcpServers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "spec-workflow-mcp@latest"]
    }
  }
}

{
  "mcpServers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "spec-workflow-mcp@latest"],
      "env": {},
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "transportType": "stdio"
    }
  }
}

{
  "mcp.servers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "spec-workflow-mcp@latest"]
    }
  }
}

{
  "assistant": {
    "version": "2",
    "mcp": {
      "servers": {
        "spec-workflow": {
          "command": "npx",
          "args": ["-y", "spec-workflow-mcp@latest"]
        }
      }
    }
  }
}

git clone https://github.com/kingkongshot/specs-mcp.git
cd specs-mcp
npm install
npm run build

{
  "mcpServers": {
    "spec-workflow": {
      "command": "node",
      "args": ["/absolute/path/to/specs-mcp/dist/index.js"]
    }
  }
}

リンク

• GitHubリポジトリ
• NPMパッケージ
• 問題の報告

📄 ライセンス

MITライセンス