7 天完成第一个 AI 项目

整理真实内容
和项目工作区

把文字、图片、来源和项目规则分开放置,让 Agent 在清楚的边界里工作。

预计阅读 22 分钟公开免费核验于 2026.08.19
内容目录 当前:第 02
7 天完成第一个 AI 项目7
7 天学会 DeepSeek Harness7
7 天建立 Agent 工作流7
7 天做出个人知识库7
本文目录 8 个部分

大家好,我是云途。昨天确定了要交付什么,今天把页面真正需要的材料准备好。

页面里的空白常常并非设计问题,原因是内容没有准备。今天只整理真实材料和工作区,不追求视觉效果。

先理解今天的原理

Agent 读取的是你提供的文件和规则。材料混在下载目录里、文件名含糊、图片来源不明时,它很难判断哪些内容可以使用。

工作区把长期规则、内容原件、页面代码和检查证据分开。这样的结构可以追溯来源,也能让你安全地替换内容而不误改程序。

项目规则、真实内容、程序文件和验收证据各自放在固定位置。终端输入窗口Shell解释命令路径指出位置项目限定范围
项目规则、真实内容、程序文件和验收证据各自放在固定位置。

为什么今天要做这件事

  1. 真实内容会决定页面需要多少空间和哪些组件。
  2. 清楚的目录可以限制 Agent 的操作范围。
  3. 来源与授权记录能避免后续误用图片和文字。

开始前检查

这是第 02 天。先完成下面的检查,再开始操作。缺少关键材料时,先补材料,不要让 Agent 猜。

  1. 昨天的 PROJECT-BRIEF.md 已经保存。
  2. 准备一段真实介绍、三个真实作品和联系方式。
  3. 准备有使用权的头像或作品图片;没有图片时保留明确的待补标记。

一步一步完成

第 1 步:在独立目录中建立工作区

今天先把规则、原始内容、程序和检查证据分开。这样 Codex 知道哪里可以写代码,你也能看出一张图片或一段文字来自哪里。

  1. 在昨天准备的独立项目目录打开终端。
  2. 运行下方建目录命令,创建 contentassetsevidenceapp
  3. 运行 find . -maxdepth 2 -type d | sort 查看结果。
  4. 如果终端显示的是正式项目或其他工作目录,先停下,不要继续创建文件。
完成这一步后,你应该看到:项目根目录下出现四个用途明确的子目录,`app` 保持为空,其他项目没有发生变化。
Finder 列表视图中的独立练习项目目录和项目内依赖
软件实拍 01:Computer Use 在 Finder 中打开课程专用项目;侧栏已隐藏,发布图不包含本机用户名和上级私人目录。

第 2 步:把页面文字集中写进 profile.md

页面设计会受到真实文字长度影响。今天先写内容原件,明天 Codex 才能按真实标题、介绍和作品说明安排空间。

  1. content 中创建 profile.md
  2. 填写真实姓名或品牌、身份说明和 80—150 字介绍。
  3. 为三个作品分别写名称、服务对象、完成结果和可公开链接。
  4. 写下一种有效联系方式;不适合公开的信息改为工作邮箱或公开账号。
  5. 缺少的内容写“待补:具体缺什么”,不要让 Codex 代写经历。
完成这一步后,你应该看到:`profile.md` 可以独立读懂,里面没有“某某项目”“这里放介绍”等无意义占位文字。
Finder 中展开的 content 目录和唯一内容真源 profile.json
软件实拍 02:Finder 展开内容目录后,可以直接确认页面资料集中在一个内容真源中;示例数据为课程专用虚构资料。

第 3 步:整理图片名称和使用来源

清楚的文件名能减少引用错误。来源记录可以回答图片是否属于你、是否允许公开,以及页面应该怎样署名。

  1. 把头像和作品图片复制到 assets
  2. 1.jpg 改成 portrait-vitchen.jpgproject-ai-editor-cover.jpg 这类能看懂的名称。
  3. assets/README.md 中记录文件、用途、来源和授权状态。
  4. 没有使用权的图片先移出发布清单,保留文字说明。
完成这一步后,你应该看到:每张准备使用的图片都有明确文件名和来源记录;无法确认授权的图片不会进入页面。

第 4 步:用 AGENTS.md 写明 Codex 的边界

项目规则会在后面的多次任务中反复使用。规则要写成具体动作,例如允许修改哪个目录、缺少材料时怎样报告、完成后必须检查什么。

  1. 在根目录创建 AGENTS.md
  2. 写明允许读取整个练习工作区,但程序文件只能创建在 app
  3. 写明不得编造个人经历、作品、客户和效果数字。
  4. 写明依赖只能安装在项目目录,不使用全局安装。
  5. 写明修改后要报告文件清单、启动命令和检查结果。
完成这一步后,你应该看到:任何新会话只读完任务书和规则,就能说清哪些目录能改、哪些动作禁止、完成后怎样交付。
VS Code Markdown 预览中的项目目标、允许范围、禁止事项和停止条件
软件实拍 03:Computer Use 在 VS Code 中预览真实 `AGENTS.md`;面包屑已隐藏,截图只保留可公开的课程规则。

第 5 步:让 Codex 做一次只读材料检查

这一步用来发现缺失内容和含糊文件。Codex 只读取并报告,不自动补图、不改文案,也不提前创建程序。

  1. 把下方只读检查提示词交给 Codex。
  2. 核对它列出的文件是否与目录一致。
  3. 查看缺失项是否会阻断明天的页面结构,例如作品没有结果说明。
  4. 把可补内容补齐;暂时无法补的项目保留明确标记。
完成这一步后,你应该看到:你得到一份真实材料清单和缺失项清单,没有出现新增程序文件或虚构内容。
VS Code 中的第 2 天工作区检查报告,包含依赖、内容真源和协作边界
软件实拍 04:VS Code 展示真实检查结果;项目内依赖、虚构内容真源和协作边界均已逐项核对。

第 6 步:保存今天的工作区基线

基线就是今天结束时的正确状态。明天 Codex 开始写程序后,可以用它判断原始内容和规则有没有被误改。

  1. 运行 find . -maxdepth 2 -type f | sort,把输出保存到 evidence/day-2-files.txt
  2. 再打开任务书、规则和 profile,确认文件能正常读取。
  3. 如果项目使用 Git,运行 git status --short 记录当前状态。
  4. 把仍待补的材料写进 evidence/day-2-missing.md
完成这一步后,你应该看到:`evidence` 中有文件清单和待补清单;任务书、真实内容、素材和规则都能找到。
建立工作区目录SHELL
mkdir -p content assets evidence app
find . -maxdepth 2 -type d | sort
先用 `pwd` 确认当前位于独立练习项目,再运行创建命令。
真实内容模板MARKDOWN
# 个人资料

## 姓名或品牌

## 一句话身份

## 个人介绍

## 代表作品 1
- 名称:
- 服务对象:
- 完成结果:
- 公开链接:

## 代表作品 2

## 代表作品 3

## 联系方式
三份作品保持相同字段,页面更容易形成稳定层级。
项目规则最小版本MARKDOWN
# 项目规则

- 允许读取当前练习工作区。
- 程序文件只允许创建和修改在 app/。
- 不编造姓名、经历、作品、客户和效果数字。
- 缺少内容时列出缺失项,等待用户补充。
- 依赖只能安装在项目目录,不使用全局安装。
- 完成后报告修改文件、启动命令、检查结果和未确认项。
规则写具体动作和目录,不写“注意安全”这类无法执行的口号。
只读检查工作区TEXT
请读取 PROJECT-BRIEF.md、AGENTS.md、content 和 assets。

这次只读检查,不创建、修改或删除文件。请输出:
1. 已有文件及用途;
2. 每个页面内容对应哪份材料;
3. 缺少或仍是占位符的内容;
4. 来源或授权不明确的图片;
5. 明天开始页面结构前必须先解决的问题。
核对报告是否与真实文件一致,再决定今天是否完成。

这次真实操作得到了什么

S01 第 2 天真实操作结果
项目状态文件确认了边界
  1. 独立目录、内容原件、素材说明、AGENTS.md 与 PROJECT-STATE.md 已建立;当前阶段明确写为尚未实现。
本次实际结果:第二天结束时,Agent 能从项目文件理解目标、规则和下一步。

正确结果长什么样

完成操作后,用结果来判断今天是否学会。页面能打开或命令能运行,只能说明流程启动了;下面这些证据同时出现,今天才算完成。

  1. 每份文字和图片都能说明用途。
  2. Agent 的只读清单与目录中的真实文件一致。
  3. 缺少的材料被明确标记,没有用虚构内容填空。
  4. 项目规则写明允许范围、禁止动作和完成后检查。

常见错误与恢复

把所有文件直接扔进根目录

按内容、素材、程序和证据重新分类。

图片只写 1.jpg

改成能表达用途的名称,并补上来源记录。

Agent 擅自生成占位文案

恢复改动,并在规则中写明缺少内容时必须报告。

留给明天的材料

结束前把今天的关键结果保存到项目目录。下一天会直接使用这些材料,保存清楚可以减少重复说明和错误猜测。

  1. 结构清楚的项目工作区。
  2. 完整或明确标注缺失项的 profile.md
  3. 图片来源清单和 AGENTS.md
完成检查

第 02 天完成检查

  • 每份文字和图片都能说明用途。
  • Agent 的只读清单与目录中的真实文件一致。
  • 缺少的材料被明确标记,没有用虚构内容填空。
  • 项目规则写明允许范围、禁止动作和完成后检查。

官方依据与延伸阅读

Codex 系统教学:写任务书实战项目:个人作品主页图文教程:Git 三个只读检查