关于 scan-new-specs
已弃用的技能，曾用于从合并的规格中发现文档任务。现在不应运行或安排它；发布触发的替代方案是 `missing_docs`，`write-feature-docs` 仍可交互使用。
主要功能
- 01已退役，不应运行或安排
- 02由 `missing_docs` 替代
- 03仍支持交互式 `write-feature-docs`
适用场景
- 01通过 `missing_docs` 的 drift-watch 模式查找文档缺口
- 02通过 `write-feature-docs` 交互式请求功能文档
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/scan-new-specs确认已加载。
详细介绍
scan-new-specs（已弃用）
已于 2026-08-20 停用。请勿调用此技能，也不要安排其运行。
其计划运行的 Agent（0ITuF9vNJ1RiO00Szlm1fW）已暂停，并将继续保持暂停。
停用原因
此技能会在规范合并时触发，而此时功能尚未发布。这一设计选择引发了两个问题：
- 它会为尚未发布、甚至有时已被放弃的工作撰写文档。 规范合并不代表功能已发布。Agent 无法确认用户实际获得了什么，因此撰写的页面可能描述尚未上线、上线后表现不同，或根本没有上线的行为。
- 它把每份规范都当成文档任务。 没有人会先判断某项更改是否值得撰写文档。纯 UI 更改、简单直观的小功能和幕后工作都会变成草稿 PR，文档仓库积累未经审核内容的速度快于审核速度。
替代方案
使用 warpdotdev/docs 中的 missing_docs 技能，并以漂移监控模式运行。它在两个关键方面有所不同：
- 由发布触发。
scripts/check_new_release.py会确保每次运行都以新的稳定版发布为前提，因此流水线关注的是实际发布的内容，而非计划中的内容。每日计划任务会处理每次发布。 - 先判断是否值得撰写。 在起草任何内容之前，都会依据
.agents/references/docs-worthiness-criteria.md评估每个候选项；默认不撰写文档，并要求列出具体证据。包括拒绝理由在内的评估结果都会记录在references/changelog_decisions.md中，避免反复讨论。
任何确实值得记录的内容，都会在发布后再次出现在这里。
如果你正准备运行此技能
- 想查找文档缺口？ 在
warpdotdev/docs仓库中以漂移监控模式运行missing_docs。 - 你是想为功能补充文档的工程师？ 直接以交互方式调用
write-feature-docs。它仍受支持，也仍会带你研究规范并确认大纲，但不再以无头模式运行。 - 正在设置计划运行的文档 Agent？ 请使用
missing_docs，不要使用此技能。安排此技能会重现它被停用的根本原因，即文档泛滥。
相关技能
missing_docs（位于warpdotdev/docs中）——由发布触发、经过价值评估门控的替代方案write-feature-docs——仍支持工程师直接以交互方式使用
评论
支持 Markdown