Claude 与 Skill
一个人用 Claude Code 同时维护 iOS、Android 和 Web:三端不同步的踩坑与机制设计
Daywell 创始人分享他用多个 Claude Code 会话分别开发三端应用时遇到的真实翻车案例:文案不一致、共享值被复制、修了 iOS 忘了 Android。他的结论是 Agent 漂移不是因为粗心,而是缺少强制机制,每次事故都以一个自动化检查收尾,而不是一句提醒。
今天就能做
- 把所有跨端共享的文案和数值放进一个版本控制的单一来源文件,禁止任何会话手打副本
- 在推送环节加检查:改了屏幕代码但没改对应 spec 就拒绝推送,跳过检查要留痕
- 修 bug 时把新规则的精确措辞写进提交信息,并为 bug 和它的邻居各写一个测试
事故一:代码里的备注不是事实来源
- 2026 年 10 月 1 日,iOS 会话在代码里留了句备注:这句话已在 web 上线,不要改写。但 web 端根本没有这句话
- 备注被传递了两次才有人打开两个文件对比,每个会话都只是信任了上一条备注
- 教训:代码里的备注是记忆不是来源,必须打开两个文件亲自核对
- 解决方案:所有三端文案统一放进一个共享 JSON,每个字符串有 id,各端逐字节比对测试
事故二:共享值被各端各自硬编码
- 10 月 5 日发现调优参数、AI 模型标识、家庭角色名称在三端各写了一份
- 事后测试只能发现已经发生的漂移,太晚了
- 他改为检查代码本身:脚本扫描源码,发现任何与 fixture 中声明值相同的字面量就拒绝推送,除非在注释过的白名单上
- fixture 文件夹按类型组织:封闭词表、文案、限制值、请求响应结构、推送通知规则
让修复的措辞随提交一起传播
- 11 月 2 日 iOS 修复了卡片更新计数过宽的问题,Android 和 web 同日各自提交了同样的修复
- 能同步成功的关键是 iOS 提交里带了新规则的精确措辞,其他会话不用猜
- 新规矩:发现差异的会话必须先为其他端提交 delta 文件,再推送
- 推送脚本检查:如果改动涉及某个屏幕文件但同一次推送没有改对应的共享 spec,推送直接被拒绝
消灭第二份拷贝,而不是修补它
- 11 月 6 日发现 Android 的事件回复通知比 iOS 少一个字段
- 修复方式不是补丁,而是让服务端用同一段代码生成两端的推送消息,从结构上杜绝漂移
- 这是他现在每个修复都追求的模式:让第二份拷贝不复存在
修复要覆盖一整类问题
- 11 月 11 日主分支变红:Android 设置页的开发者屏幕用了硬编码标题
- 修复包含两个测试:针对出问题的七行,以及针对整个主题下所有 Android 键的逐字节测试
- 同日他还写了一个 walker 的 spec:自动打开四端每个可点击元素并对比差异,只报告不阻塞,由他人工裁决后按端批量修复
给其他独立开发者的建议
- 不要依赖测试两份拷贝是否一致,要加一个让第二份拷贝无法产生的检查
- 每个端一个 Agent 会话、一个文件夹,跨端改动通过提交任务而不是直接改对方的代码
- 永远不接受备注里写的已经在另一端上线了这种说法,打开两个文件确认
- 修复提交里带上精确的新措辞,让其他会话可以照搬;每个修复配两个测试:bug 本身和它的邻居
- 检查要足够便宜,让 Agent 没有动机跳过它
原文:Keeping iOS, Android and web in sync with AI agents
来源:DEV Community · 2026-11-18
查看原文本文由 AI 阅读原文后整理,未经人工逐字核对,内容以原文为准。
登录后可以点赞、查看和发表评论