端到端完成一个入门任务

把前面学的串成一次完整任务

前几节学了概念和技巧。这一节，用它们完成第一个真实任务，走通「自然语言 → 代码 → 结果」的完整链路。

任务目标：在我们贯穿项目 text-tools 里，端到端完成一个「文本处理」功能——输入一段文本，它能统计字数并转换大小写。

---

第 1 步：准备一个干净环境

先确认我们在 text-tools 这个干净工作区里，避免乱。上一模块我们建过这个目录，现在确认并进到正确位置：

codex "确认当前工作目录是 text-tools；如果不在，cd 到 text-tools"

再准备一个测试用的示例文本文件 sample.txt，让 Codex 在沙箱里建好：

codex "在 text-tools 里创建 sample.txt，内容是：Hello Codex 你好，这是 text-tools 的第一次任务。"

这样我们的输入就有了，后面就能真实地「给它文本，看它处理」。

---

第 2 步：写一个清晰的任务描述

套用五段模板，写清楚再发给 Codex：

【目标】做一个 text-tools 的核心工具：输入一段文本，能统计字数、转换大小写
【输入】命令行读取 sample.txt 的文本
【输出】打印 1) 字数统计 2) 转成大写后的文本
【约束】用 Python 标准库，不用第三方库；输出前加上清晰的标签
【验收】运行 python tool.py sample.txt，能看到字数和大写转换的结果

这一步是全部的关键——花时间把描述写清，就是给后面的顺利打底。

---

第 3 步：让 Codex 实现

把描述发给 Codex，让它做。它会：理解需求 → 写代码 → 可能自己跑一下验证。

用自然语言把上面的任务描述发给 Codex

观察它怎么从需求到代码。它会先看 sample.txt、创建 tool.py、写统计字数和转换大小写的逻辑，还可能自己跑一遍确认能工作——这是你第一次完整体验「云端 Agent 编程」。

一个更细的、可直接照抄的实现提示（如果它一开始太简单）：

codex "按上面的验收标准实现 tool.py：用 sys.argv 或 input 读取 sample.txt 内容；统计中英文字符数；再用 .upper() 转大写打印。跑 python tool.py sample.txt 确认能出结果"

---

第 4 步：验收它的成果

别直接信它，自己验证。让它在沙箱里跑，并明确要求它贴出真实输出：

codex "运行 python tool.py sample.txt，把实际输出完整打印给我"

看输出是否符合验收标准：字数有没有、大小写对不对、标签清不清楚。不对就反馈它改。

---

第 5 步：把结果同步回本地

记住沙箱的事：它在沙箱里改的东西，可能要先同步/导出到本地，你的项目才有这些文件。

• 检查你要交付的文件（tool.py、sample.txt）有没有在你能访问的位置
• 没有的话，让它把成果同步/导出到工作目录

一个可复制示例：

codex "把 text-tools 里的 tool.py 和 sample.txt 同步/导出到我能访问的工作目录，并列出确认文件都在"

这一步别省——它是「沙箱里做出来」到「你真正拥有」的最后一环。

---

完成的标准

这个任务「完成」的标志：

• [ ] 在正确的工作目录、干净的会话里开始
• [ ] 五段式描述写清楚了（目标/输入/输出/约束/验收）
• [ ] tool.py 能统计字数、转换大小写
• [ ] 运行 python tool.py sample.txt 输出符合验收标准
• [ ] 成果已同步到你能访问的位置，文件都在
• [ ] 代码你大致看得懂

全过，你就走通了完整的「自然语言 → 代码 → 结果」链路，也完成了 text-tools 的第一个里程碑。

---

落地练习：再做一个小功能，练熟端到端

第一次做通后，再加一个功能巩固整个流程：

1. 用五段式描述，给 tool.py 加「查找替换」功能（找某个词，全部替换成另一个词）
2. 让 Codex 实现，再让它跑一个真实样例给你看输出
3. 验收通过后，让 Codex 把更新同步/导出到你能访问的位置

怎么判断做对了？——加功能的整个流程里，你没有跳过「写清楚描述」「看真实输出」「同步成果」任何一步。新的替换功能能用，且更新后的 tool.py 在你手上。

卡住了怎么办？ 描述不清楚导致跑偏？回看五段模板补全。跑不出结果？让它把报错打给你，再带着报错反馈。文件不在本地？让它明确同步/导出并列出确认。

---

常见坑：验收只看「它说跑通了」，不亲眼看输出

新手最容易在最后一步翻车：Codex 说「已完成、跑通了」，你信了，直接收工——结果一运行就报错，或者输出根本不是你要的。

「跑通了」是 Codex 的自评，你得亲自验收：让它把真实输出打给你看，最好自己再跑一遍确认。「它说行」和「你真的看到行」是两回事。 养成「眼见为实」的验收习惯，是完成任务不掉链子的底线。

---

小结

1. 第一步：干净目录 + 示例数据
2. 写清任务描述（目标/输入/输出/约束/验收）
3. 让 Codex 实现，观察它怎么做
4. 自己验证 + 把成果同步回本地
5. 你已完成 text-tools 的第一个里程碑（统计字数 + 大小写转换）

下一节，回顾这次任务并排查常见问题。