第一课：让 Agent 整理项目说明

你将完成什么

把一份散乱的笔记整理成清晰的项目说明。重点不是“生成很多文字”，而是经历 描述需求 → 确认计划 → 执行 → 检查 → 修订 的完整过程。

这篇教程不依赖某个 Agent 的命令格式。请先按你选择的工具的官方文档完成安装和接入。

1. 准备一个干净的练习目录

用文件管理器创建一个叫 agent-first-task 的文件夹。在里面新建纯文本文件 notes.txt，粘贴以下内容：

想做一个家庭书单网站，先不做账号。
首页展示书名、作者和一句话推荐。
数据先用本地文件，第一版收录 6 本书。
需要手机上也能看。
以后可能增加标签筛选，这次先不做。
上线时间还没定。
验收：能看完 6 本书的信息，没有空白卡片。

打开文件检查一遍，另外保存一份副本 notes.backup.txt。

预期结果： 文件夹中只有两份内容相同的练习文件。

2. 确认 Agent 的工作范围

在这个目录打开你选择的 Agent。具体打开方式因工具而异，使用其官方说明中的“打开项目”或“工作目录”方式。

先发送：

这是一次练习。先不要修改任何文件。
请告诉我当前工作目录，并列出该目录下的文件。
然后阅读 notes.txt，用三句话概括内容。
如果读取失败，请说明失败原因，不要猜测文件内容。

你需要检查： 它看到的是练习目录，概括中包含“家庭书单、6 本书、暂不做账号”，没有凭空增加需求。

3. 给出可检查的任务

发送下面的任务描述：

请根据 notes.txt，创建 README.md。

要求：
1. 保留原始文件，不要修改 notes.txt 和 notes.backup.txt。
2. README 用中文，分为：项目目标、第一版范围、暂不包含、验收清单、待确认事项。
3. 不添加原文没有的功能、技术栈和日期。
4. 把“上线时间还没定”放进待确认事项。
5. 暂时不要写程序、安装依赖或执行网络操作。

先给出简短计划，等我确认后再创建文件。

阅读它的计划。如果计划包含搭建框架、安装依赖或接入数据库，要求它收缩范围。计划符合要求后，回复“按这个计划创建 README.md”。

预期结果： 新增一份 README.md，原有两份文件保持不变。

4. 亲自验收结果

用编辑器打开 README.md，逐项检查：

• 是否包含五个指定章节？
• 是否准确写明第一版有 6 本书？
• 是否把账号和标签筛选列为本次不做？
• 是否保留手机端可阅读的要求？
• 是否把上线时间列为待确认，而不是编造日期？
• 是否出现原文没有的技术选型、功能或承诺？
• 原始笔记与备份是否仍然一致？

Agent 自己说“完成了”，不是验收结果。你看到的文件才是。

5. 练习一次明确的修订

如果它遗漏了移动端要求，不要只说“再优化一下”，而是说明偏差与目标：

README 的验收清单遗漏了手机端阅读要求。
请只修改验收清单，补充“在手机宽度下能阅读全部书目信息”。
不要修改其他章节。完成后说明改了哪一项。

修改后再次查看文件，确认其他内容未被顺带改动。

6. 收尾与撤销

练习结束后，保留原始笔记和最终 README。想重新练习时，只处理你确认是本次新增的 README，不要批量删除整个工作目录。

如果原始笔记被误改，可以用已检查过的备份恢复。处理真实项目时，应该先准备可靠的版本管理或备份流程。

你现在学会了什么

你已经练习了限制任务范围、要求先计划、确认工作目录、检查真实产物、给出具体修订以及预先考虑撤销。

下一步阅读 项目指令，把经常重复的约定整理出来；或者返回 学习路线，选择你的下一阶段。