Spec Workflow Mcp

Spec Workflow MCP

English | 简体中文

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

なぜ使うのか？

❌ Spec Workflow を使わない場合

• AI がタスク間を無秩序に移動し、体系的なアプローチを取れません
• 要件と実際のコード実装がつながりません
• ドキュメントが分散し、プロジェクトの進捗を追跡しにくくなります
• 設計上の決定事項が記録されません

✅ Spec Workflow を使う場合

• AI がタスクを順番に完了し、集中力とコンテキストを維持します
• ユーザーストーリーからコード実装まで、完全なトレーサビリティを確保できます
• 標準化されたドキュメントテンプレートと自動的な進捗管理を利用できます
• 各段階で確認を求めるため、正しい方向に進んでいることを確かめられます
• 進捗の永続化：新しい会話でも、check を使って中断したところから続けられます

最近の更新

v1.0.7

• 🎯 多くのモデルで、Spec Workflow を使ったタスク管理の信頼性を向上

v1.0.6

• ✨ タスクの一括完了：複数のタスクを一度に完了でき、大規模プロジェクトをより迅速に進められます

v1.0.5

• 🐛 エッジケースの修正：「タスクが見つからない」と「タスクがすでに完了している」を区別し、ワークフローが中断されないようにしました

v1.0.4

• ✅ タスク管理：プロジェクトを体系的に進められるよう、タスクの完了状況を追跡する機能を追加

v1.0.3

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

クイックスタート

1. インストール（Claude Code の例）

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 - User stories and functional requirements
🎨 design.md - Technical architecture and design decisions
✅ tasks.md - Concrete implementation task list

3. 確認しながら段階的に実装する

各段階の後、AI は次に進む前に確認を求め、プロジェクトが正しい方向に進むようにします。

ドキュメントの整理

基本構成

my-project/specs/
├── requirements.md              # Requirements: user stories, functional specs
├── design.md                    # Design: architecture, APIs, data models
├── tasks.md                     # Tasks: numbered implementation steps
└── .workflow-confirmations.json # Status: automatic progress tracking

複数モジュールのプロジェクト

my-project/specs/
├── user-authentication/         # Auth module
├── payment-system/             # Payment module
└── notification-service/       # Notification module

任意のディレクトリを指定できます："./src/features/auth に auth ドキュメントを作成するため、spec workflow を使ってください"

AI の使用ガイド

🤖 AI にこのツールをより効果的に使わせる

AI アシスタントの設定に、次のプロンプトを追加することを強くおすすめします。追加しない場合、AI は次のような動作をする可能性があります：

• ❌ Spec Workflow をいつ呼び出すべきか判断できない
• ❌ タスクの進捗管理を忘れ、作業が整理されない
• ❌ 体系的なドキュメント作成に Spec Workflow を活用できない
• ❌ プロジェクトの状態を継続的に追跡できない

この設定により、AI は Spec Workflow を適切に使って開発プロセス全体を管理できるようになります。

設定に関する注意：必要に応じて、次の内容を変更してください：

1. ./specs を任意のドキュメントディレクトリのパスに変更する
2. 「English」を任意のドキュメント言語（例：「Chinese」）に変更する

# Spec Workflow Usage Guidelines

## 1. Check Project Progress
When user mentions continuing previous project or is unsure about current progress, proactively use:
specs-workflow tool with action.type="check" and path="./specs"

## 2. Documentation Language
All spec workflow documents should be written in English consistently, including all content in requirements, design, and task documents.

## 3. Documentation Directory
All spec workflow documents should be placed in ./specs directory to maintain consistent project documentation organization.

## 4. Task Management
Always use the following to manage task progress:
specs-workflow tool with action.type="complete_task" and taskNumber="current task number"
Follow the workflow guidance to continue working until all tasks are completed.

## 5. Best Practices
- Proactive progress check: When user says "continue from last time", first use check to see current status
- Language consistency: Use the same language throughout all project documents
- Flexible structure: Choose single-module or multi-module organization based on project scale
- Task granularity: Each task should be completable within 1-2 hours

インストール

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 License