学习目标掌握用大模型拆解开源项目的方法理解SQL Bot核心产品逻辑能借助AI提取开源项目功能点并撰写PRD实现AI问数类产品最小可行性版本MVP的简易自研落地核心工具大模型Kimi/Tree/豆包1.8/codin、编程工具VS Code、原型工具Figma/墨刀、终端、飞书文档核心开源项目SQL Bot核心拆解对象、Sarkor bot关键前置指令how prompt用于拆解项目的专用提示词模板需提前准备就绪文档说明本文档基于开源项目拆解实操讨论内容整理所有步骤均为实操落地型零基础学员按步骤执行即可完成项目拆解与简易产品开发专业术语会附带通俗解释无需提前储备相关知识。第一部分 前期准备工作必做一、工具安装与配置所有工具均为免费/可试用版本零基础学员按“安装-基础配置”操作即可无需深入学习工具高级功能。编程工具VS Code操作官网下载安装无需额外配置仅需学会“打开文件夹/项目”“终端调用”基础功能即可。大模型工具二选一即可选项1Kimi搭配VS Code使用用于项目拆解、PRD撰写、代码辅助仅需注册登录即可使用选项2Tree豆包1.8/codin版本免费内置项目拆解功能注册登录后直接使用。原型工具Figma/墨刀二选一操作官网注册账号无需下载客户端网页版即可仅需学会“HTML文件导入”功能。基础工具终端电脑自带Windows为CMD/PowerShellMac为终端仅需学会cd切换路径、clone克隆项目两个基础命令飞书文档注册登录用于可视化项目流程图/时序图。二、项目与指令前置准备拉取开源项目到本地核心要求将SQL Bot、Sarkor bot两个开源项目通过clone命令克隆到本地电脑零基础可理解为“把网上的项目代码下载到自己电脑”验证拉取完成后用VS Code能打开项目文件夹即表示成功。准备how prompt指令核心要求将how prompt专用拆解提示词准备好可直接使用现成模板无需自己编写确保大模型能调用该指令验证在大模型中输入how prompt模型能响应拆解相关指令即表示成功。验证准备结果以上两项完成后在实操中可直接确认完成无需额外测试准备就绪后即可进入项目拆解环节。第二部分 开源项目核心拆解方法零基础核心步骤本环节是整个学习的核心核心逻辑为用how prompt指令大模型让AI帮我们完成项目的自动化拆解无需自己阅读一行代码零基础仅需按步骤执行即可最高效的拆解顺序为先执行how prompt指令再用工具打开项目辅助查看。步骤1克隆开源项目代码到本地打开电脑终端用cd 文件夹路径命令切换到你想存放项目的文件夹比如cd 桌面/开源项目输入clone 项目仓库地址命令等待代码下载完成终端显示“完成/成功”即止下载完成后在对应文件夹中能看到项目文件夹即表示克隆成功。零基础避坑若终端使用不熟练可直接用Tree工具内置的“克隆项目”功能可视化操作更简单。步骤2用工具打开项目并配置大模型VS CodeKimi配置用VS Code打开克隆好的SQL Bot项目文件夹在VS Code中关联Kimi大模型插件市场搜索Kimi安装后登录即可Tree配置直接打开Tree工具导入本地的SQL Bot项目Tree已内置豆包1.8/codin模型无需额外配置免费使用。二选一即可Tree操作更简单推荐零基础学员优先使用。步骤3执行how prompt指令开始拆解在配置好的大模型中Kimi/Tree输入how prompt指令并告知模型“帮我拆解这个SQL Bot开源项目生成完整的AI model usage analysis文档”等待模型执行完成模型会自动扫描项目所有代码生成一份完整的项目拆解文档——AI model usage analysis这是拆解的核心结果后续所有学习均基于该文档。零基础提示模型拆解耗时根据电脑性能而定一般5-10分钟无需操作等待即可。步骤4解读拆解核心结果AI model usage analysis文档模型生成的拆解文档包含项目所有核心信息零基础学员无需看懂代码只需重点解读4个核心板块按顺序看即可具体解读方法如下板块1项目基础信息包含项目名称、主要功能快速了解SQL Bot是做什么的核心功能AI生成SQL、数据库查询、数据可视化、数据分析/预测。板块2项目流程图/时序图核心作用看懂产品的用户使用流程比如用户在前端提问→系统调用API→大模型生成SQL→执行查询→返回结果→可视化展示可视化操作零基础必做模型生成的是Mommy语法文本绘图代码直接复制代码到飞书文档飞书会自动生成可视化的流程图/时序图无需自己绘制核心看什么重点看“用户前端→API服务→大模型服务→数据库→前端展示”的整体流转知道每个环节的作用即可。板块3系统架构图核心作用看懂项目的整体组成部分知道产品由哪些模块构成核心模块零基础只需记① 用户层Web前端、嵌入集成产品能嵌到其他平台② 服务层对话服务、大模型服务、数据服务、认证授权权限管理③ 底层数据源支持MySQL/Oracle等多数据库、lang chain框架、提示词模板库解读逻辑从上到下看知道“用户用什么→系统提供什么服务→底层靠什么支撑”即可。板块4项目提示词库核心重点模型会自动提取项目中所有的提示词模板这是SQL Bot的核心灵魂零基础学员只需分类查看无需理解具体编写逻辑后续自研产品可直接复用SQL生成提示词适配不同数据库MySQL/Oracle/Postgresql的SQL生成模板可视化相关图表生成、图表配置提示词数据分析相关数据分析、数据预测、问题推荐提示词权限相关数据源过滤、SQL权限过滤提示词其他动态SQL、术语模板、SQL插入模板基于RAG。第三部分 SQL Bot核心产品逻辑拆解零基础通俗理解看懂项目拆解文档后需理解SQL Bot的核心业务逻辑即产品怎么实现“用户提问→AI出结果图表”的这部分是后续提取功能点、写PRD的基础所有步骤均为通俗化解读无专业术语。一、SQL Bot核心业务流程一步一步懂用户在前端输入问题比如“按月份统计线索获客数据”后产品的完整处理步骤用户提问问题通过前端传到API服务系统创建一个对话实例数据源匹配系统识别用户要查询的数据库MySQL/Oracle等匹配对应的提示词模板SQL生成大模型结合「数据库表结构术语SQL示例」生成对应的SQL查询语句权限过滤系统对生成的SQL做权限校验剔除无权限查询的内容SQL执行执行通过权限校验的SQL从数据库中查询出原始数据并将数据原子化保存到数据库后续可直接调用图表生成大模型根据查询结果生成图表配置JSON前端根据配置渲染可视化图表结果展示将原始数据、可视化图表展示在前端用户可查看后续操作用户点击“分析/预测”大模型调用对应的分析/预测提示词生成分析结果并展示。二、核心设计亮点零基础需记住自研可直接复用SQL生成重试机制若生成的SQL执行失败查不出结果系统会把报错信息原有内容再次发给大模型让模型重新生成循环3次提升SQL生成的准确性原子化保存将「原始查询数据、图表配置、分析结果」分别保存到数据库的不同字段后续做仪表盘/二次查询时可直接调用无需重新计算多数据库适配为不同数据库编写专属的动态SQL提示词模板适配MySQL/Oracle/Postgresql等多种数据库可视化自主配置大模型根据查询结果自动匹配合适的图表类型柱状图/折线图等无需用户手动设置。三、设计待优化点零基础了解即可自研时可改进权限过滤逻辑不合理现有逻辑是「先生成SQL再做权限过滤」需要调用两次大模型响应速度慢优化方案在生成SQL前直接在数据库表结构中过滤掉无权限的内容一次生成即可使用小众可视化工具项目使用自研的开源BI工具小众大模型对其不熟悉需要编写大量约束提示词优化方案使用通用可视化工具如Echarts大模型训练数据多无需额外约束未限制查询结果长度直接拉取原始数据若数据量大会导致上下文过长模型响应慢优化方案在提示词中限制查询结果只拉取统计指标如SUM/AVG不拉取原始数据。四、关键术语通俗解释零基础必背专业术语通俗解释schema数据库的表结构包含表名、字段名、字段类型等RAG检索增强生成简单说就是“先从数据库中找相关信息再让大模型生成内容”避免模型编造信息动态SQL适配不同数据库的SQL语句因为不同数据库的语法有差异原子化保存把不同类型的数据原始数据/图表配置分开保存各自独立后续可单独调用提示词模板提前写好的提示词框架不同场景直接套用无需重新编写第四部分 功能点提取与PRD撰写零基础实操拆解完项目后无需开发完整的SQL Bot产品核心是提取其中的单个功能点比如“可视化图表生成”“SQL生成”借助AI撰写该功能点的PRD产品需求文档这是产品经理的核心工作零基础学员借助AI可快速完成核心原则先完成项目整体拆解再提取单个功能点避免信息遗漏。步骤1选择要提取的功能点零基础学员优先选择核心简单功能点比如可视化图表生成、AI生成SQL、数据结果分析不建议先选权限配置等复杂功能。步骤2用AI辅助撰写PRD给现成提示词直接复制使用前置条件确保大模型已完成SQL Bot项目的整体拆解对项目的流程/架构有清晰认知复制以下提示词到大模型Kimi/Tree仅需替换【要提取的功能点】即可我是一名产品经理正在设计一款AI问数类产品需要参考SQL Bot开源项目撰写PRD。请帮我分析该项目中【可视化图表生成】功能点按以下格式撰写该功能点的PRD要求内容详细、包含功能描述、用户故事、前置条件、后置条件、界面交互、业务流程、异常处理功能描述用户故事至少3个前置条件数据依赖/功能依赖/权限依赖后置条件系统状态/对话状态界面交互核心按钮/展示区域核心业务流程异常处理SQL执行失败/图表渲染失败等等待模型生成PRD生成的PRD可直接使用无需额外修改。步骤3PRD核心内容解读零基础需检查的关键点生成的PRD需包含以下7个核心部分确保信息完整后续开发可直接参考功能描述清晰说明该功能是做什么的能解决用户什么问题用户故事站在用户角度描述使用场景比如“我是运营想通过图表查看每月获客数据无需手动制作”前置条件该功能能使用的前提比如“已完成SQL查询有原始查询数据用户有查看该数据的权限”后置条件该功能使用后系统的状态变化比如“图表配置已原子化保存到数据库对话列表中记录该次操作”界面交互前端的核心元素比如“图表展示区域、图表类型切换按钮、数据详情展开按钮”业务流程该功能的单独处理步骤比如“查询结果→大模型生成图表配置→前端渲染→展示”异常处理功能使用中出现问题的解决方式比如“图表渲染失败前端提示‘配置格式错误’并展示原始数据”。第五部分 界面原型生成与工具转换零基础实操撰写完PRD后需要生成功能点的界面原型即产品的前端样子零基础学员无需自己绘制借助AI生成HTML原型代码再转换成Figma/墨刀的可编辑原型即可。步骤1AI生成HTML原型代码复制提示词即可在大模型中输入以下提示词替换【功能点】模型会生成包含「内联CSSJS」的完整HTML代码无需自己编写请参考SQL Bot开源项目的代码实现为AI问数产品的【可视化图表生成】功能点撰写前端界面原型用HTML编写包含内联CSS和JS实现核心界面图表展示区、数据详情区、操作按钮并对每个界面元素做说明。步骤2将HTML代码转换成可编辑原型Figma/墨刀二选一方法1Figma推荐打开Figma网页版新建一个文件在插件市场搜索html to design插件安装后打开选择“上传HTML文件”将AI生成的HTML代码保存为.html文件插件会自动将HTML转换成Figma可编辑的原型所有元素均可拖拽修改。方法2墨刀打开墨刀网页版新建一个项目找到「HTML转墨刀」工具粘贴AI生成的HTML代码或上传.html文件墨刀会自动生成可视化原型直接在墨刀中编辑即可。零基础提示两个工具的该功能均支持免费试用次数足够零基础实操无需付费。第六部分 最小可行性产品MVP自研落地零基础简易版若想实现产品的简易落地无需自己编写代码借助大模型Kimi/豆包做Web Coding基于撰写好的PRD让AI帮我们开发一个最小可行性版本MVP仅保留核心功能数据库关联、SQL生成、图表展示、数据分析零基础学员按步骤执行即可重点在调试。步骤1给大模型提开发需求复制提示词替换核心信息请帮我开发一个AI问数类产品的最小可行性版本MVP核心功能包含【数据库关联、AI生成SQL、可视化图表展示、数据简单分析】参考SQL Bot开源项目的逻辑要求支持MySQL数据库关联SQL生成失败时循环重试3次能根据查询结果自动渲染柱状图/折线图实现简单的数据分析功能开发前端简单界面能展示查询结果、图表、分析结论。步骤2AI开发与调试零基础核心技巧模型会生成完整的前后端代码学员只需将代码保存为对应的文件如.html/.py按模型提示运行即可常见bug及解决方法零基础遇错优先查这3点① 图表渲染失败大概率是图表配置格式错误/依赖库不全将报错信息发给大模型让模型修改配置代码② SQL执行失败检查数据库连接是否正确让模型重新生成SQL提示词③ 界面无响应让模型简化前端代码保留核心展示功能去掉复杂的交互效果。调试原则模型开发的代码大概率会有小问题将报错信息直接发给模型让模型自己修改一般修改2-3轮即可得到可用版本。步骤3产品核心功能测试可用简单的问题测试产品比如“按月份统计MySQL数据库中的线索获客数据”能实现**“提问→生成SQL→查询数据→展示图表→生成分析结论”**即表示MVP开发成功。第七部分 关键知识点与零基础避坑指南必看一、AI问数类产品的三大核心优化点自研必做做好这3点产品的核心体验就会大幅提升零基础学员自研时优先优化提升SQL生成的准确性给大模型提供「数据库表结构引擎信息术语SQL示例」并添加重试机制提升可视化精准度使用通用可视化工具Echarts减少大模型的约束提示词让模型自动匹配图表类型控制查询结果长度在提示词中要求大模型只返回统计指标SUM/AVG/COUNT不返回原始数据避免上下文过长。二、大模型使用避坑指南零基础最容易踩的坑避免给模型提供“无语义”的信息比如随机的字段名如data、URL后缀的随机字符串模型对无语义信息的处理能力差容易编造内容解决给字段/文件起有语义的名字如add_date添加日期提示词编写要“明确约束”比如让模型生成SQL时明确要求“仅生成查询语句SELECT禁止生成增删改INSERT/UPDATE/DELETE语句”并在提示词末尾再次强调不要让模型拆解超出其能力的内容用低阶模型拆解高阶项目结果会遗漏大量信息解决用Kimi/豆包1.8等高阶模型做项目拆解。三、产品开发避坑指南零基础需注意不要直接扔大PRD给AI开发万字以上的详细PRD包含大量规则模型无法兼顾开发的代码会出现大量矛盾和bug解决简化PRD只保留核心功能和流程让模型开发不要盲目复用小众工具/框架小众工具如项目自研的BI工具需要编写大量约束代码零基础难以调试解决优先使用通用工具/框架Echarts/MySQL不要忽略数据保存自研时一定要做原子化保存否则后续做二次查询/仪表盘时需要重新计算效率极低。第八部分 后续学习与答疑一、零基础后续进阶学习方向提示词工程学习简单的提示词编写技巧能根据自己的需求修改how prompt指令、SQL生成提示词基础编程知识学习简单的HTML/CSS/MySQL知识能看懂模型生成的代码简单修改bug产品设计基础学习PRD的标准撰写格式、产品流程图的绘制方法能独立完成简单功能的PRD撰写项目全流程调试尝试拆解更多的开源AI产品提取功能点并自研积累调试经验。二、常见问题快速解答克隆项目失败怎么办检查终端的文件夹路径是否正确项目仓库地址是否有效Tree工具可视化克隆更简单优先使用大模型拆解项目不完整怎么办在how prompt指令后添加“生成完整的AI model usage analysis文档包含项目流程、架构、所有提示词模板”让模型重新拆解图表渲染失败怎么办将报错信息直接发给大模型让模型修改图表配置代码优先使用Echarts等通用可视化工具AI开发的产品无法运行怎么办让模型生成“运行步骤说明”按说明逐步运行遇错直接将报错信息发给模型修改。三、实操答疑若在实操过程中遇到具体问题可将问题报错截图发给大模型Kimi/豆包或在相关学习社群提问零基础学员遇错优先让AI帮忙解决无需自己钻研复杂的代码问题。
