easysdd-requirements

easysdd/requirements/ 是项目的"能力清单"——每份文档描述一个能力因什么问题而产生、怎么解决、边界在哪，写成人话，非技术读者也能扫一眼看懂。架构文档讲"怎么搭"，需求文档讲"为什么要有这个"。两者分开记录的好处是：单独讨论需求时不被实现细节干扰，单独讨论架构时也不被产品视角牵着走。

需求文档的价值在于扫一眼就能抓到重点——用户故事在最前面、痛点和解法各一段短的、边界用列表。AI 写需求文档最容易出的几种问题都会破坏"扫一眼就抓到重点"这个特性：

• 写成 PRD 格式（字段堆）——读者要一格一格读才能拼出全貌。
• 语气过于 explain——像在上课，不是在介绍。
• 起花哨标题或用比喻——标题像广告词，读者要读半段才知道这能力是什么。
• 把实现细节塞进需求里——"通过 XXX 服务调用 YYY 接口"，这是架构 doc 的事。

下面整套规则就是为了不让这四种情况发生。

共享路径与命名约定看 easysdd/reference/shared-conventions.md。 一份样例文档看 easysdd/reference/requirement-example.md——起草前读一遍对齐语气。

适用场景