scan-new-specs 曾用于扫描已合并的产品规格,并自动起草文档变更。它已于 2026 年 8 月 20 日退役;如果你在库里看到它,应把这篇当成旧流程说明,不要继续启用或调度。
退役原因很具体:规格合并发生在功能发布之前。有些计划尚未上线,有些最终改了做法,甚至被放弃,文档却已经按设计稿写出来了。
另一个问题是,它把每份规格都当成值得新增文档的任务。小幅界面调整、用户容易理解的变化、后台实现细节,也变成待审稿件,积压越来越多。
原文给出的替代方向,是在 warpdotdev/docs 仓库使用 missing_docs 的 drift-watch 模式。新流程以稳定版本发布为触发依据,再检查变化是否值得写文档,并记录包括否决在内的判断。工程师要主动为功能写文档,则有交互式的 write-feature-docs 入口。
这份退役记录适合维护文档自动化的人读:触发信号应该证明用户已经拿到什么,而不只是证明团队计划做什么。是否需要一篇新文档,也应单独判断。