<转>如何编写优质的需求文档

　从较高的层次来看，书写需求文档的目的就是要提供对所需行为的有效描述。该所需行为可用一个黑盒系统描述，并需要注意以下细节：

• 工程师可以根据系统所说进行实现
• 测试人员，在不与开发人员沟通的前提下，可以利用满足硬件要求的设备验证需求。
• 最终产生的成果满足终端用户的要求。

• 黑盒测试

书写优质的需求文档：

最基本的原则是：需求文档应当尽量简洁，用最易懂的描述来约束系统的预期行为。 如果你遵循这个原则，剩下的那些重要因素（可测试性、避免过度设计等等）都将变得顺理成章。

　　列举一下更详细的规则，通常会更有帮助。下面是书写优质需求文档需要遵循的步骤：

　　1. 定义系统的边界。这也是黑盒系统所必要的。

　　2. 定义输入和输出。这也应当是你看待内部系统的唯一方式。

　　3. 用最易懂的方式描述系统的预期行为

　　4. 除了输入和输出之外，你的需求是不是还涉及了系统的其他部分？如果是，那么你的需求就设计过度了。重构需求，让它变得精简。

　　5. 你的需求是不是过于模棱两可？加入更多的限定规范。注意：有些模棱两可的描述并不是坏事，假设描述所包含的所有情况均可被接受，且测试的时候不需要附加的信息加以说明，那么就没关系。你不需要（也不应该）把系统的行为限制得过头。

　　6. 你的需求是否可测试？（这里指的是黑盒测试）如果不是，你最好返回到第 4 步。如果这种返工发生很多次，那就说明你的黑盒无法正确描述系统，或者你的测试工具不够优秀。无论是哪种情况，不可测试的需求文档几乎就是一文不值的。

　　7. 你的需求文档通俗易懂么？如果你的需求文档非常难以读懂，那就说明你写得不好，只能给那些照着你的需求负责实施的人带来无尽的痛苦。如果是这样，回到第 3 步。

　　8. 你是不是真的做到了第 4 步？你确认么？再检查一下。

原文地址：

http://kb.cnblogs.com/page/135757/