反向提示:如何使用现有前端恢复 PRD 和架构
需要时
您得到的前端没有文档:需要重写的遗留项目、承包商的 MVP,或者两年前您自己的代码。在进行任何更改之前,您需要了解产品的功能:哪些屏幕、哪些脚本、哪些验证规则、调用哪些 API。反向提示是从代码中收集事实并将其传输到模型,以恢复需求。
我们谈论的是您可以合法访问的代码。为了复制而从缩小的捆绑包中恢复别人产品的需求会导致法律问题和糟糕的结果:从捆绑包中并不清楚为什么产品要这样设计。
为什么“读取存储库并编写技术规范”不起作用
在具有数百个文件的项目中,代理要么不会读到底,要么会用源填充上下文并开始从它遇到的第一个文件进行概括。结果,PRD 描述了二十个屏幕中的三个,并自信地提出了其余的屏幕。需要一个中间层:压缩清单,您将使用脚本收集并检查它。
步骤 1. 库存路线
对于 Next.js 应用程序路由器:
find app -name 'page.tsx' -o -name 'page.jsx' | sed 's#/page\.[jt]sx$##; s#^app##' | sort > docs/re/routes.txt find app -name 'route.ts' | sort > docs/re/api-routes.txt
对于 React Router,找到路由声明:
grep -rn --include='*.tsx' -E 'path:\s*"|<Route ' src | sort > docs/re/routes.txt
步骤 2. 网络调用
grep -rnE --include='*.ts' --include='*.tsx' \ 'fetch\(|axios\.(get|post|put|patch|delete)|useQuery|useMutation' src app \ > docs/re/network-calls.txt
静态搜索看不到动态收集的 URL。用真实流量对其进行补充:在打开“网络”选项卡的浏览器中浏览基本场景并保存 HAR。在传输模型之前,请清除 HAR 中的 cookie、授权令牌和个人数据。
步骤 3. 验证表格和规则
grep -rnE --include='*.ts' --include='*.tsx' \ 'z\.object|yup\.object|useForm\(|required:|pattern:' src app > docs/re/validation.txt
验证方案是业务规则最密集的来源:最小长度、电话格式、必填字段、字段之间的依赖关系。
步骤 4. 分部分传输模型
不要一次发送所有内容。先上产品图:
Ниже список маршрутов приложения и список сетевых вызовов с путями к файлам. Составь карту продукта: 1. Группы экранов по пользовательским задачам. 2. Для каждого экрана: назначение, откуда на него попадают, какие API вызывает. 3. Роли пользователей, если их можно вывести из маршрутов (admin, dashboard и т.п.). Правила: - Каждое утверждение помечай [код: путь/к/файлу] или [гипотеза]. - Если назначение экрана неочевидно из названия и вызовов, напиши "не определено" и укажи, какой файл нужно прочитать, чтобы это выяснить. - Не придумывай функциональность, которой нет во входных данных.
然后,对于每组屏幕,一个单独的请求,其中仅包含这些文件的源以及描述场景、状态(空、加载、错误、无权限)和验证规则的任务。
步骤 5. 组装 PRD
将生成的文档保持在固定结构中非常有用,以便可以在迭代之间进行比较:
# PRD: <продукт> (восстановлен по коду, дата) ## Пользователи и роли ## Сценарии ### <Сценарий>: шаги, экраны, API, правила, ошибки ## Модель данных (по ответам API и типам) ## Внешние интеграции ## Нефункциональные наблюдения (авторизация, кеширование, i18n) ## Открытые вопросы ## Расхождения и подозрительные места
差异部分通常是最有价值的:客户端上的验证不存在于服务器上;没有链接的屏幕;其响应未在任何地方使用的 API 调用。
步骤 6. 检查
该模型自信地写出看似合理的东西。需要验证:
- 随机选取五个标记为
[код: ...]的语句并打开指定的文件。 - 与产品所有者确认所有要点
[гипотеза]或将其移至未解决的问题。 - 使用 PRD 亲手经历一个场景 - 从输入到结果。如果步骤与实际情况不符,请返回到相应的屏幕组。
架构与需求分离
架构描述(层、状态管理、处理数据)是另一项具有不同输入的任务:目录树、package.json、程序集配置、每种类型的几个特征文件。不要在同一查询中将其与 PRD 混合:模型将开始描述技术细节而不是产品行为。
该方法的局限性
代码显示了产品的功能,但没有显示其原因。商业原因、法律要求、与合作伙伴的协议无法从前端恢复。您无权访问的后端逻辑仅以请求和响应的形式可见。如果产品负责人有空,与他就完成的 PRD 草案进行一小时的对话将产生更多的提示迭代。
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.