用途:按 Layer 9.51 schema 标准校验 Documentation Specifications(DSPEC)文档;在用户请求校验 DSPEC 文档时,或创建、修改 DSPEC 产物后调用。
schema 引用:ai_dev_ssd_flow/09_SPEC/DSPEC/DSPEC_MVP_SCHEMA.yaml;Layer 9.51;Artifact Type:DSPEC;Deliverable Type:document。校验规则引用同一 schema 文件。
主要校验项:
- 元数据:document_type 须为 dspec-document,artifact_type 须为 DSPEC,deliverable_type 须为 document,subtype_code 须为 51,layer 须为 9。
- 内容结构:文档类型(55-58)、目标读者、内容大纲、样式指南引用。
- 受众分析:主要受众、次要受众、技术层级、前置条件。
- 内容覆盖:全部 REQ 主题、示例、图表/视觉内容、术语表。
- 可访问性:alt 文本要求、阅读水平、翻译要求、格式可访问性。
- 可追溯性:需累积标签 @brd、@prd、@ears、@bdd、@adr、@sys、@req。
- DOC-Ready 分数:内容覆盖 25%(最低 100%)、受众对齐 20%(最低 90%)、结构完整 20%(最低 90%)、样式合规 15%(最低 85%)、可访问性 10%(最低 85%)、可追溯性 10%(最低 100%);目标 DOC-Ready ≥85%。
错误码:DSPEC-E001(错误,缺少受众定义)、DSPEC-E002(错误,内容大纲不完整)、DSPEC-E003(错误,缺少文档类型)、DSPEC-W001(警告,未引用样式指南)、DSPEC-W002(警告,DOC-Ready 分数低于阈值)。
限制:资料未提供具体安装命令、运行方式或代码示例,暂未提供。