第一部分需求研究产品需求文档一、需求研究1.开发背景以前做软件开发所有代码都要我们自己一行行手动敲出来工作量特别大后续排查bug、调试程序也要耗费很久。这次我们用Vibe Coding这种新开发方式把写代码的工作交给AI来做。我们小组只负责定好整体方案检查AI写出来的代码再把程序里的问题修好省下大量写代码的时间完整走完一整套开发流程。2.我们的目标把软件开发一整套流程梳理明白拆分好每一步要做的事。全程用文字把要求发给AI让它自动生成代码我们尽量少手动写代码。从头到尾做完练习从构思需求把程序做出来再写好开发博客并发布。3.功能与使用要求我们练习开发流程梳理通用内容基础功能能够读取本地文件、自己调整各项参数、执行处理任务、保存处理好的文件同时自动留下运行记录。稳定性程序不能动不动闪退处理完的文件也不能破损、打不开。运行速度处理普通任务不用等待太久满足日常使用。操作门槛页面逻辑简单没有基础的人也能轻松上手。二、产品需求文档1.项目名字跟着Vibe Coding模式完整走完软件开发流程2.核心目的用AI工具做软件开发我们只用把需求描述清楚剩下的代码全部让AI自动生成。小组人员只负责规划整体方案、检查代码、修复程序漏洞尽量减少手动敲代码完整走完软件开发、反复修改优化、撰写并发布技术博客的全部步骤。3.整套流程内容文件的导入可以打开电脑里的本地文件常见格式全都能识别。参数的设置留出可调整的选项使用者能自己改动各项运行条件。任务的运行调用程序内部的核心工具全自动完成文件处理。结果的导出把处理好的文件保存下来并且自动记录每一次操作的运行记录5.开发规则开发方式按照Vibe Coding来做人定方案AI负责编写代码。所用技术使用Python语言搭配对应的工具内核完成开发。最终交付可以正常运行的程序再加上记录整个开发过程的技术博客。技术设计文档Tech Design根据PRD确定实现的技术以及大致技术架构。一、 创建一个test.md 文件在VS Code中实现具体步骤如下打开项目文件夹1 打开 VS Code左上角点击「文件 (File)」→「打开文件夹 (Open Folder)」2 选中本地记账项目根目录点击「选择文件夹」左侧资源管理器加载项目文件树2. 新建技术设计文档文件1 左侧资源管理器右键项目根目录空白处2 选择「新建文件 (New File)」3 文件名输入 test.md 回车自动生成 Markdown 格式文档编辑文档1 点击文件即可进入编辑区粘贴技术设计内容2 保存4. 预览文档可选编辑区右上角点击「打开预览」图标分屏实时查看排版效果二、 test.md 正文内容包含·技术栈选择前端用什么、后端用什么、数据库用什么可以问AI“我要做一个XX应用应该用什么技术栈”·项目结构代码怎么组织·数据模型需要存储哪些数据·关键技术点有哪些技术难点需要注意设计技术文档可能如下第三部分AI代理指令一、AI代理指令制定原则需求明确指令必须明确技术栈、功能范围、参数要求、性能标准、适配场景等。不给予AI自由发挥空间确保AI输出内容完全匹配开发要求。权责分离人工负责架构设计、需求整理、参数定义、代码审核、bug修复AI负责代码、注释、脚本编写减少人工手动编码工作量。支持迭代AI指令需预留迭代空间要求生成的代码模块化、低耦化、注释完整预留扩展接口支持后续优化方便人工二次修改与迭代维护。统一标准代码命令、注释、目录结构保持统一提升可维护性。二、通用标准化 AI 代理指令总开发指令根据项目需求文档和技术设计方案基于指定技术栈完成软件开发。所有基础代码由 AI 生成我方仅负责方案审核、bug修复、逻辑校验、与功能优化。程序需包含完整的基础功能和简洁的操作逻辑运行稳定无崩溃并配备完整的运行日志记录功能支持后续迭代拓展。分模块开发指令将项目拆分为多个独立低耦合模块独立开发各模块功能互不冲突、结构清晰第一 文件导入模版实现文件读取解析兼容本地文件格式第二 参数配置模板提供可自定义的参数配置功能支持用户自行调整第三 核心业务模板实现项目核心业务逻辑处理保证功能完整可用第四输出日志模板保存处理结果自动记录操作流程、运行状态异常报错。代码规范指令遵循对应编程语言规范统一命名、缩进格式关键逻辑和函数配有清晰注释说明功能用途、参数含义等删除冗余代码封装公共逻辑提升代码可读性、复用性与可维护性。异常处理指令为程序添加完善的异常捕获和容错机制覆盖文件加载、参数校验、业务运算、结果导出全流程自动捕获异常并记录日志避免程序闪退、崩溃、卡死异常给出提示保证输出文件完好。迭代优化指令首轮功能开发完成后依据测试情况迭代优化修复报错、卡顿、兼容异常等问题提升程序处理简化操作逻辑降低使用门槛完善日志体系提升稳定性。三、AI 指令执行流程整套开发采用闭环式 AI 辅助开发流程步骤如下指令下发按模块拆分下发顺序是基础功能开发、核心逻辑实现、异常处理、迭代优化不一次性堆叠需求。生成代码AI 根据单条指令输出完整、可运行、带注释的模块代码。人工审核人工核对功能完整性排查逻辑漏洞修复bug。循环调化针对所有问题再次下发优化指令反复迭代直至项目功能、稳定性、性能全部达标。第四部分补充全流程收尾一. 程序测试流程功能测试逐项验证文件导入、参数配置、任务处理、文件导出、日志记录五大核心功能稳定性测试批量长时间处理文件验证程序是否闪退、文件是否损坏边界测试测试超大文件、异常格式文件、极端参数下程序运行状态异常测试主动制造文件缺失、参数错误等场景校验异常捕获与日志记录能力。二. Bug 修复流程统一记录缺陷写明报错场景、复现步骤、预期运行效果整理优化指令提交 AI 重写对应模块代码代码更新后复测确认问题完全解决方可进入下一阶段。三. 程序打包交付使用 Python 打包工具将源码打包为独立可执行程序无需用户本地配置 Python 环境配套简易使用说明标注操作步骤、可调参数、日志文件存放路径。