SurfSense 的 Agent 技能实践：ugc-brief 技能如何用一套 SKILL.md 模板化生成 UGC 创作者 Brief-酒店常州论坛

SurfSense 的 Agent 技能实践：ugc-brief 技能如何用一套 SKILL.md 模板化生成 UGC 创作者 Brief

【免费下载链接】SurfSenseOpen-source NotebookLM alternative. Research the open web with live data(Reddit, YT, IG, TikTok, Indeed, Google Search, Maps etc) through one platform, API or MCP server. Join our Discord: https://discord.gg/ejRNvftDp9项目地址: https://gitcode.com/GitHub_Trending/su/SurfSense

本文以 SurfSense 仓库中的 ugc-brief 技能为核心，拆解这套「Agent Skill」文档的完整设计：从 frontmatter 元数据、五步生成流程（产品定义、钩子要求、谈资要点、真实性准则、Brief 输出模板）到底层的 UGC 投放最佳实践。读完后，你能掌握如何为一个 AI 编码助手（如 Cursor）编写一份可复用的工作流技能，并将其中的 Brief 模板迁移到自己的内容营销场景中。

技能定位：一份「创作者就绪」的 UGC Brief 生成器

ugc-brief 技能是 SurfSense 仓库.cursor/skills/目录下的一处 Agent 技能，其声明用途是：

Create briefs for UGC creators including product info, hook requirements, talking points, and authenticity guidelines. Use when working with UGC creators, preparing creator packages, or scaling content production with external talent.

它解决的是一个具体的内容营销工程问题：当团队要外包给 UGC（User Generated Content）创作者批量生产短视频时，如何把「产品信息、钩子要求、谈资要点、真实性要求」四要素固化为一份创作者可直接执行的 Brief，而不是每次靠人工口头沟通。技能正文开篇即给出目标——"Create creator-ready briefs for authentic UGC content."，随后是一个严格线性、可直接执行的五步流程。

技能文档结构：frontmatter 元数据 + 流程 + 模板

与仓库中其他技能（如 web-design-guidelines、seo-content-writer）一致，SKILL.md采用「YAML frontmatter + Markdown 正文」的标准结构：

--- name: ugc-brief description: Create briefs for UGC creators including product info, hook requirements, talking points, and authenticity guidelines. Use when working with UGC creators, preparing creator packages, or scaling content production with external talent. ---

name是技能的唯一标识，对应其所在目录名.cursor/skills/ugc-brief/；
description承担「触发条件说明」职责——它同时描述了技能的产出物（product info、hook requirements、talking points、authenticity guidelines）和使用场景（与 UGC 创作者协作、准备创作者物料包、规模化外聘内容生产），供 Agent 在对话中判断何时加载该技能。

值得一提的是溯源机制：SurfSense 在仓库根目录维护了一份 skills-lock.json，对从外部生态（如aaron-he-zhu/seo-geo-claude-skills、emilkowalski/skills、vercel-labs/agent-skills等）导入的技能记录了来源仓库与computedHash校验和。ugc-brief并未出现在该 lock 文件中，可以推断它是仓库本地自建的技能，而非外部导入——这类「本地技能 + 导入技能」混合的组织方式，正是.cursor/skills/目录下的 30 余个技能共存的基础。

五步生成流程：从产品输入到 Brief 输出

技能正文把 Brief 生成拆解为 5 个步骤。下面逐步还原其完整内容与工程意图。

Step 1：定义产品与核心信息（Define Product & Key Messages）

这是信息输入阶段，要求先向 Agent 喂齐两类事实：

产品概览（Product Overview）：

产品名称与品类
核心收益（top 3）
独特机制（unique mechanism）
价格档位 / 优惠（price point / offer）
目标客户画像

核心信息（Core Messages）：

主声明 / 主承诺（primary claim / promise）
次要佐证点（secondary proof points）
必须提及的功能（must-mention features）
合规要求（compliance requirements）

这一步的设计意图是把「营销事实」与「合规红线」前置：后面的钩子、谈资、CTA 全部围绕这组信息展开，且受 compliance 约束（输出模板中的 DO NOT 一节明确要求 "Make claims we can't substantiate" 禁止）。

Step 2：指定钩子要求（Specify Hook Requirements）

钩子（前 3 秒）决定短视频的完播起点。技能给出了一套五类钩子类型清单，要求以勾选框形式指定本次 Brief 需要的类型：

Greed（贪欲型：省钱、超值）
Relevancy（相关型：时效、季节性）
Emotion（情绪型：反应、故事）
Demographic（人群型：直接点名受众）
Cliffhanger（悬念型：好奇心缺口）

同时要求提供参考钩子示例（品牌自己跑得好的钩子、竞品表现好的钩子），并列出三条硬性禁忌（Hook Don'ts）：

禁止念稿式开场（No scripted openings）
禁止 "Hey guys" 这类泛化起手式
前 3 秒内禁止出现产品名（No product name in first 3 seconds）

这套「类型 + 正例 + 反例」的组合，本质上是给 LLM 的边界条件约束：既给出创意方向，又用负例锁死输出下限，避免生成千篇一律的广告腔开场。

Step 3：列出谈资要点（List Talking Points）

中段叙事被固化为一个五要素叙事骨架：

问题确认（Problem acknowledgment）
发现故事或佐证（Discovery story or proof）
产品方案（Product solution）
具体收益 / 结果（Specific benefit/result）
行动号召（Call to action）

在此之上，提供两组可选素材：

佐证点（Proof Points to Include）：

个人结果 / 体验
具体数字（如适用）
前后对比（如相关）
对机制的背书

可选元素（Optional Elements）：

开箱时刻（Unboxing moment）
应用 / 使用演示（Application / usage demo）
与替代品的对比（Comparison to alternative）
回应异议（Response to objection）

「必须骨架 + 可选加料」的分层，保证了不同创作者、不同素材条件下的产出都有统一的信息密度底线。

Step 4：真实性准则（Authenticity Guidelines）

UGC 的核心资产是「真实感」，这一步用 DO / DON'T 双清单把它写成了可验收的验收标准：

DO：

自然表达，不照稿
用自己的话
展示真实反应
保留不完美
自然光拍摄
用手机（而非专业相机）
像跟朋友说话一样看镜头

DON'T：

照本宣科（列要点可以）
过度精修或重度剪辑
使用专业灯光 / 影棚
加音乐或特效
听起来像商业广告
虚假热情
生硬使用品牌黑话

最后给出一个可操作的真实性测试（Authenticity Test）：

"Would you actually send this video to a friend recommending the product?"

——创作者交付前自问「我会把这条视频转发给朋友吗？」，把抽象的「真实感」转化为一个二值判定。

Step 5：输出创作者 Brief（Output Creator Brief）

流程的终点是一份完整、可直接发给创作者的 Brief 模板。这是技能中最长的部分，也是信息密度最高的部分，包含 8 个固定分区：

CREATOR DETAILS— 创作者信息：名称、平台（TikTok/IG/FB）、格式（竖屏 9:16）、时长（15–60 秒）、交付物类型（Raw footage / Edited）；
PRODUCT INFO— 产品信息：名称、一句话功能、核心收益、价格/优惠、官网 URL，以及独特卖点（USP）；
YOUR ANGLE— 人设视角：创作者扮演的用户画像（avatar），含年龄段、所处情境、曾有过的痛点、发现产品的路径；
HOOK（First 3 seconds）— 钩子：类型、两条「启发但不照抄」的参考钩子、三条要求（立刻停住滑动的拇指、暂不提产品名、制造好奇或共情）；
TALKING POINTS（Middle）— 中段：把 Step 3 的四段叙事（Problem / Discovery / Experience / Proof）转为「用你自己的话」填写的填空题，外加 Must mention / Nice to include 两个勾选清单；
CALL TO ACTION（Last 5 seconds）— 结尾 CTA：给出「Link is in my bio」「Tap the link to try it」「I put the link below」等参考话术，并允许在自然的前提下追加紧迫感（如 "They're running a sale right now"）；
FILMING GUIDELINES— 拍摄规范：分 Setting（自然环境、面向窗户的自然光、整洁但不完美的背景、竖屏手机拍摄）、Style（像跟朋友聊天、眼神接触镜头、匹配个人气质的自然能量、允许口误重拍）、Technical（1080p 或 4K、安静环境保证清晰音频、鼓励多条素材、交付原始素材由品牌方剪辑）三组勾选项；
DO NOT / DELIVERABLES / PAYMENT & RIGHTS / REFERENCE VIDEOS / QUESTIONS— 禁区清单（逐字照稿、专业设备、滤镜特效、信息广告腔、无法证实的声明、点名竞品）、交付要求（原始视频文件、多条 take、产品 B-roll，MP4/MOV 格式、截止日期与提交渠道）、报酬与权利（酬劳条款、使用范围 Perpetual/Limited、排他性）、参考视频与联系人。

完整模板原文见 SKILL.md 第 89–238 行，其结构化的填空式设计（方括号占位符 + 勾选框）使得任何品牌只需替换[Product Name]、[URL]、[Date]等变量，即可批量生成不同创作者的个性化 Brief 包。

UGC 投放最佳实践：为什么「原生感」胜过「精致感」

技能正文在模板之后附了一节UGC Best Practices（LeadsIcon/Kamal 来源），为上面的规范提供了理论支撑，分三个维度：

为什么原生感打败精致感（Why Native Beats Polish）：

受众瞬间能闻出「演的」（Audiences smell BS instantly）
平台算法偏原生内容
信任来自共鸣感（relatability）
完美 = 广告 = 划走（Perfect = ad = skip）

创作者筛选标准（Creator Selection）：

匹配目标人群
自然的镜头表现力
真的会使用该产品
风格不过度制作

量级策略（Volume Strategy）：

同一 Brief 分发给多个创作者
每人带来独特的演绎
混剪（mix and match）最佳片段
持续测试新面孔

这段实践与前面的五步流程形成闭环：流程负责「单份 Brief 的质量」，量级策略负责「规模化后的 A/B 素材池」，两者结合正是 UGC 投放「一人一稿、多稿混投」的典型打法。

从开发工具侧到产品侧：SKILL.md 模式在 SurfSense 中的双重落点

从源码结构看，「SKILL.md作为技能载体」这一模式在 SurfSense 中不止服务于开发者工具链。产品侧的聊天 Agent 也实现了同样的技能加载机制：surfsense_backend/app/agents/chat/multi_agent_chat/main_agent/skills/backends.py 中，BuiltinSkillsBackend从磁盘读取内置技能目录下的SKILL.md，WorkspaceSkillsBackend则以只读方式过滤工作区/documents/_skills/私有文件夹下的技能笔记，二者共同适配deepagents的SkillsMiddleware，在 Agent 构建期把技能内容渲染进系统提示词。该文件 docstring 明确写道：skill 内容 "is rendered into the system prompt at agent build time, not edited at runtime"，且两个后端均刻意保持只读——技能编写在带外（out of band）完成。

这解释了本文主体文档的形态选择：ugc-brief 这类技能之所以能被写成一整份自包含的 Markdown（流程 + 约束 + 模板），正是因为消费方（Cursor 的 Agent、或产品侧的 SkillsMiddleware）的工作方式就是「整文件载入、按描述触发、按指令执行」。技能文件不依赖任何运行时代码，其全部"逻辑"都以自然语言流程与结构化模板表达——这与 backends.py 中"只读四个方法（ls_info/download_files等）即可加载技能"的最简实现相互印证。

小结：把方法论固化为可执行的 Markdown 工作流

回到 ugc-brief 技能本身，它示范了一条清晰的方法论固化路径：

输入结构化——Step 1 强制对齐产品事实与合规边界；
创作约束显式化——Step 2/3 用「类型枚举 + 正例 + 负例 + 必选/可选分层」给生成过程加边界条件；
验收标准二值化——Step 4 的 DO/DON'T 清单与「转发给朋友」测试，让质量可判定；
输出模板变量化——Step 5 的填空式 Brief 模板使产出可直接交付第三方；
策略层兜底——Best Practices 一节解释「为什么这样做」，并给出多创作者量级投放的运营打法。

对于想在自己仓库中引入同类技能（无论是 UGC Brief 还是其他重复性工作流）的开发者而言，这份文件提供了可直接参照的最小完备结构：一段 frontmatter 元数据、一组带勾选框的输入清单、一个线性步骤流、一份占位符化的输出模板，外加一节注明来源的策略注解。技能文件的路径约定（.cursor/skills/<name>/SKILL.md）与 skills-lock.json 的导入校验机制，则构成了本地技能与导入技能共存的治理基础。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析