拓冰网站定制 
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.它解决的是一个具体的内容营销工程问题当团队要外包给 UGCUser 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 cant substantiate 禁止。Step 2指定钩子要求Specify Hook Requirements钩子前 3 秒决定短视频的完播起点。技能给出了一套五类钩子类型清单要求以勾选框形式指定本次 Brief 需要的类型Greed贪欲型省钱、超值Relevancy相关型时效、季节性Emotion情绪型反应、故事Demographic人群型直接点名受众Cliffhanger悬念型好奇心缺口同时要求提供参考钩子示例品牌自己跑得好的钩子、竞品表现好的钩子并列出三条硬性禁忌Hook Donts禁止念稿式开场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 GuidelinesUGC 的核心资产是「真实感」这一步用 DO / DONT 双清单把它写成了可验收的验收标准DO自然表达不照稿用自己的话展示真实反应保留不完美自然光拍摄用手机而非专业相机像跟朋友说话一样看镜头DONT照本宣科列要点可以过度精修或重度剪辑使用专业灯光 / 影棚加音乐或特效听起来像商业广告虚假热情生硬使用品牌黑话最后给出一个可操作的真实性测试Authenticity TestWould you actually send this video to a friend recommending the product?——创作者交付前自问「我会把这条视频转发给朋友吗」把抽象的「真实感」转化为一个二值判定。Step 5输出创作者 BriefOutput Creator Brief流程的终点是一份完整、可直接发给创作者的 Brief 模板。这是技能中最长的部分也是信息密度最高的部分包含 8 个固定分区CREATOR DETAILS— 创作者信息名称、平台TikTok/IG/FB、格式竖屏 9:16、时长15–60 秒、交付物类型Raw footage / EditedPRODUCT INFO— 产品信息名称、一句话功能、核心收益、价格/优惠、官网 URL以及独特卖点USPYOUR ANGLE— 人设视角创作者扮演的用户画像avatar含年龄段、所处情境、曾有过的痛点、发现产品的路径HOOKFirst 3 seconds— 钩子类型、两条「启发但不照抄」的参考钩子、三条要求立刻停住滑动的拇指、暂不提产品名、制造好奇或共情TALKING POINTSMiddle— 中段把 Step 3 的四段叙事Problem / Discovery / Experience / Proof转为「用你自己的话」填写的填空题外加 Must mention / Nice to include 两个勾选清单CALL TO ACTIONLast 5 seconds— 结尾 CTA给出「Link is in my bio」「Tap the link to try it」「I put the link below」等参考话术并允许在自然的前提下追加紧迫感如 Theyre running a sale right nowFILMING GUIDELINES— 拍摄规范分 Setting自然环境、面向窗户的自然光、整洁但不完美的背景、竖屏手机拍摄、Style像跟朋友聊天、眼神接触镜头、匹配个人气质的自然能量、允许口误重拍、Technical1080p 或 4K、安静环境保证清晰音频、鼓励多条素材、交付原始素材由品牌方剪辑三组勾选项DO NOT / DELIVERABLES / PAYMENT RIGHTS / REFERENCE VIDEOS / QUESTIONS— 禁区清单逐字照稿、专业设备、滤镜特效、信息广告腔、无法证实的声明、点名竞品、交付要求原始视频文件、多条 take、产品 B-rollMP4/MOV 格式、截止日期与提交渠道、报酬与权利酬劳条款、使用范围 Perpetual/Limited、排他性、参考视频与联系人。完整模板原文见 SKILL.md 第 89–238 行其结构化的填空式设计方括号占位符 勾选框使得任何品牌只需替换[Product Name]、[URL]、[Date]等变量即可批量生成不同创作者的个性化 Brief 包。UGC 投放最佳实践为什么「原生感」胜过「精致感」技能正文在模板之后附了一节UGC Best PracticesLeadsIcon/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.mdWorkspaceSkillsBackend则以只读方式过滤工作区/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/DONT 清单与「转发给朋友」测试让质量可判定输出模板变量化——Step 5 的填空式 Brief 模板使产出可直接交付第三方策略层兜底——Best Practices 一节解释「为什么这样做」并给出多创作者量级投放的运营打法。对于想在自己仓库中引入同类技能无论是 UGC Brief 还是其他重复性工作流的开发者而言这份文件提供了可直接参照的最小完备结构一段 frontmatter 元数据、一组带勾选框的输入清单、一个线性步骤流、一份占位符化的输出模板外加一节注明来源的策略注解。技能文件的路径约定.cursor/skills/name/SKILL.md与 skills-lock.json 的导入校验机制则构成了本地技能与导入技能共存的治理基础。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 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.它解决的是一个具体的内容营销工程问题当团队要外包给 UGCUser 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 cant substantiate 禁止。Step 2指定钩子要求Specify Hook Requirements钩子前 3 秒决定短视频的完播起点。技能给出了一套五类钩子类型清单要求以勾选框形式指定本次 Brief 需要的类型Greed贪欲型省钱、超值Relevancy相关型时效、季节性Emotion情绪型反应、故事Demographic人群型直接点名受众Cliffhanger悬念型好奇心缺口同时要求提供参考钩子示例品牌自己跑得好的钩子、竞品表现好的钩子并列出三条硬性禁忌Hook Donts禁止念稿式开场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 GuidelinesUGC 的核心资产是「真实感」这一步用 DO / DONT 双清单把它写成了可验收的验收标准DO自然表达不照稿用自己的话展示真实反应保留不完美自然光拍摄用手机而非专业相机像跟朋友说话一样看镜头DONT照本宣科列要点可以过度精修或重度剪辑使用专业灯光 / 影棚加音乐或特效听起来像商业广告虚假热情生硬使用品牌黑话最后给出一个可操作的真实性测试Authenticity TestWould you actually send this video to a friend recommending the product?——创作者交付前自问「我会把这条视频转发给朋友吗」把抽象的「真实感」转化为一个二值判定。Step 5输出创作者 BriefOutput Creator Brief流程的终点是一份完整、可直接发给创作者的 Brief 模板。这是技能中最长的部分也是信息密度最高的部分包含 8 个固定分区CREATOR DETAILS— 创作者信息名称、平台TikTok/IG/FB、格式竖屏 9:16、时长15–60 秒、交付物类型Raw footage / EditedPRODUCT INFO— 产品信息名称、一句话功能、核心收益、价格/优惠、官网 URL以及独特卖点USPYOUR ANGLE— 人设视角创作者扮演的用户画像avatar含年龄段、所处情境、曾有过的痛点、发现产品的路径HOOKFirst 3 seconds— 钩子类型、两条「启发但不照抄」的参考钩子、三条要求立刻停住滑动的拇指、暂不提产品名、制造好奇或共情TALKING POINTSMiddle— 中段把 Step 3 的四段叙事Problem / Discovery / Experience / Proof转为「用你自己的话」填写的填空题外加 Must mention / Nice to include 两个勾选清单CALL TO ACTIONLast 5 seconds— 结尾 CTA给出「Link is in my bio」「Tap the link to try it」「I put the link below」等参考话术并允许在自然的前提下追加紧迫感如 Theyre running a sale right nowFILMING GUIDELINES— 拍摄规范分 Setting自然环境、面向窗户的自然光、整洁但不完美的背景、竖屏手机拍摄、Style像跟朋友聊天、眼神接触镜头、匹配个人气质的自然能量、允许口误重拍、Technical1080p 或 4K、安静环境保证清晰音频、鼓励多条素材、交付原始素材由品牌方剪辑三组勾选项DO NOT / DELIVERABLES / PAYMENT RIGHTS / REFERENCE VIDEOS / QUESTIONS— 禁区清单逐字照稿、专业设备、滤镜特效、信息广告腔、无法证实的声明、点名竞品、交付要求原始视频文件、多条 take、产品 B-rollMP4/MOV 格式、截止日期与提交渠道、报酬与权利酬劳条款、使用范围 Perpetual/Limited、排他性、参考视频与联系人。完整模板原文见 SKILL.md 第 89–238 行其结构化的填空式设计方括号占位符 勾选框使得任何品牌只需替换[Product Name]、[URL]、[Date]等变量即可批量生成不同创作者的个性化 Brief 包。UGC 投放最佳实践为什么「原生感」胜过「精致感」技能正文在模板之后附了一节UGC Best PracticesLeadsIcon/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.mdWorkspaceSkillsBackend则以只读方式过滤工作区/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/DONT 清单与「转发给朋友」测试让质量可判定输出模板变量化——Step 5 的填空式 Brief 模板使产出可直接交付第三方策略层兜底——Best Practices 一节解释「为什么这样做」并给出多创作者量级投放的运营打法。对于想在自己仓库中引入同类技能无论是 UGC Brief 还是其他重复性工作流的开发者而言这份文件提供了可直接参照的最小完备结构一段 frontmatter 元数据、一组带勾选框的输入清单、一个线性步骤流、一份占位符化的输出模板外加一节注明来源的策略注解。技能文件的路径约定.cursor/skills/name/SKILL.md与 skills-lock.json 的导入校验机制则构成了本地技能与导入技能共存的治理基础。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考