SuperAPI AI 工具集

vibe-coding-doc-appflow

前端与建站

查看项目

更新于 10-15 16:43

技能介绍

用途:该技能用于生成 APP_FLOW.md,为应用绘制完整的屏幕与用户旅程地图,涵盖每个屏幕、每条路由和每个用户旅程。

主要能力:生成内容包括总览(屏幕总数、入口点、是否需要登录)、屏幕清单表格(屏幕、路由、鉴权、用途)、导航结构树、每个屏幕的定义(路由、鉴权、布局、用途、所需数据、加载/成功/空/错误四种状态、主操作、来源与去向导航、模态框)、用户旅程(含正常路径与错误路径)、模态与浮层表格、错误处理表格。

使用方式:技能会先做前置检查——读取 ./docs/PRD.md 获取功能与用户故事;若不存在则回退到无 PRD 模式,读取 progress.txt,并在文档顶部注明未经 PRD 生成;若 progress.txt 中 has_frontend 为 false 则走仅 API 模式;若是单页应用则走 SPA 模式。随后列出所有屏幕、定义导航结构、逐屏编写定义、梳理用户旅程、记录模态框,保存到 ./docs/APP_FLOW.md,展示前 20 行预览,并运行校验清单,最后询问批准或修改。

特殊处理:无 PRD 时直接从 progress.txt 读取功能列表;仅 API 项目用端点清单替换屏幕清单,用请求流程替换导航结构,用 API 调用流程替换用户旅程,并跳过模态框与加载/空状态;SPA 项目用状态/视图转换图替换导航结构树,并注明是单页架构。

生成规则:每个 PRD 功能至少对应一个屏幕;每屏具备四种状态;每屏定义来源与去向导航;用户旅程覆盖正常路径与主要错误场景;不留 TBD。

限制:具体收费、价格、平台与效果资料未提供;该技能依赖 PRD.md 或 progress.txt 等前置文件,缺失时准确度可能下降。