AI编程助手现在改代码的速度越来越快。但有个新问题被忽视了:代码在变,代码库的"真相"却常常跟不上。
行为跑在了文档前面。架构笔记很快过时。产品决策散落在聊天记录里。审查者能看到代码改动,却看不到围绕这些改动的上下文变化。
Truthmark 1.4.0就是针对这个断层设计的。这是一个Git原生的、分支级别的AI辅助开发工作流层。它帮助编程代理在功能代码变更时保持代码库真相的一致性,同时给人类留下普通的Git差异供审查。
最新版本加入了工作流验证器和写入代理。这让安装的工作流在更大的代码库中更实用——在大代码库里,单个代理的上下文很快就会拥挤不堪。
Truthmark的定位很清晰:它不想成为另一个AI模型,不托管服务,不运行数据库,不添加MCP服务器,也不要求团队信任隐藏的内存。相反,它在你的代码库中安装工作流基础设施。
这套基础设施有两个界面。面向人类的是命令行工具:维护者用它配置代码库、安装工作流文件、刷新生成的界面、验证真相设置。面向AI的则是宿主原生的工作流界面——根据宿主不同,它们以技能、提示、命令、托管指令块或项目代理的形式出现。
这个区分很关键:命令行工具准备代码库,AI界面是代理工作时使用的运行时。
默认的工作流路径是这样的:代理修改功能代码→相关测试运行→Truth Sync检查映射的真相文档→需要时更新真相文档→人类审查代码差异+真相差异。目标不是创造更多文档,而是让代码库真相更难被跳过。
当AI代理改变行为时,Truthmark会给它一个完成时的工作流守卫。代理在交接前检查映射的真相文档。如果文档需要变更,变更会以普通的Git差异形式出现。这让代码库更容易审查、更容易交接、更容易信任。
很多AI工具专注于"下一个回答"。Truthmark专注于"下一次交接"。在真实的代码库中,真相并非简单全局存在。分支会分叉,架构变更分阶段进行,产品行为在特性分支和主分支之间可能不同。内存工具可以帮助单个用户或单个会话,但它不会自动给审查者提供分支当前信念的提交记录。
Truthmark把这些上下文留在代码库里。路由文件、真相文档、生成的工作流界面和指令块都随分支存在。它们可以像其他项目文件一样被审查、更新、回滚和合并。
热门跟贴