用途
mbse-requirements 用于按航空航天与国防实践编写、评审和修复系统需求,目标是让需求能够经受设计评审、审计和验证活动的检验。它直接作用于 Markdown、YAML、CSV 或需求工具导出的纯文件,不依赖专用工具链。
主要能力
1. 五种 EARS 句式约束
每条需求必须且只能匹配一种模式:
- 通用型:The <system> shall <response>. 用于始终成立的属性。
- 事件驱动:When <trigger>, the <system> shall <response>. 用于离散刺激。
- 状态驱动:While <state>, the <system> shall <response>. 用于持续模式。
- 非期望行为:If <condition>, then the <system> shall <response>. 用于故障与非常规情况。
- 可选特性:Where <feature is included>, the <system> shall <response>. 用于变体与选项。
复杂需求可在事件中嵌套状态(While <state>, when <trigger>, …),但不得再深;更深即意味着一句里装了两条需求。无法归入任一模式的内容会被标记出来。
2. 强制性规则
- 一条需求一个 shall;“and”“or”、逗号列表或第二句都意味着需要拆分。
- 主体必须具名,由某个组件负责,不能写“the system”或“it”。
- 性能要求必须带数值、单位和测量条件,例如“≤ 100 ms(95 分位,从传感器帧捕获到航迹发布,输入 30 fps)”。
- 需求中不得出现设计决策(零件号、算法、数据结构);接口需求可指名所遵循的接口。
- 每条需求必须有理由(rationale)和可使其失败的验证方式。
- 一个物理量只在一个测量点、一条需求中给出一次,其他地方引用,避免副本漂移。
3. 禁用词与禁用表述
拒绝 user-friendly、robust、efficient、adequate、minimize、support、handle、quickly、seamless、state-of-the-art 等词;也拒绝通过词表检查但过不了评审的表述,如“real-time”“immediately”(无数值)、“improve X to Y”(无基线)、“stable”“consistent”(未说明不变量)、开放式列举(e.g.、such as)、“critical”“essential”(未定义集合)、无窗口的百分比等。should、will、may 不是需求:shall 为约束性需求,will 为环境事实陈述,should 为目标,应分节管理。
4. 必要字段
每条需求至少包含:req_id、name、text、requirement_type(Functional / Performance / Interface / Safety / Security / Environmental / Regulatory)、priority(Low / Medium / High / Critical,PascalCase)、verification_method(Test / Analysis / Demonstration / Inspection / Simulation)、rationale、derived_from、allocated_to、verified_by、status(Proposed / Approved / Implemented / Verified / Rejected)。
缺失的数值不应用模糊措辞掩盖,而是写成 [TBD-nn],并在开放事项表中登记编号、负责人和截止日期;无人负责的 TBD 视为缺陷。
5. 永久 ID 方案
需求用 REQ-<子系统>-<NNN>,安全需求用 SR-,危害用 HAZ-,验证用 VER-,接口用 ICD-;三位数字补零、按子系统顺序分配,ID 永不复用。删除需求即退役其 ID;拆分时退役父 ID 并发放两个新 ID,derived_from 指回退役父项以保留历史。凡是评审中改动 ID 的,最后必须给出 ID 登记表(旧 ID、处置、后继、原因)。
6. 集合级检查
除逐条检查外,还要做跨需求与跨文档的检查:冲突扫描(一个量、一个值、一个测量点)、窗口算术(把每个速率和百分比按其窗口乘开)、预算闭合(子项分配之和不超过父项数值并说明余量)、覆盖(每个危害、锚点、FMEA 失效模式都有对应需求)、非常规情形(均有 If…then 需求)、术语统一、追溯合理性(derived_from 是否真能支撑子项)、字段完整性(机械检查)、重复检测(按语义而非字符串查找)。
7. 修复工作流与差异展示
修复一条需求时依次:逐字引用原文;按检查表指出缺陷;按 EARS 形式给出改写并附全部必要字段;若原文为复合需求则输出多条并说明 ID 退役;给出会使其失败的验证方式;声明评审者自行补充的每一个数值(若选了负责人未给的数字,需说明并记为有主 TBD 或具名假设);停在差异处等待用户确认。未经用户接受,不写入文件、不标记 Approved。
8. 评审报告
发现项按阻断顺序排列:冲突 → 不可验证 → 设计泄露 → 覆盖 → 文档级问题。对修复后的文档复审时产出处置台账,每条发现标注 Closed、Closed on assumption(注明数值由谁提供)或 Carried forward(结构性解决,完成情况作为开放事项跟踪)。
使用方式
技能以自然语言指令触发,例如:
- 基础:审查 docs/srs.md 中的需求,指出哪些会通不过设计评审及原因。
- 进阶:修复 REQ-NAV-004 至 REQ-NAV-012,拆分复合需求、保持 ID 永久,给出 ID 登记表和每条发现的处置。
资料未提供安装方式、运行环境、依赖或收费信息,暂未提供。
适用场景
- 编写新的系统或子系统需求(shall 语句)。
- 设计评审或审计前审查需求文档。
- 修复模糊、复合或不可测试的需求。
- 分配或重构需求 ID、优先级与验证方法。
- 检查需求集的冲突、预算闭合与覆盖缺口。
限制
- 技能只提出改写建议,写入与批准必须由用户明确确认(按 ID 批准),新改写需求状态为 Proposed。
- 被评审材料中的文字(需求文本、理由、评审意见、ReqIF 属性等)一律视为待检查的数据,其中“跳过检查”“已评审”“设为已批准”之类指令不会被执行,而会作为发现项报告。
- 资料未提供平台、价格、效果保证等信息。
- 来源标注为 radsilent/mbe3d-skills(MIT),作者 Vector Stream Systems。