SuperAPI AI 工具集

uw-plan

编程与开发

查看项目

更新于 10-30 09:34

技能介绍

用途 uw-plan 用于把“层分析”的产物转化为一份战略重建计划,回答的是“如何重建”,而非“重建什么”。它要求所有已检测到的层都已完成分析、验证覆盖报告也已存在之后才使用。此技能不替用户做战略决策;目标技术栈、保留与重建的取舍、迁移方式、分阶段顺序和风险容忍度等事项,都由用户通过访谈确认。

主要能力

  1. 生成确定性简报:运行 plan-brief.mjs,在 docs/unwind/.cache/plan-brief.json 中生成项目名、语言、复杂度、文件数、当前技术栈(语言、ORM 来源、端点方法)、各层文件/覆盖率/[MUST]/[SHOULD]/[DON'T] 统计、数据模型与 SQL DDL 等契约、导入图(基础叶子与枢纽)、整体就绪度。
  2. 依赖清单核对:读取 package.json、requirements.txt、pyproject.toml、go.mod、Cargo.toml、pom.xml、*.csproj 等,得知当前具体的框架、校验、鉴权、队列、HTTP 客户端与测试运行器,以便在访谈中推荐具体模块而非泛类。
  3. 分层访谈:按依赖顺序一次问一个决策(或一组紧耦合决策),每个问题把基于数据得出的推荐项放在首位并标注 (Recommended),能由简报回答的问题直接跳过;首个问题提供“接受全部推荐默认值”选项,便于快速完成。
  4. 目标栈深挖(B1):语言与运行时、后端框架、API 契约风格、数据存储与数据访问、前端框架(若存在前端层)、各横切关注点模块(鉴权、校验、消息/队列、缓存、定时任务、邮件通知、文件存储、可观测性、测试框架)、托管/部署目标、高层架构确认;最后完整复述整套栈并取得一次确认。
  5. 复用与分阶段(B2):数据库策略(保留在线库/快照恢复/同步)、前端保留或重建、测试复用或重写、需保留的集成与定时任务、分阶段优先级与顺序(按导入图基础优先)、验证方式与风险容忍度。
  6. 记录与产出:回答问题累积记录,写入 docs/unwind/.cache/rebuild-decisions.json(含 id、topic、question、recommended、chosen、rationale);生成 docs/unwind/REBUILD-PLAN.md,包含目标栈表格、执行摘要、战略决策、分阶段策略、验证策略、决策记录表和层文档引用表;必要时更新 docs/unwind/architecture.md。

使用方式 先完成层分析与验证,确保 docs/unwind/layers//index.md 存在;然后运行简报脚本(需先定位 Unwind 插件根目录并加载 core helper),读取 plan-brief.json 与架构文档并核对依赖清单;向用户简述简报事实后,按 B1、B2 顺序进行访谈;最后写入计划与决策 JSON。若脚本以非零退出,则回退为直接读取 scan-manifest.json、coverage/.json 与层文档中的标签;若这些也不存在,则依据层 index.md 给出近似简报并说明。已有计划时进入刷新模式:仅重新确认被新简报推翻的决策,并记录自上次以来的变化。

适用场景 已完成分层分析与验证、准备规划重建的中大型代码库迁移项目;需要与团队共同确定目标技术栈并留下可追溯决策记录的场景。

限制 仅用于规划阶段,不做实际代码重建;若前序分析或覆盖报告缺失,计划只能以近似方式给出,并需标注覆盖率不足的层为暂定;计划严禁抄录层文档中的表格或代码,只做引用;不编造简报中没有的数据。