知识卡片

普通读书笔记卡 · 5454.a.1.c

现场客户消除沟通不确定性:代码才是唯一完整的需求文档

理解等级:未标注

两位工程师就一个用例中某个模糊环节该如何处理礼貌地争论了20分钟——一位记得客户说过应该重新尝试事务,另一位坚持这属于下周才要做的另一个扩展用例——直到有人突然意识到:不需要靠猜测和回忆去解决分歧,团队里就坐着系统专家、现场客户本人,办公室离他们只有四五米、门还开着。抬头一问,不到一分钟问题就解决了,不需要发邮件、不需要等语音留言回复、不需要启动正式的需求评审流程。这引出一个核心观点:想通过写更详细的规格说明文档来消除”不需要客户澄清需求”这件事,本质上是徒劳的——想做到让文档细节永远足够,文档就会变得像实现代码本身一样详细,那时文档也就没什么额外价值了;”唯一具备所有细节的需求形式就是代码”。这不是说文档完全没用,而是提醒团队:与其把精力投入到试图靠文字穷尽一切边界情况,不如优先设计让”随时能找到能拍板的人”这件事成为可能(现场客户、开放的工作空间、触手可及的沟通距离),把文档的定位收窄到提供概要路线图,把真正详尽、无歧义的规格说明交给代码和自动化测试来承担。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    参考来源

    - 位置:《团队之美》第15章《构建协作型和学习型的团队》(James Grenning,源文件:OEBPS/Text/part0032.xhtml) - 结论依据:原文详述两位工程师因用例某处细节争论20分钟、最终直接找现场客户当面解决问题的具体经过,并明确指出"唯一具备所有细节的需求形式就是代码",追求文档细节永远足够反而不划算,直接支撑本卡片结论。 - 原始内容:突然我明白了,我们没必要猜测,有现场客户在呢……不到一分钟,Johnny就解决了我们的问题。不用发送电子邮件……要是想做到我们不需要让客户澄清需求,那文档的细节永远都是不够的,而且也不好用。唯一具备所有细节的需求形式就是代码。