SuperAPI AI 工具集

uw-start

编程与开发

查看项目

更新于 10-30 10:34

技能介绍

uw-start 是 Unwind 工作流的入口技能,负责引导用户并驱动整个逆向工程流水线。它不重复实现各阶段功能,而是委派给对应的阶段技能;每个阶段结束时都有单独的继续/暂停关卡,用户始终掌握控制权。

用途 Unwind 将当前代码库逆向工程为一份重建规格,足以在另一技术栈中重建,同时保留数据模型、API 契约和业务逻辑。每个记录项都标注 [MUST] / [SHOULD] / [DON'T],完整性通过集合运算(扫描结果减去文档覆盖)验证,而非口头断言。

流水线 依次为 scan → analyze → grill(可选)→ plan → dashboard,每个阶段设置检查点。

使用方式 第一步:前置条件检查。运行命令确认是否在 git 工作树内;git 推荐使用,用于驱动源链接的 link_format,缺失时进入本地模式、链接会降级但仍可工作。检查 node 与 pnpm 是否可用;二者可启用确定性扫描器(@unwind/core),缺失时各技能优雅降级为纯 LLM 流程。同时确认当前目录是要分析的项目根目录。 第二步:判断是全新运行还是已有分析。检查 docs/unwind/layers/*/ 是否存在;已有分析时告知用户,由 uw-analyze 的 Step 0 前关卡处理“更新(刷新,非破坏性)”或“从头重启(删除先前文档,需明确确认)”的决策,uw-start 不在此处删除任何内容。 第三步:选择运行模式。通过 AskUserQuestion 询问用户:逐步执行并带检查点(推荐),一次运行一个阶段,在每个关卡由用户决定继续或暂停;或直接运行到仪表盘,按 scan → analyze → plan → dashboard 顺序不在关卡暂停,但仍遵守从头重启的确认(绝不自动删除),并在任何错误时停止。 第四步:启动。调用第一个阶段技能 unwind:uw-scan,然后按流水线推进。

阶段与产出

  1. 扫描:unwind:uw-scan,产出 architecture.md 和 .cache/scan-manifest.json。
  2. 分析:unwind:uw-analyze,产出 layers/**(已播种并验证到 100%)。
  3. 拷问(可选):unwind:uw-grill,产出 questions/*.md,攻击已记录的业务逻辑,向领域专家询问哪些不应被重建。
  4. 计划:unwind:uw-plan,产出 REBUILD-PLAN.md,就目标技术栈、复用与分阶段采访用户。
  5. 仪表盘:unwind:uw-dashboard,构建 rebuild-graph.json 并启动查看器。
  6. 构建(可选):unwind:uw-build,在目标技术栈中执行重建,并生成源→目标验证图以衡量完整性。

模式说明 逐步模式:调用 unwind:uw-scan,然后根据用户对每个阶段继续/暂停提示的回答进行操作。grill 为可选且从不自动运行;覆盖循环结束后可提议 unwind:uw-grill,它在计划之前运行,查找不应被重建的业务规则(过时变通方案、无法解释的常量、矛盾),将只有领域专家能解决的问题写入 docs/unwind/questions/;若用户只需规格可跳过。 直接到仪表盘模式:依次调用各阶段并在关卡自动继续,直到仪表盘启动;仅在重启确认、计划采访(目标技术栈与复用由用户决定,uw-plan 可通过“接受所有推荐默认值”一次性完成)或错误时暂停。 unwind:uw-graph 是可选导出(不启动服务器的原始 rebuild-graph.json,用于静态部署、CI 或分享),不是必需阶段;仪表盘自身会构建图。

后续操作 执行重建:在计划(及图审查)之后运行 unwind:uw-build,在目标技术栈中实际重建代码库;它会就范围/顺序采访用户,分派与技术无关的逐层构建代理,将进度保存在 docs/unwind/.cache/rebuild-state.json,并维护源→目标验证图衡量完整性;可逐步执行,或通过 /loop 技能(/loop /uw-build)循环直到测得的完整性达到目标。 代码变更后,运行 unwind:uw-refresh(增量)或重新打开 unwind:uw-dashboard(从当前扫描和文档重建图)。完整技能索引见 unwind:uw-help。

限制 需在代码库目录中运行;git 与 node/pnpm 缺失时功能降级。grill 与 build 为可选阶段。重启从头需明确确认,不会自动删除。