SuperAPI AI 工具集

scan-new-specs

通用与其它

查看项目

更新于 10-16 07:22

技能介绍

用途:scan-new-specs 原本用于扫描已合并的 PRODUCT.md 规格,并自动起草文档 PR。该技能自 2026-08-20 起已废弃并停用,不应调用,也不应安排调度;其关联的定时智能体(0ITuF9vNJ1RiO00Szlm1fW)已暂停并保持暂停。

停用原因:该技能在规格合并时触发,而规格合并发生在功能发布之前。由此产生两个问题:一是为未发布、有时甚至被放弃的工作起草文档,因为合并的规格并不等于已交付的功能,智能体没有证据判断用户实际获得了什么;二是把每个规格都当作文档任务,纯 UI 改动、小而直观的新增以及幕后工作都会生成草稿 PR,导致文档仓库积累大量未经审核的内容债务。

替代方案:warpdotdev/docs 中的 missing_docs 技能,以 drift-watch 模式运行。区别有两点:一是由发布触发,scripts/check_new_release.py 以新的稳定版本为每次运行的门槛,使流水线看到实际发布的内容;二是以是否值得记录为门槛,每个候选都会先依据 .agents/references/docs-worthiness-criteria.md 评估,默认不写文档,并要求给出具体证据,判定结果(包括拒绝)记录在 references/changelog_decisions.md 中。

使用建议:若想查找文档缺口,请在 warpdotdev/docs 仓库中以 drift-watch 模式运行 missing_docs;若工程师想为自己的功能编写文档,可直接交互式调用 write-feature-docs,它仍然可用,会引导完成规格研究和提纲确认,但不再以无头方式运行;若要设置定时文档智能体,请使用 missing_docs,而不是本技能。

限制:本技能已停用,无可用功能;资料未提供其安装命令、收费或价格信息。