1332 Quick Start 18e617bc

# ⚡ QUICK START - 会话启动清单

> **Version**: 2.0
> **Last Updated**: 2026-01-14
> **Status**: Active
> **Context 占用**: ~2,000 tokens
> **用途**: 每次会话开始时必读

---

## 🔍 自动识别

**当前目录**: `E:\Bobo's Coding cache`
**项目类型**: 数据分析和自动化（DAA）
**技术栈**: TypeScript + PostgreSQL + Vercel + MCP

**关键文件检查**:
- ✅ [CLAUDE.md](./CLAUDE.md) - 主配置文档
- ✅ [DECISION_TREE.md](./DECISION_TREE.md) - 决策树
- ✅ [ERROR_CATALOG.md](./errors/ERROR_CATALOG.md) - 错误总览

---

## ⚠️ 高频错误提醒（Top 10）

> 每次编码前必查！这些是最常犯的错误

| ID | 错误类型 | 频率 | 严重度 | 自检问题 |
|----|---------|------|--------|---------|
| E001 | 异步未并行处理 | 高 | 🔴 | 是否使用 `Promise.all()`? |
| E002 | 轮询无超时限制 | 高 | 🔴 | 是否设置 `maxAttempts`? |
| E003 | 错误未重新抛出 | 中 | 🔴 | `catch` 是否 `throw error`? |
| E004 | SQL 未使用 CTE | 中 | 🟡 | 是否预过滤数据? |
| E005 | 状态 ID 重复生成 | 中 | 🟡 | ID 是否只生成一次? |
| E006 | API 参数顺序错误 | 中 | 🟡 | 是否核对文档? |
| E007 | 忘记资源清理 | 低 | 🔴 | 超时/失败是否清理? |
| E008 | Chart 配置不完整 | 低 | 🟢 | 是否包含 tooltip? |
| E009 | 依赖未安装就使用 | 低 | 🟡 | 是否 `npm install`? |
| E010 | 硬编码魔法值 | 低 | 🟢 | 是否使用常量? |

**详细说明**: [ERROR_CATALOG.md](./errors/ERROR_CATALOG.md)

---

## 🌳 快速决策（5 秒定位工具）

```mermaid
graph LR
    A[收到任务] --> B{任务类型?}

    B -->|查询数据| C[bytebase MCP]
    B -->|生成图表| D[chart MCP]
    B -->|Git 操作| E[/commit Skill]
    B -->|代码审查| F[/code-review Skill]
    B -->|浏览器测试| G[browser-use Skill]
    B -->|UI 设计| H[ui-ux-pro-max Skill]
    B -->|架构设计| I[Plugins 自动激活]

    C --> J[开始执行]
    D --> J
    E --> J
    F --> J
    G --> J
    H --> J
    I --> J
```

**详细决策树**: [DECISION_TREE.md](./DECISION_TREE.md)

---

## 🎯 工作模式确认

**核心原则**: **计划 → 确认 → 执行到底 → 验收**

### 标准工作流

```
1️⃣ 收到任务 → 分析需求 + 创建 TodoList
                ↓
2️⃣ 展示计划 → 等待用户确认
                ↓
3️⃣ 用户确认 OK → 执行到底（不问问题，除非致命阻塞）
                ↓
4️⃣ 全部完成 → 总结 + 请求用户验收
```

### 4 种致命阻塞（唯一允许提问）

只有以下情况才能打断执行并提问：

1. ❗ **缺少关键凭证** - 数据库密码、API key、敏感信息
2. ❗ **多个对立方案** - 完全不同的技术方案且无法从代码库判断
3. ❗ **需求本质矛盾** - 用户要求互相冲突（"既要A又要非A"）
4. ❗ **不可逆高风险** - 删除生产数据、强制推送到 main 等

### 禁止提问的情况（自行决策）

以下情况必须自己决策，不得提问：

- ✅ 文件命名、目录结构（遵循现有规范）
- ✅ 代码实现细节（选择最佳实践）
- ✅ 依赖版本选择（使用最新稳定版）
- ✅ 测试策略（全面覆盖）
- ✅ 代码风格（遵循 eslint/prettier）
- ✅ UI 布局细节（遵循设计系统）
- ✅ 变量/函数命名（语义化命名）

**详细说明**: [Auto Execution Mode](./docs/workflows/auto-execution.md)

---

## 📊 当前项目上下文

### 项目信息
- **名称**: 数据分析和自动化（DAA）
- **功能**: Markdown 分析模板 + Vercel 定时任务 + PostgreSQL 快照
- **特点**: 结合 Claude Code 执行 + base44 部署

### 常用命令
```bash
# 开发测试
cd functions && npm test              # 运行测试
vercel dev                            # 本地开发服务器

# 数据库操作
npm run db:push                       # 推送 schema 变更
npm run db:studio                     # 打开 Drizzle Studio

# 部署
vercel --prod                         # 部署到生产环境
```

### 关键路径
```
分析模板:      *.md（根目录）
API 函数:      functions/api/cron/*.ts
数据库 Schema: functions/lib/db/schema.ts
MCP 客户端:    functions/lib/mcp/client.ts
```

### 核心数据表
- `daaf_bot_revenue_snapshots` - Bot 收入归因快照
- `daaf_daily_summary_snapshots` - 每日汇总快照
- `daaf_cost_daily_snapshots` - 每日成本快照
- `daaf_free_cost_by_bot_snapshots` - Free 用户成本 Top30

---

## 🔧 可用工具速览

### MCP Servers（8 个）
- **mcphub** - 数据分析集群（bytebase + honeycomb + statsig + chart）
- **asana** - 任务管理
- **context7** - 文档搜索
- **firebase** - Firebase 开发
- **greptile** - 代码理解
- **playwright** - 浏览器自动化
- **stripe** - 支付集成
- **supabase** - Supabase 开发

### 高频 Skills
- `/commit` - Git 提交
- `/code-review` - 代码审查
- `/write-tests` - 生成测试
- `browser-use` - 浏览器自动化
- `ui-ux-pro-max` - UI/UX 设计

### Plugins（自动激活）
- backend/frontend-development - 架构设计
- debugging-toolkit - 错误诊断
- code-review-ai - 代码质量
- data-engineering - 数据管道

**完整列表**: [能力体系文档](./docs/capabilities/)

---

## 🔗 快速导航

### 核心文档
- [主配置文档 CLAUDE.md](./CLAUDE.md)
- [决策树 DECISION_TREE.md](./DECISION_TREE.md)
- [错误知识库 errors/](./errors/)

### 详细指南
- [MCP Servers 详解](./docs/capabilities/mcp-servers.md)
- [Skills 使用指南](./docs/capabilities/skills-guide.md)
- [Plugins 自动激活](./docs/capabilities/plugins-auto.md)

### 工作流程
- [自动执行模式](./docs/workflows/auto-execution.md)
- [数据分析流程](./docs/workflows/data-analysis.md)
- [全栈开发流程](./docs/workflows/full-stack-dev.md)

### 参考资料
- [命令速查表](./docs/references/commands-cheatsheet.md)
- [最佳实践](./docs/references/best-practices.md)
- [常见问题 FAQ](./docs/references/faq.md)

---

## ✅ 启动检查完成

```
📂 项目: 数据分析和自动化
⚠️ 高频错误: 10 个需要注意
🔧 可用工具: 8 MCP + 13 Skills + 30+ Plugins
📖 文档加载: 核心文档（~2K tokens）

准备接收任务 🚀
```

---

**📌 提示**:
- 遇到问题先查 [ERROR_CATALOG.md](./errors/ERROR_CATALOG.md)
- 不确定用什么工具查 [DECISION_TREE.md](./DECISION_TREE.md)
- 想了解能力详情查 [capabilities/](./docs/capabilities/), [workflows/](./workflows/), [references/](./references/) 目录