2026秋软工实践团队作业（一）

作业所属课程	H202601软件工程与软件工程实践
作业要求	2026秋软工实践团队作业-第一次（团队展示+选题报告+需求分析）
作业目标	通过团队协作与真实需求调研，完成以专业领域智能体（Agent）为核心的软件项目选题、方案设计和需求分析，明确项目功能、技术路线及实施计划，提升团队的软件工程实践能力
团队名称	组长说的都队
团队成员	任宝硕、黄亦博、吴莉芊、陈果、陈铮、向飞燕 卓滢、郭航铭、吴昊阳、颜志航、林烨、曾子瑞
GitHub 仓库	renbaoshuo/202601-software-engineering-lab

团队展示

我们的队名是「组长说的都队」。

▲ 小组合照

项目规划

团队项目 QueryPilot 选择 SQL 学习与查询诊断领域，主要面向正在学习数据库课程的大学生和需要调试基础 SQL 的初级开发者。我们希望帮助用户理解报错原因，发现查询结果与目标之间的偏差，并通过实际运行验证修改效果。产品采用 Web 应用形式，用户通过浏览器即可完成查询编写、运行和诊断。

团队访谈了几位目标用户群体的成员，收集他们近期遇到的 SQL 问题，了解原有解决办法，以及使用教材、搜索引擎或通用 AI 后仍未解决的困难。调研重点关注用户是否理解修改建议、如何判断查询结果正确，以及是否需要保存和恢复调试过程，并据此调整了我们预期实现的功能范围。

软件支持配置表结构、编辑 SQL 和运行查询。用户描述查询目标后，可以请求 Agent 诊断，查看解释、执行证据和修改建议，再自行修改并重新运行。工作台还将提供个人模型配置、本地会话历史和历史导入导出，通过工具轨迹与流式回答展示诊断进展。

智能体定制围绕 SQLTutorAgent 展开。团队计划整理 15–20 个经过核验的知识条目，覆盖 NULL、连接、聚合、子查询等规则和典型错误，保留来源及可复现示例，并采用 BM25 检索相关内容。Agent 将按任务需要调用 SQL 静态分析、表结构查看、沙箱执行和知识检索四类工具，结合真实结果解释问题。例如统计全部部门人数时，可以通过执行结果发现空部门被错误计数，再结合聚合规则说明原因，引导用户修改后验证。

评测计划准备约 30 个案例，划分开发集和独立留出集，对比通用模型、加入解析与执行反馈的模型，以及完整领域 Agent。团队将检查诊断解释、建议可执行性和知识引用是否可靠，保留失败案例与实际输出，用可复现的结果说明领域定制带来的变化。

团队愿景

我们希望通过软件工程实践，发挥各自所长，一起把项目从需求调研做到上线交付，为 SQL 初学者做出可用的软件。在这个过程中学会有效协作，养成认真测试、及时沟通的习惯，并对团队共同交出的成果负责。

成员风采

• 曾子瑞，学号102401514，性格老实极了、坚决服从组织安排，擅长 Vibe Coding、数据分析。
• 陈果，学号102401302，性格不详，能力不详，但可以逢山开路遇水搭桥。
• 陈铮，学号102401303，性格老实巴交，让往东就往东、让往西就往西，擅长 Vibe Coding。
• 郭航铭，学号102401335，性格纯正i人，能力不详，喜欢摸鱼发呆。
• 黄亦博，学号052402241，性格不详，擅长立正挨打。
• 林烨，学号102401513，服从安排「葱澄！」，擅长 Vibe Coding，喜欢玩游戏、摸鱼。
• 任宝硕，学号102401339，肯干能学，擅长前后端开发。
• 吴昊阳，学号102401337，性格不详，能力不详，但可以逢山开路遇水搭桥。
• 吴莉芊，学号102401301，性格实力不详但听话，擅长 Vibe Coding、整理资料，喜欢划船🚣、遛鸟。
• 向飞燕，学号102401304，性格老实芭蕉，擅长 Vibe Coding。
• 颜志航，学号102401217，才学浅薄但服从安排，擅长 Vibe Coding。
• 卓滢，学号102401305，才疏学浅、虚心求教，擅长 Vibe Coding、Java 后端，喜欢摸鱼。

（按拼音顺序排列）

团队分工

• 前端，负责 SQL 工作台、编辑器、结果展示、模型设置和本地历史等浏览器端功能，成员有陈铮、陈果。
• 后端，负责 API、Agent 任务编排、模型与工具接入，以及 SQL 沙箱执行，成员有卓滢、曾子瑞、郭航铭。
• 知识库，负责整理和核验 SQL 规则、典型错误与示例，维护知识条目及来源，支持 Agent 检索和引用，成员有吴莉芊、颜志航。
• Agent评测，负责设计案例与评分规则，对比定制前后的诊断效果，形成可复现的评测报告，成员有向飞燕、黄亦博。
• 产品，负责用户调研、需求范围和使用流程设计，并协调团队交付、整理用户文档和组织验收，成员有任宝硕、吴昊阳、林烨。

需求分析文档

我们编写的《QueryPilot 软件需求规格说明书》定义了一款面向数据库课程学生和初级开发者的 SQL 学习与诊断 Web 应用。用户可在浏览器中选择内置数据集、查看表结构、编写并运行 SQLite 只读查询；遇到报错或结果不符预期时，调用后端由大模型驱动的 SQLTutorAgent，结合静态分析、沙箱执行结果和领域知识库给出带证据的诊断解释，再自行修改并验证。设计上强调隐私与本地优先：会话和历史保存在浏览器本地，模型配置由用户个人提供且仅在单次请求中使用；诊断结论必须对应真实工具调用记录，执行仅限内置数据集上的只读查询。

全文共四章：第 1 章引言说明目的、范围和术语；第 2 章总体描述产品架构、功能、用户与约束；第 3 章为主体，规定界面、五个应用 API、SQL 编辑运行、Agent 诊断、知识检索、模型配置、会话历史、工具轨迹、流式回答等具体需求，以及性能、技术栈、安全和离线评测方案；第 4 章给出六个维度的验收操作。若关注产品功能可读第 2 章与 3.2 节，关注接口实现看 3.1 与 3.4 节，验收则对照第 4 章。

正文见项目仓库中的「QueryPilot 软件需求规格说明书」。