setup-speckit

Spec-Kit のセットアップ

Spec-Kit を対象リポジトリにインストールし、仕様駆動開発（SDD）の全パイプライン（specify → clarify → plan → tasks → implement → analyze → checklist → constitution）を利用できるようにします。

使用する場面

• speckit ワークフロー用の新しいリポジトリを立ち上げる場合
• 既存のプロジェクトに SDD を導入する場合

ソースフォーク

フォーク	リポジトリ	備考
fellowship-dev（デフォルト）	fellowship-dev/spec-kit	軽量で、トークン使用量が少なく、意見の強いデフォルト設定
upstream	github/spec-kit	オリジナル版で、より冗長かつトークンコストが高い

デフォルトでは fellowship-dev フォークを使用してください。ユーザーが upstream 版を明示的に希望する場合は、テンプレートとプロンプトが長いため、呼び出しごとのトークン使用量が大幅に増えることを警告してください。

前提条件

• 対象リポジトリで Git が利用可能であること
• 対象リポジトリに .claude/ ディレクトリがあること（ない場合は、先に setup-harness を実行してください）

インストールされるもの

target-repo/
├── .specify/
│   ├── scripts/bash/          # create-new-feature.sh, setup-plan.sh, common.sh, etc.
│   ├── templates/             # spec, plan, tasks, checklist, constitution templates
│   └── memory/
│       └── constitution.md    # Project principles (customized or default)
├── .claude/commands/
│   ├── speckit.specify.md     # /speckit.specify <issue-number>
│   ├── speckit.plan.md        # /speckit.plan
│   ├── speckit.tasks.md       # /speckit.tasks
│   ├── speckit.implement.md   # /speckit.implement
│   ├── speckit.clarify.md     # /speckit.clarify
│   ├── speckit.checklist.md   # /speckit.checklist
│   ├── speckit.analyze.md     # /speckit.analyze
│   └── speckit.constitution.md
└── specs/                     # Created per-feature by /speckit.specify

インストール手順

1. Spec-Kit を一時ディレクトリにクローンする

# Default: fellowship-dev fork (leaner, recommended)
SPECKIT_SRC=$(mktemp -d)
git clone --depth 1 https://github.com/fellowship-dev/spec-kit.git "$SPECKIT_SRC"

# Alternative: upstream (more verbose, higher token cost)
# git clone --depth 1 https://github.com/github/spec-kit.git "$SPECKIT_SRC"

2. 対象ディレクトリを作成する

mkdir -p .specify/scripts/bash .specify/templates .specify/memory
mkdir -p .claude/commands
mkdir -p specs

3. スクリプトをコピーする

cp "$SPECKIT_SRC"/scripts/bash/*.sh .specify/scripts/bash/
chmod +x .specify/scripts/bash/*.sh

4. テンプレートをコピーする

cp "$SPECKIT_SRC"/templates/spec-template.md .specify/templates/
cp "$SPECKIT_SRC"/templates/plan-template.md .specify/templates/
cp "$SPECKIT_SRC"/templates/tasks-template.md .specify/templates/
cp "$SPECKIT_SRC"/templates/checklist-template.md .specify/templates/
cp "$SPECKIT_SRC"/templates/constitution-template.md .specify/templates/

5. Claude Code のスラッシュコマンドをコピーする

cp "$SPECKIT_SRC"/templates/commands/specify.md .claude/commands/speckit.specify.md
cp "$SPECKIT_SRC"/templates/commands/plan.md .claude/commands/speckit.plan.md
cp "$SPECKIT_SRC"/templates/commands/tasks.md .claude/commands/speckit.tasks.md
cp "$SPECKIT_SRC"/templates/commands/implement.md .claude/commands/speckit.implement.md
cp "$SPECKIT_SRC"/templates/commands/clarify.md .claude/commands/speckit.clarify.md
cp "$SPECKIT_SRC"/templates/commands/checklist.md .claude/commands/speckit.checklist.md
cp "$SPECKIT_SRC"/templates/commands/analyze.md .claude/commands/speckit.analyze.md
cp "$SPECKIT_SRC"/templates/commands/constitution.md .claude/commands/speckit.constitution.md

6. 憲章を初期化する

プロジェクトにまだ憲章がない場合：

cp .specify/templates/constitution-template.md .specify/memory/constitution.md

今すぐカスタマイズするか、デフォルトを使うかをユーザーに確認してください。主な決定事項：

• テストファーストにするか、テスト後にするか
• ライブラリファーストの方針
• 機能ごとの複雑さの上限
• フレームワーク固有の原則

7. クリーンアップする

rm -rf "$SPECKIT_SRC"

8. 必要な GitHub ラベルが存在することを確認する

REPO=$(gh repo view --json nameWithOwner -q '.nameWithOwner')

gh label create "in-progress" --repo "$REPO" --color "97f157" --description "Issue is actively being worked on" 2>/dev/null || true
gh label create "ready-to-work" --repo "$REPO" --color "f6a80a" --description "PRD complete, ready for implementation" 2>/dev/null || true

9. インストールを検証する

ls .specify/scripts/bash/*.sh      # Scripts present and executable
ls .specify/templates/*.md         # Templates present
ls .claude/commands/speckit.*.md   # Slash commands present
cat .specify/memory/constitution.md # Constitution initialized
gh label list --repo "$REPO" | grep -E "in-progress|ready-to-work"

インストール後

• /speckit.constitution を実行して、このプロジェクトの原則をカスタマイズします
• これでリポジトリで /speckit.specify <issue-number> ワークフローを利用できるようになります

SDD の理念（簡潔版）

• 仕様は50行以下、箇条書きのみ
• 計画は50行以下、意思決定は表形式
• タスクは40行以下、チェックボックスを使い、説明文は書かない
• 憲章で原則（テストファースト、ライブラリファースト、シンプルさ）を徹底する
• ブランチ名：<issue-number>-<short-name>