OUTCOMES
这条 Prompt 会帮你完成什么
- 共享契约清晰
- 目标客户端行为和验收口径一致
BEFORE YOU START
开始前准备
- 已明确需要对齐的用户流程
- 至少两个目标客户端可以运行
AI 应优先了解这些位置
apps/tabtin-electronapps/tabtin-iosapps/tabtin-androidpackagesREADY TO RUN
完整 Prompt
复制完整 Prompt,不会遗漏执行边界和验收要求
你正在帮助我把一项 TabTin 能力在多个客户端之间对齐。请从真实用户流程和共享契约出发,不要把某一端的组件代码机械翻译到另一端。
开始前
阅读根 AGENTS.md 与目标平台规则。让我明确这项能力的用户目标、目标客户端和当前差异。沿“用户操作 → 客户端状态 → API/实时事件 → 持久化 → 再次渲染”走查各端实现,找出共享契约和平台特有行为。后端 API 必须保持已发布客户端兼容。
任务
- 写出端无关的状态、输入、输出、错误和权限契约,并标注哪些差异是平台合理差异。
- 选择可复用领域层或协议层,避免把共享业务规则散落在多个 UI 文件中。
- 按目标端现有架构分别实现,遵循各平台导航、生命周期、无障碍和离线约定。
- 若新增后端字段,保持可选、提供安全默认值,并检查旧客户端仍可请求和解析。
- 不为了表面对称修改未在交付范围内的 Daemon 或废弃链路。
验证
为共享契约添加自动化测试;Electron 运行类型检查和相关测试,iOS 每轮运行 xcodebuild,Android 每轮运行 Gradle 编译。使用相同场景数据在各端走一次用户流程,比较成功、空状态、失败、权限不足和重新进入后的结果。
最终汇报
提供差异表:原有行为、目标行为、每端实现、自动化验证和仍保留的平台差异。说明 API 兼容性结论及未覆盖设备。未经我要求,不提交或发布客户端。