快速参考卡片

把全书浓缩成一页。忘了某个理念"是干嘛的、什么时候用"，回这里扫一眼。

一、六大范式速查

范式	全称	层次	一句话	详情
Vibe Coding	氛围编程	探索层	凭感觉对话式快速做出东西	→
TDD	Test-Driven Development	验证层	先写测试，用测试约束 AI 行为	→
SDD	Spec-Driven Development	规格层	先写规格，再让代码围绕意图生长	→
Claude Team / superpowers	协作 / 工作流	执行·协作层	把 AI 纳入团队、把流程固化成 workflow	→
Context Engineering	上下文工程	上下文层	给 AI 更相关、而非更多的信息	→
Harness Engineering	执行工装工程	环境层	搭可运行/验证/修复的闭环执行环境	→

二、补位链（一图记住谁补谁）

Vibe 太快 → SDD 讲清意图
SDD 太抽象 → OpenSpec/Spec Kit 落地入库
规格不够 → TDD 变成可执行约束
测试不够 → Claude Team/superpowers 协作推进
协作不够 → Context Engineering 保证拿对上下文
上下文不够 → Harness Engineering 搭完整闭环

三、常用命令速查

# 环境：PowerShell / 终端

# Spec Kit（需 Python + uv）
pip install uv
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
specify init my-app --ai claude
specify --help                       # 验证是否装好

# OpenSpec（需 Node.js >= 20）
npm install -g @fission-ai/openspec@latest
openspec init

# 版本自检
node -v                              # OpenSpec 需 >= 20

四、各框架核心命令 / 产物

框架	关键命令链	主要产物
Spec Kit	/speckit.constitution → .specify → .plan → .tasks → .implement → .analyze	spec.md / plan / tasks（含"宪法"强制测试）
OpenSpec	/openspec:proposal → review → apply → archive	proposal.md / design.md / tasks.md / spec delta
Kiro	自然语言对话 → /kiro:generate（自动触发 lint/test 钩子）	Requirements / Design / Tasks 三个 md

五、选型决策表

场景	推荐
一次性脚本 / 小改动	直接 Vibe Coding
企业级、多人协作、合规	Spec Kit
快速原型、小团队	Kiro
维护老项目、控风险	OpenSpec
原型 + 维护混合	Kiro + OpenSpec
长时自动化研发	全套 + Harness Engineering

六、三条铁律 & 一条安全红线

铁律：意图显式化 · 约束 > 指令 · 人负责验收
安全红线：给代理的自动执行 = 沙箱 + 命令白名单 + 隔离凭据 + 破坏性动作人工审批

展开见专题章：AI 编程安全清单 · 常见幻觉与陷阱

七、学习路径回顾

1. 建立心智模型：简介 → 范式全景图
2. 逐个吃透范式：Vibe → TDD → SDD → 协作与工作流 → 上下文工程 → 执行工装工程
3. 串起来用：组合落地实战 → 最佳实践与反模式 → 落地构件：AGENTS/Rules/Skills → 范式选型决策树 → 端到端 Walkthrough
4. 安全与质量：AI 编程安全清单 · 常见幻觉与陷阱
5. 工具与团队：AI 编码工具链选型 · 团队落地与治理
6. 兜底：排错与 FAQ · 术语表

八、延伸资源

• GitHub Spec Kit 官方博客（2025-09-02，介绍开源 spec-driven toolkit）
• GitHub 博客《How to build reliable AI workflows with agentic primitives and context engineering》（2025-10-13）
• OpenAI《Harness engineering: leveraging Codex in an agent-first world》（2026-02-11）
• Anthropic《How Anthropic teams use Claude Code》（2025-07-24）
• obra/superpowers（GitHub 仓库，agentic skills framework）
• Martin Fowler：Test Driven Development

📌 说明：本领域演进极快，各工具命令与能力以官方最新 README 为准。

九、回到起点

• 还没建立整体认知？先读 简介。
• 想直接把某范式用进项目？去 组合落地实战。