インストールとセットアップ

前提条件

Spec-Craftをインストールする前に、以下が準備されていることを確認してください：

Python: バージョン 3.10 以上。
Node.js: CAD (JSCAD) ビルドに必要。
Emacs: バージョン 29.1 以上（AI による分離編集環境として推奨）。
uv: 高速なパッケージ管理のために強く推奨されます。

インストール

Spec-Craftをインストールする最も簡単な方法は uv を使うことです：

uv を使う場合 (推奨)

uv tool install spec-craft

pipx を使う場合

pipx install spec-craft

ソースからインストールする場合 (開発用)

git clone https://github.com/akuroiwa/spec-craft.git
cd spec-craft
uv sync

AIエージェントの設定

Spec-CraftはMCP（Model Context Protocol）サーバーを提供します。設定は使用するAIエージェントによって異なります：

Gemini CLI

.gemini/settings.json に設定を追加します。

{
  "mcpServers": {
    "spec-craft": {
      "command": "uv",
      "args": ["run", "spec-craft", "serve"]
    }
  }
}

Claude Desktop

claude_desktop_config.json に設定を追加します。

{
  "mcpServers": {
    "spec-craft": {
      "command": "uv",
      "args": ["--directory", "/path/to/spec-craft", "run", "spec-craft", "serve"]
    }
  }
}

Antigravity CLI

プロジェクト固有の設定を行うには、ワークスペース内の .antigravitycli/mcp_config.json に以下を追加します：

{
  "mcpServers": {
    "spec-craft": {
      "command": "uv",
      "args": ["run", "spec-craft", "serve"]
    }
  }
}

ローカル設定ファイルがGit管理されないよう、.antigravitycli/ が .gitignore に追加されていることを確認してください。

すべてのワークスペースで共通のグローバル設定とする場合は、~/.gemini/antigravity-cli/mcp_config.json に設定を配置できます。

注釈

spec-kit には、Antigravity CLI 専用の --integration agy（または古いバージョンでは --ai agy）が用意されています。これは .agents/skills/ ディレクトリに直接、必要なスキルファイルを生成します。また、Antigravity は .agents/skills/ をエージェントスキルとしてネイティブにロードするため、--integration claude または --integration codex を指定してインストールすることでも動作します。

Aider

重要

spec-kit は Aider をネイティブサポートしていません（--integration aider は存在しません）。また、Aider はエージェントスキル（.agents/skills/）もネイティブにはサポートしていません。しかし、Spec-Kit の根本的な統合思想は、本質的に「仕様駆動開発（SDD）のワークフローを、アクティブなエージェントが解釈可能な形式にマッピングする」という単純なものです。

Aider はターミナル中心で Git と親和性の高いコマンドラインツールであり、差分編集やトークン消費量を抑えたローカル開発を得意としています。以下の3つの方法のいずれかを利用することで、完全な SDD 準拠を達成できます。

1. Direct Markdown Loading (Recommended)

Aiderの起動時に --read オプションを指定するか、Aiderチャット内で /read コマンドを実行して、アクティブなスキルや規約を直接読み込ませることができます：

aider --read AGENTS.md --read .agents/skills/speckit-plan/SKILL.md

これは、Aider が任意の Markdown ファイルをコンテキストに読み込めるためです。他の統合（Claude や Codex など）向けに spec-kit が生成した .agents/skills/speckit-*/SKILL.md ファイルには、Aider が解釈可能な SDD ワークフローの完全な指示が含まれています。

2. spec-kit-mcp Integration (MCP Option)

プロジェクト固有の .aider.conf.yml またはグローバルの ~/.aider.conf.yml に spec-kit-mcp を追加することで、AiderをMCPクライアントとして構成できます：

mcp-servers:
  - name: spec-kit
    command: uvx
    args:
      - --from
      - git+https://github.com/lsendel/spec-kit-mcp
      - spec-kit-mcp

3. Automatic Convention Loading

Aiderが常にSDDの指示にアクセスできるよう、.aider.conf.yml に規約ファイルを登録します：

read:
  - AGENTS.md
  - .specify/constitution.md

Spec-Kit のインストール

Spec-Kit は、仕様駆動開発の戦術レイヤー（Specify → Plan → Implement）を提供します。AI エージェント用に SDD コマンドの土台を生成するためにインストールしてください。

クイックスタート

# Install from a specific stable release (recommended)
uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <PROJECT_NAME>

# Or install latest from main
uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME>

サポートされている統合

Spec-Kit は、--integration フラグを介して多くの AI エージェントをサポートしています：

# Antigravity CLI (generates .agents/skills/)
specify init . --integration agy

# Claude Code (generates .claude/commands/ and .agents/skills/)
specify init . --integration claude

# Gemini CLI (generates .gemini/commands/)
specify init . --integration gemini

# GitHub Copilot (generates .github/prompts/)
specify init . --integration copilot

# Codex (generates .agents/skills/)
specify init . --integration codex

# Generic (bring your own agent)
specify init . --integration generic --integration-options="--commands-dir .myagent/commands/"

注釈

Antigravity CLI ユーザーの場合: --integration agy（推奨）を使用するか、--integration claude / --integration codex にフォールバックします。これらはすべて、Antigravity がエージェントスキルとしてネイティブにロードする .agents/skills/ を生成します。

Aider ユーザーの場合: Spec-Kit はネイティブの --integration aider を持っていません。代わりに、サポートされている任意の統合（--integration claude または --integration agy など）でインストールし、上記の Aider セクションで説明されている 3 つの方法のいずれかを使用して、生成されたスキルファイルをロードしてください。