用 3 份资料跑通 Obsidian + Codex 个人AI知识库

写作时间:2026年8月

大家好,我是Blake(布莱克),坐标山东济南,电商从业12年,曾任年GMV10亿+垂类品牌数据负责

人,负责电商全渠道BI产品从0到1建设,今年4月份加入生财,是生财的一名新圈友。

生财AI养成系:5月份参加超级AI大航海,正式开始学习AI,是5月超级AI大航海优秀船员,目前已经跑

通Obsidian+Codex个人AI知识库工作流,并在6月生财Codex实战聚会获得“最佳变现潜力奖”。

文章内容是7.31日我在生财线下分享自己已经跑通的Obsidian+Codex个人AI知识库工作流实操教程,

内容包含完整的系统介绍,全套Prompt 。 这篇文章写给想搭建个人AI知识库、通过AI知识库进行内容

创作,但是看了很多教程,还是不知道从哪一步开始的非技术人员,全程不需要会代码,跟随这份手

册实操也能获得属于自己的第1个个人AI知识库。

同时也记录我在生财的成长和复盘,希望能够给到一些刚接触、正在学习AI的人看见,记得不用担心

太多,不要被复杂教程和各种专业名词吓退,缩小目标,慢慢学习,建立自己的感受和体验,做一些

满足自己需求的最小MVP版本,再逐步完善,一定会有适合自己的场景并学会AI这项技能。

马上也有第二大脑内容创作航海,希望这篇文章能够帮助到你,完成航海目标。

用 3 份资料跑通 Obsidian + Codex 个人AI知识库 配图1

7.31现场,分享的是我已经跑通的Obsidian+Codex个人AI知识库工作流,现场通过Codex进行知识

库最小结构目录搭建,用3份公开网页文章进行一次分类目录结构整理,使用文章进行AI教程输出,再写回知识库闭环。

AI按规则整理、调用、维护我的本地资料,帮我整理新增资料、创建项目、检查文件更新、从资料中

生成评估、教程、方案、行动建议。

AI根据我在Codex日常的工作记录复盘总结写入知识库、根据知识库沉淀的学习资料内容方向、正在

进行的AI项目等等,帮我总结出不同时间背景下我的AI学习阶段、问题,下一阶段进阶建议。

用 3 份资料跑通 Obsidian + Codex 个人AI知识库 配图1

日常只需要和Codex说,帮我整理知识库/帮我整理新增资料,帮我创建项目,检查文件更新,基于

XX资料输出XX内容,7.31线下分享的PPT和实操手册,也是Codex先做,我审核并提出修改意见,它

再继续执行。

一、为什么写这篇帖子

很多人都想搭建个人AI 知识库,希望它能管住不断增加的资料,也希望以后写文章、做项目或者学习

新东西时,AI 可以直接读到这些内容。

网上能找到很多教程,教程中Obsidian、Markdown、目录结构、插件、Skills 和 Agent 会一起出

现,每个概念都有详细说明,但轮到自己动手时,仍然可能卡在最前面,软件装好以后先做什么,目

录应该怎样建,需要准备多少资料,做到什么程度才算已经可以用了。

这一次我想把搭建范围缩小一点,用这份手册先带你完成1个能用的版本,让你能够开启个人AI知识库

和通过AI知识库进行内容创作之路,只要准备 3 份非敏感资料,让 Codex 读到正确的文件夹,完成一

次整理,再用这些资料解决一个真实问题,第一遍只做这些。

实操手册包含了已经稳定的完整系统内容,最开始只要跟着第一部分实操,完成第一部分后再按需看

后面的内容。

二、从 AI 对话框开始

我做了 12 年电商,前 3 年做天猫运营,后 9 年主要做全平台的数据分析和企业BI项目,多年积累下来

的学习、工作和项目资料一直放在本地文件里,后来也跟着5月超级AI大航海用过 ima 和飞书知识库,

这些工具可以保存内容,但整理资料的分类、更新,仍然需要自己处理,网页链接不能一键剪存,资

料都存在云端,随时可能消失。

5 月 7 日,我在生财 AI 航海的打卡里写过一句话:”7天前,我对 AI 的认知等于对话框。“,当时我

只用过 DeepSeek、Kimi 和豆包,ChatGPT 听说过,但对工作流、Agent、Skill、AI 编程这些概念几

乎不了解,刚刚开始跟随生财集中学习 AI,主要用法还是提问,AI回答,我做,还不知道怎样让 AI 读

取一个完整的本地文件夹,也没有弄清 README.md、AGENTS.md、Skills 和 Agent 分别负责什么。

用 3 份资料跑通 Obsidian + Codex 个人AI知识库 配图1

我一边焦虑,一边不知道该从哪里学起,工具越来越多,每个工具都有人推荐,越看越容易分散。

那几天,我先给自己搭了一张简单的学习地图:对话工具解决什么问题,工作流工具解决什么问题,

AI 编程工具又能做到什么,然后逐个体验 ChatGPT、Gemini、语音输入工具和 ima 知识库等等AI工

具,还给自己加了一条约束:纯理论学习不能连续超过 7 天,必须找一个最小任务动手。

5 月 22 日,我在航海复盘里记录了下一步计划:用 Obsidian 和 Codex 搭建个人知识库。这时候我已

经用过 ima 记录笔记,也体验过飞书知识库。参加过石榴爸爸的线下聚会后,还跑通过一次 AI 公众号

写作工作流,第一次对 Skill 和 Agent 有了实操层面的认识。

用 3 份资料跑通 Obsidian + Codex 个人AI知识库 配图1

5 月 29 日,我开始让 Codex 帮我搭目录、写规则和建立第一批流程。6 月 5 日,这套知识库正式投入

使用。到了 7 月,它已经管理了 100 多个文件,其中有 80 多份 Markdown 文档。知识库里还有 4 个

Skills 和一个总控 Agent。我再也没有手动进行过资料整理,每次我发起任务,Codex给方案,我负责

确认,Codex负责执行。

7 月 31 日,我把这套系统带到生财线下聚会,第一次作为分享者讲给其他圈友听,从 5 月初只会使用

AI 对话框,到站在线下讲自己的 AI 知识库,中间没有哪一步突然开窍。我做的事情很具体:完成一个

任务,检查结果,记录问题,再把新的要求补进规则。

用 3 份资料跑通 Obsidian + Codex 个人AI知识库 配图1

三、现在这套系统能做什么

持续成长中…

日常功能

•资料分类: 新增资料先进入收集箱,通过网页插件剪藏的文件按网页类型来源、时间分类,和

Codex说帮我整理知识库,自动输出新的分类结构目录方案并说明原因,我确认后,Codex自动进

行分类规整。

•项目管理: 让Codex建立项目分类,进行各个项目资料分类、归档、决策、进度记录,让项目可持

续开发。

•文章/方案: 根据不同资料内容产出新的文件,比如解释AI教程,变成通俗易懂的学习手册,输出

培训资料。

•持续沉淀: 各项新增内容、规则写回知识库。

用 3 份资料跑通 Obsidian + Codex 个人AI知识库 配图1

三类结果

第一类是学习评估,判断当前阶段和下一步。第二类是教程输出,由 Codex 先做,我审核修改。

第三类是对外模板,保留通用结构,同时排除个人资料。

用 3 份资料跑通 Obsidian + Codex 个人AI知识库 配图1

可以开启新的AI对话框,可以迁移AI工具使用,不需要超长上下文,依赖同一对话框,生怕会话丢

失。跟随日常使用场景持续沉淀规则、新的应用场景、新的Skill,形成更多适用不同结果的Skills,

越来越强大的Agent。

现场的实操从 3 份资料开始,先完成最小目录结构搭建,一次整理和资料使用闭环。

下面保留这次分享使用的完整实操手册、原有说明、提示词和安全规则都保持不变。第一次阅读时,

可以先完成第一部分,日常使用和进阶内容等出现真实需要后再看。

四、Obsidian+Codex从 0 到 1:个人AI知识库实操手册(7.31现场版)

用 3 份资料,在 20 分钟内跑通一次整理、使用和产出闭环。现场完成第一部分,课后再根据真实需求

扩展目录、项目和 Skills。你负责目标、判断和最终确认;Codex 负责检查、提出方案、执行已确认的

操作并自检。

用 3 份资料跑通 Obsidian + Codex 个人AI知识库 配图1

Obsidian 是什么

它既是Markdown编辑器也是知识库应用,笔记以本地纯文本文件保存,可以编辑、搜索和浏览文

档,也可以通过链接连接不同笔记,强调数据可持久访问和避免平台锁定。

下载和安装

准备 Obsidian、Codex 和测试文件夹,最小组合只有三项:

工具用途官方入口 (根据自Windows 64位安Mac 安装包

己的电脑系统下载装包

对应版本)

Obsidian阅读和管理本地Obsidian 下载Obsidian-Obsidian-

Markdown 文档1.12.7.exe 1.12.7.dmg

ChatGPT 桌面应用读取并管理本地文ChatGPT 桌面版下ChatGPT ChatGPT.dmg中的 Codex件载Installer.exe

WorkBuddy无法使用Codex WorkBuddy 下载WorkBuddy-WorkBuddy-

时,可先用win32-x64.exe darwin-x64.dmg

WorkBuddy

本地文件夹保存知识库文档和在电脑上自行创建–

附件

本文以 Windows 为例。不同版本的界面名称可能变化,只要完成让 Codex 连接 Obsidian 正在使用的

同一个知识库文件夹即可。

设置本地文件夹路径

在电脑上创建一个空文件夹, 建议根目录用英文,内部目录用中文。 这样做的好处是:

•英文路径兼容性更好。•中文目录方便自己理解。•以后迁移、备份、让 AI 读取时更稳定。

打开 Obsidian,选择刚创建的 KnowledgeBase 文件夹。

用 3 份资料跑通 Obsidian + Codex 个人AI知识库 配图1

如果打开Obsidian不是打开本地仓库的页面,而是以前建过本地仓库了,可以点击底部仓库路径选择

管理仓库,重新创建一个新的。

用 3 份资料跑通 Obsidian + Codex 个人AI知识库 配图1

软件界面•左侧文件目录、中间编辑区、标签页

用 3 份资料跑通 Obsidian + Codex 个人AI知识库 配图1

•搜索

用 3 份资料跑通 Obsidian + Codex 个人AI知识库 配图1

•左下角设置

用 3 份资料跑通 Obsidian + Codex 个人AI知识库 配图1

核心插件、第三方插件

跑通第一次闭环不需要安装任何第三方插件;等出现真实需求后再按需配置。

用 3 份资料跑通 Obsidian + Codex 个人AI知识库 配图1

使用路线

本次知识库简介

最小闭环版-个人 AI 知识库由四层组成:1. 本地资料:Markdown、PDF、附件等真实文件。

2. 结构说明:README.md 告诉人和 AI 每个目录怎么使用。

3. 操作规则:AGENTS.md 规定哪些事可以直接做,哪些必须确认。

4. AI 协作:Codex 负责检查、提方案、执行已确认的操作并自检,用户保留最终判断权。

Skills 和总控 Agent 属于成熟阶段的自动化能力,不是第一次搭建的必要条件;等真实流程稳定重复后

再增加。

适合谁•知道 Codex 的基本用法,但没有使用过 Obsidian。•想让 AI 读取并管理自己的本地资料。•有学习、工作、写作或项目资料需要长期沉淀。•安装了很多AI工具,但是发现安装工具和形成稳定工作流还有很大差距。•愿意保留最终判断权,并在重要操作前检查方案。

开始前确认•如果你要求 AI 处理过程完全离线,这套方案不符合要求。•不要把密码、验证码、API Key 或高度敏感资料交给 AI。•总控流程只在用户触发后运行,不会在后台自动修改全部文件。•还没有真实资料时,先准备 3 份可以安全测试的资料副本或者使用手册给的附件(在第一部分第4

步中)。

今天要完成什么

路线适合什么时候完成目标

现场 20 分钟快速路线线下实操、第一次体验用 3 份资料跑通一次整理、使用和

产出闭环

课后完整搭建路线现场成功后继续完善形成适合自己的目录、规则、项目

和进阶能力

如果你正在参加现场实操,只完成第一部分即可。不要在第一次操作时安装大量插件、导入全部历史

资料或创建 Skills 和总控 Agent。

会使用 Obsidian

•能创建或打开一个知识库文件夹,看懂文件目录、笔记编辑区、搜索和设置入口。

Codex 连接正确

•Codex 能读取 Obsidian 正在使用的同一个本地知识库文件夹。

完成一次资料整理

•3 份测试资料已经经过“Codex 给出方案、用户确认、Codex 执行并自检”的流程,放到合适的位

置。

完成一次真实使用

•能根据知识库资料回答一个问题或生成一份内容,列出参考文件,并把确认后的结果继续保存到知

识库。

完成这 4 项后,个人 AI 知识库的最小闭环就已经跑通。后面的目录完善、项目管理、网页剪藏、

Skills 和总控 Agent,都可以在真实需要出现后再逐步增加。

三种执行角色

角色负责什么

用户操作安装软件、选择文件夹、备份、放入资料、判断方

案、完成最终确认

Codex 操作读取和检查文件、生成方案、执行已确认的文件操

作、更新文档并自检

用户与 Codex 协作Codex 先检查或提出建议,用户确认,Codex 再执行

代码块中的内容是发给 Codex 的提示词。带有 【】 的位置需要替换成自己的信息。

进入第一次实操

我自己的知识库也是从这一段开始的。先确认 Codex 读到了正确的文件夹,再让它给出方案,不提前

创建 Skills。

第一部分:现场 20 分钟跑通新手闭环

让 Codex 只读验证文件夹

新建任务-选择项目-新建项目-打开刚才的本地文件夹:

【重要】一定按照这个步骤操作,不要临时发起对话框没有创建项目,在后期突然新建空白项目移动

对话框

然后发送:

代码块

请只读检查当前文件夹,不要创建、移动、删除或修改任何文件。2请告诉我:1. 当前工作目录的完整路径。2. 根目录下已经存在的文件和一级目录;如果为空,请明确说明。3. 你是否能够正常读取这个文件夹。7如果无法读取,请停止并告诉我需要重新选择哪个文件夹。

只有 Codex 正确报告路径和现有内容,才继续下一步。

生成最小方案

代码块

我想用 Obsidian + Codex 建立一个个人 AI 知识库。2我的主要用途是:【学习 / 工作 / 写作 / 项目 / 其他】。我准备放入的资料是:【文章、笔记、PDF、课程、项目资料等】。我希望先完成的真实任务是:【根据资料回答问题 / 输出总结 / 生成教程 / 推进项目等】。6请根据这些信息输出一套可以直接执行的最小方案,包括:8 1. 不超过 5 个核心目录,以及每个目录的用途。2. 资料从进入、整理、使用、产出到归档的流向。3. 一份可以直接写入的 README.md 完整草案,说明:- 知识库的用途- 实际目录结构- 每个目录的用途- 资料的基本流向4. 一份可以直接写入的精简版 AGENTS.md 完整草案,至少包含以下基础规则:- 未经明确要求不删除文件。- 移动、重命名、覆盖、批量修改和目录调整前,先给出方案并等待确认。- 原始资料默认保护原文;不确定是格式修改还是内容修改时,先询问。- 创建或移动前检查目标路径;遇到同名文件时不覆盖、不自动合并。- 完成操作后检查最终文件状态并汇报。- 基于知识库回答时列出参考文件,区分资料内容、归纳结论和 AI 推断。5. 本次需要创建的目录和文件清单。6. 本次暂不创建的内容,例如文件目录.md、项目 PROGRESS.md、Skills、总控 Agent 和其他插件目录。7. 哪些操作可以直接执行,哪些操作必须再次得到我的确认。26如果信息不足,可以使用下面的通用最小结构作为参考:28- 00_收集箱:未分类资料和临时入口- 01_知识笔记:自己的笔记、总结和可复用结论- 02_原始资料:外部文章、课程、PDF 和参考资料- 03_归档:暂时不用但需要保留的内容- 附件:图片、音频、PDF 等附件34目录先少后多,不要创建当前没有真实用途的分类。36现在只输出完整方案和文件草案,不创建、移动、删除或修改任何文件。输出后等待我确认。

检查三件事:

•目录是否符合自己的理解习惯。•一级目录是否过多。•是否包含当前没有真实用途的分类。

不满意就直接告诉 Codex 修改意见,不需要在每次反馈里重新编号版本。

代码块

请根据我下面的意见,输出一份可以独立阅读的完整修订版方案。2我的修改意见:【填写需要合并、删除、增加或改名的内容】5现在仍然只修改方案,不操作文件。输出后等我最终确认。

确认方案并创建最小系统

方案确认后发送:代码块我确认使用刚才最终确认的完整方案,请开始创建最小知识库。1 2执行前:4 1. 再次确认当前工作目录就是知识库根目录。2. 检查现有文件和目录是否与最终方案冲突。3. 如果已经存在同名目录、README.md、AGENTS.md 或其他同名文件,立即停止并报告差异,不要覆盖或自动合并。4. 检查最终方案是否包含可以直接写入的 README.md 和 AGENTS.md 完整草案;如果缺少,先停止并告诉我,不要自行补充。9确认没有冲突后:11 1. 只创建最终方案中已经确认的目录和文件。2. 按照最终方案中已经确认的完整草案写入 README.md 和 AGENTS.md。3. 不要自行增加、删除或改写已经确认的目录、正文和规则。4. 不创建最终方案中明确列为“暂不创建”的内容。5. 如果需要操作任何已有资料,先停止并向我确认。6. 完成后检查:- 实际目录是否与最终方案一致- README.md 是否与实际目录一致- AGENTS.md 是否与确认内容一致- 是否意外创建了方案以外的文件7. 自检完成后,再统一汇报实际创建结果。

放入 3 份资料并完成第一次整理

如果没有自己可以测试的本地文件,使用以下3份文件即可:

李想罗永浩26年5月对话讲了173个观点.md

当 Obsidian 遇上 Claude Code:知识管理的革命性升级丨附详细教程.md

如何打造个人知识体系?.md

由用户把 3 份可以公开或可以安全测试的资料副本放入:

代码块

00_收集箱

不要使用唯一一份重要资料,也不要一次导入全部历史文件。

然后发送:

代码块

请先读取当前知识库的 README.md 和 AGENTS.md,再检查 00_收集箱中的 3 份测试资料。

2请用表格列出:- 文件名- 建议位置- 分类理由- 目标位置是否已有同名文件- 是否需要我确认9现在只输出整理方案,不移动、删除、重命名或修改文件。如果现有目录已经能承接资料,不新增分类。原始资料默认保护正文,不要用总结替换原文。如果你需要我确认分类选项,我的回答只用于确定整理方案,不代表授权执行;在我发送下一条执行提示词前,不要操作文件。

不满意就直接告诉 Codex 修改意见。

确认方案后发送下面的提示词:

代码块

我确认刚才的整理方案,请只处理这 3 份测试资料。2执行前检查目标路径和同名文件,不覆盖、不自动合并,不删除文件,不改写原文。整理完成后检查文件数量、目标位置和原位置,再汇报实际结果。

基于资料完成一次真实任务

选择一个现场可以完成的问题或输出:

【】要输入具体的任务描述和指令。

示例:【我刚学习AI,属于新手小白,请你学习知识库中关于知识管理的2份资料,进行总结和释义,

重新输出一份知识管理的学习教程给我,让我可以看懂相关的专业名词和流程步骤。】

如果你使用的是本次文档中给3份测试文件,可以复制上面这段任务描述指令来进行测试。

代码块

请阅读刚才整理的 3 份资料,完成下面的真实任务:2【填写问题或需要输出的内容】4要求:1. 只依据当前资料和可以明确识别的事实回答。2. 列出参考文件名或相对路径。3. 区分资料中的信息、你的归纳结论和 AI 推断。4. 资料不足时明确告诉我缺少什么,不要补写不存在的事实。

5. 先在对话中输出,不要直接写入知识库。

如果结果符合需要,可以再说:

【】要输入具体的目录,没有目标目录可以输入“帮我创建用于XX的目录,目录结构根据你的建议

来”。

代码块

请把刚才确认的结果保存为一份新的 Markdown 文档,放到【目标目录】。保留参考文件列表,完成后检查文件是否创建成功。

第一次闭环包括:

代码块

资料进入→ Codex 提出整理方案→ 用户确认→ 文件完成整理→ 基于资料完成真实任务→ 结果继续沉淀回知识库

作品展示

展示时只讲三件事:

1. 我想解决什么问题。

1. 我的最小知识库结构是什么。

1. Codex 根据资料完成了什么真实结果。

现场做到这里,完成现场闭环后,不需要每次重复整套搭建流程。日常管理知识库时,根据具体任务

直接告诉 Codex 要做什么即可。

从第一次操作进入日常使用

完成现场这组操作后,知识库才开始进入日常使用。我后来最常用的四类任务,都来自下面这些可以

直接说给 Codex 听的话。

第二部分:日常使用|四句话管理知识库

日常只需说清任务、资料范围和确认边界; AGENTS.md 与已经验证的流程负责其余约束。

1. 帮我整理知识库/帮我整理新增资料

代码块

帮我整理新增资料。先检查并给出方案;涉及新增分类、移动、重命名、覆盖或修改原文时,等我确认后再执行。

2. 帮我创建项目

代码块

帮我为【项目名称】创建项目。2先检查是否已有同名或用途重叠的项目,再给出项目目录、目标、交付物和 PROGRESS.md 方案。等我确认后创建。

3. 帮我检查哪些文档需要更新

代码块

请只读检查当前知识库中哪些文档需要更新。2重点检查 README.md、AGENTS.md、已有文件目录.md、相关项目 PROGRESS.md,以及内容与实际状态不一致的文档。先列出理由和修改建议,不要直接修改。

4. 帮我基于 XX 资料输出 XX 内容

代码块

请阅读【资料范围】,基于这些资料输出【目标内容】。2列出参考文件名或相对路径,区分资料内容、归纳结论和 AI 推断。资料不足时告诉我缺少什么,不要补写不存在的事实。先在对话中输出,等我确认后再保存。

更多常用说法

场景可以直接说

规整格式帮我规整这些文档的格式,不要改动原文内容

整理剪藏整理网页剪藏入口中的文章,分类不确定时先告诉我继续项目先读取项目 PROGRESS.md,再继续推进,完成后更

新进度

学习评估阅读相关资料,总结当前掌握程度和下一阶段行动建

议

知识问答根据指定资料回答问题,列出参考文件,资料不足时

明确说明

执行方案可以,按刚才确认的方案执行,完成后自检

第三部分:进阶选学

等真实需要出现以后再扩展

日常任务用过一段时间以后,再处理备份、项目和 Skills。下面的内容可以按需要选择,不用在第一次

搭建时全部完成。

完善个人知识库

隐私与数据边界

“本地知识库”表示原始文件保存在自己的电脑上,不代表 AI 处理过程完全离线。Codex 读取资料并

回答时,相关内容仍受当前账户、套餐、数据控制和组织规则影响。

开始前需要注意:

•检查 ChatGPT 的数据控制设置和组织管理要求。•不在知识库中保存密码、API Key、验证码、恢复码等访问凭据。•身份证件、财务、医疗、合同和客户资料只提供完成任务所必需的最小范围。•对外分享或生成平台副本前再次检查隐私。

生成更完整的个性化方案

现场已经跑通最小闭环的人,可以继续补充真实需求:

代码块

请只读检查当前知识库,不要修改文件。2请先向我了解:1. 我建立知识库的长期目标,以及希望得到哪些输出。2. 我经常保存哪些资料,资料来自哪里。3. 我已有的文件、目录和正在推进的项目。4. 我对目录命名、分类数量、操作确认、隐私保护和 AI 协作方式的偏好。

8然后结合当前实际文件,输出一份完整修订方案,包括:- 推荐目录和每个目录的必要性- 资料进入、整理、使用、产出和归档的流向- README.md 和 AGENTS.md 的调整建议- 是否确实需要文件目录.md- 只有存在长期项目时才考虑项目 PROGRESS.md- 现有资料迁入方式- 日常管理方式- 执行顺序、确认节点和验收标准18目录先少后多,不要为了完整而创建暂时没有真实用途的分类。现在只输出方案,不操作文件。

Codex 输出方案后,用户需要确认:

•目录名称是否容易理解。•分类之间是否存在重叠。•每个目录是否有真实资料来源或真实用途。•文件移动、原文保护、备份和隐私边界是否能够接受。•执行顺序和完成标准是否清楚。

什么时候需要文件目录.md

文件目录.md 不是第一次搭建的必做文件。

满足以下情况之一时,可以让 Codex 根据实际文件生成:

•文件数量已经明显增加。•资料分散在多级目录中,经常找不到位置。•需要一张可以快速搜索文件名、类型和路径的索引。•需要检查资料是否已经归档或是否存在重复文件。

代码块

请只读扫描当前知识库的实际文件,根据真实文件生成文件目录.md。2至少包含:- 文件名- 资料类型- 当前目录- 相对路径- 更新时间9要求:1. 实际文件系统是唯一事实来源。2. 文件目录.md 只是可以重新生成的索引。3. 不根据旧索引移动文件。4. 不记录对外分享时不应公开的完整本地路径。5. 现在只创建或重建索引,不移动、删除或修改资料正文。

如果索引和实际文件不一致,应重新扫描实际文件,而不是按照旧索引调整文件。

备份和高风险操作

第一次低风险测试使用资料副本。

以下操作开始前必须建立知识库外的可恢复副本:

•批量移动或重命名。•删除或覆盖文件。•目录重构。•大规模正文修改。•导入大量唯一原件。

备份完成后至少核对文件数量,并随机打开重要文档或附件。同步盘主要解决同步,不应作为唯一备

份。

格式规整与原文保护

Codex 默认可以直接处理:

•多余空行和纯空格行。•行尾空格和不可见字符。•导入造成的重复首标题。•空标题。•明显断裂的数字序号和项目符号。•列表项之间不必要的空行。

Codex 默认不能直接处理:

•改写或润色正文。•删除看起来重复但可能有意义的段落。•调整观点顺序。•改变标题层级所表达的含义。•用摘要替换原文。

如果分不清是格式修复还是内容修改,一律先询问用户。

完整基础验收

现场 4 项完成清单通过后,可以在课后进行更完整的检查。:

Obsidian 能正常打开知识库。

Codex 已只读验证知识库路径和实际文件。

目录来自自己的真实目标或明确选择的最小方案。

README.md 与实际目录和资料流向一致。

AGENTS.md 保持精简,并包含确认、原文保护、同名检查和自检规则。

如果创建了文件目录.md,它与实际文件一致并可重新生成。

高风险操作前有知识库外的可恢复备份。

敏感信息检查不会复述具体值。

第一批资料完成了先方案、确认后执行。

同名文件没有被自动覆盖或合并。

格式规整没有改写原文。

已经完成一次带来源的真实问答或内容输出。

需要长期推进的项目有 PROGRESS.md。

代码块

请只读检查当前知识库是否完成从 0 到 1 的基础搭建。2请用表格输出:- 检查项- 状态- 实际证据- 需要修正的内容8只检查当前实际存在的基础功能,不要把网页剪藏、项目管理、第三方平台、Skills 和总控流程作为通过条件。现在只检查,不修改文件。

建立项目管理

满足以下任一情况,就适合建立项目:

•有明确目标和交付物。

•需要跨多次对话推进。•有重要决策和下一步需要记录。•相关资料会持续增加。

代码块

请在知识库中为【项目名称】建立项目目录和 PROGRESS.md。2 PROGRESS.md 包括:- 项目目标- 当前状态- 已完成- 最近决策- 下一步- 待确认问题10要求:1. 先检查是否已有同名或用途重叠的项目。2. 如果存在重叠,只汇报现状、差异和建议,等我确认后再创建。3. 不要编造已经完成的事项。4. 创建完成后检查 README.md 是否需要更新。5. 如果已经使用文件目录.md,再根据实际文件更新索引。6. 最后检查项目目录、PROGRESS.md 和相关说明是否一致。

以后继续项目时可以说:

代码块

请先读取【项目路径】中的 PROGRESS.md,再继续推进【本次任务】。完成后更新项目进度并自检。

Skills 和总控流程

Skills 从重复任务里来

我的 4 个 Skills 也是在知识库已经投入使用以后才做的。先让真实任务重复出现,再把稳定步骤写成

Skill,会更容易判断它负责什么,也更容易检查执行结果。

先理解三个概念

名称普通理解例子AGENTS.md整个知识库长期遵守的精简规则不擅自删除文件、保护原文

Skill一项重复工作的固定步骤资料分类、格式规整、项目进度更

新

总控流程根据任务选择和组合合适的 Skills收到整理任务后依次分类、规整和

自检

Skill 是 Codex 可以识别的可复用工作流。项目级 Skill 放在:

代码块

.agents/skills/【Skill 名称】/SKILL.md

每个 SKILL.md 至少需要包含 name 和 description ,并且只负责一类明确任务。

本手册中的:

代码块

.agents/knowledgebase-manager-agent.md

是作者使用的本地总控流程文件,不是平台自动注册、也不是后台独立运行的 Agent。它需要用户发起任务,并由 AGENTS.md 指示 Codex 读取后才会工作。

什么时候创建

先正常使用知识库。当一项操作重复出现 3 次以上,而且步骤和判断基本稳定时,再考虑做成 Skill。

代码块

请读取当前知识库的 AGENTS.md、README.md、已有项目 PROGRESS.md,以及当前能够看到的知识库管理记录。2找出有证据表明重复出现 3 次以上、步骤和判断已经比较稳定的操作。4请输出一份完整的 Skills 和总控流程方案,包括:6 1. 哪些操作适合做成 Skill,并列出重复出现的证据。2. 哪些操作证据不足,暂时不应做成 Skill。3. 每个候选 Skill:- 负责什么- 不负责什么- 在什么情况下触发- 建议名称- 建议保存路径- SKILL.md 中的 name 和 description- 核心执行步骤和安全边界4. 哪些 Skills 可以由一个总控流程组合调用。5. 是否需要创建总控流程文件,以及建议保存路径。6. 根目录 AGENTS.md 需要增加或调整的路由规则。7. 计划创建和修改的完整文件清单。8. 创建后的低风险测试方法和验收标准。22项目级 Skill 默认规划到:24.agents/skills/【Skill 名称】/SKILL.md 26总控流程如果确实需要,默认规划到:28.agents/knowledgebase-manager-agent.md 30以上路径和结构也必须作为方案的一部分供我确认。32证据不足时明确标记“证据不足”,不要自行假设。34现在只输出完整方案,不创建或修改文件,等待我确认。

确认后创建

代码块

我确认使用刚才最终确认的 Skills 和总控流程方案,请按照确认内容执行。2执行前:4 1. 检查计划中的目标目录和文件是否已经存在。2. 如果存在同名 Skill、总控流程或 AGENTS.md 路由冲突,立即停止并报告差异,不要覆盖或自动合并。3. 再次核对准备创建和修改的文件是否都已在确认方案中展示。8确认没有冲突后:10 1. 只创建确认方案中选定的 Skills。2. 按照确认方案中的名称、路径、name、description、职责、触发条件和安全边界写入SKILL.md。3. 只在确认方案需要时创建总控流程文件。4. 只按照确认方案修改根目录 AGENTS.md 中的启动和路由规则,不复制全部 Skill 细节。5. 不自行增加、删除或合并未经确认的 Skills。6. 未经授权且没有固定规则覆盖时,删除、移动、重命名、目录调整和正文修改仍然必须先确认。7. 创建完成后只检查:- 文件路径和名称- YAML 元数据- Skill 职责与触发条件- 总控流程引用- AGENTS.md 路由8. 本次不要自动运行真实知识库整理任务。24完成后告诉我实际创建和修改了哪些文件、自检结果,以及应该使用什么低风险任务进行第一次测试。

第一次测试使用少量资料,并明确说:

代码块

请使用 knowledgebase-manager-agent 帮我整理新增资料。先检查并给方案,不要直接执行高风险操作。

如果 Skill 没有出现在 Codex 中,先检查路径和 SKILL.md 元数据,再刷新或重启 Codex。

官方参考: Build skills

五、本次线下聚会复盘

以上实操内容,从最小闭环版本到进阶选学稳定系统内容,深浅兼顾,可按需选学。

现场分享以PPT主线讲解+真实过程演示+实操手册的形式,PPT介绍个人AI知识库完整系统如何构成,

先看我为什么搭建知识库,看Obsidian和Codex的协作方式,沉淀的规则和输出闭环,再打开Codex

后台回看最早的需求、修改意见和执行记录,通过真实案例、成果展示帮助大家理解各种概念,最后

跟着实操手册搭建最小版本,完成一次真实任务。分享复盘总体反馈还不错(其实要感谢大家舍不得

批评,有提升优化建议也给的非常细节和中肯)。

1. 通过真实案例理解: 如何使用自然语言,让AI出方案-人审核-AI执行-人验收的AI协作应用,如何通

过一步步规则沉淀,最终形成可以复用的Skill、Skills、Agent总控。看到README.md、

AGENTS.md里有什么。

2. 无代码完成个人AI知识库搭建最小闭环: 现场有圈友跟随实操手册操作,很快就完成了自己第1个

最小版本知识库结构,并使用文档中提供的测试资料和提示词,完成了用Codex使用测试资料重新

输出内容写回知识库的最小闭环流程。

3. 现场遇到的问题和我给的解决方案:

•Codex的安装问题:◦有些Windows电脑由于系统问题,不能使用微软商店,安装时不能唤起,可以使用完整的安装

包进行安装;

◦在8月航海手册中都有相关的安装包。

•Codex使用CC Switch配置的AI大模型,无法正常工作,发出提示词后会突然终止工作:◦ChatGPT Plus账号订阅:IOS礼品卡代充,充值+手续费140/月左右,可以同时使用GPT和

Codex,和Hermes(一鱼三吃),资本家看了都流泪系列。

◦成功订阅ChatGPT Plus会员后,无法在Codex桌面版直接切换模型,刚开始让Codex自己切

换,但是频频报错,于是让Workbuddy去给Codex换模型,成功的退出了CC switch,恢复在

Codex桌面端切换模型。

◦让AI自己修自己,把修复过程中的报错返回给AI继续修复;让AI修AI,跨AI修复,Workbuddy

修Codex;

◦遇到问题等AI解决完可以回看一下它处理的过程或者让它总结解释给你听,这样就明白了这次

为什么出现问题,是怎么解决的。虽然没有自己动手,但是也学到了。

•让Codex使用知识库中的资料进行新的内容输出,但是输出质量太差:◦需要说明详细的背景和个人需求,例如:学习阶段-AI新手小白,问题-看不懂AI专业名词,需

求-用通俗的语言解释,最好用具体的场景举例说明。

六、结尾

这套方法的工作顺序

这套方法通过以下管理链路持续运行:

代码块

根据真实用途设计→ 从 3 份资料开始→ Codex 先给方案→ 用户确认后执行→ 基于资料完成真实任务→ 结果继续沉淀→ 重复流程稳定后再做成 Skill 和总控流程

先完成一个可以使用的最小闭环,再根据真实需求逐步升级。

这份手册也经过了同样的协作过程

这份实操手册由 Codex 通过搭建过程对话总结+Obsidian沉淀的过程记录文档,输出方案和初稿,我

负责审核事实、步骤和表达,再给出修改意见,Codex 根据意见继续修改,每次调整以后,还要检查

手册、PPT 和相关文件版本是否一致。

现在可以准备 3 份非敏感资料,先完成第一次整理和使用,再选一个你确实需要解决的问题,确认这

个版本已经能帮到你,再决定下一步增加哪些目录和功能。

一些感谢的话

感谢生财有术 ,有丰富、详细的AI实战内容,让新手小白可以从焦虑、迷茫,到在生财找到相应的学

习路径,有高手帮助,并且能够尝试公开分享,尝试被看见。

感谢安静先生 ,从5月超级AI大航海开始,像哆啦A梦一样,遇到任何问题,都被耐心和及时的帮助。

感谢石榴教练 ,持续的公开分享,生财济南线下的组局,给大家提供了良好的实践交流环境,并且鼓

励大家参与进来,在我提出想要分享之后,对课件内容多次耐心指导,得到很大的进步。

感谢小武 对文章内容的优化指导。

因为有人无偿的分享和帮助,让我也愿意在有一些小小实践经验之后,尝试大胆对外发言。

希望未来可以和更多高手交流学习,也可以持续有反馈输出,能帮助到刚开始学习AI和正在学习AI的

人。

附录

附录 A:Obsidian Web Clipper

只有经常保存网页文章时才需要配置。本部分不属于第一次现场实操。

1. 安装浏览器扩展

浏览器安装入口

Chrome、Brave、Arc 等 Chromium 浏览器Chrome Web Store

Microsoft Edge Edge Add-ons

Firefox Firefox Add-ons

Safari App Store

官方说明: Obsidian Web Clipper 帮助

2. 通用参数

参数参考值

Behavior Create a new note

Vault选择自己的知识库Note name{{title}}

3. 三组参考模板

模板触发规则Note location正文变量tags

Clippings/Web/{{content}}clippings通用网页不设置,作为默认

{{date|date:"YY
模板
YY-MM"}}

飞书文档/^https:\/\/[^Clippings/Feis{{content}}feishu

/]*feishu\.cn\/hu/{{date|date:

docx\//"YYYY-MM"}}

微信公众号https://mp.wei Clippings/WeCh{{content}}wechat

xin.qq.com/at/{{date|date:

"YYYY-MM"}}

Properties 可以使用: title 、 source 、 site 、 author 、 clipped 、 tags 。

通用网页 Note content:

代码块

# {{title}}2> [!info] 来源> [{{domain}}]({{url}})> 剪藏时间:{{date|date:"YYYY-MM-DD HH:mm"}}6—8{{content}}

飞书文档 Note content:

代码块

# {{title}}2> [!info] 飞书来源> [打开原始文档]({{url}})> 剪藏时间:{{date|date:"YYYY-MM-DD HH:mm"}}6—8{{content}}

微信公众号 Note content:

代码块

# {{title}}2> [!info] 微信来源> [打开原文]({{url}})> 作者:{{author}}> 剪藏时间:{{date|date:"YYYY-MM-DD HH:mm"}}7—9{{content}}

配置完成后剪藏一篇真实网页,确认标题、正文、来源链接和保存目录正确。飞书正文不完整时,先

选中需要保存的内容再剪藏。

附录 B:第三方平台适配

本地 Markdown 文档保留为原始版本。需要在飞书、Notion、公众号等平台使用时,优先生成平台适

配副本。

代码块

请读取【原文路径】,生成一份适合【平台名称】使用的版本。2要求:1. 保留本地原文,不覆盖原文件。2. 根据平台能力选择 Markdown、DOCX、HTML 或可直接粘贴的排版稿,并说明选择理由。3. 新建一份带平台名称的适配副本。4. 不添加原文没有的事实。5. 当前无法直接写入平台时,生成可以导入或复制粘贴的本地版本。6. 涉及账号登录、对外发布或覆盖线上内容时,再次得到我的明确确认。

附录 C:对外分享和隐私保护

对外分享时只分享系统,不复制自己的完整知识库。

可以保留:

•通用目录示例。•通用版 README.md 和 AGENTS.md。•通用 Skills 和总控流程模板。•空白模板和脱敏示例文件。

必须排除:

•个人画像、历史对话和每日记录。•私人项目、原始资料、剪藏正文和附件。•姓名、账号、联系方式、真实路径和访问凭据。•可以识别个人身份或业务的信息。

代码块

请生成这套知识库的对外分享版本。2只保留通用目录、规则、Skills、总控流程、空白模板和虚构示例。排除个人资料、私人项目、历史对话、原始资料、剪藏正文、附件、真实路径、账号和访问凭据。5先输出保留清单和隐私排除清单,等我确认后再生成。7生成后检查最终发布文件夹或 ZIP,而不只是检查源目录。疑似敏感信息只报告文件路径和信息类型,不展示具体值。输出隐私检查报告,并提醒我进行人工最终复核;不要自行宣布“可以直接发布”。

正式发布前由用户完成:

•查看最终发布包的完整文件清单。•搜索姓名、联系方式、账号、盘符、用户名、公司名、客户名和私人项目关键词。•随机打开文档、图片和附件,检查正文、路径、链接和元数据。•确认发布包与源知识库分离,再决定是否发布。

附录 D:常见问题

问题处理方法

Codex 找不到知识库打开本地文件夹或项目,再运行只读访问验证

不知道用什么目录回答用途问题,或选择通用最小方案目录越建越多合并用途相近分类;没有真实资料来源的目录暂不创

建

遇到同名文件停止处理,比较差异,让用户选择保留两个、改名或

人工合并

文档显示两个标题检查文件名标题和正文一级标题是否重复

网页正文无法保存使用 Web Clipper、保存 PDF,或复制为 Markdown

AI 可能改动原文使用精简 AGENTS.md 约束,高风险操作前备份并明

确只读或只做格式规整

文件目录.md 与实际文件不一致以实际文件为准重新生成索引,不按旧索引移动文件

本地知识库是否完全离线不是。文件保存在本地,但 AI 处理仍受账户和数据控

制设置约束

AGENTS.md 能否恢复误删不能。它是协作规则,不是备份或版本控制

怎样确认备份有效核对文件数量并随机打开重要文档和附件

Skill 没有出现检查 .agents/skills 路径、YAML 中的 name 和

description,然后刷新或重启 Codex

总控 Agent 会不会后台自动运行不会。本手册的总控文件需要用户触发并由

AGENTS.md 路由读取

第三方平台不能直接写入生成平台适配副本,再手动导入或粘贴

相关阅读

© 版权声明
THE END
喜欢就支持一下吧
点赞11 分享
blake的头像-环球搭子
评论 抢沙发

请登录后发表评论

    暂无评论内容