用途:这是 Vibe Coding 逆向工程流程的第二阶段(RE Stage 2),目标是通过读取源码文件,对代码库建立经过验证的理解,覆盖 8 个分析领域,为后续生成文档做准备。
前置条件:先读取 progress.txt 获取 vibe-coding-re-scan 的扫描结果;所有文件读取都使用 vibe-coding-explore,只对文件做 smart_outline、对关键符号做 smart_unfold,不要读取完整代码文件。
八个分析领域:1)框架与技术栈:读取 package.json/requirements.txt、框架配置、tsconfig.json,提取精确版本、主要依赖、TypeScript 严格模式与构建配置。2)数据库结构:读取 prisma/schema.prisma、drizzle/ 模式、models/、最新迁移文件,提取模型/表、字段与类型、关系、索引、枚举。3)API 端点:读取 app/api/、pages/api/、routes/、controllers/,提取每个路由路径、HTTP 方法、认证要求、简要说明与请求/响应结构。4)认证:先识别框架再读取对应文件(Next.js/React、Vue/Nuxt、Angular、Django、FastAPI/Flask 各有指定位置),提取认证库、流程、会话存储、受保护路由机制与用户角色。5)前端组件树:按框架读取对应目录,提取共享布局结构、UI 组件清单、状态管理方式与数据流。6)业务逻辑:读取 lib/、utils/、hooks/、services/,提取核心算法、业务规则、数据转换与关键自定义 hook。7)集成:读取 lib/[service].ts 与环境变量引用,提取外部服务、初始化模式及使用这些服务的功能。8)CSS 与设计系统:读取 globals.css、tailwind.config.*、variables.css 及 3-5 个示例组件,提取 CSS 方案、:root 中的 CSS 变量、配色、排版与样式一致性。
置信度:High 表示代码中明确或显而易见;Medium 表示由模式推断、可能有缺口;Low 表示代码极少、需大量猜测。
验证步骤:先向用户展示分析摘要并等待确认,摘要包含框架、数据库、API、认证、前端、业务逻辑、集成、样式各项及置信度,并列出低置信度缺口,询问是否正确、是否需要修正,用户回复修正或“looks good”后继续。
保存与交接:将 PHASE: REVERSE-ENGINEER、STATUS: analysis_complete 及框架、数据库模型、API 端点数、认证方式、组件数、集成、CSS 方案、是否有设计令牌、字体名、整体置信度、缺口等写入 progress.txt,然后激活 vibe-coding-re-generate。
限制:资料未提供该技能的收费、价格、平台支持范围与具体效果信息;其分析结果依赖扫描阶段输出,低置信度领域可能需要用户补充信息。