开发工作流与策略

一、Vibe Coding 核心方法论

原则

每日工作节奏

  1. 开始前：回顾昨天的验收结果，确认今天的目标
  2. 开发中：一次只做一个模块，完成 → 验证 → 下一个
  3. 结束时：记录遇到的问题和明天需要调整的内容

二、与 Claude Code 协作策略

Prompt 编写原则

  1. 给足上下文：每次开新模块前，描述清楚整体架构和这个模块的目标
  2. 分层递进：先描述「是什么」，再描述「怎么做」，最后描述「约束条件」
  3. 提供范例：给出期望的输入/输出格式，LLM 输出更稳定
  4. 明确限制：说清楚 iOS 版本（17+）、不用哪些库、性能要求

关键 Prompt 模板

注意：以下为 Claude Code 通用模板。Cursor（iOS 开发）的 5 个专用 Prompt 模板详见 kept-blueprint.html 的「Cursor Prompt 范本」章节，涵盖语音服务、Core Data、Widget、地理围栏和 API 调用。

新模块开发

我正在开发 Kept 应用的 [模块名]。

背景：Kept 是一个 AI 记忆助手 iOS App，[模块在整体架构中的位置和作用]。

需求：
1. [功能点 1]
2. [功能点 2]
3. [功能点 3]

技术约束：
- iOS 17+, SwiftUI, @Observable macro
- [其他约束]

请保持简洁，不要过度抽象。

Bug 修复

[模块名] 出现了问题：[症状描述]

预期行为：[应该怎样]
实际行为：[实际怎样]

请先分析可能的原因，然后写一个测试来重现这个 bug，再修复它。

代码优化

当前 [模块名] 的实现可以工作，但 [具体问题]。

请在不改变外部接口的前提下优化 [具体方面]。

三、7 天 Sprint 执行策略

每天的执行模式

日 主题 核心验收标准
D1 搭骨架 项目初始化 + 语音录入 按住说话松开后文字出现
D2 AI 大脑 云端 API + LLM 意图理解 curl 发送文本，返回结构化 JSON
D3 贯通 端云串联 + Core Data 存储 说话 → API → 列表显示记忆
D4 提醒 时间通知 + 地理围栏 到超市附近手机推送通知
D5 Widget 锁屏 Widget + 完成确认 锁屏看到记忆，点完成后消失
D6 打磨 UI 打磨 + 边界处理 整体视觉统一，核心流程流畅
D7 试跑 自测 + Bug 修复 真实使用出现 1 次 aha moment

每日验收流程

  1. 完成当天任务清单中的所有项目
  2. 在真机上运行并测试（不只依赖模拟器）
  3. 录一段屏幕演示当天的功能（D2 为纯 API，用 curl 输出截图代替录屏）
  4. 记录发现的问题到 bug 列表
  5. 确认通过后才进入下一天的内容

四、迭代优化策略

LLM Prompt 调优

性能优化路径

体验优化顺序

  1. 录入速度（松开到确认 ≤ 0.5s 端侧，2-5s 云端完成理解）
  2. 提醒准确度（对的时间、对的地点）
  3. 文案温度（像朋友随口说，不像机器通知）
  4. 视觉体验（warm, minimal, 不 overwhelming）

五、风险管理

风险 应对
Action Button 体验不丝滑 同时做 App 内长按按钮作为备选
LLM 分类不准 持续收集错误 case，密集调优
地理围栏不精准 200m 半径，后期改 significant location
20 个围栏上限 importance 排序，动态管理
后台位置权限被拒 回退到时间触发 + Widget
中英混杂识别差 优先中文，LLM 纠错英文实体

六、种子验证方法

观测指标

  1. 习惯形成：每天 2-3 条以上，连续 7 天不衰减 = 成功
  2. Aha Moment：前两周每人至少 1-2 次精准提醒惊喜 = 成功

数据收集

收集方式