1. 项目缘起与核心定位第一次看到marketingskills这个仓库名的时候我正陷在一堆重复的营销执行工作里——给独立站写 meta description、调 Google Ads 的落地页文案、整理 GA4 的事件埋点、盯着 Search Console 的覆盖率报告发呆。这些活儿单拎出来都不难但架不住量大、琐碎、还要求一致性。当时我就在想能不能把这些营销动作拆成一套可复用的“技能包”让 AI agent 按需调用而不是每次都从零写 prompt。marketingskills本质上就是干这件事的它是一套面向营销场景的AI agent 技能集合把 SEO、CRO转化率优化、analytics数据分析这些高频营销任务封装成结构化的、可被 agent 直接调用的技能模块。你可以把它理解成一个“营销工具箱”里面每个工具都对应一类具体任务比如关键词聚类、落地页诊断、事件追踪方案生成、竞品内容差距分析等等。这个项目解决的核心问题是营销执行中的“最后一公里”自动化。市面上不缺营销理论也不缺 AI 写作工具但缺的是把“营销方法论”翻译成“agent 可执行指令”的中间层。marketingskills补的就是这一层。它适合谁我梳理了一下大概三类人用起来最顺手独立站运营者一个人管 SEO、内容、广告、数据需要把重复劳动压缩到最低增长/营销团队的 tech lead想给团队搭一套 AI 辅助工作流但不想从零造轮子AI agent 开发者需要现成的营销领域技能定义作为自己 agent 项目的参考或直接集成。关键词里出现的 Claude Code、AI agents、SEO、CRO、analytics基本勾勒出了这个项目的技术底座和应用边界。接下来我会从设计思路、核心模块、实操落地、踩坑排查几个层面把这个项目拆开讲透。2. 整体设计思路与技能拆解逻辑2.1 为什么是“技能包”而不是“大而全的 prompt”我见过太多人做营销 AI 工具第一反应是写一个巨长的 system prompt把 SEO 规则、文案要求、数据分析逻辑全塞进去。结果就是token 爆炸、指令冲突、模型注意力被稀释最后输出质量还不如人工。marketingskills的设计哲学明显反着来——按任务边界切分技能每个技能只解决一类问题输入输出定义清晰。这种设计的优势在于可组合一个完整的“独立站 SEO 审计”流程可以拆成“抓取页面结构 → 分析关键词覆盖 → 生成优化建议 → 输出优先级列表”四个技能串联可测试每个技能单独跑输出质量容易评估不像大 prompt 那样一改就全乱可复用同一个“关键词聚类”技能既能用在 SEO 内容规划也能用在广告组结构优化。从工程角度看这其实就是把营销工作流“函数化”了。每个技能是一个函数输入是原始数据页面 HTML、关键词列表、GA4 导出 CSV输出是结构化结果JSON、Markdown 表格、优先级队列。2.2 技能分类与核心模块根据仓库结构和常见营销任务链路我把marketingskills的技能大致归为四类技能类别典型任务输入输出SEO 技能关键词聚类、内容差距分析、meta 优化、内链建议关键词列表、竞品 URL、页面内容聚类分组、优化建议、优先级CRO 技能落地页诊断、CTA 文案生成、表单字段优化页面截图/HTML、转化目标问题清单、改进方案Analytics 技能事件追踪方案、GA4 配置建议、漏斗分析业务目标、页面路径埋点方案、分析维度内容技能大纲生成、标题优化、内容改写目标关键词、受众画像内容结构、文案变体这个分类不是死的实际用的时候经常交叉。比如做“独立站谷歌 SEO”的时候你会同时用到 SEO 技能关键词和内容技能大纲最后用 analytics 技能验证效果。2.3 与 Claude Code / AI agents 的集成逻辑marketingskills之所以在 Claude Code 社区里被频繁提及是因为它的技能定义格式天然适配 agent 的 tool use 机制。Claude Code 作为一个终端里的 AI 编程助手本身支持自定义技能/命令扩展。你把marketingskills里的技能定义挂进去就能在终端里直接喊“帮我分析这个页面的 SEO 问题”agent 会自动调用对应技能读取你指定的文件输出结果。这里的关键是技能描述的质量。一个技能能不能被 agent 正确调用取决于它的 description 写得好不好。我实测下来好的技能描述应该包含触发条件什么情况下该用这个技能输入格式需要用户提供什么输出格式会返回什么结构边界说明不处理什么情况。比如一个“关键词聚类”技能描述里如果只写“对关键词进行聚类”agent 很可能在用户问“帮我看看这个页面标题好不好”的时候也错误调用。但如果写清楚“当用户提供关键词列表并需要按主题分组时使用输入为换行分隔的关键词输出为 Markdown 表格”调用准确率会高很多。3. 核心技能模块的细节与实操要点3.1 SEO 技能从关键词到内容规划SEO 是marketingskills里最重的模块也是独立站运营者最常用的部分。我把它拆成三个关键环节来讲。关键词聚类是第一步。很多人拿到几百个关键词就懵了不知道从哪下手。传统做法是用工具Ahrefs、Semrush的聚类功能但要么贵要么不够灵活。用marketingskills的思路你可以让 agent 读取关键词 CSV按搜索意图和主题相关性分组。实操时我会给 agent 这样的指令# 假设关键词文件是 keywords.csv每行一个词 请读取 keywords.csv按搜索意图信息型/导航型/交易型和主题相似度聚类 输出 Markdown 表格列包括聚类名称、包含关键词、建议内容类型、优先级。这里有个经验聚类粒度要控制。太粗了比如只分“SEO”和“营销”没用太细了每个词一组又失去意义。我一般让 agent 按“一个聚类能对应一篇内容”的标准来分这样输出直接能当内容日历用。内容差距分析是第二步。你需要知道竞品覆盖了哪些主题、你没覆盖。实操时把竞品 sitemap 和你自己的 sitemap 都喂给 agent让它对比 URL 结构和标题输出差距列表。注意这一步最好用竞品的分类页和博客列表页而不是全站抓取否则数据量太大agent 处理起来会丢细节。Meta 优化是第三步也是最容易自动化的一步。给 agent 一个页面 URL 或 HTML 文件让它输出 title 和 description 的优化建议。我踩过的坑是agent 容易写出“关键词堆砌”的 meta因为它不知道品牌调性和用户点击心理。解决办法是在技能描述里加约束比如“title 不超过 60 字符description 不超过 155 字符必须包含一个行动动词避免重复关键词超过两次”。3.2 CRO 技能落地页诊断与转化优化CRO 技能的核心是把“转化率优化”这个模糊概念拆成可检查的清单。我常用的诊断维度包括首屏是否在 3 秒内传达核心价值CTA 按钮是否足够醒目、文案是否明确表单字段是否过多每多一个字段转化率下降约 10%这是行业常见经验值社会证明评价、案例、logo是否放在决策路径上移动端体验是否被单独考虑。用marketingskills的 CRO 技能时我会把落地页 HTML 或截图描述喂给 agent让它按上述维度逐条打分并给改进建议。实测下来agent 在“文案层面”的建议质量不错但在“视觉层面”比如按钮颜色、留白的建议比较泛需要人工把关。注意CRO 技能的输出应该当作“检查清单”而不是“最终方案”。agent 能帮你发现明显问题但转化率提升往往需要 A/B 测试验证别直接全量上线。3.3 Analytics 技能事件追踪与漏斗分析Analytics 技能解决的是“埋点方案设计”和“数据解读”两个问题。独立站最常见的需求是我想追踪用户从落地页到下单的完整路径该怎么埋点用marketingskills的 analytics 技能你可以描述业务目标让 agent 输出 GA4 事件方案。比如业务目标追踪独立站从产品页 → 加购 → 结账 → 支付成功的漏斗。 请输出 GA4 事件名称、触发条件、参数列表以及建议的自定义维度。Agent 通常会给出类似view_item、add_to_cart、begin_checkout、purchase的事件映射并补充item_id、value、currency等参数。这里的关键是事件命名一致性一旦定了add_to_cart就别再出现addToCart或cart_add否则后续分析会乱。漏斗分析环节把 GA4 导出的 CSV 喂给 agent让它计算各步骤转化率并指出流失最大的环节。我一般会要求 agent 同时输出“绝对流失人数”和“相对流失率”因为这两个指标看问题的角度不同。3.4 内容技能大纲、标题与改写内容技能是使用频率最高的因为内容营销是独立站 SEO 的燃料。我常用的三个子技能大纲生成给一个目标关键词和受众画像让 agent 输出 H2/H3 结构。注意要指定“覆盖搜索意图”和“包含 FAQ 部分”这两点对 SEO 很关键。标题优化给一批标题让 agent 按“包含关键词、有数字、有情绪词、不超过 60 字符”的标准打分并改写。我一般会要 3 个变体然后人工选一个。内容改写把旧内容喂给 agent让它按新的关键词方向改写。这里要小心agent 容易把原文改得面目全非最好在技能描述里加“保留原文核心信息和数据只调整结构和关键词密度”。4. 实操落地从安装到跑通第一个技能4.1 环境准备与 Claude Code 接入marketingskills本身是一组技能定义文件要跑起来需要配合 agent 运行环境。目前社区里最常用的组合是 Claude Code 本地技能目录。安装 Claude Code 的步骤这里不展开官方文档写得很清楚重点讲技能接入。假设你已经装好了 Claude Code接入marketingskills的流程大致是把marketingskills仓库克隆到本地在 Claude Code 的配置目录里创建技能引用通常是 symlink 或直接复制技能文件重启 Claude Code用/skills或类似命令确认技能已加载在对话里用自然语言触发技能。我实测下来技能目录结构要清晰比如marketingskills/ seo/ keyword-clustering.md content-gap-analysis.md meta-optimization.md cro/ landing-page-audit.md analytics/ event-tracking-plan.md content/ outline-generator.md每个.md文件里包含技能名称、描述、输入输出格式、示例。这样 agent 加载时能快速索引。4.2 跑通第一个 SEO 技能关键词聚类拿一个真实场景练手我手上有一个独立站卖手工皮具积累了 200 多个关键词。我想把它们聚类成内容主题。第一步准备输入文件# keywords.txt 手工皮具 手工钱包 真皮钱包 手工皮具品牌 皮具保养 钱包保养 手工皮带 ...第二步触发技能在 Claude Code 里输入请使用 keyword-clustering 技能读取 keywords.txt 按搜索意图和主题相似度聚类输出 Markdown 表格。第三步检查输出Agent 返回的表格大概长这样聚类名称包含关键词建议内容类型优先级手工钱包选购手工钱包、真皮钱包、钱包品牌购买指南高皮具保养皮具保养、钱包保养、皮革护理教程中手工皮带手工皮带、皮带定制产品页中第四步人工校验这一步不能省。Agent 有时候会把“皮具保养”和“皮革护理”分到不同组其实是一个意思。我会手动合并然后按优先级排内容日历。4.3 参数选择与效果验证跑技能的时候有几个参数值得注意温度temperatureSEO 和 analytics 类任务建议低温度0.2-0.3保证输出稳定内容创意类可以高一点0.7最大输出长度关键词聚类如果词多要调大 max tokens否则表格会被截断输入格式CSV 比纯文本好因为 agent 能识别列名减少歧义。效果验证我一般看两个指标覆盖率聚类是否覆盖了所有关键词和可执行性每个聚类是否能直接对应一篇内容。如果覆盖率低于 90%说明聚类粒度有问题如果可执行性差说明聚类名称太抽象。5. 常见问题与排查技巧实录5.1 技能不被调用或调用错误这是最常见的问题。表现是你说了需求agent 却用通用能力回答没走技能。排查思路检查技能描述是否包含明确的触发词检查技能文件是否被正确加载用/skills确认尝试在指令里显式点名技能比如“使用 keyword-clustering 技能”。我踩过的坑是技能描述写得太学术agent 匹配不上口语化指令。后来改成“当用户提供关键词列表并想分组时使用”调用率明显提升。5.2 输出格式不稳定同一个技能有时候输出表格有时候输出列表。原因是技能描述里没锁死输出格式。解决办法是在技能文件里加输出模板比如输出必须为 Markdown 表格列固定为聚类名称、包含关键词、建议内容类型、优先级。5.3 数据量太大导致丢细节关键词超过 500 个、或者页面 HTML 太长时agent 容易“偷懒”只处理前面一部分。我的做法是分批处理把关键词按字母或来源切成 100 个一组分别跑最后合并。虽然麻烦点但结果完整。5.4 常见问题速查表问题现象可能原因解决方法技能不触发描述缺触发词补充口语化触发条件输出格式乱未锁死模板在技能文件里加输出模板数据丢失输入过长分批处理每批 ≤100 条建议太泛缺少上下文在指令里补充品牌调性、受众调用错技能技能边界模糊明确“不处理什么”5.5 独家避坑技巧技能文件版本化每次改技能描述都记一笔否则调着调着就忘了哪版好用先小样本测试新技能先拿 10 条数据跑确认输出质量再上量保留人工审核环节SEO 和 CRO 建议直接影响线上别让 agent 直接改生产环境用真实数据校准拿 GA4 的真实转化数据反推 CRO 建议是否靠谱比拍脑袋强。6. 技能扩展与工作流串联6.1 把单技能串成完整工作流单个技能解决单点问题但营销工作是链式的。我常用的一个独立站 SEO 工作流是keyword-clustering聚类关键词content-gap-analysis对比竞品找差距outline-generator生成内容大纲meta-optimization优化页面 metaevent-tracking-plan设计追踪方案上线后funnel-analysis看数据。这个链路可以在 Claude Code 里用脚本串起来也可以手动一步步跑。手动跑的好处是每步都能人工校验适合质量要求高的场景。6.2 自定义技能的方法marketingskills里的技能不是终点你可以按同样格式加自己的。我加过一个“Discuz 列表页 SEO 设置”技能因为社区论坛的 SEO 和独立站逻辑不同。技能文件大概这样# 技能名称discuz-list-seo ## 描述 当用户需要优化 Discuz 论坛列表页的 SEO 时使用。 ## 输入 - 论坛版块 URL - 当前 title/description 模板 ## 输出 - 优化后的 title/description 模板 - 分页处理建议 - canonical 标签建议 ## 边界 不处理帖子内容页 SEO。加完之后agent 就能在遇到 Discuz 相关问题时调用这个技能而不是套用独立站的逻辑。6.3 与 analytics 闭环技能跑完不是结束得看效果。我一般会在内容上线 2-4 周后把 Search Console 的展现/点击数据和 GA4 的转化数据喂给 agent让它对比优化前后的变化。这一步用funnel-analysis技能输出“哪些页面提升了、哪些没动、可能原因”。这个闭环跑通之后整个营销流程就从“拍脑袋”变成了“数据驱动”。7. 一些个人体会这套东西我用了几个月最大的感受是AI agent 不会替代营销判断但能把执行效率拉高一个量级。以前做一轮关键词聚类加内容规划要一整天现在两小时能跑完剩下时间用来打磨内容和看数据。另一个体会是技能描述的质量决定一切。同样的模型技能写得好输出直接能用写得烂输出就是废话。我现在的习惯是每加一个新技能先拿真实数据跑三遍不满意就改描述直到稳定为止。最后分享一个小技巧如果你用的是 Claude Code可以把常用技能组合写成一个 shell 脚本一键跑完整条链路。比如run-seo-workflow.sh里面按顺序调用各个技能输出到指定目录。这样每次做新站 SEO改改输入文件就行省去重复指令的功夫。
1. 项目缘起与核心定位第一次看到marketingskills这个仓库名的时候我正陷在一堆重复的营销执行工作里——给独立站写 meta description、调 Google Ads 的落地页文案、整理 GA4 的事件埋点、盯着 Search Console 的覆盖率报告发呆。这些活儿单拎出来都不难但架不住量大、琐碎、还要求一致性。当时我就在想能不能把这些营销动作拆成一套可复用的“技能包”让 AI agent 按需调用而不是每次都从零写 prompt。marketingskills本质上就是干这件事的它是一套面向营销场景的AI agent 技能集合把 SEO、CRO转化率优化、analytics数据分析这些高频营销任务封装成结构化的、可被 agent 直接调用的技能模块。你可以把它理解成一个“营销工具箱”里面每个工具都对应一类具体任务比如关键词聚类、落地页诊断、事件追踪方案生成、竞品内容差距分析等等。这个项目解决的核心问题是营销执行中的“最后一公里”自动化。市面上不缺营销理论也不缺 AI 写作工具但缺的是把“营销方法论”翻译成“agent 可执行指令”的中间层。marketingskills补的就是这一层。它适合谁我梳理了一下大概三类人用起来最顺手独立站运营者一个人管 SEO、内容、广告、数据需要把重复劳动压缩到最低增长/营销团队的 tech lead想给团队搭一套 AI 辅助工作流但不想从零造轮子AI agent 开发者需要现成的营销领域技能定义作为自己 agent 项目的参考或直接集成。关键词里出现的 Claude Code、AI agents、SEO、CRO、analytics基本勾勒出了这个项目的技术底座和应用边界。接下来我会从设计思路、核心模块、实操落地、踩坑排查几个层面把这个项目拆开讲透。2. 整体设计思路与技能拆解逻辑2.1 为什么是“技能包”而不是“大而全的 prompt”我见过太多人做营销 AI 工具第一反应是写一个巨长的 system prompt把 SEO 规则、文案要求、数据分析逻辑全塞进去。结果就是token 爆炸、指令冲突、模型注意力被稀释最后输出质量还不如人工。marketingskills的设计哲学明显反着来——按任务边界切分技能每个技能只解决一类问题输入输出定义清晰。这种设计的优势在于可组合一个完整的“独立站 SEO 审计”流程可以拆成“抓取页面结构 → 分析关键词覆盖 → 生成优化建议 → 输出优先级列表”四个技能串联可测试每个技能单独跑输出质量容易评估不像大 prompt 那样一改就全乱可复用同一个“关键词聚类”技能既能用在 SEO 内容规划也能用在广告组结构优化。从工程角度看这其实就是把营销工作流“函数化”了。每个技能是一个函数输入是原始数据页面 HTML、关键词列表、GA4 导出 CSV输出是结构化结果JSON、Markdown 表格、优先级队列。2.2 技能分类与核心模块根据仓库结构和常见营销任务链路我把marketingskills的技能大致归为四类技能类别典型任务输入输出SEO 技能关键词聚类、内容差距分析、meta 优化、内链建议关键词列表、竞品 URL、页面内容聚类分组、优化建议、优先级CRO 技能落地页诊断、CTA 文案生成、表单字段优化页面截图/HTML、转化目标问题清单、改进方案Analytics 技能事件追踪方案、GA4 配置建议、漏斗分析业务目标、页面路径埋点方案、分析维度内容技能大纲生成、标题优化、内容改写目标关键词、受众画像内容结构、文案变体这个分类不是死的实际用的时候经常交叉。比如做“独立站谷歌 SEO”的时候你会同时用到 SEO 技能关键词和内容技能大纲最后用 analytics 技能验证效果。2.3 与 Claude Code / AI agents 的集成逻辑marketingskills之所以在 Claude Code 社区里被频繁提及是因为它的技能定义格式天然适配 agent 的 tool use 机制。Claude Code 作为一个终端里的 AI 编程助手本身支持自定义技能/命令扩展。你把marketingskills里的技能定义挂进去就能在终端里直接喊“帮我分析这个页面的 SEO 问题”agent 会自动调用对应技能读取你指定的文件输出结果。这里的关键是技能描述的质量。一个技能能不能被 agent 正确调用取决于它的 description 写得好不好。我实测下来好的技能描述应该包含触发条件什么情况下该用这个技能输入格式需要用户提供什么输出格式会返回什么结构边界说明不处理什么情况。比如一个“关键词聚类”技能描述里如果只写“对关键词进行聚类”agent 很可能在用户问“帮我看看这个页面标题好不好”的时候也错误调用。但如果写清楚“当用户提供关键词列表并需要按主题分组时使用输入为换行分隔的关键词输出为 Markdown 表格”调用准确率会高很多。3. 核心技能模块的细节与实操要点3.1 SEO 技能从关键词到内容规划SEO 是marketingskills里最重的模块也是独立站运营者最常用的部分。我把它拆成三个关键环节来讲。关键词聚类是第一步。很多人拿到几百个关键词就懵了不知道从哪下手。传统做法是用工具Ahrefs、Semrush的聚类功能但要么贵要么不够灵活。用marketingskills的思路你可以让 agent 读取关键词 CSV按搜索意图和主题相关性分组。实操时我会给 agent 这样的指令# 假设关键词文件是 keywords.csv每行一个词 请读取 keywords.csv按搜索意图信息型/导航型/交易型和主题相似度聚类 输出 Markdown 表格列包括聚类名称、包含关键词、建议内容类型、优先级。这里有个经验聚类粒度要控制。太粗了比如只分“SEO”和“营销”没用太细了每个词一组又失去意义。我一般让 agent 按“一个聚类能对应一篇内容”的标准来分这样输出直接能当内容日历用。内容差距分析是第二步。你需要知道竞品覆盖了哪些主题、你没覆盖。实操时把竞品 sitemap 和你自己的 sitemap 都喂给 agent让它对比 URL 结构和标题输出差距列表。注意这一步最好用竞品的分类页和博客列表页而不是全站抓取否则数据量太大agent 处理起来会丢细节。Meta 优化是第三步也是最容易自动化的一步。给 agent 一个页面 URL 或 HTML 文件让它输出 title 和 description 的优化建议。我踩过的坑是agent 容易写出“关键词堆砌”的 meta因为它不知道品牌调性和用户点击心理。解决办法是在技能描述里加约束比如“title 不超过 60 字符description 不超过 155 字符必须包含一个行动动词避免重复关键词超过两次”。3.2 CRO 技能落地页诊断与转化优化CRO 技能的核心是把“转化率优化”这个模糊概念拆成可检查的清单。我常用的诊断维度包括首屏是否在 3 秒内传达核心价值CTA 按钮是否足够醒目、文案是否明确表单字段是否过多每多一个字段转化率下降约 10%这是行业常见经验值社会证明评价、案例、logo是否放在决策路径上移动端体验是否被单独考虑。用marketingskills的 CRO 技能时我会把落地页 HTML 或截图描述喂给 agent让它按上述维度逐条打分并给改进建议。实测下来agent 在“文案层面”的建议质量不错但在“视觉层面”比如按钮颜色、留白的建议比较泛需要人工把关。注意CRO 技能的输出应该当作“检查清单”而不是“最终方案”。agent 能帮你发现明显问题但转化率提升往往需要 A/B 测试验证别直接全量上线。3.3 Analytics 技能事件追踪与漏斗分析Analytics 技能解决的是“埋点方案设计”和“数据解读”两个问题。独立站最常见的需求是我想追踪用户从落地页到下单的完整路径该怎么埋点用marketingskills的 analytics 技能你可以描述业务目标让 agent 输出 GA4 事件方案。比如业务目标追踪独立站从产品页 → 加购 → 结账 → 支付成功的漏斗。 请输出 GA4 事件名称、触发条件、参数列表以及建议的自定义维度。Agent 通常会给出类似view_item、add_to_cart、begin_checkout、purchase的事件映射并补充item_id、value、currency等参数。这里的关键是事件命名一致性一旦定了add_to_cart就别再出现addToCart或cart_add否则后续分析会乱。漏斗分析环节把 GA4 导出的 CSV 喂给 agent让它计算各步骤转化率并指出流失最大的环节。我一般会要求 agent 同时输出“绝对流失人数”和“相对流失率”因为这两个指标看问题的角度不同。3.4 内容技能大纲、标题与改写内容技能是使用频率最高的因为内容营销是独立站 SEO 的燃料。我常用的三个子技能大纲生成给一个目标关键词和受众画像让 agent 输出 H2/H3 结构。注意要指定“覆盖搜索意图”和“包含 FAQ 部分”这两点对 SEO 很关键。标题优化给一批标题让 agent 按“包含关键词、有数字、有情绪词、不超过 60 字符”的标准打分并改写。我一般会要 3 个变体然后人工选一个。内容改写把旧内容喂给 agent让它按新的关键词方向改写。这里要小心agent 容易把原文改得面目全非最好在技能描述里加“保留原文核心信息和数据只调整结构和关键词密度”。4. 实操落地从安装到跑通第一个技能4.1 环境准备与 Claude Code 接入marketingskills本身是一组技能定义文件要跑起来需要配合 agent 运行环境。目前社区里最常用的组合是 Claude Code 本地技能目录。安装 Claude Code 的步骤这里不展开官方文档写得很清楚重点讲技能接入。假设你已经装好了 Claude Code接入marketingskills的流程大致是把marketingskills仓库克隆到本地在 Claude Code 的配置目录里创建技能引用通常是 symlink 或直接复制技能文件重启 Claude Code用/skills或类似命令确认技能已加载在对话里用自然语言触发技能。我实测下来技能目录结构要清晰比如marketingskills/ seo/ keyword-clustering.md content-gap-analysis.md meta-optimization.md cro/ landing-page-audit.md analytics/ event-tracking-plan.md content/ outline-generator.md每个.md文件里包含技能名称、描述、输入输出格式、示例。这样 agent 加载时能快速索引。4.2 跑通第一个 SEO 技能关键词聚类拿一个真实场景练手我手上有一个独立站卖手工皮具积累了 200 多个关键词。我想把它们聚类成内容主题。第一步准备输入文件# keywords.txt 手工皮具 手工钱包 真皮钱包 手工皮具品牌 皮具保养 钱包保养 手工皮带 ...第二步触发技能在 Claude Code 里输入请使用 keyword-clustering 技能读取 keywords.txt 按搜索意图和主题相似度聚类输出 Markdown 表格。第三步检查输出Agent 返回的表格大概长这样聚类名称包含关键词建议内容类型优先级手工钱包选购手工钱包、真皮钱包、钱包品牌购买指南高皮具保养皮具保养、钱包保养、皮革护理教程中手工皮带手工皮带、皮带定制产品页中第四步人工校验这一步不能省。Agent 有时候会把“皮具保养”和“皮革护理”分到不同组其实是一个意思。我会手动合并然后按优先级排内容日历。4.3 参数选择与效果验证跑技能的时候有几个参数值得注意温度temperatureSEO 和 analytics 类任务建议低温度0.2-0.3保证输出稳定内容创意类可以高一点0.7最大输出长度关键词聚类如果词多要调大 max tokens否则表格会被截断输入格式CSV 比纯文本好因为 agent 能识别列名减少歧义。效果验证我一般看两个指标覆盖率聚类是否覆盖了所有关键词和可执行性每个聚类是否能直接对应一篇内容。如果覆盖率低于 90%说明聚类粒度有问题如果可执行性差说明聚类名称太抽象。5. 常见问题与排查技巧实录5.1 技能不被调用或调用错误这是最常见的问题。表现是你说了需求agent 却用通用能力回答没走技能。排查思路检查技能描述是否包含明确的触发词检查技能文件是否被正确加载用/skills确认尝试在指令里显式点名技能比如“使用 keyword-clustering 技能”。我踩过的坑是技能描述写得太学术agent 匹配不上口语化指令。后来改成“当用户提供关键词列表并想分组时使用”调用率明显提升。5.2 输出格式不稳定同一个技能有时候输出表格有时候输出列表。原因是技能描述里没锁死输出格式。解决办法是在技能文件里加输出模板比如输出必须为 Markdown 表格列固定为聚类名称、包含关键词、建议内容类型、优先级。5.3 数据量太大导致丢细节关键词超过 500 个、或者页面 HTML 太长时agent 容易“偷懒”只处理前面一部分。我的做法是分批处理把关键词按字母或来源切成 100 个一组分别跑最后合并。虽然麻烦点但结果完整。5.4 常见问题速查表问题现象可能原因解决方法技能不触发描述缺触发词补充口语化触发条件输出格式乱未锁死模板在技能文件里加输出模板数据丢失输入过长分批处理每批 ≤100 条建议太泛缺少上下文在指令里补充品牌调性、受众调用错技能技能边界模糊明确“不处理什么”5.5 独家避坑技巧技能文件版本化每次改技能描述都记一笔否则调着调着就忘了哪版好用先小样本测试新技能先拿 10 条数据跑确认输出质量再上量保留人工审核环节SEO 和 CRO 建议直接影响线上别让 agent 直接改生产环境用真实数据校准拿 GA4 的真实转化数据反推 CRO 建议是否靠谱比拍脑袋强。6. 技能扩展与工作流串联6.1 把单技能串成完整工作流单个技能解决单点问题但营销工作是链式的。我常用的一个独立站 SEO 工作流是keyword-clustering聚类关键词content-gap-analysis对比竞品找差距outline-generator生成内容大纲meta-optimization优化页面 metaevent-tracking-plan设计追踪方案上线后funnel-analysis看数据。这个链路可以在 Claude Code 里用脚本串起来也可以手动一步步跑。手动跑的好处是每步都能人工校验适合质量要求高的场景。6.2 自定义技能的方法marketingskills里的技能不是终点你可以按同样格式加自己的。我加过一个“Discuz 列表页 SEO 设置”技能因为社区论坛的 SEO 和独立站逻辑不同。技能文件大概这样# 技能名称discuz-list-seo ## 描述 当用户需要优化 Discuz 论坛列表页的 SEO 时使用。 ## 输入 - 论坛版块 URL - 当前 title/description 模板 ## 输出 - 优化后的 title/description 模板 - 分页处理建议 - canonical 标签建议 ## 边界 不处理帖子内容页 SEO。加完之后agent 就能在遇到 Discuz 相关问题时调用这个技能而不是套用独立站的逻辑。6.3 与 analytics 闭环技能跑完不是结束得看效果。我一般会在内容上线 2-4 周后把 Search Console 的展现/点击数据和 GA4 的转化数据喂给 agent让它对比优化前后的变化。这一步用funnel-analysis技能输出“哪些页面提升了、哪些没动、可能原因”。这个闭环跑通之后整个营销流程就从“拍脑袋”变成了“数据驱动”。7. 一些个人体会这套东西我用了几个月最大的感受是AI agent 不会替代营销判断但能把执行效率拉高一个量级。以前做一轮关键词聚类加内容规划要一整天现在两小时能跑完剩下时间用来打磨内容和看数据。另一个体会是技能描述的质量决定一切。同样的模型技能写得好输出直接能用写得烂输出就是废话。我现在的习惯是每加一个新技能先拿真实数据跑三遍不满意就改描述直到稳定为止。最后分享一个小技巧如果你用的是 Claude Code可以把常用技能组合写成一个 shell 脚本一键跑完整条链路。比如run-seo-workflow.sh里面按顺序调用各个技能输出到指定目录。这样每次做新站 SEO改改输入文件就行省去重复指令的功夫。
