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>