第 03 节:把调研边界说清楚

本节 objectives:

• 能说明本 skill 为什么不绑定 Exa、Firecrawl 或私有搜索代理。
• 能给 agent 指定来源优先级和时效要求。
• 能在宿主 agent 没有联网能力时改用用户提供链接。

先修:会触发一次课程生成 ｜ 上一节 << 02 ｜ 下一节 04 >>

课程不是模型背出来的,是资料压出来的

SKILL.md 明确说,本 skill 不内置搜索供应商、API key、私有 Worker 或第三方凭证;取材优先使用宿主 agent 已具备的搜索/浏览能力。¹ 这条设计让 skill 更 universal:它能交给 Codex 这类已经有搜索/浏览工具的 agent,也能在没有联网工具时请用户提供可靠链接。

这也意味着你不能只说"做一门好课"就期待来源自动变好。你要把调研边界说出来。

讲解

一个好的调研边界有四部分:

course-authoring-guide.md 要求每条源写进 sources.md,并标 - 权威: 字段;关键事实不能只靠 AI生成/营销 源。² 它还要求写课阶段复用同一份 sources.md,不要一边写一边反复重新上网。²

所以你的 prompt 可以很朴素,但要让 agent 知道什么算可靠:

来源:优先官方文档和权威教程;技术事实用近两年资料。不要把无出处博客或 AI 生成营销文当关键事实。如果当前 agent 没有联网检索能力,先停下来让我提供链接。

跟我做一遍(worked example)

目标:给"如何使用 Agent Mentor Skill"这门课定来源边界。

可写成:

来源边界:- 本项目机制只用本仓 README、SKILL.md、course-authoring-guide、templates、course-reader README、course-guard 和质量 rubric。- Codex skill 机制只用 OpenAI 官方 Codex Skills 文档。- 不使用旧 agent-mentor 产品转向前文档。- 不引入 Exa、Firecrawl 或私有 Worker 作为必需依赖。- 如果需要外部事实但无法联网,先让我提供链接。

这组边界把"项目内部契约"和"Codex 官方机制"分开了。它也防止 agent 把历史方向、私有搜索服务或自己的记忆混进现行课程。

换你补全(faded example)

你要做一门"Python 文件读写基础"课。请补完整:

来源优先级: ____________________。时效要求: ____________________。禁用项: ____________________。无联网降级: ____________________。

参考答案:

来源优先级:优先 Python 官方文档和权威教程。时效要求:以当前 Python 3 文档为准,不讲 Python 2。禁用项:不要用随机博客解释安全敏感的路径和编码行为。无联网降级:如果不能联网,先让我提供 Python 官方文档链接。

关键判断点是:你不是要求 agent "多搜点",而是要求它按可复查的来源层级取材。

小结 + 通向下一节

本 skill 的 universal 来自"不绑定私有搜索凭证",代价是你要让宿主 agent 的取材边界可见。下一节会把生成出来的 Markdown 放进阅读站里看,因为一门课最终要经得住真实阅读。