工程开发
doc-validator avatar

doc-validator

SDD 框架的跨文件验证、追溯性缺口检测及全项目一致性检查。

简介

doc-validator 是一种专为规格导向开发 (SDD) 框架设计的质量保证代理技能。它执行全面的跨文件分析,以确保从 BRD、PRD 到技术规格 (SPEC) 及实施计划等各层级文件生命周期中的结构与逻辑完整性。通过遍历文件图谱,它能识别孤立的工件、验证双向链接一致性,并检测可能威胁项目稳定性的重复需求 ID。它是主要版本发布前的重要守门员,确保累计标签层级与追溯矩阵完整且准确。

  • 识别项目目录内的断开交叉引用与孤立文件。

  • 验证双向链接一致性,确保满足所有上游依赖关系。

  • 检测跨多个 SDD 层级与工件的重复元素 ID。

  • 检查累计标签层级与追溯矩阵的完整性。

  • 调度针对链接、图表、术语及需求计数的专用验证器。

  • 使用本地文件系统图谱遍历监控全项目的一致性。

  • 适合管理复杂 SDD 文件集的人工智能代理使用,以防止架构偏移。

  • 非用于单一文件结构或元数据验证;此类任务请依赖 {TYPE}_VALIDATION_RULES.md。

  • 输入包括强制性的文件目录路径,以及用于严格程度和范围(跨文件、追溯性或完整)的可选参数。

  • 提供标准化错误代码,以便进行高效的调试与修复。

  • 针对典型项目(100-200 份文件)资源开销极低(200-500MB RAM),且无需网络依赖。

  • 支持术语、章节计数及内容索引等特定类别的自动修复功能。

仓库统计

Star 数
14
Fork 数
2
Open Issue 数
0
主要语言
Python
默认分支
main
同步状态
空闲
最近同步时间
2026年5月3日 18:30
在 GitHub 查看