狂想曲委员会——代码规范、Alpha 冲刺任务与计划
狂想曲委员会——代码规范、Alpha 冲刺任务与计划
| 这个作业属于哪个课程 | 软件工程实践 |
|---|---|
| 这个作业要求在哪里 | 团队第四次作业:站立式会议+α冲刺 |
| 这个作业的目标 | 统一开发规范与接口,确定七天 Alpha 任务、五人职责和 AI 技术员使用方式 |
| 其他参考文献 | 作业指定参考:《阿里巴巴 Java 开发手册》v1.3.0、华为代码规范、《构建之法》第 2、13 章;阅读及采用情况由成员补充 |
团队:狂想曲委员会
项目:《福大秋日狂想曲》
计划周期:2026 年 10 月 23—29 日
文档内容:冲刺范围、开发规范、实名分工、每日目标与验收方式。
一、Alpha 阶段目标
本次做一个能通过正常操作游玩的校园题材游戏切片。程序优先,使用占位画面完成开局、日期与属性展示、活动结算、两餐、短剧情、一个小游戏及存读档,再测试和打包。完整八周剧情、全部结局与正式音画资源留到后续。
本次程序切片为 7 个游戏日。网页界面用于快速检查同一业务核心的行为;Ren'Py 界面、引擎存档、字体与发行包在引擎中另行验收。
本周不拍游戏实景、人物、CG 或宣传素材。每日真实站会照片仍按要求保留,每天程序截图从实际运行界面采集。
二、代码与协作规范
以下是本工程建议采用的 Python/Ren'Py 实施规范,参考通用命名、职责划分、异常处理和协作思想,不照搬 Java 专属语法要求。
- 编码与命名:文件采用 UTF-8;Python 缩进统一四个空格;模块、函数和变量使用
snake_case,类使用PascalCase,常量使用UPPER_SNAKE_CASE。界面文案使用中文,标识符尽量使用语义清楚的英文。 - 模块职责:业务核心处理状态与规则;配置集中存放活动参数、初始值和切片长度;剧情处理条件与选择;界面只收集输入和展示结果。网页验证界面与 Ren'Py 调用共同核心,避免维护两份不同规则。
- 状态边界:日期、时段、属性、资金、事件标记属于当前游戏状态。跨周目记录与普通存档分开设计;首日仅明确边界,未实现的持久化不得标记为完成。
- 输入与结算:开局输入、活动类型、资金和精力不足等情况要有明确反馈。错误操作不得修改状态;同一结算不可重复发奖。活动数值是当前 Alpha 实现基线,调整时同步文档和测试。
- 注释与错误:注释解释规则原因和边界,不重复代码。禁止吞掉全部异常或把报错当作正常完成;开发日志保留足够诊断信息,不写入账号口令。
- 资源管理:占位资源集中引用,文件名稳定,便于后续替换。发行包只使用来源与授权清楚的外部素材。
- 提交规则:每个任务建立真实 Issue,写清验收条件;本人核对后用本人账号提交,提交信息建议为
feat(core): 增加日程推进 #实际Issue编号。示例中的编号须替换为真实编号。 - 合并与复核:每人先运行本模块检查,再由另一人看边界与接口。每日集成后保留实际运行截图,测试失败与已知问题如实记录。
- AI 产出:AI 生成代码、用例和文案标明来源;代码执行结果以实际报告为准,负责人承担对应模块的维护、测试和修改。
三、五人分工
本次按五位成员安排以下职责。负责人负责模块复核与后续开发,首日工程生成与检查由 AI 协助执行;实际投入和工作量比例在总结时依据真实记录统计。
| 成员 | 主责 | 首日职责与验收 | 次日重点 |
|---|---|---|---|
| 林宇杰/102400222 | 核心逻辑与集成 | 核对状态、日期、属性和活动接口;维护冲刺规范与任务范围 | 复核活动成本、收益与次日推进 |
| 陈材臻/022401402 | 配置与存档 | 核对配置与状态字段,区分普通存档和永久记录边界 | 原生保存读取与状态一致性实测 |
| 彭杰/162304124 | 剧情与事件 | 接手开局与日常循环脚本,确定剧情接入位置 | 事件条件、选项与好感变化 |
| 连伟成/102400219 | 界面与交互 | 检查菜单、开局和属性面板,整理截图与博客 | 活动选择、禁用原因和反馈 |
| 叶全祺/102400230 | 测试、小游戏与交付 | 复核自动检查及报告,整理原生人工验收项 | 小游戏操作、计分与回归用例 |
首日任务按截图格式整理在 Issue 任务记录,含依赖、状态、验收结果及文件证据。
全员提供自己模块的代码与验证证据。AI 技术员单独记录,不能把同一批 AI 产出直接折算成五名成员各自完成的开发量。
四、七天任务与验收
| 日期 | 当天重点 | 可检查成果 | 博客安排 |
|---|---|---|---|
| 10/23 · Day 1 | 规范、分工、接口与工程骨架;菜单、开局、日期和属性;自动检查入口 | 新游戏能显示初始状态;自动检查可执行;区分网页验证和引擎验收 | 合集、规范计划、Day 1 |
| 10/24 · Day 2 | 活动成本与收益、精力检查、次日推进、基础存读档 | 完成活动并推进日期;保存读取恢复关键状态 | Day 2 |
| 10/25 · Day 3 | 两餐、资金与打工;小游戏操作和结算 | 完成一个日循环;资金不为负;同餐不重复支付 | Day 3 |
| 10/26 · Day 4 | 事件、剧情分支、好感;永久记录与重复结算防护 | 正常触发剧情;不同选择产生对应结果;验证记录边界 | Day 4 |
| 10/27 · Day 5 | 串通整个切片;首个 Windows 包;整理测试与演示材料 | 无调试跳转能完成演示;构建包完成启动检查 | Day 5 |
| 10/28 · Day 6 | 停止新增功能,修复与回归;换机测试、答辩预演 | 候选包可运行;测试用例和实际结果可复现;PPT 与共享评审表就绪 | Day 6、独立测试随笔 |
| 10/29 · Day 7 | 固定最终版本,核对贡献、附件与链接,正式提交 | 程序、仓库和演示版本对应;11 篇文章与附件可访问 | Day 7、独立总结 |
时间不足先停止新增扩展功能,缩短剧情与装饰工作,保留正常流程、存读档、一个小游戏、测试和每日真实证据。取消或延期的任务单独注明,不把它们计作已完成。
五、AI 技术员如何参与
本次使用 AI 协助建立工程骨架、编写状态与活动规则、创建自动检查、整理接口与博客。团队提供需求与限制,AI 输出代码及文档,各模块负责人分别承担后续复核、维护与开发。
每次记录“任务与输入摘要—AI 输出—人工修改—验证结果—关联提交”。例如,让 AI 生成资金不足的用例后,成员需核对失败时状态是否保持不变,再实际执行,而不是仅采纳一句“测试已通过”。发现 AI 误解需求时,同时修改实现与说明。
网页验证通过只说明当前验证范围内的规则和交互符合预期。Ren'Py 引擎控制流、字体、存档和打包另列人工验收,AI 不自动替代这部分工作。
六、并行测试与每日证据
无引擎依赖的规则使用 Python 标准库自动检查。优先覆盖初始状态、活动结算、非法输入、精力不足、日期推进和状态序列化;新增两餐、剧情、小游戏后同步补对应边界。引擎界面、普通存档、跨周目记录与 Windows 包需要实际运行检查。
每天保留当天真实站会照片、真实程序截图、五人 Issue/提交或非开发成果、AI 工作记录及燃尽图。燃尽图以“剩余人时”为统一单位,每日重新估算,未采集的实际数据保持空缺。
本地工程、任务表与运行报告已经关联。
相关推荐
OutOfTheOrdinary - Alpha SprintTopical Collection of Essays
【OutOfTheOrdinary - Alpha SprintTopical Collection of Essays】这篇文档描述的是一个软件工程的α冲刺阶段报告,其中主要涉及了UI(用户界面)和前端开发两个关键领域的工作进展和计划
STProjectPlanner:一个崇高的Sublime Text 3项目规划插件
ProjectPlanner(alpha) Project Planner是Sublime Text 3插件,旨在简化中型项目的下一步操作计划。 下一个动作是即将执行的动作,例如,在下一个冲刺中。 计
2020职称计算机考试photoshop考前冲刺试题.pdf
本文将详细解析与Photoshop相关的知识点,包括图像格式、切片工具、图像映射、色彩模式、色阶调整、颜色模式转换、滤镜优化以及图层蒙版和Alpha通道的应用。1.
【备战2020】高考数学 最新专题冲刺 坐标系与参数方程(1) 理.doc
参数方程与直线的倾斜角:题目提到了直线的参数方程形式,通常为\( \begin{cases} x = x_0 + t\cos\alpha \\ y = y_0 + t\sin\alpha \end{cases
2010年考研冲刺班微积分上(三十六技之1-6)
### 2010年考研冲刺班微积分上(三十六技之1-6)#### 知识点解析在微积分的学习过程中,对于极限问题的处理是非常重要的一个环节。



