2. Scope
✅ MVP 必须包含 (P0)
| 模块 | 功能 | 边界说明 |
|---|
| 代码输入 | 文本框粘贴代码 | 仅支持纯文本粘贴,最大 10,000 字符 |
| AI 审查 | LLM API 调用返回审查建议 | 使用成本最低的模型,单次请求超时 30s |
| 结果展示 | 格式化输出审查意见 | 分类:问题类型 + 建议修复 |
| 基础展示 | 首页 + 审查页 | 单页面应用,简单路由 |
⏸️ 下一步考虑 (P1)
- 代码语言自动检测
- 语法高亮
- 审查历史记录
- 用户反馈(有用/无用)
❌ MVP 不做 (明确边界)
- Git 集成 / 仓库拉取
- 用户注册/登录
- 代码片段收藏
- 多人协作
- IDE 插件
- 微信/Slack 通知
3. Dependencies
已验证事实
- 技术栈共识:Next.js 14 + TypeScript + Supabase + Vercel
- MVP 形态共识:Web 端单文件粘贴审查
需前置确认 (依赖)
| 依赖项 | 状态 | 风险 |
|---|
| LLM API 密钥 | 待获取 | 可能阻塞开发 |
| Supabase 项目 | 待创建 | 需配置 |
| Vercel 账号 | 待部署 | 需配置 |
关键假设
- 单次审查 API 成本可控制在 $0.01 以内(如使用 GPT-3.5 Turbo 或 Claude Haiku)
- 用户愿意义务使用简单工具(无登录门槛)
4. Risks
| 风险 | 等级 | 缓解措施 |
|---|
| 🔴 API 成本失控 | 高 | 严格限制单次 token 上限,优先选最便宜模型 |
| 🔴 MVP 上线后无人用 | 中 | 先做技术验证,再做小范围推广测试 |
| ⚠️ LLM 返回质量不稳定 | 中 | Prompt 迭代优化,设置 fallback 提示 |
| ⚠️ 超出 MVP 范围膨胀 | 中 | 严格守住 P0 边界,完成后再议 P1 |
5. Actions Completed / Next 3 actions
已完成
接下来 (按顺序执行)
- 搭建项目脚手架 —
npx create-next-app@latest + Supabase 客户端初始化
- 实现核心审查流程 — 输入框 + API 调用 + 结果展示
- 部署到 Vercel — 验证生产环境可用性
6. Completion Status
- 功能清单:✅ 已输出 P0/P1/不做边界
- 优先级排序:✅ 已明确
- 技术栈:✅ Next.js + TS + Supabase + Vercel 统一
- 风险标注:✅ 已识别成本风险为最高优先级
- 下一步:✅ 3 个可执行动作已列出
HANDOFF_CONFIDENCE: 3
置信度说明:功能拆解本身结构清晰,但核心假设(API 成本 <$0.01)未经实际验证,MVP 完成后需以此为验收标准。
{
"confidence": 3,
"suggested_owner": "wukong",
"handoff_ready": true,
"completed": true,
"blocking_issues": []
}