小白学 AI Agent 第 5 期：把重复工作做成 Pi 的 Skill

如果你每次都要对 Pi 重复说“先读文件、不要直接修改、最后给我检查结果”，说明这组要求值得保存下来。

Pi 提供 Skill 和提示模板，目的不是让你背更多命令，而是把重复的工作方法整理成可复用的说明。

一、 Skill 和提示模板有什么区别

Skill 更像一份可复用的工作方法。它可以包含适用场景、步骤、检查清单和注意事项。

提示模板更像一个固定提问格式。你输入命令后，Pi 展开模板，再把具体内容交给模型。

简单理解：Skill 解决“怎么完成一类工作”，提示模板解决“怎么快速发起一次固定提问”。

二、先写一个最小 Skill

在项目目录中创建：

.agents/skills/safe-notes/SKILL.md

内容可以先写得很短：

# 安全整理笔记

适用于整理文本笔记时。

1. 先读取目标文件。
2. 先给出整理计划，不要直接覆盖现有文件。
3. 用户确认后，写入新的结果文件。
4. 最后说明新文件路径和没有处理的内容。

重新启动 Pi，输入 /skill:safe-notes，再告诉它你要整理哪个测试文件。

第一次不要把 Skill 写成几十页。先验证它有没有被加载，再逐步增加规则。

三、 Skill 里应该写什么

适合写进去的内容包括：

• 这项工作什么时候使用。
• 固定的处理顺序。
• 必须确认的危险动作。
• 输出格式和检查项目。
• 项目中约定的目录和文件命名。

不适合写进去的内容包括 API Key 、密码、私人资料和无法验证的承诺。 Skill 不是保险箱，也不是权限系统。

四、提示模板适合固定问题

如果你经常问 Pi“总结这个文件，列出事实、疑问和下一步”，可以做一个提示模板。

模板里保留稳定结构，把变化的内容留给每次输入。例如：

请按下面格式分析我提供的内容：
1. 已确认的事实
2. 仍需核对的地方
3. 可执行的下一步
不要补充没有依据的数字或结论。

模板的价值是减少重复输入，但它不会自动提高事实准确性。每次仍然要看输入文件和模型回答。

五、如何确认 Skill 真的生效

不要只看 Pi 有没有回复。可以让它回答：

请列出你准备遵守的工作步骤，不要读取或修改文件。

如果步骤和 Skill 内容一致，说明加载成功。然后在一个测试文件上试一次，观察它是否在写入前等待确认。

如果没有生效，检查目录、文件名、 Markdown 标题和当前项目是否被信任。也可以重启 Pi，避免继续使用旧会话里的上下文。

六、 Skill 不是自动执行器

Skill 只是给模型的工作说明。它不等于程序，也不等于沙箱。

模型仍可能误解规则，扩展也可能改变界面和行为。涉及删除、覆盖、安装和联网时，仍然要检查工具调用。

这一期的练习重点是把一套稳定步骤写下来，并验证 Pi 是否按步骤行动。下一期会进一步认识 Extension 和 Pi Package，看看怎样给 Pi 增加命令、界面和可分发的功能。