CadencePro

CadencePro Sprint 任务拆解

日期： 2026-03-26 基于： PRD + 市场调研 + last30days 热度分析 + 当前代码状态 + 护城河战略 方法论： BMAD Sprint Planning

---

战略开发原则（2026-05-02 更新）

后续排期默认遵循 docs/competitive-moat-analysis.md。

北极星： Apple Watch 上的无声触觉步频教练。

需求优先级按以下顺序判断：

1. 先做能强化“实时检测 -> 触觉引导 -> 跑后解释 -> 个人步频路径”的功能。
2. 先沉淀自然步频、舒适区间、疲劳漂移、训练建议等个人资产。
3. 后做 Strava、音乐、社交等外围集成；这些只能服务传播或辅助体验，不能抢主体验。
4. 教练模式是长期护城河，但必须建立在 Personal Cadence Path Engine 成熟之后。

---

Sprint 0：发布前冲刺（本周）

目标：MVP 可以提交 App Store 审核

S0-1 ⚡ 真机验证核心技术风险

• 优先级： P0 — 阻塞一切
• 负责： 魏琪（需要 Mac + Apple Watch）
• 预估： 2 小时
• 验收标准：
  • Apple Watch 真机上 CoreMotion 步频检测工作（跑 3 分钟，数据合理 150-190 SPM）
  • 触觉节拍器震动节奏正确（设 175 BPM，体感踩点）
  • Background Audio Session 与原生体能训练同时运行不冲突
• 风险： 如果后台共存失败 → 降级为独立训练模式（去掉 F3 卖点）
• 文件： CadenceProWatch/Engine/BeatEngine.swift, CadenceDetector.swift, HapticPlayer.swift

S0-2 🔧 补完训练结束流程

• 优先级： P0
• 预估： 3 小时
• 依赖： S0-1 通过
• 任务：
  • ActiveWorkoutView 结束训练后导航到 WorkoutSummaryView
  • endWorkout() 返回的 session 插入 ModelContext 持久化
  • WorkoutSummaryView「完成」按钮回到主页
  • 验证：完成一次训练 → 看到总结 → 回到主页 → 历史列表有这次记录
• 文件： ActiveWorkoutView.swift, WorkoutSummaryView.swift, WorkoutManager.swift

S0-3 📝 步频教育文案

• 优先级： P1
• 预估： 2 小时
• 基于： last30days 调研（@the5krunner + @mikeroscoe101 的用户痛点）
• 任务：
  • 在 QuickStartView 底部加 1 行教育 tip（随机显示）
  • 在 OnboardingView 结果页加步频科普
  • 国际化：en.lproj + zh-Hans.lproj 各加 5 条 tips
• 文案内容：

  tip.1 = "步频提高 5-10% 可降低膝关节冲击力最高 20%"
  tip.2 = "慢跑时步频 150-160 是正常的，不代表跑姿有问题"
  tip.3 = "不必追求 180 SPM，找到你的最佳效率区间更重要"
  tip.4 = "渐进式提升：每周提高 2-3 SPM 比直接跳到目标更安全"
  tip.5 = "手臂摆动加快 = 步频自然提高，试试看"
  

S0-4 🔒 隐私标签

• 优先级： P1
• 预估： 1 小时
• 基于： Runo 2.0 隐私卖点 + 我们的零服务器架构优势
• 任务：
  • SettingsView 加 “🔒 隐私” section：”所有数据仅存储在您的设备和 iCloud 上，不会发送到任何服务器”
  • iPhone ProfileView 加同样的隐私说明
  • 国际化
• 文件： SettingsView.swift, ProfileView.swift, Localizable.strings × 2

S0-5 📸 App Store 素材准备

• 优先级： P0
• 预估： 4 小时
• 任务：
  • Watch 截图 × 5（主页、BPM 设置、训练中、间歇选择、训练总结）
  • iPhone 截图 × 5（仪表盘、训练详情、计划编辑、历史、引导页）
  • App Store 描述文案（英文 + 中文）
  • 关键词设置
  • 隐私政策页面（可以用简单的 GitHub Pages）
• App Store 关键词：

  英文：running cadence, cadence metronome, haptic metronome, 180 spm,
        injury prevention running, interval cadence, Apple Watch runner,
        running form, step rate, stride rate
  中文：跑步步频, 步频训练, 跑步节拍器, 间歇训练, 跑步防伤,
        步频180, 触觉反馈跑步, 跑姿纠正, Apple Watch 跑步
  

S0-6 🚀 提交 App Store 审核

• 优先级： P0
• 依赖： S0-1 ~ S0-5 全部完成
• 预估： 2 小时
• 任务：
  • Xcode Archive → Upload to App Store Connect
  • 填写 App Store Connect 元数据（描述、截图、分类、价格）
  • 分类：Health & Fitness
  • 价格：免费
  • 年龄分级：4+
  • 提交审核
• 注意： 后台音频权限需要在审核备注里详细说明用途（节拍器触觉反馈保活）

---

Sprint 1：V1.0 功能（审核期间 + 上线后 4 周）

目标：上线 Pro 订阅，开始变现

S1-1 间歇训练完善（F5）

• 优先级： P1
• 预估： 1 周
• 当前状态： UI 和 WorkoutManager 间歇支持已有骨架
• 任务：
  • IntervalSetupView 显示各段详情（时间/距离、BPM）
  • ActiveWorkoutView 适配间歇模式（显示当前段 + 进度 ●●●○○）
  • 段间切换动画 + 触觉提示
  • 按距离模式：接入 GPS 距离累计触发段切换
  • 测试：完整跑一个亚索 800 模板
• 文件： IntervalSetupView.swift, ActiveWorkoutView.swift, WorkoutManager.swift

S1-2 步频区间可视化（F6）

• 优先级： P1
• 预估： 3 天
• 当前状态： CadenceZoneConfig 数据模型已有
• 任务：
  • Watch ActiveWorkoutView 背景色根据当前区间变化
  • iPhone 训练详情页显示各区间时间占比饼图
  • 区间自定义编辑 UI（iPhone ProfileView）
  • 加入步频教育文案（S0-3 的扩展）
• 文件： ActiveWorkoutView.swift, WorkoutDetailView.swift, ProfileView.swift

S1-3 步频-配速仪表盘完善（F7）

• 优先级： P1
• 预估： 3 天
• 当前状态： DashboardView 有基础图表骨架
• 任务：
  • 散点图加趋势线（线性回归）
  • 计算并显示「最佳效率步频区间」
  • 周/月切换
  • 与上周对比的 delta 显示
• 文件： DashboardView.swift

S1-4 HealthKit 深度集成（F8）

• 优先级： P1
• 预估： 3 天
• 当前状态： HealthKitService 已写
• 任务：
  • 训练结束后自动写入 HealthKit
  • 读取原生跑步训练数据（合并分析）
  • iPhone 端显示 HealthKit 授权状态和同步状态
  • 真机验证全流程
• 文件： HealthKitService.swift, HealthKitManager.swift, WorkoutManager.swift

S1-5 成就系统（调研驱动新增）

• 优先级： P2
• 预估： 3 天
• 基于： last30days 调研（Dick’s App 游戏化 18155 likes）
• 任务：
  • 数据模型：Achievement（id, name, description, unlocked, unlockedDate）
  • 预定义 10 个成就：
    • 🏅 第一次训练
    • 🏅 连续 7 天训练
    • 🏅 连续 30 天训练
    • 🏅 步频稳定性 ≥ 90
    • 🏅 步频目标达成 10 次
    • 🏅 完成间歇训练
    • 🏅 累计 50 次训练
    • 🏅 累计 100 次训练
    • 🏅 步频提升 10 SPM（vs 首次测试）
    • 🏅 在 3 个不同步频区间各训练 10 次
  • 训练结束时检查并解锁
  • iPhone 端成就展示页
  • 国际化
• 文件： 新增 Shared/Models/Achievement.swift, 新增 CadenceProPhone/Views/AchievementsView.swift

S1-6 Pro 订阅

• 优先级： P1
• 预估： 3 天
• 任务：
  • StoreKit 2 集成
  • 免费版 vs Pro 功能区分：
    • 免费：单一 BPM 节拍器 + 自适应
    • Pro：间歇训练 + 步频区间 + 仪表盘 + 成就 + 历史趋势
  • 订阅页 UI（iPhone）
  • 恢复购买功能
  • 定价：¥68/年 或 $8.99/年
• 文件： 新增 Shared/Services/StoreKitService.swift, 新增 CadenceProPhone/Views/PaywallView.swift

---

Sprint 2：V1.5（上线后 8-12 周）

S2-1 Personal Cadence Path Engine（F9，护城河核心）

• 优先级： P1 — Strategic Must
• 预估： 1 周
• 任务：
  • 3 分钟自然步频测试
  • 生成个人舒适步频区间
  • 基于历史数据计算最佳效率区间
  • 识别后半段疲劳/漂移模式
  • 4-8 周渐进提升计划生成
  • 训练前显示“今日建议步频”
  • 跑后显示“下次怎么调”的一句洞察

S2-2 日语本地化（调研驱动）

• 优先级： P2
• 预估： 1 天
• 基于： last30days 调研（日本市场间歇训练热度）
• 任务：
  • ja.lproj/Localizable.strings（~180 个 key）

S2-3 步频教育内容与增长素材（轻量版）

• 优先级： P2
• 预估： 3 天
• 基于： 用户在 Instagram 找步频教练
• 任务：
  • App 内嵌入 5 个步频训练教程（图文）
  • 生成 App Store 截图/文案围绕“无声触觉步频教练”
  • “本周训练建议” 基于上周数据生成
  • 可分享步频稳定性卡片（用于验证传播）
  • 不需要后端

---

Sprint 3：V2.0（上线后 16-20 周）

S3-1 教练模式（F12，长期护城河）

• 需要后端： CloudKit 共享数据库或轻量 API
• 预估： 2 周
• 任务：
  • 步频作业模板
  • 学员执行摘要
  • 计划完成度
  • 可分享报告

S3-2 Strava 洞察分享（F10，传播实验）

• 预估： 3 天
• 优先级： P3（只做步频洞察分享，不做普通同步）

S3-3 音乐 BPM 匹配（F11，辅助体验）

• 预估： 1 周
• 依赖： Apple Music API

---

任务总览

Sprint	任务数	总预估	关键交付物
S0 发布前	6	~14 小时	MVP 上 App Store
S1 V1.0	6	~4 周	Pro 订阅 + 间歇 + 区间 + 成就
S2 V1.5	3	~2 周	Personal Cadence Path + 日语 + 增长素材
S3 V2.0	3	~4 周	教练模式 + Strava 洞察分享 + 音乐辅助

---

依赖关系图

S0-1 真机验证 ──→ S0-2 补完流程 ──→ S0-5 截图 ──→ S0-6 提交审核
                                        ↑
S0-3 教育文案 ──→────────────────────────┘
S0-4 隐私标签 ──→────────────────────────┘

S1-1 间歇完善 ──→ S1-6 Pro 订阅（区分免费/Pro）
S1-2 步频区间 ──→┘
S1-3 仪表盘 ────→┘
S1-4 HealthKit ──→┘
S1-5 成就系统 ──→┘

---

文档完成日期： 2026-03-26 下次更新： MVP 提交审核后