shipping-across-surfaces

该技能针对产品事实在代码、落地页、面向智能体的摘要、变更日志、导航徽章、README 以及各工具或端点描述中重复出现、各自独立漂移且无测试覆盖的问题。核心做法：一是在仓库中写下“表述面清单”，把它作为面向用户变更的完成定义，清单通常包括落地页、meta/OG/Twitter 标签与结构化数据、文档页与 llms.txt、变更日志与版本徽章、Sitemap 与页脚、README 与对比页、以及代码内各工具/命令/端点描述；并在整个代码树而非仅文档目录中 grep 旧字符串。二是能生成就不重述：由实时 schema 渲染的 API 参考、模板化的版本徽章、从注册表派生的功能列表，比手写副本更可靠；无法生成时用漂移测试对照实时来源，例如断言 README 记录的已注册工具名集合与实际注册表一致。三是序列化字段改名要同时检查生产者与消费者，模板和内联 JavaScript 也是消费者，可用边界契约测试固定。四是不要手工维护他人拥有的表述面副本，事实应由拥有方以版本化生成产物对外发布。五是跨仓库的格式变更需配套消费者 PR，载荷需版本化，发布节奏不同时先上解码器。六是区分被重载的产品术语并写明定义与规范标签，事实性断言保留可追溯的稳定标识且只追加不重编号，可用仓库级检查强制引用。资源还提供了变更落地与减少表述面数量的检查清单。具体安装与使用方式暂未提供。