先说结论

资料库按照认知逻辑组织信息,代码库按照工程逻辑组织资源。前者服务于理解,后者服务于实现。它们不需要采用同一套分类方式,更没有必要让一边迁就另一边。

真正需要一致的,是任务所依据的事实、目标和验收标准,而不是文件夹长得一模一样。

V5正式-knowledge-library-engineering-repository-cover-16x9.webp

从整理内容分发平台开始

最近整理个人品牌的内容分发资料时,一个很具体的差异浮现出来。

在资料库里,平台是最自然的分类单位。知乎有知乎的账号、发布规则和运营情况;CSDN 有 CSDN 的;百家号也有自己的资料。每个平台对应一份长期维护的档案,想了解哪个平台,就去看哪个平台。

但如果任务是把一篇新文章分发出去,工程系统关注的就不再是「平台有哪些」,而是「文章从哪里来、要发到哪里、怎么发布、如何验证、失败了怎么办」。一个流程可能涉及多个平台;同一个平台,也可能被发布、数据采集和运营检查等不同任务调用。

资料是围绕平台整理的,执行却是围绕内容分发展开的。这不是哪边设计错了,而是两边本来就在回答不同的问题。

认知逻辑关心归属,工程逻辑关心运转

整理资料时,首先想知道的是:这是什么信息?属于哪个对象?和哪些信息有关?以后要查找、理解或修改它,应该从哪里进入?

设计工程时,首先要考虑的是:什么条件触发任务?数据怎样流动?哪些步骤可以复用?出现错误后如何恢复?怎样确认结果真的完成?

同一份平台资料,在认知层是一个需要持续维护的对象;在工程层则可能是多个工作流共同读取的输入。

因此,两边的差异也不是 ChatGPT Page 和 Markdown 的差异。Page 可以记录流程,Markdown 也能记录知识;代码库里还有代码、配置和数据库。决定组织方式的不是文件格式,而是这套内容主要用于理解,还是用于运行。

任务书是两套逻辑之间的接口

这件事也让我重新看待自己与 AI Agent 的分工。

站在用户和协调 AI 的角度,任务书应该把意图表达清楚:要做什么、依据哪些资料、有哪些限制、做完如何验收。它不必变成一份详细的鼠标操作说明。

例如一次内容分发任务,可以要求:将指定文章发布到选定平台,遵守各平台现行规则,避免重复发布,并返回可访问的文章链接;不能完成的,说明原因。

至于通过浏览器还是 API 发布,调用哪个脚本,怎样组织代码和处理异常,可以由熟悉项目的执行 Agent 依据现有工程能力来决定。技术实现改变了,业务任务的表达不一定要跟着改变。

当然,这不代表执行 Agent 可以任意发挥。涉及账号权限、费用、对外发布及不可逆操作,仍然需要遵守预先约定的授权边界。把操作步骤交出去,不等于把判断标准也交出去。

不要统一目录,要统一事实

如果强行要求资料库与代码库同构,很容易出现两种情况:要么为了工程流程把一个平台的资料复制到好几个地方,要么为了迁就平台分类把一个完整工作流拆散。前者容易产生版本冲突,后者增加维护负担。

更合适的做法,是让平台资料保留一个权威入口,由任务书引用;让代码库按照实际执行依赖安排模块、脚本和配置。如果运行时必须使用机器可读的规则副本,也应明确它从哪里来、如何更新,避免悄悄形成第二套相互冲突的事实。

任务结束后,执行记录保存这一次做了什么、结果如何;如果发现平台规则发生变化,再更新对应的平台档案。任务结果和长期知识不必混成一份文档。

把精力留在该判断的地方

按照这个思路,用户不需要逐份设计执行层的技术文件,也不需要要求 Codex 按照资料空间的目录写代码。工程项目中的规则、脚本、测试和必要说明,可以由执行 Agent 持续维护,再通过结果验证和必要的审查来约束质量。

用户更应该关注的是:资料是否准确,目标是否值得做,任务是否越界,结果是否符合预期。

知识按照理解世界的方式分类,工程按照完成目标的方式组织。 两个库各自遵循适合自己的逻辑,任务书负责让它们衔接。这比让两边拥有一模一样的目录,更适合长期的人机协作。