Codex + Obsidian 知识库使用培训

Yuli Du · 2026-09-04

为什么需要一套工作方法

AI 能让第一次产出更快，但长期项目真正困难的部分，是让资料、决策、任务和复盘能够被下一位参与者找到、理解并继续推进。课程把 Codex 看作项目协作者，把 Obsidian 看作个人和团队的可读知识入口；两者都服务于人做判断，而不是替代责任。

Agent 很适合做资料梳理、已有内容改写、代码或文档草拟、重复检查、清单生成与明确范围内的执行。它应当先读清规则，再说明计划、操作范围和验证方式。

以下判断必须由人承担：任务是否值得做、事实是否可靠、访问和发布是否被授权、是否涉及隐私或商业敏感信息、最终方案是否符合业务目标。遇到目标冲突、来源不明、需要删除或对外发送内容时，应停下来请求方向。

一份可交给 Agent 的任务至少包含目标、已知资料、不可触碰的边界、交付物和验收方式。先提出短计划，再确认哪些文件会被读写；范围不明时，宁可先做只读检查。

目标：把现有课程笔记整理成站内长页。
资料：仅使用已确认公开的正文。
边界：不引用个人信息、内部素材或未公开地址。
交付：一份结构化 Markdown，并列出修改摘要。
验收：标题层级、代码块、表格和窄屏阅读正常。

执行时按计划逐项完成，重要判断写在结果里。遇到原始资料与要求不一致，不靠猜测补全；用占位或问题说明替代虚构。修改范围应尽量小，避免顺手重构无关文件。

审阅不只是看有没有报错。检查目标是否达成、内容是否完整、链接和交互是否可用、移动端是否可读，以及是否引入不该公开的材料。把未验证项和下一步说清楚，才算完成一次可接手的协作。

文档不是为了写得多，而是为了让新的协作者在开始行动前能迅速建立正确的上下文。README 写入口；AGENTS 写约束；架构说明写关系；handoff 写当前状态。它们不应代替真实资料，也不应记录敏感信息。

当一类任务反复出现、输入输出稳定、边界明确时，才适合整理成 Skill。一个好 Skill 会说明适用场景、前置条件、执行顺序、产物和停止条件。

例如，设计资料整理、项目收尾、链接检查都可以有可复用的步骤；而方向选择、商业判断和高风险发布仍应保留给人。第一次调用新 Skill 时，先选小范围、可逆的任务，确认它遵守边界后再扩大使用。

知识库应按信息的用途组织，而不是按“我当时在哪个软件里看到”组织。一个可持续的基础结构可以是：

每条重要笔记写清来源、更新时间、证据状态和适用边界。项目页只引用实际需要的资料，不把整个知识库作为上下文丢给 Agent。这样可以让知识库增长，同时保持公开内容、客户资料和个人信息之间的边界。

先为一个具体项目建立入口：目标、当前任务、关键文档、资料索引和最近一次 handoff。再把每天的新资料送进 Inbox，把已验证的内容沉淀到主题或输出。Workbench 的价值不在于增加工具数量，而在于让“从哪里开始、做到哪里、下次谁来接手”都能被回答。

选择一个低风险任务，用目标、资料、边界、交付物和验收方式写成不超过一页的任务卡。请特别标出哪些事实不能补、哪些操作必须先问。

为手边一个项目写 README、AGENTS、架构说明和 handoff 的最小版本。假设一周后由陌生协作者接手：他能否知道入口、边界、已验证项和下一步？

建立一个主题或项目页，连接至少三条已确认来源的笔记。为每条笔记写明用途和证据状态，并说明哪部分不能进入公开交付物。

完成后，你应该能够用一张任务卡启动协作，用 Plan—Execute—Review 控制过程，用四份项目文档完成转交，并让知识库为下一次项目提供可读、可查、可复用的上下文。