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

把笔记整理成 README

这节课用一份家庭书单网站的笔记，练习让 Agent 读取文件、创建 README，再修改其中一项。做完后，文件夹里会多出一份可以继续使用的项目说明。

开始前，先按Agent 指南安装并接入一个工具。

用下面的虚构笔记练习，单独建一个目录，不放入密码或重要项目原件。

1. 准备笔记

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

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

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

现在文件夹里应该有两份内容相同的练习文件。

2. 让 Agent 读取笔记

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

先发送：

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

回复应包含“家庭书单、6本书、暂不做账号”。如果它列出的文件不对，先重新选择练习目录，再继续。

3. 创建 README

发送下面的任务描述：

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

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

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

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

完成后会多出README.md，两份笔记应保持原样。

4. 打开文件检查

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

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

直接打开文件检查，比只看聊天回复更容易发现遗漏。

5. 补上一项要求

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

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

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

6. 保存或重做

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

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

下一步

这套“读取→创建→检查→修改”的步骤，也可以用于整理会议笔记和项目需求。

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