Claude Code 实战课

主题

3.10 大型项目框架 — 从零构建复杂系统的正确姿势 ​

学习目标 ​

学完这节课，你将能够：

  • 理解为什么大型项目不能直接让 AI "开干"
  • 掌握 GSD、Superpowers、Spec Kit 三个主流框架的核心差异
  • 根据项目特点选出最合适的框架

为什么大型项目需要框架 ​

小 demo 随便写写没问题。你跟 Claude Code 说"帮我做个 todo app"，几分钟就搞出来了。

但大型项目完全是另一回事。你让它写一个有用户系统、权限管理、数据看板的完整产品，大概率的结果是：前面写得不错，越往后越乱。命名不一致，架构忘了，改 A 功能把 B 搞坏了。

核心问题：AI 的上下文窗口有限。200k token 塞满后它就"失忆"了，前面定好的规范全忘光。

所以你需要一个"项目框架"——不是 React 那种代码框架，而是一套管理 AI 行为的工作流。它告诉 AI 怎么拆任务、每步做什么、怎么验证质量、怎么保持一致性。

框架一：GSD（Get Sh*t Done） ​

仓库：https://github.com/gsd-build/gsd-2

核心理念 ​

一句话概括：一个任务必须装进一个上下文窗口，装不下就拆成两个。

GSD 是独立的 CLI 工具，把工作组织成三层：里程碑（Milestone） → 切片（Slice） → 任务（Task）。每个切片自动走完 规划 → 执行 → 完成 → 重新评估 → 下一个切片 的完整循环。

安装 ​

bash
npm install -g gsd-pi@latest
gsd          # 启动后 /login 登录 LLM 提供商

两种模式：Step 模式一步一停让你检查；Auto 模式全自动跑完整个里程碑。

[截图: GSD Auto 模式运行界面，能看到自动拆分 Slice 和 Task 的过程]

亮点特性 ​

  • 每个任务用全新的上下文窗口，预注入相关文件，不会上下文污染
  • Git 隔离：每个里程碑独立 worktree，完成后 squash merge
  • 崩溃恢复：断了从断点继续；成本追踪：实时显示 token 费用
  • 卡住检测：发现 AI 绕圈子时自动切换策略

适合谁 ​

独立开发者、需求清晰的绿地项目、希望 AI 长时间自主工作的场景。/gsd auto 一开，喝杯咖啡回来代码就好了。

框架二：Superpowers ​

仓库：https://github.com/obra/superpowers

核心理念 ​

不是独立工具，而是一套可组合的技能模块，注入到你现有的 AI 工具里（Claude Code、Cursor、Copilot CLI、Gemini CLI 都支持）。

四个核心原则：测试驱动（没测试的代码直接删）、系统化优先、降低复杂度（YAGNI）、证据胜于声称。

安装 ​

通过各平台的插件市场安装即可。安装后技能根据任务场景自动激活。

[截图: 在 Claude Code 中安装 Superpowers 插件]

七阶段工作流 ​

  1. 头脑风暴——AI 先问清楚需求，设计方案需你确认
  2. Git Worktree 隔离——自动创建独立分支
  3. 规划——拆成 2-5 分钟的小任务，精确到文件路径
  4. 执行——每个任务派子智能体，执行后双重审查
  5. TDD——严格红-绿-重构，先写测试的代码才留下
  6. 代码审查——对照计划逐项审查，严重问题阻断进度
  7. 分支完成——跑全量测试，提供 merge/PR 选项

适合谁 ​

对代码质量有洁癖的团队、有 TDD 文化的项目、需要长期维护不能写完就扔的产品。也适合多平台用户——不绑定某个 AI 工具，换工具 Superpowers 跟着走。

框架三：Spec Kit（GitHub 官方出品） ​

仓库：https://github.com/github/spec-kit

核心理念 ​

规格驱动开发（Spec-Driven Development）——把规格说明书变成可执行的一等公民，每一行代码都能追溯到规格条目。先写清楚"要什么"和"为什么"，技术细节交给 AI。

安装 ​

bash
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z

安装后通过斜杠命令集成：/speckit.specify、/speckit.plan、/speckit.implement。

[截图: specify init 后生成的项目结构，能看到 specs/ 和 plans/ 目录]

六阶段流程 ​

宪法（定原则） → 规格（写需求） → 规划（定架构） → 任务（拆工作项） → 实现（写代码） → 审查（验收）

所有产物以 Markdown 存在项目里，有完整 git 历史。60+ 社区扩展支持 CI/CD 门禁、Jira 同步、安全审查等。

适合谁 ​

团队协作和企业级项目的首选。有产品经理写需求、开发者写代码、QA 做验证的标准流程，Spec Kit 能把全链路串起来。也是唯一能和 Jira、Linear、Azure DevOps 打通的框架。

对比表格 ​

维度GSDSuperpowersSpec Kit
出品方社区社区（Jesse Vincent）GitHub 官方
形态独立 CLI技能插件CLI + 斜杠命令
核心理念任务拆解 + 自主执行TDD + 技能组合规格驱动开发
项目规模中大型中大型大型 / 企业级
规范程度中（自动流程）高（严格 TDD）最高（全链路追溯）
灵活性高高中
学习成本低中中高
AI 自主程度最高（Auto 模式）中（需人工确认）中（规格需人工写）
多工具支持20+ LLM 提供商4 大平台GitHub 生态为主
扩展生态一般中等最丰富（60+）

选择建议 ​

选 GSD：独立开发者、需求清晰、想让 AI 自主跑、在意 token 成本。

选 Superpowers：代码质量洁癖、需要 TDD、用多个 AI 工具、项目长期维护。

选 Spec Kit：企业级项目、多人协作、需要全链路追溯、在 GitHub 生态里。

它们不互斥：GSD 管执行节奏，Superpowers 管代码质量，Spec Kit 管需求追溯。有团队混着用——Spec Kit 写规格，GSD 或 Superpowers 来执行。

小结 ​

大型项目不能直接让 AI "开干"，你需要框架规范它的行为：

  • GSD 像高效的项目经理——自动拆活、自动干活、自动复盘
  • Superpowers 像严格的技术 Lead——没测试不准提交、审查不过不准合并
  • Spec Kit 像企业级项目管理系统——从需求到代码全链路管控

从你最痛的问题出发：效率不够选 GSD，质量不达标选 Superpowers，多人协作乱选 Spec Kit。

用 Claude Code 构建，用 VitePress 驱动

© 2026 Claude Code 实战课