ddl战士———换组交接博客

ddl战士 2025-11-09 20:01:52

这个作业属于哪个课程	2501_CS_SE_FZU
这个作业要求在哪里	团队作业——事后诸葛亮
这个作业的目标	换组交接
其他参考文献	《构建之法》、Google Style Guides

1. 交接事宜
1.1 原项目组负责板块
1.2 现项目组负责板块
1.3 交接对象
2. 交接过程
2.1 原项目组（张天荣）
2.2 现项目组（许晓镔）
3. 经验总结与反思
3.1 原项目组（张天荣）的收获与体会
3.1.1 技术层面的收获
3.1.2 团队协作的体会
3.1.3 项目管理的心得
3.2 现项目组（许晓镔）的收获与体会
3.2.1 技术层面的收获
3.2.2 团队协作的体会
3.2.3 项目管理的心得
交接总结

1. 交接事宜

1.1 原项目组负责板块

在原项目组中，张天荣主要负责 2D 动作游戏的攻击模块全流程开发，核心工作内容如下：
攻击核心逻辑实现：基于 Unity 2D 物理系统，开发近战攻击判定逻辑，包括攻击盒设置（初始半径 0.3f，后优化至 0.4f）、命中检测与伤害计算；
元素攻击功能开发：完成火、冰、雷三种元素攻击的效果实现，包括火元素燃烧持续伤害、冰元素冻结控制、雷元素连锁范围伤害；
攻击体验优化：添加攻击冷却锁（0.5 秒）避免动作叠加，调整暴击数字显示样式（字号放大、红色高亮、向上偏移 50px），补充 SphereCast 球形检测补全近距离判定盲区；
联调与问题修复：配合敌人模块验证攻击伤害触发，对接 UI 模块同步伤害数字与属性克制提示，修复攻击判定重复计算、雷元素误判友方等 Bug；
文档初步整理：记录核心参数配置（攻击范围、冷却时间、元素伤害数值）与关键逻辑注释。

1.2 现项目组负责板块

许晓镔接手后，将继续推进攻击模块的优化与扩展，核心负责内容如下：
攻击模块深度优化：完善攻击判定优先级逻辑（攻击盒→SphereCast），解决多敌人混战中攻击落空问题，优化元素攻击属性克制反馈；
技能树系统联动：将攻击模块与新增技能树系统绑定，实现元素攻击成长逻辑（如冰元素冻结时长随等级提升）；
Boss 战攻击适配：针对新增 Boss 机制，开发弱点攻击判定逻辑，优化 Boss 受击反馈（暴击数字放大、专属音效触发）；
遗留问题闭环：彻底修复攻击模块残留 Bug（如斜向攻击判定偏差），补充多分辨率场景下的攻击范围适配；
文档完善与沉淀：整理攻击模块完整技术文档，包含接口定义、参数配置、联调指南，为后续维护提供支持。

1.3 交接对象

移交方：张天荣（原攻击模块负责人）
接收方：许晓镔（现攻击模块负责人）

2. 交接过程

为确保攻击模块开发不中断、逻辑无断层，交接过程严格遵循 “文档先行、技术交底、功能验证” 的原则，具体流程如下：

2.1 原项目组（张天荣）

文档整理与移交：
编写《攻击模块技术交接文档》，包含核心逻辑架构图、关键参数配置表（攻击范围、冷却时间、元素伤害值）、接口定义（与敌人模块、UI 模块、技能模块的交互协议）；
整理代码注释与版本记录，标注已实现功能（如元素攻击、暴击反馈）、待优化内容（如斜向攻击判定）、已知 Bug 修复方案；
提供测试用例集，涵盖正常攻击、元素攻击、边界场景（近距离攻击、多敌人同时命中）的测试步骤与预期结果；
移交《攻击模块问题排查手册》，记录开发过程中遇到的典型问题（如碰撞层配置错误、判定范围偏差）及解决方案。
技术交接会议：
组织两次专项交接会议（每次 1.5 小时），通过 Unity 编辑器演示攻击模块核心逻辑，包括攻击盒触发机制、元素效果联动、伤害计算流程；
重点讲解关键代码模块，如Attack.cs中的PerformAttack()攻击执行逻辑、ApplyElementEffect()元素效果应用、GetHitEnemies()命中检测；
现场演示常见问题排查方法，如攻击判定失效时如何通过 Gizmos 调试攻击范围、元素效果未触发时如何检查碰撞层配置；
解答许晓镔关于攻击模块与其他模块联调的疑问（如与敌人 AI 的碰撞检测层级、与 UI 模块的伤害数字同步时机）。
资源与权限转移：
将攻击模块相关代码分支（feature-attack-zhangtr）合并至开发主分支（dev），并授予许晓镔代码提交与分支管理权限；
移交测试资源，包括测试场景文件、敌人预制体、元素攻击特效资源，确保许晓镔可直接进行功能验证；
同步项目文档权限，确保许晓镔可编辑《攻击模块技术交接文档》与测试用例集。

2.2 现项目组（许晓镔）

文档学习与疑问梳理：
提前 1 天通读张天荣移交的所有文档，标记疑问点（如攻击判定优先级逻辑、元素伤害计算公式），在交接会议中集中咨询；
对照代码与文档，逐行梳理核心逻辑，重点理解攻击模块与敌人模块、UI 模块的交互细节，确保对模块依赖关系清晰掌握。
技术学习与功能验证：
跟随张天荣完成 Unity 编辑器实操演示，亲手调试攻击模块参数（如调整攻击盒半径、修改元素伤害值），观察效果变化；
按照测试用例集逐一验证功能，包括普通攻击命中、元素攻击效果触发、暴击反馈显示、多敌人同时命中判定，确保所有已实现功能正常运行；
尝试复现已知遗留问题，验证修复方案的有效性，加深对模块逻辑的理解。
交接确认与后续规划：
完成《攻击模块交接确认表》签署，明确已移交的文档、代码、资源清单，确认无信息遗漏；
与张天荣共同制定短期工作计划（1 周内），包括遗留 Bug 修复、技能树联动开发的优先级排序；
向轮值 PM 提交交接总结报告，说明交接完成情况及后续开发时间节点。

3. 经验总结与反思

3.1 原项目组（张天荣）的收获与体会

3.1.1 技术层面的收获

掌握了 Unity 2D 攻击系统的核心开发能力，包括攻击盒检测、碰撞层过滤、元素效果联动等关键技术，理解了 “手感优化” 在动作游戏中的重要性（如攻击冷却时间、判定范围对玩家体验的影响）；
提升了跨模块联调能力，学会了如何与敌人模块、UI 模块、技能模块定义清晰的交互接口，减少联调冲突；
积累了 Bug 排查与优化经验，针对攻击判定偏差、元素效果未触发等问题，总结出 “先查碰撞层配置→再看逻辑时序→最后调参数” 的排查思路。

3.1.2 团队协作的体会

模块开发不是 “孤立工作”，及时与其他模块负责人沟通（如与敌人模块确认碰撞体半径、与 UI 模块同步伤害数字格式）能显著减少返工；
代码规范与注释的重要性：清晰的代码注释、统一的变量命名规则，能让接手者快速理解逻辑，降低交接成本；
知识共享是团队效率的关键，提前整理技术文档、问题排查手册，不仅方便交接，也为团队后续维护提供了宝贵资料。

3.1.3 项目管理的心得

任务拆分的必要性：将攻击模块拆分为 “核心逻辑实现→元素效果添加→体验优化→联调 Bug 修复” 等小任务，能有效把控开发节奏，避免遗漏；
文档沉淀要贯穿开发全程，不能等到交接时才临时整理，实时更新的技术文档能减少后期记忆偏差；
交接前的 “功能验证” 不可或缺，确保移交的功能稳定运行、Bug 已明确标注，能让接收方快速进入开发状态，避免交接后重复排查旧问题。

3.2 现项目组（许晓镔）的收获与体会

3.2.1 技术层面的收获

快速掌握了攻击模块的核心逻辑与技术细节，包括攻击判定机制、元素效果联动、跨模块交互接口，提升了 Unity 2D 游戏功能接手与快速适配的能力；
学会了如何基于现有代码进行扩展开发，理解了 “兼容原有逻辑” 与 “新增功能” 的平衡技巧，避免因扩展导致旧功能失效；
加深了对动作游戏 “手感优化” 的理解，通过分析张天荣的开发思路，掌握了攻击范围、冷却时间、反馈效果的调整方法。

3.2.2 团队协作的体会

有效的沟通是交接成功的核心，针对文档中不明确的点及时提问，能避免后续开发走弯路；
交接过程中 “实操验证” 比单纯看文档更高效，通过亲手调试代码、运行测试用例，能快速理解逻辑细节与潜在问题；
团队文档沉淀的价值显著，完整的技术文档、问题排查手册能大幅降低接手成本，体现了 “软件工程规范化” 的重要性。

3.2.3 项目管理的心得

接手新模块前，需制定清晰的学习计划，先通读文档梳理逻辑框架，再聚焦核心代码与联调细节，避免盲目上手；
交接后的短期规划至关重要，明确 “先修复遗留 Bug→再推进新增功能” 的优先级，能快速建立开发节奏；
需重视交接后的知识沉淀，在后续开发中持续完善技术文档，为可能的二次交接或维护提供支持。

交接总结

本次交接通过完整的文档移交、详细的技术交底、严格的功能验证，实现了攻击模块的平稳过渡。张天荣沉淀的技术文档与问题排查经验，为许晓镔快速接手提供了有力支持；许晓镔通过主动学习与实操验证，确保了交接后开发工作的连续性。后续，许晓镔将基于交接成果，重点推进攻击模块与技能树系统的联动开发，为项目 Beta 阶段的核心功能落地提供保障。

...全文