---
title: "资料库是认知逻辑，代码库是工程逻辑"
author: "冯智勇Geo"
published: "2026-11-10T09:58:22.000Z"
description: "资料库按照认知逻辑组织信息，代码库按照工程逻辑组织资源；任务书负责衔接两者，统一事实、目标和验收标准，而不是统一目录。"
tags: ["AI协作","知识管理","AI Agent"]
url: "https://fengzhiyonggeo.com/posts/knowledge-library-engineering-repository/"
---

# 资料库是认知逻辑，代码库是工程逻辑

## 先说结论

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

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

![V5正式-knowledge-library-engineering-repository-cover-16x9.webp](https://fengzhiyonggeo.com/images/knowledge-library-engineering-repository-cover-16x9.webp)

## 从整理内容分发平台开始

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## 不要统一目录，要统一事实

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

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

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

## 把精力留在该判断的地方

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

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

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