双11狂欢大促

盲盒赢 定制羽绒服

开启惊喜盲盒,抽取你的专属好礼

— 惊喜奖品抢先看 —

狂想曲委员会——代码规范、Alpha 冲刺任务与计划

狂想曲委员会 狂想曲委员会 墨衍会员 · AI 创作全网分发 墨衍智能分发 通过墨衍一键同步至各平台 可同步平台 CSDN微信公众号微博知乎掘金百家号博客园抖音小红书 你的文章也可以这样分发 墨衍会员 ¥399起/年,写一次发全网 我也要 + 加入社区

狂想曲委员会——代码规范、Alpha 冲刺任务与计划

这个作业属于哪个课程软件工程实践
这个作业要求在哪里团队第四次作业:站立式会议+α冲刺
这个作业的目标统一开发规范与接口,确定七天 Alpha 任务、五人职责和 AI 技术员使用方式
其他参考文献作业指定参考:《阿里巴巴 Java 开发手册》v1.3.0、华为代码规范、《构建之法》第 2、13 章;阅读及采用情况由成员补充

团队:狂想曲委员会
项目:《福大秋日狂想曲》
计划周期:2026 年 10 月 23—29 日
文档内容:冲刺范围、开发规范、实名分工、每日目标与验收方式。

一、Alpha 阶段目标

本次做一个能通过正常操作游玩的校园题材游戏切片。程序优先,使用占位画面完成开局、日期与属性展示、活动结算、两餐、短剧情、一个小游戏及存读档,再测试和打包。完整八周剧情、全部结局与正式音画资源留到后续。

本次程序切片为 7 个游戏日。网页界面用于快速检查同一业务核心的行为;Ren'Py 界面、引擎存档、字体与发行包在引擎中另行验收。

本周不拍游戏实景、人物、CG 或宣传素材。每日真实站会照片仍按要求保留,每天程序截图从实际运行界面采集。

二、代码与协作规范

以下是本工程建议采用的 Python/Ren'Py 实施规范,参考通用命名、职责划分、异常处理和协作思想,不照搬 Java 专属语法要求。

  1. 编码与命名:文件采用 UTF-8;Python 缩进统一四个空格;模块、函数和变量使用 snake_case,类使用 PascalCase,常量使用 UPPER_SNAKE_CASE。界面文案使用中文,标识符尽量使用语义清楚的英文。
  2. 模块职责:业务核心处理状态与规则;配置集中存放活动参数、初始值和切片长度;剧情处理条件与选择;界面只收集输入和展示结果。网页验证界面与 Ren'Py 调用共同核心,避免维护两份不同规则。
  3. 状态边界:日期、时段、属性、资金、事件标记属于当前游戏状态。跨周目记录与普通存档分开设计;首日仅明确边界,未实现的持久化不得标记为完成。
  4. 输入与结算:开局输入、活动类型、资金和精力不足等情况要有明确反馈。错误操作不得修改状态;同一结算不可重复发奖。活动数值是当前 Alpha 实现基线,调整时同步文档和测试。
  5. 注释与错误:注释解释规则原因和边界,不重复代码。禁止吞掉全部异常或把报错当作正常完成;开发日志保留足够诊断信息,不写入账号口令。
  6. 资源管理:占位资源集中引用,文件名稳定,便于后续替换。发行包只使用来源与授权清楚的外部素材。
  7. 提交规则:每个任务建立真实 Issue,写清验收条件;本人核对后用本人账号提交,提交信息建议为 feat(core): 增加日程推进 #实际Issue编号。示例中的编号须替换为真实编号。
  8. 合并与复核:每人先运行本模块检查,再由另一人看边界与接口。每日集成后保留实际运行截图,测试失败与已知问题如实记录。
  9. 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 工作记录及燃尽图。燃尽图以“剩余人时”为统一单位,每日重新估算,未采集的实际数据保持空缺。

本地工程、任务表与运行报告已经关联。

...全文

相关推荐

评论
收藏 已收藏
分享
返回顶部