构建之法阅读笔记01

1、我过去是怎么做的（或者我过去看见谁是怎么做的）

在大二上学期参与一个课程小组项目时，我观察到团队成员（包括我自己）普遍存在一些职业素养方面的问题。最典型的表现是：

（1）时间管理混乱：我们经常在deadline前熬夜赶工，有一次甚至通宵改bug。明明老师给了4周时间，前3周大家都在拖延，最后1周才开始疯狂编码。

（2）沟通效率低下：在微信群里的讨论经常是碎片化的，重要的技术决策被淹没在"早上好"、"吃了吗"这类闲聊中。有次因为接口定义没说清楚，导致两个模块对接时出现严重问题。

（3）文档敷衍了事：最后提交的设计文档基本是复制粘贴需求文档，测试报告也只是简单写了"测试通过"，完全没有记录测试用例和发现的问题。

2、结合书中所讲，说明为什么这样不好

《构建之法》第16章专门讨论了"工程师的职业素养"，邹欣老师明确指出：

• 关于时间管理：书中强调"好工程师像专业运动员一样训练自己的时间管理能力"。我们这种"截止日期驱动"的开发模式，不仅影响代码质量，还会造成身心俱疲。就像书中说的："熬夜写出的代码往往需要更多时间来调试"。

• 关于沟通：书中提到"专业的工程师懂得有效沟通的价值"。我们混乱的沟通方式直接导致了接口问题，这印证了书中的观点："模糊的需求必然导致模糊的实现"。

• 关于文档：书中有句话让我印象深刻："代码只能告诉你怎么做，文档告诉你为什么这么做"。我们敷衍的文档使得后来想要改进系统时，完全记不清当初的设计思路。

3、提出一个解决办法，避免再次掉入陷阱

针对这些问题，我制定了以下改进方案：

（1）采用敏捷开发方法：

• 使用看板工具（如Trello）拆解任务
• 制定每周里程碑，每日站会同步进度
• 坚持"今日事今日毕"的原则

（2）建立规范的沟通机制：

• 技术讨论使用GitHub Issues
• 定期召开正式会议并做记录
• 重要决策必须形成书面结论

（3）文档即代码（Docs as Code）：

• 使用Markdown编写实时更新的文档
• 将文档纳入版本控制系统
• 建立文档review机制

（4）培养专业习惯：

• 坚持做工作日计划与总结
• 建立个人知识管理库
• 定期进行代码复盘

通过这样的改变，我希望不仅能提高项目质量，更能培养自己作为软件工程师的专业素养。就像《构建之法》中说的："优秀的工程师不是天生的，是通过持续的专业训练造就的。"