[!SUCCESS] **先给结论：**原有知识库和新增知识库都要用，但学习目的不同。原有知识库帮助你理解项目、讲清项目；新增知识库训练你怎样使用 Codex、OpenSpec 等工具规范地完成开发。新知识库不能只浏览一遍，更不能停留在看文档、看源码，至少要亲手完成一次真实的 AI Coding 实践。

很多同学看到两套资料后，第一反应是：“是不是两套都要从头到尾学完，才能参加面试？”这个问题不能简单回答“是”或“不是”。你不需要逐篇打卡、把所有文章全部背完，但必须弄清两套资料分别培养什么能力，并把新知识库中的核心方法真正用起来。

原有项目知识库主要围绕 OncallAgent 的项目背景、设计立意、核心概念、功能模块和实现思路展开，帮助你回答“这是一个什么项目、为什么要做、主要解决什么问题”。新增工程化知识库关注的则是“在 AI 参与开发的情况下，怎样把一个想法规范地变成可以落地的工程任务”。它训练的不是多记几个技术名词，而是使用 AI、组织 AI、约束 AI 和推进交付的能力。

📷 [图片 token=Wgd6bL06hoDDcfxocJlcl2iInOg（未能下载，见飞书原文）]

一个帮助你理解项目，一个训练你驾驭 AI

两套知识库不是简单的新旧替换关系，也不是同一份内容换一种写法。它们分别回答两类不同的问题。

学习维度原有项目知识库新增工程化知识库
核心定位项目讲解与项目立意AI Coding 规范化与工程落地
主要问题OncallAgent 是什么，为什么这样设计，各模块怎样协作怎样让 Codex 理解需求、遵守规则、按计划完成开发并减少返工
学习重点项目背景、AI 概念、RAG、Agent、MCP、架构思路、功能流程和项目表达Codex、OpenSpec、SDD、AGENTS.md、需求澄清、方案规划、任务拆分、实现、验证和归档
正确学法理解项目逻辑，运行项目，建立完整的项目认知打开真实项目，亲手发起变更，让 AI 在规范和流程下完成一次工程实践
面试作用帮助你讲清项目价值、业务场景、技术方案和核心功能帮助你讲清自己怎样使用和驾驭 AI，怎样把模糊需求推进为可交付任务

可以把两者理解为两层能力：原有知识库让你“有项目可讲”，新增知识库让你“有 AI 工程协作过程可讲”。前者仍然重要，但在 AI 已经进入日常开发的环境里，只会介绍项目功能、背诵架构名词，已经不足以完整展示自己的开发能力。

📷 [图片 token=YyFCbzErDoD4ENxXdV2c5u0hncg（未能下载，见飞书原文）]

为什么新的知识库一定要学

过去学习一个项目，常见方式是先看教程，再看源码，最后把项目运行起来。这样能够帮助你理解系统，但它容易让学习停留在“别人已经做完了，我负责阅读和复述”的状态。进入 AI Coding 之后，开发者更重要的能力，是能不能把 AI 变成一个可协作、可管理的工程伙伴。

📷 [图片 token=Sx9ibqQGxo4CKsxuIp9cztfVnbS（未能下载，见飞书原文）]

Codex 可以快速阅读项目、生成代码、修改文件和运行检查，但它并不会自动知道你的真实目标。需求说得不清楚，它就可能快速跑偏；边界没有定义，它可能顺手修改不该动的地方；完成标准没有说明，它也可能在“看起来已经做好”的位置提前停止。真正有价值的能力，不是会不会把一句需求发给 AI，而是能否持续掌握方向。

📷 [图片 token=TkRSbK1SyoJMqZxzgtAcNeqRnGh（未能下载，见飞书原文）]

OpenSpec、SDD 和 AGENTS.md 等内容，正是为了解决这类问题。OpenSpec 帮助你把想法整理成 proposal、spec、design 和 tasks，再进入实现、验证与归档；AGENTS.md 把仓库中长期有效的规则告诉 Codex；SDD 则让开发围绕明确的规格推进，而不是完全依赖临时对话。学习这些内容，本质上是在学习怎样给 AI 建立目标、边界、节奏和完成标准。

📷 [图片 token=TqOvbfQJNop0KOxg3ZvcNT7mnZb（未能下载，见飞书原文）]

**因此，新知识库不是原有项目讲解的附录，而是面向 AI 时代的一套开发能力训练。**即使你已经把原有项目学得很熟，也应该继续完成这部分学习。

看完文档，不等于掌握 AI Coding

这套新知识库最容易出现的误区，是把 Codex、OpenSpec 和 AGENTS.md 当成新的面试知识点：看完概念、记住几个命令、浏览一下生成的文件，然后就认为自己已经掌握了。实际上，这样得到的仍然只是“知道”，还没有变成“会用”。

📷 [图片 token=DaYdbNNDgonvnzxEN9Xc7Fvinvd（未能下载，见飞书原文）]

真正的学习必须进入项目。你需要亲自打开 OncallAgent，选择一个范围合适的真实需求，例如完善一处用户提示、调整一个页面状态、补充一个小功能，或者修复一个能够复现的问题。然后让 Codex 和 OpenSpec 陪你走完整个过程。

实践中，你会遇到文档里无法替代的真实问题：最初的需求是否足够清楚，哪些内容应该明确排除，方案是不是设计得过重，任务拆分是否可以逐项完成，AI 有没有误解你的意思，什么时候应该暂停生成并重新调整方向。只有亲手处理过这些问题，你才会逐渐理解“驾驭 AI”到底意味着什么。

📷 [图片 token=WR7tbgiwHos8Hzx3iOCcGH7Hnte（未能下载，见飞书原文）]

**源码解析文章可以作为地图，帮助你找到练习入口；但阅读地图不是走完路线。**学习结果不应该是“我看过多少篇文章”，而应该是“我是否真的使用这套流程完成过一次变更”。

至少亲手完成一次 OpenSpec 开发闭环

第一次实践不需要选择很大的功能。需求越小，越容易把注意力放在方法本身。建议按照下面的顺序完成一次闭环：

  1. **先让 Codex 了解项目规则。**打开真实仓库，阅读项目说明和 AGENTS.md，确认本次练习允许修改什么、不应该修改什么。

  2. **把想法说清楚。**说明目标、使用场景、范围、非目标和完成条件。如果自己还没有想明白，先与 Codex 讨论，不要急着生成代码。

  3. **使用 OpenSpec 建立变更。**依次理解 proposal、spec、design 和 tasks 各自解决的问题，不要只关注文件有没有生成。

  4. **按任务推进实现。**让 Codex 围绕已经确认的方案逐步完成，过程中发现方向不对就及时停下来修正规格或任务。

  5. **完成验证和复盘。**检查需求是否真正完成，回顾 AI 在哪里理解正确、在哪里发生偏差、自己又是怎样调整的。

  6. **归档这次变更。**把这次练习从临时对话沉淀为项目可以继续使用的工程记录。

走完一次之后，再选择第二个不同类型的小任务练习会更有效。例如第一次做小功能，第二次处理缺陷或优化。重复几次以后，你会发现自己与 AI 的沟通会从“想到什么说什么”，逐渐变成有目标、有步骤、有边界的工程协作。

📷 [图片 token=E9i2bHRgiodq7JxhyfmcfSaanAd（未能下载，见飞书原文）]

根据自己的基础安排学习顺序

**第一次学习 OncallAgent。**先使用原有知识库建立项目认知，理解项目为什么存在、主要解决什么问题，以及 RAG、Agent、MCP 等概念在项目中扮演什么角色。具备基本认识后，就进入新知识库学习 Codex 与 OpenSpec，并尽快开始第一次实践。不要等到“所有项目文章都看完”才动手。

📷 [图片 token=U4OWbj4xYo1nH4xL0ZmcwweHn8B（未能下载，见飞书原文）]

**已经学完原有项目。**不需要重新学习已经掌握的项目讲解，可以直接把新知识库作为下一阶段主线。从 Codex、SDD、OpenSpec 和 AGENTS.md 开始，然后选择一个自己能够控制范围的小需求完成闭环。你的重点应从“这个项目是怎样设计的”转向“我怎样借助 AI 继续开发这个项目”。

**正在准备面试。**原有知识库用于整理项目介绍、设计立意和功能理解，新知识库用于准备 AI Coding 实践。不要只背 OpenSpec 会生成哪些文件，而要真正做一次，并把过程中最有价值的判断记录下来。时间有限时，也应优先完成一个小而完整的实践，而不是快速浏览更多文章。

📷 [图片 token=DiFVbHSuJoimQSxTOkjc8Njynkf（未能下载，见飞书原文）]

面试中真正值得讲的是你的使用过程

面试官如果继续追问 AI Coding，往往不会满足于“我用过 Codex”或“我安装了 OpenSpec”。更有区分度的内容，是你怎样让 AI 在一个真实项目中稳定工作。你应该能够自然地回答下面这些问题：

  • 为什么没有拿到需求就直接让 AI 写代码？

  • 你是怎样向 AI 描述目标、边界和完成条件的？

  • proposal、spec、design、tasks 分别帮助你解决了什么问题？

  • AI 曾经在哪个环节理解偏了，你是怎样发现并纠正的？

  • 哪些判断必须由你自己完成，哪些工作适合交给 Codex？

  • 为什么完成实现后还需要验证、复盘和归档？

  • 使用这套流程以后，返工、沟通和任务失控的问题发生了什么变化？

这些问题不能靠背诵概念回答。只有真正做过，你才能把需求怎样变化、方案怎样调整、AI 怎样执行、自己怎样做判断讲得具体。到了这个程度，OpenSpec 就不再是简历上的一个工具名称，而会成为你讲述 AI 工程实践的一条完整主线。

📷 [图片 token=MDqGbbqW1owintxyamlcT6Nrnrh（未能下载，见飞书原文）]

学习完成的标准不是“看完”，而是“做过”

你不必为了面试把两套知识库的每一篇文章全部学完，但新的知识库一定要进入实践。至少应达到以下状态：你亲手在真实项目中使用过 Codex；独立走过一次 OpenSpec 变更流程；能够用自己的语言解释每个阶段为什么存在；遇到 AI 跑偏时知道怎样暂停、澄清和调整；能够完整讲述一次从需求提出到完成归档的经历。

达到这个标准后，你在面试中谈论的不再只是“OncallAgent 有哪些功能”，还可以继续讲“我是怎样利用 AI 推进开发的”“怎样防止 AI 随意发挥”“怎样把一次对话变成规范化工程过程”。这正是新知识库希望补充的核心能力。

最后可以记住一句话：原有知识库重点回答“项目是什么”，新增知识库重点回答“我是怎样使用 AI 把项目做出来并继续做下去的”。项目知识要理解，AI Coding 方法更要亲手实践。只有真正用过，面试时才能讲得具体、从容，也经得起继续追问。

📷 [图片 token=AxKrb3LL5oMUelxOu4YczXHtnkd（未能下载，见飞书原文）]