小白学 AI Agent 第 7 期：用 Pi 做完一个小项目

前面几期分别练了界面、模型、工具、上下文和可复用规则。这一期把它们放在一起，完成一个不会影响真实资料的小项目：做一份本地待办清单。

目标很简单：创建一个 Markdown 文件，让 Pi 帮你整理任务，但所有写入都放在练习目录里。

一、先准备项目目录

mkdir -p ~/pi-todo-demo
cd ~/pi-todo-demo
pi

启动后先让 Pi 只查看：

确认当前目录，并说明你准备创建哪些文件。不要写入，不要运行安装命令。

如果目录不对，先退出 Pi，回到正确目录再启动。不要在错误目录里继续。

二、先定义结果

告诉 Pi 这次要做什么：

我要做一个本地待办清单。请先给出文件结构和处理计划，不要创建文件。
要求：任务包含标题、优先级、截止日期和完成状态；没有日期的任务不要自行编造日期。

先看计划。好的计划应该明确文件名、字段和不会做的事情。如果它开始修改文件，说明你的要求还不够清楚，先停止并重新说明“只给计划”。

三、让 Pi 创建初始文件

确认计划后再说：

按刚才的计划创建 todo.md。创建前再次告诉我目标路径，确认后再写入。

文件内容可以先放三条测试任务。不要把真实工作资料直接交给第一次练习。

创建完成后，用 read 读取文件，让 Pi 检查格式：

读取 todo.md，检查每条任务是否都有标题、优先级、截止日期和完成状态。只报告问题，不要修改。

四、让 Pi 提出修改，再决定是否执行

现在故意留一条格式不完整的任务，然后输入：

找出 todo.md 中缺少字段的任务，给出修改建议。不要直接写回文件。

看完建议后再决定是否允许修改。确认时说明范围：只补齐字段，不改变任务含义，不添加没有依据的日期。

这一步很重要。Agent 可以给建议，但“采用建议”仍然应该是你的决定。

五、最后做一次检查

让 Pi 运行只读检查：

请检查 todo.md 是否存在、是否为空、每条任务是否使用统一格式。先告诉我准备运行的命令，不要安装或删除任何东西。

如果检查结果正常，再让 Pi 总结：文件在哪、改了什么、还有什么没有处理。

六、这条工作流为什么可靠

它不是靠一句很长的提示词，而是分成几个可检查的阶段：先确认目录，再说明计划，创建文件，读取复核，提出建议，最后检查。

每一步都尽量让 Pi 先解释，再执行。出了问题，也能知道问题发生在哪一步。

七、把流程迁移到真实工作

以后你可以把这个方法用于会议纪要、读书笔记、项目清单或简单代码整理。但迁移前先处理三件事：

• 把真实资料复制到可回滚的副本。
• 明确哪些文件允许读，哪些文件允许改。
• 让 Pi 先给计划和差异，不要一上来批量执行。

这一期的目标不是让 Pi 自动完成所有工作，而是让你看懂一条完整的 Agent 工作流。下一期收尾时，我们会把项目权限、沙箱、JSON、RPC 和 SDK 放在一起，说明 Pi 适合做什么，以及哪些边界不能忽略。