SuperAPI AI 工具集

uw-analyze

编程与开发

查看项目

更新于 10-30 10:34

技能介绍

uw-analyze 是 Unwind 代码库拆解流水线中的第二个阶段(scan → analyze → grill → plan → dashboard),用于在扫描完成后逐层分析代码库并产出机器可读的文档。

前置条件 使用前需已由 uw-scan 生成 docs/unwind/architecture.md 和 docs/unwind/.cache/scan-manifest.json。分析结果输出到 docs/unwind/layers/*/ 文件夹,每个文件夹包含一份 index.md 和若干分区文件。分析遵循 analysis-principles.md:完整性、机器可读、链接到源码、不添加评论、增量写入、使用 anchor-id 标题、以清单播撒候选条目。

工作方式 流程采用混合模式:先运行 seed-layers.mjs,为每个专家子代理生成基于确定性扫描结果的候选清单({layer, docDir, count, items}),专家以此为完整性检查清单逐条记录;验证阶段则由 verify-coverage.mjs 做确定性的清单减文档比对,而非主观的 LLM 比较。若 @unwind/core 或清单不可用,则回退到旧的无种子派发加 LLM 缺口检测方式,流程仍可运行。

执行流程 第一步检查是否已有历史分析:若 docs/unwind/layers/ 已有内容,通过 AskUserQuestion 让用户选择“更新(刷新)”或“从头重启”。更新模式保留现有文档,专家会在 index.md 中添加“## Changes Since Last Review”并与当前扫描结果对账,属非破坏性操作;重启模式需用户二次明确确认后才会执行删除命令,仅删除分析产物,保留 architecture.md 和 scan-manifest.json。

第二步生成层种子文件。第三步解析架构文档,提取 repository.link_format 和 YAML layers 块,构建依赖图,跳过 status: not_detected 的层。第四步按依赖关系分阶段派发子代理:数据库 → 领域模型 → 服务层 → API 与消息(并行)→ 前端(可选)→ 单元/集成/E2E 测试(并行)→ 基础设施(并行)。每个子代理以种子清单为检查项,必须逐条记录,遗漏的条目需放入“## Excluded”并写明一行原因;允许补充扫描器遗漏的条目(如动态注册路由)。文档写入要求增量进行:先建目录,写初始 index.md 骨架,每分析完一个分区立即写文件并更新索引。

测试层会被拆分为 unit-tests、integration-tests、e2e-tests 三个种子,分别派发对应专家,仅处理存在的种子文件,输出到对应文件夹。基础设施层无依赖,也在该阶段派发,用于记录构建/依赖配置、运行时配置、程序入口/引导及部署运维资产。

验证与补全 全部层完成后运行 verify-coverage.mjs,生成 docs/unwind/.cache/coverage/{layer}.json(覆盖率与匹配方式),并为有缺口的层生成 gaps.md 工作清单。随后并行派发 uw-complete 代理按缺口补写文档,完成后删除 gaps.md。重复验证与补全循环,直到所有层达到 100% 覆盖(或剩余缺失项均为“## Excluded”中有合理说明的条目),由于比对是确定性的,循环可收敛且可复现。

收尾 达到全覆盖后,通过 AskUserQuestion 询问是继续规划(调用 unwind:uw-plan)还是暂停(提示用户之后输入 /uw-plan 恢复)。

适用场景 适合需要系统化理解大型代码库、按架构层次生成结构化文档并进行覆盖率审计的工程团队。限制:依赖前置扫描产物和 Unwind 插件环境;需要支持 Task 子代理的宿主;未提供关于收费、平台支持等进一步信息。