我正在构建一个文档治理工具。
我们有代码的层层测试套件,也有文档的格式风格检查工具,但是,我们没有文档的自洽性、新鲜度的解决方案。
这个工具不做 CI Guard,而是只守护三个链条的完整性。
· 意图到实现(Intent - Specs - Impl)
· 内容到引用(Reference)的概念与实体
· 工作语言(Canonical)到派生语言(Localization)
目前的思路主要是,用 front matter 做文档级引用,用 wiki link 做概念/实体 引用。
用 content hash 实现版本锁定,上游变更下游告警,手动更新,提醒 Agent 检查是否要更新下游文档。
根据项目复杂度启用更严格的治理规则集。
顯示更多