mage0535/vibe-coding-universal/v1

┌─────────────────────────────────────────────────┐
│ 阶段 1: 深度调研 (Survey)                       │
│   7 轮结构化提问 → 明确真实需求                  │
├─────────────────────────────────────────────────┤
│ 阶段 2: 记忆检索 (Recall)                       │
│   搜索 .vibe/history/ 相似项目 → 复用经验/避坑  │
├─────────────────────────────────────────────────┤
│ 阶段 3: 文档生成 (Document)                     │
│   生成 .vibe/guide.md 统一开发指导文档           │
├─────────────────────────────────────────────────┤
│ 阶段 4: 确认进入开发 (Confirm)                   │
│   用户确认后，基于 guide.md 开始编码             │
└─────────────────────────────────────────────────┘

### 🔵 Q1/7 — 项目概览
"请用一句话描述你想做什么？它解决了什么问题？"
→ 记录为: overview
 
### 🔵 Q2/7 — 目标用户
"谁会使用这个产品？目标用户画像是什么？"
→ 记录为: audience
 
### 🔵 Q3/7 — 核心功能
"列出最核心的 3-5 个功能。哪些是必须的，哪些是锦上添花的？"
→ 记录为: features (must-have / nice-to-have)
 
### 🔵 Q4/7 — 技术偏好
"有偏好的技术栈吗？（如 React/Vue/Python/Go/Flutter）如果没有，我可以推荐最适合的。"
→ 记录为: tech_pref
 
### 🔵 Q5/7 — UI/UX 风格
"界面风格偏好？（如极简/暗黑模式/企业风/游戏风）有参考的产品或网站吗？"
→ 记录为: ui_style
 
### 🔵 Q6/7 — 部署环境
"打算部署在哪里？（Vercel/Docker/本地/手机 App/微信小程序）"
→ 记录为: deploy_env
 
### 🔵 Q7/7 — 约束与边界
"有什么特殊限制？（如：开发时间、预算、合规要求、性能要求、隐私保护）"
→ 记录为: constraints

survey_result:
  overview: "..."
  audience: "..."
  features:
    must_have: ["...", "..."]
    nice_to_have: ["...", "..."]
  tech_pref: "..."
  ui_style: "..."
  deploy_env: "..."
  constraints: "..."
  survey_date: "YYYY-MM-DD HH:MM"
  ai_decisions: "记录所有 AI 自主决策的点"
  skipped_questions: []

如果新项目与历史项目满足以下任一条件，视为"相似":
- 同领域（如都是"记账"类）
- 核心功能重叠度 > 50%
- 技术栈相同 + 功能类似
- 解决了相同的核心问题

## 💡 历史经验参考
基于过往项目 [项目名] 的经验：
-✅ 成功的做法: ...
-❌ 踩过的坑: ...
-🔧 调整建议: ...

---
title: "[项目名称] — 开发指导文档"
version: 1.0
created: YYYY-MM-DD
status: draft  # draft | confirmed | developing | done
survey_completed: true
---
 
# 📋 [项目名称] 开发指导文档
 
> **一句话描述**: [从 Q1 提取]
> **核心问题**: [从 Q1 提取]
> **目标用户**: [从 Q2 提取]
> **生成时间**: YYYY-MM-DD HH:MM
 
---
 
## 1. 需求定义
 
### 1.1 核心功能（Must Have）
| # | 功能 | 优先级 | 描述 |
|---|------|--------|------|
| 1 | ... | P0 | ... |
| 2 | ... | P0 | ... |
 
### 1.2 锦上添花（Nice to Have）
| # | 功能 | 优先级 | 描述 |
|---|------|--------|------|
| 1 | ... | P1 | ... |
 
### 1.3 明确不做（Out of Scope）
> 记录开发过程中明确排除的功能，避免范围蔓延。
-(开发过程中逐步补充)
 
---
 
## 2. 技术架构
 
### 2.1 技术栈选型
| 层级 | 选择 | 理由 |
|------|------|------|
| 前端 | ... | ... |
| 后端 | ... | ... |
| 数据库 | ... | ... |
| 部署 | ... | ... |
 
### 2.2 项目结构

 
### 2.3 关键依赖
- (列出核心 npm/pip 包)
 
---
 
## 3. UI/UX 规范
 
### 3.1 设计风格
- **整体风格**: ...
- **主色调**: ...
- **字体**: ...
- **组件库**: ... (如 shadcn/ui / Ant Design / Material)
 
### 3.2 响应式要求
- 移动端优先 / 桌面端优先 / 全平台适配
 
---
 
## 4. 开发计划（分步执行）
 
> **原则**: 每步 10-30 分钟可完成，完成后立即验证。
 
| 阶段 | 任务 | 预计时间 | 状态 |
|------|------|----------|------|
| Phase 0 | 初始化项目骨架 | 10min | ⬜ |
| Phase 1 | 核心功能 A | 20min | ⬜ |
| Phase 2 | 核心功能 B | 20min | ⬜ |
| Phase 3 | 核心功能 C | 20min | ⬜ |
| Phase 4 | UI 完善与联调 | 30min | ⬜ |
| Phase 5 | 测试与部署 | 20min | ⬜ |
 
---
 
## 5. 开发约束
 
### 5.1 铁律（不可违反）
1. 不得基于猜测实现业务逻辑，必须与人类确认需求
2. 不得跳过验证流程，每个功能完成后必须测试
3. 不得触碰架构红线或绕过既有设计规范
4. 不得在未定义数据结构前编写业务逻辑
5. 不得一次性生成大量代码，必须分小块逐步验证
 
### 5.2 编码规范
- 每个函数只做一件事
- 变量命名清晰（禁止 a, b, x 等无意义命名）
- 每个文件顶部写一段话描述该文件的作用和上下游链路
- 不得吞掉异常或使用空 catch 掩盖错误
- 优先复用既有成熟库，不得自行造轮子
 
### 5.3 特殊约束
- [从 Q7 提取]
 
---
 
## 6. 历史经验
 
### 6.1 相似项目参考
- (如有相似项目，在此记录其经验教训)
- 如无，标注"本项目为首次开发，无历史参考"
 
### 6.2 已知坑点
- (基于通用 Vibe Coding 经验)
- AI 容易幻觉不存在的 API → 使用前必须查证文档
- 一次性生成大量代码后无法调试 → 必须分小块
- 上下文污染导致 AI 理解偏差 → 每个新功能开独立对话或用 /compact
 
---
 
## 7. 变更记录
 
| 日期 | 变更内容 | 变更原因 |
|------|----------|----------|
| YYYY-MM-DD | 初始创建 | 调研完成 |
 
---
 
## 8. AI 决策记录
 
> 记录开发过程中所有 AI 自主做出的决策，供用户审查。
 
| 决策点 | AI 选择 | 理由 | 用户确认 |
|--------|---------|------|----------|
| ... | ... | ... | ⏳ |
 
---
 
*本文档由 AI 自动生成，经用户确认后生效。*
*开发过程中，本文档是唯一的真理来源（Single Source of Truth）。*

project/
├── .vibe/                      # ← 本技能的工作目录（隔离的，不影响其他）
│   ├── guide.md                # 统一开发指导文档（核心产出）
│   ├── client-profile.md       # 客户长期偏好（跨项目复用）
│   ├── history/                # 历史项目归档
│   │   ├── 2026-04-21_记账app/
│   │   │   └── guide.md        # 过往项目的开发文档
│   │   └── ...
│   └── session-log.md          # 当前会话的调研记录
│
├── ... (用户原有的项目文件)     # ← 本技能绝不触碰
├── .gitignore                   # ← 本技能绝不修改
├── AGENTS.md                    # ← 本技能绝不覆盖
└── .cursor/ or .claude/        # ← 本技能绝不干扰

.vibe/

# 客户画像
 
## 技术偏好
-偏好的技术栈: ...
-不喜欢的技术: ...
 
## UI 偏好
-风格偏好: ...
-常用组件库: ...
-色彩偏好: ...
 
## 工作习惯
-沟通风格: ...
-决策速度: ...
-关注重点: ...
 
## 历史统计
-完成项目数: N
-常用技术: ...
-常见需求类型: ...