项目实训个人博客（三）

本周是多智能体协同 AI 剧本杀实训项目推进的第三周在前两周完成项目核心功能确定、业务模块拆分、编写开发者文档的基础上本周工作重点转向项目代码骨架搭建。我依据前期定稿的开发者文档使用 Cursor 开发工具结合自行编写并归档在飞书文档的代码生成专属提示词引导 AI 按照模块划分依次生成各部分初始代码完成整合调试后搭建起整个项目的基础开发框架。本次自行编写的 Cursor 代码生成提示词归档链接https://ncn0fqvondhh.feishu.cn/wiki/BQTXwme01iXb1IkUIlNc0o0TnGc一、本周核心工作依托自研提示词与开发者文档完成代码生成及框架搭建本周围绕规范梳理、顺序规划、代码生成、框架整合四个环节开展工作以开发者文档为设计依据以自制提示词为编码标准借助 Cursor 完成项目基础代码的落地搭建。1. 梳理自制提示词统一项目编码规范首先我对自己编写并记录在飞书文档中的提示词内容进行完整梳理这套提示词专门适配本次多智能体 AI 剧本杀项目明确了整套代码编写的约束标准明确项目所用技术栈适配要求、框架版本及第三方依赖引入规则制定统一的项目目录层级、模块划分方式、文件与变量命名规范规定代码注释标准要求关键函数、核心逻辑都附带功能说明与参数解释便于后期阅读维护针对多智能体业务特性制定智能体类结构设计、模块间交互格式、预留扩展接口的编写要求遵循高内聚低耦合原则规范各模块独立开发标准为后续功能迭代预留拓展空间统一基础代码输出格式保证生成的代码具备初始化运行能力包含基础配置、数据模型与通用工具封装。通过梳理提示词内容确立了整套项目开发的统一编码规范为后续代码生成和团队协作开发建立统一标准。2. 参照开发者文档规划模块代码生成顺序结合第二周拆分的业务模块与架构设计文档我规划了从底层到上层、从核心到外围的代码生成顺序保证框架搭建逻辑合理、层级清晰底层基础模块通用工具类、全局配置、日志封装、统一异常处理、数据库基础连接与数据模型多智能体核心模块总管理智能体、审核智能体、编剧智能体、主持人智能体、NPC 智能体、多媒体生成智能体、复盘归档智能体架构调度模块多智能体协同调度层、大模型 AI 服务对接层后端接口模块路由配置、请求参数封装、统一响应格式定义项目入口模块主程序启动文件、全局路由注册、环境变量整合配置。按照该顺序依次生成代码能够让底层支撑模块优先搭建完成上层业务模块可直接依赖复用减少后期代码调整和重构的工作量。3. 使用 Cursor按模块逐一生成初始代码整理好规范与开发顺序后我将自制提示词约束要求和项目开发者文档架构说明同步到 Cursor 中按照规划顺序逐个模块生成初始化代码为七大智能体分别生成独立代码文件、基础类结构、核心方法框架以及模块间消息交互预留接口搭建 FastAPI 项目基础骨架、LangGraph 多智能体调度基础逻辑完成数据库实体模型初步定义生成公共工具函数、全局常量、数据校验工具类完善项目底层通用支撑能力对照提示词规范核对 AI 生成代码的风格、目录存放、注释格式对不符合设计要求的内容进行调整修改。借助 Cursor 的 AI 编码能力高效完成了重复性模板代码的编写重点聚焦架构合理性与代码规范校验。4. 整合全模块代码搭建项目完整基础框架各模块初始代码全部生成完成后我对所有代码文件进行统一整理与整合按照预设的项目目录结构对代码文件进行分类归档、规整存放整合全局路由配置、环境变量参数、数据库连接配置完成项目基础配置闭环梳理各模块之间的依赖关系补充模块间调用接口与数据传递基础格式清理冗余、重复代码统一全项目代码缩进、命名风格与注释格式最终完成了结构完整、层级清晰、符合设计规范的项目整体基础开发框架。5. 本地运行测试优化框架结构框架搭建完成后在本地进行项目启动测试检查项目运行状态、代码语法报错、目录结构规范性。针对 AI 生成的不合理代码结构、冗余逻辑以及模块耦合问题进行微调优化保证项目框架可以正常启动运行满足后续业务逻辑开发的基础要求。二、本周收获与不足收获熟练掌握了自制提示词配合 AI 开发工具生成项目模块化代码的流程能够通过自定义规范约束代码输出风格与质量完整走完从架构文档设计到代码框架落地的全过程对多智能体项目的目录划分、模块依赖关系有了更清晰的认知借助 AI 工具简化了基础模板代码编写工作提升了项目框架搭建的效率为后续团队分工开发节省了大量时间建立了统一的项目开发规范为后续多人协作开发、代码风格统一奠定了良好基础。不足目前仅完成各模块基础代码骨架多智能体之间协同交互的核心业务逻辑还未进行细化填充部分模块的接口参数只做了基础预留还需要结合实际业务场景进一步细化完善框架搭建完成后配套的结构说明文档没有同步更新后续需要补充完善。三、下周工作计划将搭建完成的项目基础框架同步共享给小组成员作为团队统一开发基线按业务模块细化拆分开发任务基于现有框架进行具体业务逻辑的开发填充统一规范模块间接口调用标准与数据传输格式保障各模块后期能够顺利联调优化完善提示词细节补充边角功能模块代码进一步完善项目整体框架跟进项目整体开发进度协调解决开发过程中出现的依赖冲突、架构适配等问题。四、总结第三周是项目从设计文档落地到代码框架的关键过渡阶段。本周依托前期开发者文档结合自行编写的代码生成提示词通过 Cursor 完成了各功能模块初始代码生成同时完成代码整合、调试优化搭建起项目完整的基础开发框架。目前项目整体架构骨架已经成型具备了业务功能开发的基础条件。下周团队将基于现有框架正式开展各模块具体业务逻辑的开发工作稳步推进实训项目有序落地。