用途:把模糊或含糊的需求描述转换为清晰、无歧义、可测试的规格语句,采用 EARS(Easy Approach to Requirements Syntax)方法。
主要能力:提供 6 种句式模板。Ubiquitous:The <system> shall <response>. 用于始终生效的行为;Event-Driven:WHEN <trigger>, the <system> shall <response>. 用于离散事件触发;State-Driven:WHILE <state>, the <system> shall <response>. 用于持续状态;Unwanted Behavior:IF <condition>, THEN the <system> shall <response>. 用于错误处理与边界情况;Optional Feature:WHERE <feature>, the <system> shall <response>. 用于依赖功能开关或配置;Complex:组合 WHEN、WHILE、IF、WHERE,每条规格最多 2 个关键字。另附模式选择决策流程。
使用方式:独立使用时,接收用户给出的模糊需求,按选择指南分类,套用相应模板改写,并校验每条语句仅含一个 shall、语言可度量可验证、EARS 关键字大写,最后给出改写前后对比。与 USDM 配合时,在 USDM 第 3 步层级构建中,对 SPEC-NNN 级规格套用 EARS 模式。
写作规则:每条规格一个 shall;需要 and 连接两个动作时拆分为两条;关键字 WHEN、WHILE、IF、THEN、WHERE 大写;强制用 shall,可选 may,不用 should、could、might;使用主动语态;响应需含数量、时限、格式等可验证标准;触发条件要具体。
适用场景:需求规格编写、规格评审、错误与边界情况定义、功能开关相关行为描述。
限制:资料未提供安装命令、平台支持、收费与价格信息;参考资料位于 references/ears-patterns.md 与 examples/ears-examples.md。