Provenance：一款随代码演进同步维护规格说明的工具

大家好，我一直在做 Provenance 这个工具，用途是随着你对代码的理解越来越清晰，让你对代码的规格说明也能随之逐步生长。目前我觉得，软件改进的整个生命周期太割裂了。我们和团队沟通，用 agent 把东西规格化，在 ticket 里跟踪工作，但并没有什么真正把这些串起来的东西，也没有什么干净利落的方式让它们保持同步更新。Provenance 就是我为解决这个问题所做的尝试——在规划、需求、实现和验证之间建立直接关联。我特意尽量让这些概念对每个人自己的工作流保持中立。这里我讲其中几个：Source：一个 source 是任何你可以链接、并且可能有助于理解你软件的东西，比如一张图、会议记录、法规，甚至一段视频。Requirement：一个 requirement 是对系统某项需求的高层描述。Resolution：一个 resolution 是关于系统某个属性的决定，你认为这个属性需要被记录。通常 resolution 是一个或多个 requirement 的子项，同时又可以是许多 requirement 的父项。Rule：一个 rule 是 requirement 的子项，用来描述该 requirement 的某一个单一属性。Rule 可以直接链接到实现它的函数和验证它的测试。我们还处在早期阶段，但我很想听听大家的看法。