SuperAPI AI 工具集

uw-complete

写作与研究

查看项目

更新于 10-30 09:34

技能介绍

用途 uw-complete 用于处理校验阶段产出的 gaps.md 文件,把缺失的文档补入各分层文档文件。它通常在 uw-verify 之后执行,是 unwind 流水线(scan → analyze → verify → complete → grill → plan → dashboard)中的补齐环节。

输入与输出 输入为 docs/unwind/layers/{layer}/gaps.md,来源是校验步骤。输出为补齐缺口后更新过的分节文件。gaps.md 中的条目分为三类:缺失项(含源位置与目标分节)、不准确项(需要修正的内容)、未分类项(需要补打标签)。

锚点 Id 规则 锚点 Id 很重要。由确定性校验器生成的 gaps.md 会为每个缺失项列出 Id。文档需采用带锚点 Id 的标题格式,使重新校验时能够匹配、覆盖率循环得以收敛:### <name> [MUST|SHOULD|DON'T] <!-- id: <Id from gaps.md> -->。若某项不应出现在重建版本中,应将其移入 ## Excluded 段并附一行原因,而不是为其编写文档。

使用方式 第一步:读取 gaps.md,按分层获取缺失项、不准确项与未分类项。 第二步:为存在缺口的分层派发补齐代理。对每个缺失项,读取指定位置的源文件,按分析原则编写文档,写入指定分节文件并采用上述锚点标题,原样复制 gaps.md 中的 Id 以保证重新校验可匹配。对每个不准确项,读取源文件并修正文档以匹配实际代码。对每个未分类项,补充相应的 [MUST/SHOULD/DON'T] 标签。链接格式为 [from architecture.md]。完成后更新 index.md 的统计数量并删除 gaps.md。 第三步:校验完成情况,确认所有 gaps.md 已删除、分节文件已更新、index.md 计数准确。

标签判定 MUST 对应核心功能、业务逻辑、外部契约;SHOULD 对应有价值的模式与良好实践;DON'T 对应特定技术实现细节。

并行执行 各分层的补齐任务之间没有依赖,可并行派发代理同时处理数据库、服务层、API 等分层。

大量缺口的处理 若某分层缺口很多(20 个以上),应逐项处理,每完成一项即写入文件,不要缓存全部改动,以避免令牌耗尽。

完成之后 当所有 gaps.md 均被删除后,建议重新校验以证明覆盖率循环已收敛。可通过 AskUserQuestion 询问用户下一步:重新校验覆盖率(推荐,确认 100% 后再继续);审查业务逻辑(调用 unwind:uw-grill,用于找出过时规则、未解释常量和矛盾之处,并将只有领域专家能回答的问题写入 docs/unwind/questions/);或暂停,暂停时可提示用户运行 unwind:uw-verify(输入 /uw-verify)重新检查覆盖率。

限制 该技能依赖先前的校验产出 gaps.md;其行为围绕文档补齐与覆盖率收敛,不负责判断业务逻辑是否值得重建(由 uw-grill 承担)。关于收费、价格与平台支持等信息,资料暂未提供。