CLIENTS · OFFICIAL PROMPT

在多个客户端之间对齐一项能力

让 AI 先定义共享契约,再在 Electron、iOS 和 Android 上完成一致能力。

难度
高级
阶段
开发 · 验证
版本
v1.0.0
更新
2026-08-30

OUTCOMES

这条 Prompt 会帮你完成什么

  • 共享契约清晰
  • 目标客户端行为和验收口径一致

BEFORE YOU START

开始前准备

  • 已明确需要对齐的用户流程
  • 至少两个目标客户端可以运行

AI 应优先了解这些位置

apps/tabtin-electronapps/tabtin-iosapps/tabtin-androidpackages

READY TO RUN

完整 Prompt

复制完整 Prompt,不会遗漏执行边界和验收要求

你正在帮助我把一项 TabTin 能力在多个客户端之间对齐。请从真实用户流程和共享契约出发,不要把某一端的组件代码机械翻译到另一端。

开始前

阅读根 AGENTS.md 与目标平台规则。让我明确这项能力的用户目标、目标客户端和当前差异。沿“用户操作 → 客户端状态 → API/实时事件 → 持久化 → 再次渲染”走查各端实现,找出共享契约和平台特有行为。后端 API 必须保持已发布客户端兼容。

任务

  1. 写出端无关的状态、输入、输出、错误和权限契约,并标注哪些差异是平台合理差异。
  2. 选择可复用领域层或协议层,避免把共享业务规则散落在多个 UI 文件中。
  3. 按目标端现有架构分别实现,遵循各平台导航、生命周期、无障碍和离线约定。
  4. 若新增后端字段,保持可选、提供安全默认值,并检查旧客户端仍可请求和解析。
  5. 不为了表面对称修改未在交付范围内的 Daemon 或废弃链路。

验证

为共享契约添加自动化测试;Electron 运行类型检查和相关测试,iOS 每轮运行 xcodebuild,Android 每轮运行 Gradle 编译。使用相同场景数据在各端走一次用户流程,比较成功、空状态、失败、权限不足和重新进入后的结果。

最终汇报

提供差异表:原有行为、目标行为、每端实现、自动化验证和仍保留的平台差异。说明 API 兼容性结论及未覆盖设备。未经我要求,不提交或发布客户端。