快速上手

通过一个完整的端到端示例，体验 Vibe Coding 的完整流程。

目标

为一个 Python Flask 应用添加健康检查接口 GET /health，返回 {"status": "ok", "version": "1.0.0"}。

第一步：写规格

在发出任何请求之前，先把问题固定下来：

目标：为 Flask 应用添加 GET /health 接口
范围：只修改 app.py，不改动其他文件
约束：返回格式固定为 JSON，HTTP 状态码 200
验证：运行 pytest tests/test_health.py

第二步：填任务简报

背景：
这是一个 Flask REST API 项目，入口文件是 app.py，
已有 /users 和 /products 两个路由，使用 Blueprint 组织。

目标：
添加 GET /health 接口，返回 {"status": "ok", "version": "1.0.0"}

范围：
只修改 app.py 中的路由注册部分，不新增文件，不改动现有路由。

约束：
- 沿用项目现有的 jsonify 返回风格
- 不引入新依赖
- 版本号从 config.py 的 VERSION 常量读取

验收：
运行 pytest tests/test_health.py，所有用例通过。
curl http://localhost:5000/health 返回正确 JSON。

交付：
改动摘要 + 验证结果 + 残余风险。

第三步：发出请求

把任务简报发给 AI，附上 app.py 和 config.py 的内容。

第四步：验证结果

运行测试手动验收类型检查

pytest tests/test_health.py -v

flask run &
curl http://localhost:5000/health
# 期望输出：{"status": "ok", "version": "1.0.0"}

mypy app.py

第五步：复盘

记录三件事：

• 这次任务简报哪里写得好，下次复用
• AI 哪里跑偏了，根因是什么
• 还有哪些边界情况没有覆盖

---

恭喜

你已经完成了第一个 Vibe Coding 任务。接下来读基础理论，深入理解背后的设计逻辑。