已废弃技能 scan-new-specs…

当你想为已发布功能自动补文档、或想替换按 spec 合并触发的文档流水线时，改用发布触发且带文档价值门槛的 missing_docs 技能。

适用场景

解决思路

1. 不要调用 scan-new-specs，也不要为它设置定时调度；它的定时 agent（0ITuF9vNJ1RiO00Szlm1fW）已暂停并保持暂停。
2. 改用 warpdotdev/docs 仓库中的 missing_docs 技能，并以 drift-watch 模式运行。
3. 让 missing_docs 由发布触发：用 scripts/check_new_release.py 在每次运行前检查是否有新的稳定版本发布，使流水线只看到真正已发布的内容，而不是计划中的内容；用每日调度来执行每个版本的工作。
4. 在草拟任何内容之前，先用 .agents/references/docs-worthiness-criteria.md 对每个候选项做文档价值评估，默认判定为不需要文档，并要求给出具体证据。
5. 把判定结果（包括拒绝）记录到 references/changelog_decisions.md，避免同一问题被反复争论。
6. 如果你是在找文档缺口，从 warpdotdev/docs 仓库运行 drift-watch 模式的 missing_docs。
7. 如果你是工程师、想为自己的功能写文档，直接交互式调用 write-feature-docs；它仍然可用，仍会带你做 spec 调研和大纲确认，但不再以无头方式运行。
8. 如果你要搭建定时文档 agent，使用 missing_docs 而不是本技能；调度本技能会重新引入它被废弃的那种文档泛滥问题。

适用边界 · 注意事项

• 不要用本技能为未发布或可能被放弃的工作草拟文档：spec 合并不等于功能已发布，无法证明用户实际收到了什么。
• 不要把每个 spec 都当作文档任务：纯 UI 改动、小而直观的新增、以及幕后工作不应自动生成草稿 PR。
• 不要在需要定时文档 agent 时调度本技能，否则会重新造成未经审核的内容债务堆积。