为什么 SKILL.md 操作手册能让营销 Agents 可复用
一份关于 UnifAPI 中 Skill 层的实战指南：触发短语、数据调用、输出模板、置信度规则与公开数据边界。
一句话概括：一个 Skill 是 UnifAPI Agent 内部可复用的单元。它告诉助手何时使用这条工作流、获取哪些数据、如何组织输出，以及在哪里停下。
提示词易写难维护。一条有用的营销工作流需要的不止一条指令。它需要触发条件、输入要求、数据源的选择、置信度规则、输出模板与边界。
这正是为什么 UnifAPI Agents 以 Skills 的形式实现。
一个 Skill 里该有什么
| Skill 组成 | 它的作用 |
|---|---|
| 名称与描述 | 帮助助手路由到正确的工作流 |
| 何时使用 | 列出触发短语与用户意图 |
| 输入 | 告诉助手在调用数据前需要收集哪些上下文 |
| 数据调用 | 命名要使用的 UnifAPI 操作或 Data Skills |
| 工作流 | 把工作拆解为步骤 |
| 输出模板 | 防止含糊的摘要 |
| 置信度规则 | 区分观察到的事实与推断出的判断 |
| 边界 | 让 Agent 保持只读且诚实 |
当一个 Skill 命名一项能力时，它最为有力。keyword-research 是一个 Skill。seo-audit 是一个 Skill。ai-answer-gap 是一个 Skill。"做所有营销"则不是。
Enhanced、Advice 与 Data Skills
UnifAPI 使用三种 Skill 类型：
| Skill 类型 | 含义 | 示例 |
|---|---|---|
| Enhanced | 一项会调用实时公开数据的营销能力 | SEO 审计、KOL 定价、AI 可见性审计 |
| Advice | 不含实时调用的框架或判断 | Schema 指引、定位框架 |
| Data | 由一个 Platform Agent 拥有的确定性数据源指南 | LinkedIn Data Skill、Reddit Data Skill |
这种区分让产品保持清晰。并非每个有用的营销 Skill 都需要一次实时 API 调用。但当一个 Skill 对公开可见性做出事实性论断时，它就应当使用记录。
为什么 Skills 应当命名操作
助手可以通过 MCP 发现操作，但发现并不是工作流的全部。一个好的 Skill 仍然应当告诉助手，哪些数据族对这份工作重要。
例如，一个 SEO 审计 Skill 可以这样说：
- 为目标查询拉取实时 SERP 证据。
- 用关键词概览与历史为需求提供背景。
- 对目标页面与排名靠前的竞品页面使用 Browser Markdown。
- 返回一份修复计划，把观察到的证据与建议分开列出。
这远比"如有需要就用 API"要好得多。
输出模板是产品的一部分
输出形态是许多 agent 工作流翻车的地方。没有模板，助手可能返回一段令人愉快、却无法据以行动的摘要。
一个 Skill 应当指明产物：
| 工作流 | 有用的产物 |
|---|---|
| KOL 定价 | 带低/基准/高区间与置信度的、排序的创作者表格 |
| GEO 审计 | 逐条提示词的引用与提及矩阵 |
| 本地 pack 扫描 | 查询、排名、竞品、评论数与地图位置 |
| 竞品画像 | 发布时间线、渠道、论断、佐证与风险 |
| 内容策略 | 带需求、来源证据与契合度的机会待办列表 |
模板不会让助手变得机械，它们让答案变得可审阅。
置信度规则防止虚假确定性
公开数据很强大，但它并非无所不知。一个 Skill 应当让助手做标注：
| 标签 | 含义 |
|---|---|
| Observed | 直接从一条公开记录中读取 |
| Inferred | 从若干记录推断而来 |
| Assumed | 由用户提供，或为完成分析所必需 |
| Unknown | 公开数据中无法获得 |
这在营销工作流中很重要。一个 KOL 定价 Skill 能估算一个区间，而非一个最终报价。一个 GEO Skill 能报告可见性，但无法保证未来被收录。一个本地 SEO Skill 能审计列表，却不能编辑它们。
一份简短的 Skill 质量清单
在发布一个 Skill 之前，问一问：
- 它是否对应一份具体的工作？
- 描述里是否包含真实的触发短语？
- 它是否指明了必填与可选输入？
- 它是否命名了要使用的数据源或 Data Skills？
- 它是否包含一个输出模板？
- 它是否解释了置信度与边界？
- 它是否链接到相关 Skills 以供后续工作？
如果答案是否定的，那么这个 Skill 很可能只是一份提示词草稿，而不是一条工作流。
接下来读什么
Platform Agents 与 Data Skills - 展示 Skills 的数据源专属版本。
Agent First 架构 - 解释 Skills 处在 Agents 与 APIs 之间的什么位置。
浏览 UnifAPI Skills - 查看实时的 Skill 页面。