用途:doc-ears-validator 用于校验 EARS(Easy Approach to Requirements Syntax)需求文档是否符合 Layer 3 模式标准,可在用户请求校验 EARS 文档时,或创建/修改 EARS 产物后调用。
主要能力:按校验清单执行检查,包括文件夹结构校验(阻塞项,EARS 文档必须位于嵌套目录 docs/03_EARS/EARS-NN_{slug}/ 内,文件夹名与文件名需匹配 ID 模式);元数据校验(document_type、artifact_type、layer、architecture_approaches、priority、development_status 及 ears、layer-3-artifact 标签,禁止特定标签模式);结构校验(6 段 MVP 结构:标题、Document Control、用途与背景、EARS 在开发流程中的位置、需求、质量属性、可追溯性、参考);内容校验(EARS 需求模式,含 Ubiquitous、Event-Driven、State-Driven、Unwanted、Optional 等,需求 ID 格式 EARS.NN.EE.SS,BDD-Ready 评分下限 90%);可追溯性校验(上游 @brd、@prd 标签,下游预期产物)。
使用方式:可用命令校验单个或全部文档,例如 python ai_dev_ssd_flow/03_EARS/scripts/validate_ears.py docs/03_EARS/EARS-001_example.md、python ai_dev_ssd_flow/03_EARS/scripts/validate_ears.py docs/03_EARS/、加 --verbose 输出详细结果。工作流依次解析 YAML frontmatter、检查元数据、标签、章节结构、Document Control 表、EARS 模式、关键词、上游引用,计算评分并生成报告。被 doc-flow、doc-ears 调用,向 trace-check 与 quality-advisor 输出。
限制:资料未提供安装方式、依赖环境、定价与平台支持;校验器行为以所给 schema 与错误码为准,未列出的功能暂未提供。