从零学用 Codex 搭网站 Day 5：把第一篇 Markdown 文章放上线

今天开始，网站不再只是几张固定页面。我们给它装一条最小内容管道：一个文件就是一篇文章，写完能进列表，也能有独立链接。

这篇是 从零学用 Codex 搭网站 的第 5 天。今天的最小可用单元只有一个：Markdown 内容目录、文章列表页、详情页，以及一篇真实文章。

先别收藏更多教程。打开 Codex，做完，看到结果，再回来继续。

今天只拿走一个结果

Markdown 内容目录、文章列表页、详情页，以及一篇真实文章。

你需要准备的输入也很少：文章标题、摘要、发布日期、正文和作者名。

如果这些输入还没有，先写“不确定”。真实的不确定，比让 Codex替你编一个答案有用。

第一轮对话：先让 Codex理解现场

把下面这段复制给 Codex。方括号里的内容换成你自己的。别删限制条件。

请为当前网站增加最小 Markdown 博客系统。

每篇文章至少保存：slug、标题、摘要、作者、发布日期、关键词、状态、正文。
需要：
- /articles 列表页；
- /articles/[slug] 详情页；
- 只展示 published；
- 构建时检查 slug 重复和必填字段；
- 先用一篇真实示例文章跑通。

请先解释内容文件放在哪里、发布一篇新文章要做哪三步，再开始实现。

发出去以后，不要趁它工作时继续塞十条要求。等它完成第一轮，看它检查了什么、改了哪些文件或引用了哪些证据。

第二轮：你亲手验收，不靠“看起来不错”

今天重点检查：新增文章是否自动出现在列表；草稿会不会误上线；slug 重复时构建是否失败；中文标题和代码块显示是否正常。

看到问题时，描述现象，不要抢着替它诊断。比如说“390px 宽度下右边被裁掉”，比“CSS 的 grid 写错了”更好。前者是事实，后者只是你的猜测。

接着发这段纠偏对话：

请模拟编辑犯错：复制一篇文章并保留相同 slug，运行内容校验，确认它会失败。然后恢复正确 slug，再构建一次。把失败信息和成功信息都告诉我。

怎么判断它真的理解了

网站任务里，Codex说“完成了”只是一个进度提示，不是验收结论。真正的证据通常只有几种：构建命令退出码为 0、目标 URL 返回正确状态、页面截图符合预期、自动测试覆盖了核心路径、改动清单与任务范围一致。让它把证据摆出来，你再判断。

如果改动突然扩散到很多文件，先停下来问：“为了完成今天这个结果，哪些文件是必要的？哪些只是顺手优化？” 新手最容易被一大串改动吓住，于是直接接受。其实缩小 diff 本身就是在学习系统边界。

还有一个土办法很好用：让 Codex在交付时写出“我没有做什么”。没有接数据库、没有做后台、没有配置真实邮件，都应明确写出来。知道当前版本的边界，明天才能接得上。

一个很容易踩的坑

先上一个复杂 CMS。你现在要验证的是持续写作，不是管理十个编辑和权限角色。

我现在判断提示词好不好，只看三件事：输入是不是事实，范围是不是够小，完成以后能不能验收。句子漂不漂亮，反而排在后面。

今天先别做这三件事

第一，别在任务做到一半时换技术、换表格或换一套提示词。工具切换会给人一种重新开始的轻松感，但旧问题没有因此消失。

第二，别把 Codex 的解释全部抄进笔记。只记你下次还会用的输入、判断和验收动作。其余说明随时可以再问。

第三，别把“多做一点”当奖励。今天的边界本身就是训练内容。能在最小成果通过后停手，说明你开始掌握任务拆分，而不是被新点子牵着走。

今天的 20 分钟刻意练习

不用 Codex 写正文。自己写 300 字，再让 Codex 只检查格式、断链和元数据。这样你能分清内容创作和工程发布。

练习时别开新教程，别换工具。卡住就把现场交回 Codex：你做了什么、预期什么、实际发生什么、原始错误是什么。

如果还是没做成，不要用“重新帮我做一次”清空现场。把最后一个成功状态、第一处失败、原始输出和你已经试过的动作写成四行。下一轮只解决第一处失败。这个习惯会让你少掉很多无效重来。

下班前的验收单

• [ ] 列表与详情都能打开
• [ ] 草稿不公开
• [ ] 重复 slug 会报错
• [ ] 新增文章步骤不超过三步

四项都过，今天就停。没过也别扩功能，只修最前面那一项。

留一条“明天还能接上”的记录

在项目里写下四行：

1. 今天做成了什么；
2. 哪个输入最影响结果；
3. Codex 哪次判断错了，你用什么证据纠正；
4. 明天开始前必须保持不变的东西。

这四行比再收藏十个提示词值钱。它们会逐渐变成你的工作说明、测试清单，最后才是可复用的 Skill。

少量资源不是少学，而是让资源短到足以马上行动。今天的教程到这里，剩下的时间交给你的手。