# https://github.com/coreyhaines31/marketingskills 项目说明书生成时间：2026-05-11 17:55:30 UTC ## 目录 - [项目概述](#project-overview) - [快速开始](#quick-start) - [安装指南](#installation-guide) - [技能系统概览](#skills-overview) - [技能分类总览](#skill-categories) - [转化率优化技能组](#cro-skills) - [内容与文案技能组](#content-skills) - [SEO与发现技能组](#seo-skills) - [增长与收入技能组](#growth-skills) - [CLI工具集](#cli-tools) ## 项目概述 ### 相关页面相关主题：[快速开始](#quick-start), [技能系统概览](#skills-overview), [安装指南](#installation-guide)

相关源码文件

以下源码文件用于生成本页说明： - [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md) - [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md) - [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md) - [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md) - [skills/schema-markup/references/schema-examples.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema-markup/references/schema-examples.md)

# 项目概述 ## 项目简介 Marketing Skills 是一个面向 AI 代理（Agent）的营销技能集合库，旨在为自动化营销任务提供标准化的技能定义和操作指南。该项目通过结构化的技能模块，帮助 AI 代理执行各类营销工作，包括内容策略、SEO 优化、付费广告、网站架构设计等。资料来源：[CONTRIBUTING.md:1-5]() ## 核心设计理念 ### 技能模块化项目采用模块化设计，每个营销技能独立存放在 `skills/` 目录下的子目录中。每个技能包含完整的指令、参考资料、脚本和资源文件，可被不同的 AI 代理平台调用。 ### 跨代理兼容性技能设计遵循跨平台兼容原则，确保同一套技能可以在多种 AI 代理环境中运行，包括 Codex、Cursor、Windsurf 等主流平台。资料来源：[CLAUDE.md:1-5]() ## 项目架构 ### 整体架构图 ```mermaid graph TD subgraph "项目根目录" CLAUDE["CLAUDE.md"] AGENTS["AGENTS.md"] CONTRIBUTING["CONTRIBUTING.md"] end subgraph "skills/ 技能目录" SKILL1["content-strategy/"] SKILL2["paid-ads/"] SKILL3["site-architecture/"] SKILL4["schema-markup/"] SKILL5["image/"] end subgraph "tools/ 工具集成" CLI["clis/"] INTEGRATIONS["integrations/"] end CLAUDE --> SKILL1 CLAUDE --> SKILL2 AGENTS --> SKILL1 CONTRIBUTING --> SKILL1 SKILL1 --> REF1["references/"] SKILL2 --> REF2["references/"] SKILL3 --> REF3["references/"] ``` ### 目录结构规范 ``` marketingskills/ ├── skills/ # 技能模块目录 │ ├── [skill-name]/ # 单个技能目录 │ │ ├── SKILL.md # 必需 - 主指令文件 │ │ ├── references/ # 可选 - 附加文档 │ │ │ └── guide.md │ │ ├── scripts/ # 可选 - 可执行代码 │ │ │ └── helper.py │ │ └── assets/ # 可选 - 模板、图片、数据 │ │ └── template.json ├── tools/ # 工具集成 │ ├── clis/ # CLI 工具 │ │ └── optimizely.js │ └── integrations/ # 第三方集成 │ ├── postmark.md │ ├── sanity.md │ ├── wordpress.md │ └── ahrefs.md ├── CLAUDE.md # Claude Code 配置 ├── AGENTS.md # 代理配置说明 └── CONTRIBUTING.md # 贡献指南 ``` 资料来源：[CONTRIBUTING.md:25-40]() ## 技能系统详解 ### SKILL.md 文件规范每个技能的核心是 `SKILL.md` 文件，必须包含 YAML frontmatter 元数据： ```yaml --- name: your-skill-name description: 技能使用场景描述，包含触发短语和关键词，帮助代理识别相关任务 --- ``` **可选字段：** | 字段 | 说明 | 默认值 | |------|------|--------| | `license` | 许可证类型 | MIT | | `metadata` | 元数据（作者、版本等） | 无 | **命名规范：** - 目录名：小写，仅使用连字符（例：`email-sequence`） - name 字段：必须与目录名完全一致 - description：1-1024 字符，包含触发短语资料来源：[CONTRIBUTING.md:10-25]() ### 技能文件结构 ```mermaid graph LR A["SKILL.md
必需"] --> B["references/
可选"] A --> C["scripts/
可选"] A --> D["assets/
可选"] B --> B1["guide.md"] B --> B2["mermaid-templates.md"] C --> C1["helper.py"] C --> C2["optimizely.js"] D --> D1["template.json"] D --> D2["schema-examples.md"] ``` ## 代理集成机制 ### 动态内容注入 Claude Code 支持在 SKILL.md 中嵌入 shell 命令，使用 `` !`command` `` 语法。当技能被调用时，系统执行命令并将结果内联注入。 **常用应用场景：** ```markdown # 自动注入产品营销上下文文件 Product context: !`cat .agents/product-marketing-context.md 2>/dev/null || echo "No product context file found"` # 注入当前日期 Today's date: !`date +%Y-%m-%d` # 注入当前 git 分支 Current branch: !`git branch --show-current 2>/dev/null` ``` ### 产品上下文自动加载在技能文件顶部放置以下内容，使上下文在技能执行时自动可用： ```markdown Product context: !`cat .agents/product-marketing-context.md 2>/dev/null || echo "No product context file found — ask the user about their product before proceeding."` ``` 资料来源：[CLAUDE.md:10-35]() ### 代理兼容性说明 | 代理平台 | 支持状态 | 特殊说明 | |---------|---------|---------| | Claude Code | 完全支持 | 支持 `!`command`` 动态注入 | | Codex | 基础支持 | 仅读取标准 SKILL.md | | Cursor | 基础支持 | 仅读取标准 SKILL.md | | Windsurf | 基础支持 | 仅读取标准 SKILL.md | **重要限制：** 动态内容注入功能仅限于 Claude Code。其他代理会看到字面量的 `` !`command` `` 字符串而非执行结果。资料来源：[CLAUDE.md:35-45]() ## 工具集成 ### CLI 工具项目在 `tools/clis/` 目录下提供了多种 CLI 工具脚本： | 工具 | 文件 | 功能 | |------|------|------| | Optimizely | `optimizely.js` | 项目和页面管理 | | Livestorm | `livestorm.js` | 活动、会话、人员管理 | ### 第三方集成 `tools/integrations/` 目录包含与主流营销工具的集成文档： | 集成服务 | 文件 | API 端点示例 | |---------|------|-------------| | Postmark | `postmark.md` | `/templates`, `/messages/outbound` | | Sanity | `sanity.md` | `/export`, `/dataset` | | WordPress | `wordpress.md` | `/wp-json/wp/v2/posts` | | Ahrefs | `ahrefs.md` | `/v3/site-explorer/` | | Hyperframes | `hyperframes.md` | 视频帧生成 | 资料来源：[tools/integrations/postmark.md:1-30]() 资料来源：[tools/integrations/sanity.md:1-25]() ## 技能模块概览 ### 内容策略技能 **目录：** `skills/content-strategy/` 包含内容规划、编辑工作流、SEO 字段规范等参考资料。 ### 付费广告技能 **目录：** `skills/paid-ads/` 涵盖转化追踪、广告平台集成等。 ### 网站架构技能 **目录：** `skills/site-architecture/` 提供导航模式、面包屑规范、移动端导航等设计模板，包含 Mermaid 图表模板。 ### Schema 标记技能 **目录：** `skills/schema-markup/` 提供 JSON-LD 结构化数据示例，覆盖 Article、Product、WebSite 等类型。 ### 图片技能 **目录：** `skills/image/` 包含 AI 图片生成提示词指南，支持多种用例场景。 ## 贡献指南 ### 添加新技能流程 ```mermaid graph TD A["创建技能目录
mkdir skills/your-skill-name"] --> B["创建 SKILL.md 文件"] B --> C["添加 YAML frontmatter"] C --> D["编写技能指令"] D --> E["添加可选资源
references/scripts/assets"] E --> F["遵循命名规范"] F --> G["提交 Pull Request"] ``` ### 技能请求用户可通过 [GitHub Issues](https://github.com/coreyhaines31/marketingskills/issues/new?template=skill-request.yml) 提交新技能请求。资料来源：[CONTRIBUTING.md:5-10]() ## 工作原理 ```mermaid sequenceDiagram participant User as 用户 participant Agent as AI 代理 participant Skill as SKILL.md participant Ref as References participant Tool as Tools User->>Agent: 调用技能 Agent->>Skill: 读取技能指令 Skill-->>Agent: 返回指令内容 Agent->>Ref: 访问参考资料（如需要） Ref-->>Agent: 返回文档内容 Agent->>Tool: 执行脚本或集成 Tool-->>Agent: 返回结果 Agent-->>User: 完成营销任务 ``` ## 关键特性总结 | 特性 | 说明 | |------|------| | 模块化设计 | 每个技能独立，可单独使用 | | 跨平台兼容 | 支持多种 AI 代理环境 | | 丰富的参考资料 | 内置模板、图表、示例代码 | | 工具集成 | 预置主流营销工具集成文档 | | 动态内容 | 支持 shell 命令注入 | | 标准化格式 | 统一的 SKILL.md 规范 | --- **维护者：** Corey Haines **许可证：** MIT --- ## 快速开始 ### 相关页面相关主题：[项目概述](#project-overview), [安装指南](#installation-guide), [技能系统概览](#skills-overview)

相关源码文件

以下源码文件用于生成本页说明： - [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md) - [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md) - [skills/product-marketing-context/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/product-marketing-context/SKILL.md) - [skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md) - [skills/image/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/image/SKILL.md) - [skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md)

# 快速开始本页面为用户提供如何在 marketingskills 项目中快速上手的完整指南，包括项目安装、技能添加和工作流程。 ## 项目概述 Marketing Skills 是一个 AI 代理营销技能集合，为 AI 代理提供专业的营销知识和 workflows。当用户将这些技能添加到项目中时，代理能够识别营销任务并应用正确的框架和最佳实践。 ## 核心概念 ### 什么是技能（Skills）技能是 Markdown 文件，为 AI 代理提供特定任务的专门知识和 workflows。每个技能包含： - 触发短语和关键词 - 详细的使用说明 - 可选的参考资料、脚本和模板 ### 技能层级结构 ```mermaid graph TD PMC["product-marketing-context
(产品营销上下文)"] SEO["SEO 与内容"] CRO["转化率优化"] CONTENT["内容与文案"] PAID["付费与分发"] GROWTH["增长与留存"] SALES["销售与GTM"] STRATEGY["策略"] PMC --> SEO PMC --> CRO PMC --> CONTENT PMC --> PAID PMC --> GROWTH PMC --> SALES PMC --> STRATEGY style PMC fill:#f9f,stroke:#333,stroke-width:2px ``` `product-marketing-context` 技能是整个系统的基础，所有其他技能在执行任务前都会先读取它以了解产品、受众和定位。 ## 添加新技能 ### 目录结构每个技能需要遵循标准的目录结构： ``` skills/your-skill-name/ ├── SKILL.md # 必需 - 主指令文件 ├── references/ # 可选 - 附加文档 │ └── guide.md ├── scripts/ # 可选 - 可执行代码 │ └── helper.py └── assets/ # 可选 - 模板、图片、数据 └── template.json ``` ### 创建 SKILL.md 文件每个技能必须有包含 YAML 前置数据的 `SKILL.md` 文件： ```yaml --- name: your-skill-name description: 何时使用此技能。包含帮助代理识别相关任务的触发短语和关键词。 --- # 你的技能名称代理指令在此处... ``` 前置数据字段说明： | 字段 | 必填 | 说明 | 默认值 | |------|:----:|------|:------:| | name | 是 | 技能名称，必须与目录名完全匹配 | - | | description | 是 | 描述，包含触发短语 | - | | license | 否 | 许可证类型 | MIT | | metadata | 否 | 元数据（作者、版本等） | - | ### 命名规范 - **目录名**：小写，仅使用连字符（如 `email-sequence`） - **Name 字段**：必须与目录名完全一致 - **Description**：1-1024 字符，包含触发短语 ## 技能工作流程 ### 代理识别流程 ```mermaid graph TD A["用户请求"] --> B["代理分析请求"] B --> C{"匹配触发短语?"} C -->|是| D["加载对应技能"] C -->|否| E["使用通用知识"] D --> F["读取 product-marketing-context"] F --> G["执行技能指令"] G --> H["应用最佳实践"] style D fill:#90EE90 style F fill:#FFD700 ``` ### 技能间的协作技能相互引用并建立在共享上下文之上。当代理执行任务时： 1. **初始化**：代理识别相关技能 2. **上下文加载**：读取 `product-marketing-context` 获取项目背景 3. **技能执行**：按照技能指令执行具体任务 4. **参考资料**：如有需要，引用 `references/` 目录中的附加文档 ## 可用技能分类 ### 获客与增长 | 技能目录 | 说明 | 适用场景 | |----------|------|----------| | `seo-content` | SEO 与内容策略 | 博客文章、落地页 | | `programmatic-seo` | 规模化页面生成 | 大量长尾页面 | | `site-architecture` | 页面层级与导航 | 网站结构优化 | | `schema-markup` | 结构化数据 | 搜索引擎优化 | ### 付费与分发 | 技能目录 | 说明 | 适用场景 | |----------|------|----------| | `paid-ads` | Google、Meta、LinkedIn 广告 | 付费推广活动 | | `ad-creative` | 广告创意生成 | 批量广告制作 | | `social-content` | 社交媒体策略 | 内容排期管理 | ### 测量与测试 | 技能目录 | 说明 | 适用场景 | |----------|------|----------| | `analytics-tracking` | 事件追踪设置 | 数据收集配置 | | `ab-test-setup` | 实验设计 | A/B 测试规划 | ### 留存与增长工程 | 技能目录 | 说明 | 适用场景 | |----------|------|----------| | `churn-prevention` | 流失预防 | 取消流程、拯救优惠 | | `co-marketing` | 联合营销 | 合作伙伴识别 | | `free-tool-strategy` | 免费工具策略 | 营销工具与计算器 | | `referral-program` | 推荐与联盟 | 裂变营销 | ### 策略与变现 | 技能目录 | 说明 | 适用场景 | |----------|------|----------| | `marketing-ideas` | 140+ SaaS 营销创意 | 营销灵感 | | `marketing-psychology` | 心理模型 | 用户行为洞察 | | `launch-strategy` | 产品发布 | 新功能推广 | | `pricing-strategy` | 定价策略 | 套餐设计 | ### 销售与运营 | 技能目录 | 说明 | 适用场景 | |----------|------|----------| | `revops` | 生命周期与评分 | 线索路由 | | `sales-enablement` | 销售赋能 | 演示脚本、异议处理 | ## 典型使用流程 ### 创建竞品分析以 `competitor-profiling` 技能为例，展示典型工作流程： ```mermaid graph TD A["确定竞品 URL"] --> B["Firecrawl Map 站点映射"] B --> C["识别关键页面"] C --> D["Firecrawl Scrape 抓取页面"] D --> E["保存原始数据"] E --> F["提取定位和定价"] F --> G["生成竞品报告"] style B fill:#87CEEB style D fill:#87CEEB ``` 具体步骤： 1. **映射站点**：`firecrawl_map` 发现竞品站点结构 2. **识别页面类型**：首页、定价、功能、关于、博客 3. **抓取关键页**：`firecrawl_scrape` 逐页抓取 4. **保存数据**：`competitor-profiles/raw/<竞品 slug>/<日期>/scrapes/` 5. **合成报告**：生成 `<竞品 slug>.md` 文件 ### 事件追踪配置使用 `analytics-tracking` 技能配置追踪： #### 核心事件结构 ```javascript { event: "event_name", properties: { // 必需 plan: "starter" | "pro" | "enterprise", // 可选 product_id: "SKU123", category: "Category", price: 99.99 } } ``` #### 典型漏斗事件序列 | 漏斗类型 | 事件序列 | |----------|----------| | 注册漏斗 | signup_started → signup_step_completed → signup_completed → onboarding_started | | 购买漏斗 | pricing_viewed → plan_selected → checkout_started → purchase_completed | | 电商漏斗 | product_viewed → product_added_to_cart → cart_viewed → checkout_started → purchase_completed | ## 贡献指南 ### 建议新技能通过 [打开技能请求 issue](https://github.com/coreyhaines31/marketingskills/issues/new?template=skill-request.yml) 建议新技能。 ### 提交 PR 1. Fork 仓库 2. 创建技能目录和文件 3. 遵循命名规范和目录结构 4. 编写清晰的 SKILL.md 说明 5. 提交 Pull Request 详细贡献规范请参阅 [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)。 ## 快速操作清单 - [ ] Fork 并克隆仓库 - [ ] 阅读 `product-marketing-context/SKILL.md` 了解上下文机制 - [ ] 创建一个示例技能目录 - [ ] 编写 SKILL.md 文件，包含 YAML 前置数据 - [ ] 添加 references/ 目录和示例文档 - [ ] 提交 PR 并等待审核 ## 后续步骤完成快速开始后，建议深入了解： 1. **[产品营销上下文](skills/product-marketing-context/SKILL.md)** - 所有技能的基础 2. **[贡献指南](CONTRIBUTING.md)** - 完整的贡献规范 3. **[竞品分析技能](skills/competitor-profiling/SKILL.md)** - 学习技能如何协同工作 4. **[分析追踪](skills/analytics-tracking/references/event-library.md)** - 事件追踪最佳实践 --- ## 安装指南 ### 相关页面相关主题：[快速开始](#quick-start), [项目概述](#project-overview)

相关源码文件

以下源码文件用于生成本页说明： - [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md) - [tools/integrations/sanity.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/sanity.md) - [tools/integrations/wordpress.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/wordpress.md) - [tools/integrations/hubspot.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/hubspot.md) - [tools/integrations/postmark.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/postmark.md) - [.claude-plugin/plugin.json](https://github.com/coreyhaines31/marketingskills/blob/main/.claude-plugin/plugin.json)

# 安装指南本指南旨在帮助开发者和技术团队快速上手并正确配置 marketingskills 项目。marketingskills 是一个营销技能集合仓库，提供了涵盖内容策略、SEO优化、付费广告、社交媒体、分析追踪、A/B测试等营销全链路所需的技能、模板和参考文档。 ## 环境要求 ### 硬件与操作系统要求 | 组件 | 最低要求 | 推荐配置 | |------|---------|---------| | 处理器 | 双核 1.5 GHz | 四核 2.5 GHz 或更高 | | 内存 | 4 GB RAM | 8 GB RAM | | 磁盘空间 | 500 MB | 1 GB 以上 | | 操作系统 | macOS 10.14+ / Ubuntu 18.04+ / Windows 10 | macOS 12+ / Ubuntu 20.04+ | ### 软件依赖 - **Node.js**: 版本 18.0.0 或更高 - **npm**: 版本 8.0.0 或更高（随 Node.js 一起安装） - **Git**: 版本 2.30.0 或更高 ## 快速安装 ### 步骤一：克隆仓库打开终端并执行以下命令： ```bash git clone https://github.com/coreyhaines31/marketingskills.git cd marketingskills ``` ### 步骤二：安装依赖项目使用 npm 管理依赖，执行安装命令： ```bash npm install ``` 此命令将读取 `package.json` 并安装所有必要的依赖包。 ### 步骤三：验证安装运行以下命令验证环境配置正确： ```bash npm --version node --version ``` 确保 Node.js 版本符合要求。 ## 项目结构概览 ``` marketingskills/ ├── skills/ # 营销技能集合 │ ├── content-strategy/ # 内容策略相关技能 │ ├── seo/ # SEO优化技能 │ ├── paid-ads/ # 付费广告技能 │ ├── social-content/ # 社交媒体内容技能 │ ├── analytics-tracking/ # 分析追踪技能 │ ├── ab-test-setup/ # A/B测试设置技能 │ ├── churn-prevention/ # 客户流失预防技能 │ ├── marketing-ideas/ # 营销创意技能 │ └── sales-enablement/ # 销售赋能技能 ├── tools/ # 工具集 │ ├── clis/ # 命令行工具 │ │ ├── optimizely.js # Optimizely CLI │ │ ├── livestorm.js # Livestorm CLI │ │ ├── wistia.js # Wistia CLI │ │ └── intercom.js # Intercom CLI │ └── integrations/ # 第三方集成文档 │ ├── sanity.md # Sanity CMS 集成 │ ├── wordpress.md # WordPress 集成 │ ├── hubspot.md # HubSpot 集成 │ ├── postmark.md # Postmark 邮件服务 │ └── hyperframes.md # Hyperframes 视频工具 ├── .claude-plugin/ # Claude 插件配置 │ ├── plugin.json # 插件元数据 │ └── marketplace.json # 市场列表配置 ├── README.md # 项目主文档 ├── CONTRIBUTING.md # 贡献指南 └── LICENSE # MIT 许可证 ``` ## 技能模块详解 ### 内容策略模块内容策略模块位于 `skills/content-strategy/` 目录下，包含以下核心技能： | 技能名称 | 功能描述 | |---------|---------| | headless-cms | 无头 CMS 集成与工作流 | | editorial-workflows | 编辑工作流程管理 | | content-calendar | 内容日历规划 | **配置 headless-cms 集成：** 参考 `skills/content-strategy/references/headless-cms.md` 中的配置指南，定义内容模型包括： ```json { "contentType": "blogPost", "fields": { "title": "string (required)", "slug": "slug (required)", "body": "richText", "publishDate": "datetime", "author": "reference (author)", "category": "reference (category)" } } ``` ### 站点架构模块站点架构技能位于 `skills/site-architecture/`，提供页面层级、导航模式和 URL 结构的设计参考： - **页面层级设计**：定义页面优先级和导航位置 - **导航模式**：包括顶部导航、页脚导航、面包屑导航 - **URL 结构**：标准化 URL 命名约定详细模板参考 `skills/site-architecture/references/site-type-templates.md`。 ### SEO 模块 SEO 技能目录包含： | 模块 | 功能 | |-----|------| | gsc-api | Google Search Console API 集成 | | programmatic-seo | 大规模页面生成 | | schema-markup | 结构化数据标记 | Schema markup 参考 `skills/schema-markup/references/schema-examples.md`，支持以下类型： - Organization - WebSite - Article/BlogPosting - Product ### 付费广告模块位于 `skills/paid-ads/` 和 `skills/ad-creative/`，支持以下平台： - **Google Ads**：搜索广告、展示广告 - **Meta Ads**：Facebook/Instagram 广告 - **LinkedIn Ads**：B2B 广告投放 ## CLI 工具安装 ### Optimizely CLI 参考 `tools/clis/optimizely.js`： ```bash # 安装（如果需要全局安装） npm install -g optimizely-cli # 基本用法 node tools/clis/optimizely.js events list --project-id <项目ID> node tools/clis/optimizely.js pages list --project-id <项目ID> ``` ### Livestorm CLI 参考 `tools/clis/livestorm.js`： ```bash # 活动管理 node tools/clis/livestorm.js events list node tools/clis/livestorm.js sessions list --event-id <活动ID> # 与会人员管理 node tools/clis/livestorm.js people list --email <邮箱> ``` ### Wistia CLI 参考 `tools/clis/wistia.js`： ```bash # 媒体管理 node tools/clis/wistia.js media list node tools/clis/wistia.js media stats --id <媒体ID> # 观众分析 node tools/clis/wistia.js stats visitors node tools/clis/wistia.js stats engagement --id <媒体ID> ``` ### Intercom CLI 参考 `tools/clis/intercom.js`： ```bash # 用户管理 node tools/clis/intercom.js users list node tools/clis/intercom.js users get --id <用户ID> # 工单管理 node tools/clis/intercom.js tickets list node tools/clis/intercom.js conversations list --user-id <用户ID> ``` ## 第三方服务集成 ### Sanity CMS 详细配置参考 `tools/integrations/sanity.md`。 ```bash # 初始化 Sanity 项目 sanity init # 本地开发 sanity dev # 部署 Studio sanity deploy # 导出数据集 sanity dataset export production ./backup.tar.gz ``` **GROQ 查询示例：** ```javascript // 获取最近10篇文章 const query = '*[_type == "post"][0..9]{title, slug}'; // 获取特定文章 const singlePost = '*[_type == "post" && slug.current == $slug][0]'; ``` ### WordPress REST API 参考 `tools/integrations/wordpress.md`。 ```bash # 获取文章列表 curl -X GET "https://example.com/wp-json/wp/v2/posts?per_page=20" \ -H "Authorization: Basic {base64(username:app_password)}" # 创建文章 curl -X POST "https://example.com/wp-json/wp/v2/posts" \ -H "Authorization: Basic {base64(username:app_password)}" \ -H "Content-Type: application/json" \ -d '{"title": "标题", "content": "内容", "status": "publish"}' ``` **WP-CLI 命令：** ```bash # 列出文章 wp post list --post_type=post --post_status=publish # 创建文章 wp post create --post_title="标题" --post_content="内容" --post_status=publish # 数据库操作 wp db export backup.sql wp search-replace 'old-domain.com' 'new-domain.com' ``` ### HubSpot 参考 `tools/integrations/hubspot.md`。 ```bash # HubSpot CLI 安装 npm install -g @hubspot/cli # 初始化项目 hs init # 上传文件 hs upload src dest # 监听变化 hs watch src dest ``` **关键对象：** | 对象类型 | 说明 | |---------|------| | Contacts | CRM 中的联系人 | | Companies | 公司组织 | | Deals | 销售机会 | | Tickets | 支持工单 | | Products | 销售产品 | | Line Items | 交易行项目 | ### Postmark 邮件服务参考 `tools/integrations/postmark.md`。 ```bash # 创建模板 curl -X POST https://api.postmarkapp.com/templates \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "X-Postmark-Account-Token: {account_token}" \ -d '{ "Name": "Welcome Email", "Alias": "welcome", "Subject": "Welcome {{name}}!", "HtmlBody": "

Hello {{name}}

" }' ``` **统计分析接口：** ```bash # 投递统计 GET https://api.postmarkapp.com/deliverystats # 跳出率查询 GET https://api.postmarkapp.com/bounces?count=50&offset=0&type=HardBounce # 打开统计 GET https://api.postmarkapp.com/stats/outbound/opens ``` ### Hyperframes 视频工具参考 `tools/integrations/hyperframes.md`。 ```javascript // 创建视频场景 const hyperframes = require('hyperframes'); const video = await hyperframes.createVideo({ frames: [ { html: `

Welcome to Acme

`, duration: 3, }, { html: `

Ship faster with AI

`, duration: 3, }, ], output: "intro.mp4", width: 1080, height: 1920, fps: 30, }); ``` ## Claude 插件配置项目包含 Claude 插件配置，位于 `.claude-plugin/` 目录。 ### plugin.json 结构 ```json { "name": "marketingskills", "description": "营销技能集合：内容策略、SEO、付费广告、社交媒体、分析追踪等", "version": "1.0.0", "skills": [ "content-strategy", "seo", "paid-ads", "social-content", "analytics-tracking" ], "tools": { "clis": [ "optimizely", "livestorm", "wistia", "intercom" ], "integrations": [ "sanity", "wordpress", "hubspot", "postmark" ] } } ``` ## 环境变量配置 ### 必需的环境变量创建 `.env` 文件并配置以下变量： ```bash # Sanity SANITY_PROJECT_ID=your_project_id SANITY_DATASET=production SANITY_TOKEN=your_token # WordPress WP_API_URL=https://your-site.com/wp-json/wp/v2 WP_USERNAME=your_username WP_APP_PASSWORD=your_app_password # HubSpot HUBSPOT_ACCESS_TOKEN=your_access_token # Postmark POSTMARK_ACCOUNT_TOKEN=your_account_token POSTMARK_SERVER_TOKEN=your_server_token # Optimizely OPTIMIZELY_API_TOKEN=your_api_token # Livestorm LIVESTORM_API_KEY=your_api_key # Wistia WISTIA_API_TOKEN=your_api_token # Intercom INTERCOM_ACCESS_TOKEN=your_access_token ``` ## 常见问题排查 ### npm install 失败 ```bash # 清除缓存后重试 npm cache clean --force rm -rf node_modules npm install ``` ### CLI 工具无法执行确保 Node.js 版本正确，并检查文件执行权限： ```bash chmod +x tools/clis/*.js ``` ### 环境变量未生效确保 `.env` 文件位于项目根目录，或在执行命令前手动导出变量： ```bash export $(cat .env | xargs) ``` ## 相关资源 - **贡献指南**：[CONTRIBUTING.md](CONTRIBUTING.md) - **许可证**：[MIT License](LICENSE) - **问题反馈**：[GitHub Issues](https://github.com/coreyhaines31/marketingskills/issues) ## 贡献代码欢迎提交 Pull Request 和 Issue。贡献前请阅读 `CONTRIBUTING.md` 了解： 1. 如何添加新的技能模块 2. 如何改进现有文档 3. 代码风格规范 4. 提交信息的格式要求 --- ## 技能系统概览 ### 相关页面相关主题：[技能分类总览](#skill-categories), [转化率优化技能组](#cro-skills), [内容与文案技能组](#content-skills), [SEO与发现技能组](#seo-skills), [增长与收入技能组](#growth-skills)

相关源码文件

以下源码文件用于生成本页说明： - [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md) - [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md) - [skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md) - [skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md) - [skills/site-architecture/references/mermaid-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/mermaid-templates.md)

# 技能系统概览 ## 概述技能系统（Agent Skills）是 Marketing Skills 项目中用于定义和封装营销自动化任务的核心组件。该系统基于 [Agent Skills 规范](https://agentskills.io/specification.md)，为 AI 代理提供标准化的技能描述和执行指南。技能系统的设计目标是将复杂的营销任务（如竞争对手分析、SEO 优化、广告投放管理等）封装为可复用、可组合的模块，使 AI 代理能够根据用户需求自动调用相应的技能完成任务。 ## 核心架构 ### 技能目录结构每个技能存放在独立的目录中，采用统一的目录结构组织各类资源： ``` skills// ├── SKILL.md # 必需 - 技能主指令文件 ├── references/ # 可选 - 参考文档和指南 │ └── *.md ├── scripts/ # 可选 - 可执行脚本 │ └── *.py └── assets/ # 可选 - 模板、数据文件 └── *.json ``` ### 技能定义规范技能使用 YAML frontmatter 定义元数据，格式如下： ```yaml --- name: skill-name description: 技能用途描述，包含触发短语和关键词 --- # 技能标题技能详细指令内容... ``` ### Frontmatter 字段约束 | 字段 | 必需 | 约束条件 | |------|------|----------| | `name` | 是 | 1-64 字符，小写字母、数字、连字符，必须与目录名完全一致 | | `description` | 是 | 1-1024 字符，描述技能用途和触发场景 | | `license` | 否 | 许可证名称（默认：MIT） | | `metadata` | 否 | 键值对（作者、版本等） | 资料来源：[AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md) ## 技能分类 ### 按功能领域分类 | 类别 | 示例技能 | 用途 | |------|----------|------| | 内容营销 | `ai-seo` | AI 驱动的 SEO 内容优化 | | 网站架构 | `site-architecture` | 网站结构规划和导航设计 | | 数据分析 | `analytics-tracking` | 事件跟踪和漏斗分析 | | 广告投放 | `paid-ads` | 付费广告管理和转化追踪 | | 竞争情报 | `competitor-profiling` | 竞争对手数据收集和分析 | ### 按文件类型分类 | 类型 | 说明 | |------|------| | 核心技能 | 包含完整 SKILL.md 和 references/ 目录 | | 简单技能 | 仅包含 SKILL.md 的轻量级技能 | | 工具技能 | 配合 CLI 工具使用的技能 | ## 工作流程 ### 技能创建流程 ```mermaid graph TD A[创建技能目录] --> B[编写 SKILL.md] B --> C[添加 YAML frontmatter] C --> D{是否需要参考资料?} D -->|是| E[创建 references/ 目录] D -->|否| F{需要脚本支持?} E --> F F -->|是| G[创建 scripts/ 目录] F -->|否| H{需要资源文件?} G --> H H -->|是| I[创建 assets/ 目录] H -->|否| J[验证 frontmatter 有效性] I --> J J --> K[提交 PR] ``` ### 技能执行流程 ```mermaid graph TD A[用户请求] --> B[解析触发短语] B --> C{匹配技能} C -->|找到| D[加载 SKILL.md] C -->|未找到| E[返回错误] D --> F{存在 references?} F -->|是| G[加载参考文档] F -->|否| H{存在 scripts?} G --> H H -->|是| I[准备脚本环境] H -->|否| J[执行技能指令] I --> J J --> K[返回结果] ``` ## 命名规范 ### 目录命名 - 使用小写字母 - 仅使用连字符 `-` 分隔单词 - 示例：`email-sequence`、`competitor-profiling` ### 字段命名 - `name` 字段必须与目录名完全一致 - 描述中应包含触发短语，帮助代理识别相关任务 ## 验证与测试 ### 手动验证清单技能开发完成后需手动验证以下内容： | 检查项 | 命令/方法 | |--------|----------| | YAML 语法 | 检查 frontmatter 格式正确 | | 字段一致性 | `name` 字段与目录名匹配 | | 字段长度 | `name` 1-64 字符，`description` 1-1024 字符 | | 命名规范 | 仅允许小写字母、数字、连字符 | ### CLI 工具验证对于需要 CLI 工具配合的技能： ```bash # 语法检查 node --check tools/clis/.js # 显示用法 node tools/clis/.js # 预览请求（不发送） node tools/clis/.js --dry-run ``` 资料来源：[AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md) ## 技能示例结构 ### 竞争对手分析技能 `competitor-profiling` 技能展示了完整的技能结构： ``` competitor-profiles/ ├── raw/ │ └── / │ └── / │ ├── scrapes/ # 页面抓取结果 │ ├── seo/ # SEO 数据 │ └── reviews/ # 评论数据 ├── .md # 合成的竞品档案 └── _summary.md # 跨竞品汇总 ``` 研究流程分为三个阶段： 1. **站点抓取（Firecrawl）** - 提取定位、特性、定价和消息 2. **SEO 数据收集（DataForSEO）** - 收集排名关键词、反向链接等 3. **评论数据采集** - 从 G2、Capterra 等平台收集用户评价资料来源：[skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md) ### 分析跟踪技能 `analytics-tracking` 技能定义了标准的事件模型： **用户上下文：** ```json { "user_id": "user_123", "plan": "pro" } ``` **会话上下文：** ```json { "session_id": "sess_abc", "session_number": 5, "page": "/pricing" } ``` **漏斗事件序列示例：** | 漏斗类型 | 事件序列 | |----------|----------| | 注册漏斗 | signup_started → step_completed → completed → onboarding_started | | 购买漏斗 | pricing_viewed → plan_selected → checkout_started → purchase_completed | | 电商漏斗 | product_viewed → added_to_cart → cart_viewed → checkout_started → purchase_completed | 资料来源：[skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md) ## 工具集成 ### 集成 API 文档项目在 `tools/integrations/` 目录下维护了多种营销工具的 API 集成文档： | 工具 | 功能 | 关键端点 | |------|------|----------| | Postmark | 邮件发送与追踪 | 模板管理、退订统计 | | Livestorm | 网络研讨会管理 | 活动、会话、人员管理 | | ZoomInfo | B2B 数据 enrichment | 联系人、公司、意向数据 | | Intercom | 客户沟通 | 文章、事件追踪 | | WordPress | CMS 内容管理 | 文章、页面、媒体管理 | | Sanity | 结构化内容管理 | 文档查询、GROQ | ### CLI 工具 `tools/clis/` 目录包含 Node.js 编写的命令行工具，采用零依赖设计： | 工具 | 支持命令 | |------|----------| | livestorm.js | events、sessions、people、webhooks、organization | | optimizely.js | campaigns、pages | ## 扩展技能系统 ### 添加新技能 1. 创建技能目录：`mkdir -p skills/your-skill-name` 2. 编写 SKILL.md 文件，包含有效的 YAML frontmatter 3. 按需添加 references/、scripts/、assets/ 目录 4. 验证文件结构和命名规范 ### 技能请求如需新技能，可通过 [GitHub Issues](https://github.com/coreyhaines31/marketingskills/issues/new?template=skill-request.yml) 提交技能请求。资料来源：[CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md) ## 最佳实践 ### 技能设计原则 1. **单一职责** - 每个技能专注于特定领域 2. **清晰描述** - description 应包含触发短语和关键词 3. **模块化结构** - 使用 references/ 目录组织相关文档 4. **可验证性** - 提供清晰的执行路径和预期结果 ### 文档编写规范 - 使用中文标题和说明（保留英文技术术语） - 包含代码示例和命令片段 - 使用表格整理结构化数据 - 使用 Mermaid 图展示流程和架构 --- ## 技能分类总览 ### 相关页面相关主题：[技能系统概览](#skills-overview), [转化率优化技能组](#cro-skills), [内容与文案技能组](#content-skills), [SEO与发现技能组](#seo-skills), [增长与收入技能组](#growth-skills)

相关源码文件

以下源码文件用于生成本页说明： - [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md) - [skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md) - [skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md) - [skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md) - [skills/ai-seo/references/content-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/references/content-patterns.md) - [tools/integrations/postmark.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/postmark.md) - [tools/integrations/sanity.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/sanity.md) - [tools/clis/livestorm.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/livestorm.js)

# 技能分类总览 ## 项目概述 Marketing Skills 是一个开源的营销技能库，旨在为营销专业人员提供可复用的技能模板、参考文档和工具集成。该项目采用模块化架构，将营销技能分为多个类别，每个类别包含主技能说明文件（SKILL.md）和可选的参考文档、脚本和资源文件。资料来源：[CONTRIBUTING.md:1-10]() ## 技能架构项目采用标准化目录结构管理各类营销技能，所有技能遵循统一的命名规范和元数据格式。资料来源：[CONTRIBUTING.md:18-35]() ```mermaid graph TD ROOT["marketingskills/"] ROOT --> SKILLS["skills/"] ROOT --> TOOLS["tools/"] SKILLS --> CAT1["竞争对手分析
(competitor-profiling)"] SKILLS --> CAT2["付费广告
(paid-ads)"] SKILLS --> CAT3["站点架构
(site-architecture)"] SKILLS --> CAT4["AI SEO
(ai-seo)"] SKILLS --> CAT5["分析追踪
(analytics-tracking)"] CAT1 --> SM1["SKILL.md"] CAT1 --> REF1["references/"] CAT1 --> SCR1["scripts/"] TOOLS --> INT["integrations/"] INT --> POSTMARK["postmark.md"] INT --> SANITY["sanity.md"] INT --> LIVESTORM["livestorm.md"] INT --> WP["wordpress.md"] INT --> ZOOMINFO["zoominfo.md"] INT --> OUTREACH["outreach.md"] INT --> INTERCOM["intercom.md"] INT --> TOLT["tolt.md"] INT --> SAVVYCAL["savvycal.md"] TOOLS --> CLI["clis/"] CLI --> LIVESTORM_JS["livestorm.js"] CLI --> OPTIMIZELY_JS["optimizely.js"] ``` ## 技能类别详解 ### 竞争对手分析（competitor-profiling）竞争对手分析技能提供系统化的竞品研究方法论，支持营销团队深入了解市场格局。资料来源：[skills/competitor-profiling/SKILL.md:1-20]() 该技能的数据采集结构如下： | 数据类型 | 存储位置 | 格式 | |---------|---------|------| | 页面抓取 | `raw/<竞品slug>/<日期>/scrapes/` | Markdown | | SEO数据 | `raw/<竞品slug>/<日期>/seo/` | JSON | | 评价数据 | `raw/<竞品-slug>/<日期>/reviews/` | Markdown/JSON | 技能执行流程采用 Firecrawl 进行页面抓取，DataForSEO 进行 SEO 数据采集，并支持 G2、Capterra 等评价平台的数据整合。资料来源：[skills/competitor-profiling/SKILL.md:25-40]() ### 付费广告（paid-ads）付费广告技能聚焦于转化追踪最佳实践，提供多平台的广告追踪集成方案。资料来源：[skills/paid-ads/references/conversion-tracking.md:1-15]() 该技能包含主流广告平台的追踪脚本模板，包括 TikTok 广告分析等集成方案，帮助团队建立完整的广告效果归因体系。 ### 站点架构（site-architecture）站点架构技能指导营销人员设计合理的网站结构，涵盖导航模式、信息架构和内部链接策略。资料来源：[skills/site-architecture/references/navigation-patterns.md:1-30]() 核心导航组件包括： | 组件类型 | 用途 | Schema标记 | |---------|------|------------| | 标准导航 | 主菜单导航 | nav 元素 | | 面包屑 | 路径导航 | BreadcrumbList | | 页脚导航 | 辅助链接 | footer 元素 | | 侧边导航 | 内容分类 | nav 元素 | 技能提供了 Hub-and-Spoke 内容模型，帮助建立中心主题页面与相关子主题页面的层级关系，优化内部链接结构和 SEO 效果。资料来源：[skills/site-architecture/references/mermaid-templates.md:1-30]() ### AI SEO（ai-seo） AI SEO 技能针对生成式搜索引擎优化场景，提供内容创作指南和 E-E-A-T（经验、专业性、权威性、可信度）优化策略。资料来源：[skills/ai-seo/references/content-patterns.md:1-25]() 核心内容模式包括： - **自包含答案块**：可被 AI 直接提取的独立声明 - **证据三明治结构**：主张、数据证据、结论的标准化呈现 - **领域特定权威信号**：技术内容强调精确性，医疗内容引用同行评审研究 ### 分析追踪（analytics-tracking）分析追踪技能提供标准化的用户行为事件库，支持跨平台的分析数据收集。资料来源：[skills/analytics-tracking/references/event-library.md:1-50]() 标准事件序列定义： | 漏斗类型 | 事件序列 | |---------|---------| | 注册漏斗 | signup_started → signup_step_completed → signup_completed → onboarding_started | | 购买漏斗 | pricing_viewed → plan_selected → checkout_started → purchase_completed | | 电商漏斗 | product_viewed → product_added_to_cart → cart_viewed → checkout_started → purchase_completed | 事件上下文包含会话信息、用户属性、时间戳等标准字段，确保数据一致性和可比性。 ## 工具集成 ### 邮件服务集成 **Postmark** 提供.Transactional 邮件 API 集成，支持模板管理、投递统计、退信管理和开点击追踪。资料来源：[tools/integrations/postmark.md:1-25]() | 功能 | 端点 | |------|------| | 创建模板 | POST /templates | | 获取投递统计 | GET /deliverystats | | 列表退信 | GET /bounces | | 搜索出站消息 | GET /messages/outbound | ### 内容管理系统集成 **Sanity** 作为结构化内容管理平台，支持博客、营销网站等多渠道内容交付。该集成提供文档查询（GROQ）、数据导入导出和实时协作编辑能力。资料来源：[tools/integrations/sanity.md:1-35]() 关键对象类型： | 对象类型 | 说明 | |---------|------| | Document | 顶级内容项，包含 `_id`、`_type`、`_rev` | | Asset | CDN 存储的图片和文件 | | Reference | 文档间引用链接 | | Portable Text | 结构化富文本块 | | Dataset | 隔离的内容数据库 | ### 网络研讨会集成 **Livestorm** 支持产品演示和网络研讨会的自动化管理，提供活动创建、注册管理、会话追踪和录制获取等功能。资料来源：[tools/integrations/livestorm.md:1-30]() CLI 工具 livestorm.js 提供命令行接口，支持活动的完整生命周期管理。资料来源：[tools/clis/livestorm.js:1-25]() ```bash # CLI 命令示例 node livestorm.js events list node livestorm.js sessions create --event-id node livestorm.js people register --id --email ``` ### 其他平台集成 | 平台 | 用途 | 关键功能 | |------|------|---------| | WordPress | CMS 管理 | 文章/页面 CRUD、媒体上传、用户管理 | | ZoomInfo | B2B 数据 | 联系人搜索、公司数据、意向信号 | | Outreach | 销售外联 | 潜在客户管理、序列自动化 | | Intercom | 客户沟通 | 文章管理、会话追踪、事件提交 | | Tolt | 联盟营销 | 佣金追踪、联盟管理、支付自动化 | | SavvyCal | 日程安排 | 预约链接管理、活动检索、网页钩子 | ## CLI 工具项目提供零依赖的 Node.js CLI 工具（Node 18+），位于 `tools/clis/` 目录。资料来源：[CLAUDE.md:12-18]() | 工具 | 功能 | |------|------| | livestorm.js | Livestorm 活动、会话、人员管理 | | optimizely.js | Optimizely 项目和页面管理 | 验证方式： ```bash # 语法检查 node --check tools/clis/.js # 显示帮助 node tools/clis/.js # 预览请求（不发送） node tools/clis/.js --dry-run ``` ## 技能贡献指南 ### 目录命名规范 | 规范项 | 要求 | |-------|------| | 目录名 | 小写，仅使用连字符分隔（如 `email-sequence`） | | name 字段 | 必须与目录名完全一致 | | 字符限制 | 1-64 个字符 | ### 元数据格式 ```yaml --- name: skill-name description: 技能描述，1-1024字符，包含触发短语 license: MIT # 可选，默认 MIT metadata: # 可选 author: 作者名 version: 1.0.0 --- ``` ### 标准目录结构 ``` skills/your-skill-name/ ├── SKILL.md # 必需 - 主指令文件 ├── references/ # 可选 - 附加文档 │ └── guide.md ├── scripts/ # 可选 - 可执行代码 │ └── helper.py └── assets/ # 可选 - 模板、图片、数据 └── template.json ``` ## 技能选择流程 ```mermaid graph TD START["营销需求识别"] --> Q1{"需要竞品研究?"} Q1 -->|是| COMPETITOR["竞争对手分析"] Q1 -->|否| Q2 Q2{"需要广告追踪?"} Q2 -->|是| PAID["付费广告"] Q2 -->|否| Q3 Q3{"需要网站结构设计?"} Q3 -->|是| SITE["站点架构"] Q3 -->|否| Q4 Q4{"需要 AI 搜索优化?"} Q4 -->|是| AISE["AI SEO"] Q4 -->|否| Q5 Q5{"需要用户行为分析?"} Q5 -->|是| ANALYTICS["分析追踪"] Q5 -->|否| END["查看工具集成"] COMPETITOR --> TOOL1["数据采集 + Sanity"] PAID --> TOOL2["TikTok + Postmark"] SITE --> TOOL3["WordPress"] AISE --> TOOL4["内容模式库"] ANALYTICS --> TOOL5["事件库 + 集成"] ``` ## 总结 Marketing Skills 项目通过标准化的技能分类体系，为营销团队提供从竞品研究、内容创作到效果追踪的完整工具链。每个技能类别均包含结构化的参考文档和可选的脚本工具，支持灵活组合以满足不同营销场景需求。 --- ## 转化率优化技能组 ### 相关页面相关主题：[技能系统概览](#skills-overview), [内容与文案技能组](#content-skills)

相关源码文件

以下源码文件用于生成本页说明： - [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md) - [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md) - [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md) - [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md) - [skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md) - [skills/analytics-tracking/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics-tracking/references/event-library.md)

# 转化率优化技能组 ## 概述转化率优化（CRO, Conversion Rate Optimization）技能组是 marketingskills 项目中的核心技能分类之一，专门用于指导 AI 代理执行各类转化率优化任务。该技能组通过结构化的指令模板，帮助自动化系统分析和改进用户旅程中的关键转化节点。根据项目文档，转化率优化技能组包含六大核心技能，覆盖从落地页到付费升级的完整用户生命周期。资料来源：[README.md:1-30]() ## 技能分类体系转化率优化技能组按照用户旅程的不同阶段划分为以下六个专门技能： | 技能标识 | 适用场景 | 主要职责 | |---------|---------|---------| | `page-cro` | 营销落地页 | 分析和优化营销页面的转化效率 | | `signup-flow-cro` | 注册流程 | 改进用户注册/报名流程的转化率 | | `onboarding-cro` | 激活引导 | 优化用户注册后的激活和上手体验 | | `form-cro` | 线索捕获表单 | 提升表单填写率和线索收集效果 | | `popup-cro` | 弹窗和遮罩层 | 优化模态窗口和弹窗的转化表现 | | `paywall-upgrade-cro` | 付费墙升级 | 改进应用内付费升级时刻的转化 | 资料来源：[README.md:18-26]() ## 技能结构规范每个转化率优化技能遵循统一的项目结构规范： ``` skills/{skill-name}/ ├── SKILL.md # 必需 - 主指令文件 ├── references/ # 可选 - 补充文档 ├── scripts/ # 可选 - 可执行代码 └── assets/ # 可选 - 模板和数据文件 ``` ### SKILL.md 文件规范主指令文件必须包含 YAML 前置元数据： ```yaml --- name: skill-name description: 何时使用此技能的描述，包含触发短语和关键词 --- ``` **必填字段规则：** | 字段 | 必填 | 规则 | |-----|-----|------| | `name` | 是 | 小写字母、数字、连字符，与目录名完全一致 | | `description` | 是 | 1-1024 字符，包含触发短语 | | `license` | 否 | 许可证名称（默认：MIT）| | `metadata` | 否 | 键值对（作者、版本等）| **Name 字段命名规则：** - 只能使用小写字母、数字和连字符 - 不能以连字符开头或结尾 - 不能有连续连字符（`--`） - 必须与父目录名称完全匹配有效示例：`page-cro`、`email-sequence`、`ab-test-setup` 无效示例：`Page-CRO`、`-page`、`page--cro` 资料来源：[CONTRIBUTING.md:1-50]() ### 技能目录结构 ``` skills/skill-name/ ├── SKILL.md # 必需 - 主指令（<500 行） ├── references/ # 可选 - 按需加载的详细文档 ├── scripts/ # 可选 - 可执行代码 └── assets/ # 可选 - 模板、数据文件 ``` 资料来源：[CLAUDE.md:1-30]() ## 通用工作流程 ### 转化率分析流程 ```mermaid graph TD A[开始分析] --> B[识别转化节点] B --> C[收集当前数据] C --> D[分析用户行为] D --> E[识别瓶颈] E --> F[生成优化建议] F --> G[实施更改] G --> H[监控效果] H --> I{达成目标?} I -->|否| D I -->|是| J[持续优化] ``` ### 转化漏斗序列根据事件追踪库规范，典型的转化漏斗包含以下事件序列： **注册漏斗：** 1. `signup_started` - 注册开始 2. `signup_step_completed` (email) - 邮箱步骤完成 3. `signup_step_completed` (password) - 密码步骤完成 4. `signup_completed` - 注册完成 5. `onboarding_started` - 激活开始 **购买漏斗：** 1. `pricing_viewed` - 价格页浏览 2. `plan_selected` - 方案选择 3. `checkout_started` - 结账开始 4. `payment_info_entered` - 支付信息填写 5. `purchase_completed` - 购买完成资料来源：[skills/analytics-tracking/references/event-library.md:1-50]() ## 事件追踪规范转化率优化需要依赖精确的事件追踪系统。事件追踪应包含以下关键上下文信息： ### 用户上下文 ``` user_id: "usr_123" anonymous_id: "anon_456" email: "user@example.com" plan: "starter" | "pro" | "enterprise" ``` ### 会话上下文 ``` session_id: "sess_abc" session_number: 5 page: "/pricing" referrer: "https://google.com" ``` ### 活动上下文 ``` source: "google" medium: "cpc" campaign: "spring_sale" content: "hero_cta" ``` ### 产品上下文（电商场景） ``` product_id: "SKU123" product_name: "Product Name" category: "Category" price: 99.99 quantity: 1 currency: "USD" ``` ### 时间上下文 ``` timestamp: "2024-01-15T10:30:00Z" time_on_page: 45 session_duration: 300 ``` 资料来源：[skills/analytics-tracking/references/event-library.md:50-80]() ## 导航与面包屑优化转化率优化与网站架构密切相关。良好的导航设计直接影响用户转化路径的流畅性。 ### 标准面包屑格式 ``` Home > Features > Analytics Home > Blog > SEO Category > How to Do Keyword Research Home > Docs > API Reference > Authentication ``` **规则：** - 分隔符：使用 `>` 或 `/`，保持一致 - 除当前页面外，每个段落都是链接 - 当前页面为纯文本（不链接） - 如果 H1 中已显示标题，则不包含当前页面 ### 带 Schema 标记的面包屑 ```html ``` 资料来源：[skills/site-architecture/references/navigation-patterns.md:1-50]() ## 技能质量检查清单在提交或更新转化率优化技能时，必须满足以下质量标准： - [ ] `name` 字段与目录名完全匹配 - [ ] `name` 遵循命名规则（小写、连字符、无 `--`） - [ ] `description` 包含 1-1024 字符的触发短语 - [ ] `SKILL.md` 行数控制在 500 行以内 - [ ] 不包含敏感数据或凭证信息 - [ ] 遵循项目中现有技能的规范模式资料来源：[CONTRIBUTING.md:50-70]() ## 提交工作流程 ### 分支命名规范 | 变更类型 | 分支前缀 | 示例 | |---------|---------|------| | 新技能 | `feature/` | `feature/page-cro` | | 改进 | `fix/` | `fix/page-cro-clarity` | | 文档 | `docs/` | `docs/cro-guide` | ### 提交信息规范遵循 [Conventional Commits](https://www.conventionalcommits.org/) 规范： - `feat: add page-cro skill` - 新增技能 - `fix: improve clarity in signup-flow-cro` - 修复改进 - `docs: update CRO guide` - 文档更新 ### Pull Request 模板项目提供三种 PR 模板： - 新技能（New Skill） - 技能更新（Skill Update） - 文档（Documentation）资料来源：[AGENTS.md:1-50]() ## 技能使用示例在 Claude Code 等 AI 代理环境中，可以通过以下方式调用转化率优化技能： ### 直接调用技能 ``` /page-cro /email-sequence /seo-audit ``` ### 通过描述触发用户可以描述任务，AI 代理会根据描述自动选择合适的技能： ``` "优化我们的落地页以提高注册转化率" → 使用 page-cro 技能 "设置 Google Analytics 4 追踪注册事件" → 使用 analytics-tracking 技能 ``` 资料来源：[README.md:1-15]() ## 与其他技能组的协作转化率优化技能组并非独立运作，而是与项目中的其他技能组紧密协作： ```mermaid graph LR CRO[转化率优化技能组] --> COPY[内容与文案技能组] CRO --> SEO[SEO与发现技能组] CRO --> PAID[付费与分发技能组] CRO --> ANALYTICS[分析与追踪技能组] COPY -->|文案优化| CRO SEO -->|流量提升| CRO PAID -->|广告优化| CRO ANALYTICS -->|数据支撑| CRO ``` ### 协作技能列表 **内容与文案：** - `copywriting` - 营销页面文案 - `copy-editing` - 文案编辑润色 - `email-sequence` - 自动化邮件序列 **SEO 与发现：** - `seo-audit` - 技术性和页面 SEO - `ai-seo` - AI 搜索优化 - `programmatic-seo` - 大规模页面生成 **付费与分发：** - `paid-ads` - Google、Meta、LinkedIn 广告 - `ad-creative` - 批量广告创意 **分析与追踪：** - `analytics-tracking` - 事件追踪配置资料来源：[README.md:26-40]() ## 扩展阅读如需深入了解相关主题，建议参考以下资源： - **站点架构**：`skills/site-architecture/references/` 目录下的导航模式和站点类型模板 - **事件追踪**：`skills/analytics-tracking/references/event-library.md` 完整的事件库定义 - **Schema 标记**：`skills/schema-markup/references/schema-examples.md` 结构化数据示例 - **贡献指南**：`CONTRIBUTING.md` 完整的技能开发流程 --- ## 内容与文案技能组 ### 相关页面相关主题：[技能系统概览](#skills-overview), [转化率优化技能组](#cro-skills)

相关源码文件

以下源码文件用于生成本页说明： - [skills/copywriting/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/copywriting/SKILL.md) - [skills/cold-email/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/SKILL.md) - [skills/email-sequence/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/email-sequence/SKILL.md) - [skills/social-content/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/social-content/SKILL.md) - [skills/image/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/image/SKILL.md) - [skills/video/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/video/SKILL.md)

# 内容与文案技能组 ## 概述内容与文案技能组是 Marketing Skills 项目中专注于营销内容创作的核心模块，涵盖从文案撰写到视觉内容生成的完整内容营销工作流程。该技能组为营销团队提供了一套标准化的内容创作指南和最佳实践，帮助生成高质量的营销文案、邮件内容、社交媒体帖子以及图像和视频素材。根据项目架构，内容与文案技能组主要包含以下核心技能： | 技能名称 | 功能描述 | 典型应用场景 | |---------|---------|-------------| | copywriting | 营销页面文案撰写 | 首页、落地页、产品页 | | copy-editing | 文案编辑与润色 | 现有内容的优化提升 | | cold-email | B2B 冷启动外联邮件 | 销售线索开发 | | email-sequence | 自动化邮件序列 | 欢迎序列、客户培育 | | social-content | 社交媒体内容 | LinkedIn、Twitter、Instagram | | image | AI 图像生成与设计 | 营销素材、社交图片 | | video | 视频内容创作 | 产品演示、教程视频 | 资料来源：[README.md](README.md) ## 技能组架构内容与文案技能组采用模块化设计，各技能既可独立使用，也可组合形成完整的内容营销流程。技能之间存在明确的数据流向和依赖关系： ```mermaid graph TD A[内容策略规划] --> B[copywriting 文案撰写] B --> C[copy-editing 文案润色] C --> D[多渠道分发] D --> E[cold-email 冷启动邮件] D --> F[email-sequence 自动化序列] D --> G[social-content 社交内容] G --> H[image 图像创作] G --> I[video 视频制作] H --> J[视觉素材输出] I --> J E --> K[邮件营销输出] F --> K style A fill:#f9f,stroke:#333 style J fill:#9f9,stroke:#333 style K fill:#9f9,stroke:#333 ``` ## 核心技能详解 ### 文案撰写（Copywriting）文案撰写技能是整个内容与文案技能组的基础，负责生成各类营销页面的核心文案内容。该技能专注于创建能够有效传达产品价值主张并推动用户行动的营销文案。 **触发关键词与场景：** - 落地页文案（homepage copy for my SaaS） - 产品特性描述 - 价值主张提炼 - 行动号召按钮文案 - 客户成功案例文案资料来源：[skills/copywriting/SKILL.md](skills/copywriting/SKILL.md) ### 文案编辑（Copy-editing）文案编辑技能专注于对现有文案进行优化和润色，确保文案达到专业水准。该技能不从头创作内容，而是在既有文案基础上进行改进，提升可读性、说服力和品牌一致性。 **适用场景：** - 现有营销页面的A/B测试变体创建 - 品牌语言规范化调整 - 语法和格式修正 - 语气和调性统一 ### 冷启动邮件（cold-email）冷启动邮件技能专为 B2B 销售场景设计，帮助营销人员快速生成有效的冷启动外联邮件。该技能涵盖单封邮件撰写和多步骤邮件序列编排。 **核心功能：** ```mermaid graph TD A[目标受众分析] --> B[邮件个性化策略] B --> C[开场白设计] C --> D[价值主张传递] D --> E[行动号召设置] E --> F[邮件序列编排] C --> G[单封冷启动邮件] D --> G E --> G F --> H[序列1: 首次接触] F --> I[序列2: 跟进邮件] F --> J[序列3: 最终唤起] ``` **API 集成支持：** 该技能支持与多种邮件发送平台集成，包括 Postmark、ConvertKit、Mailchimp 等主流服务。资料来源：[skills/cold-email/SKILL.md](skills/cold-email/SKILL.md) ### 自动化邮件序列（email-sequence）自动化邮件序列技能帮助营销团队设计和创建多步骤的自动化邮件流程，用于客户培育、欢迎序列、购物车挽回等多种场景。 **邮件序列类型：** | 序列类型 | 典型邮件数量 | 发送周期 | 主要目的 | |---------|------------|---------|---------| | 欢迎序列 | 3-5 封 | 3-7 天 | 新用户激活 | | 培育序列 | 5-10 封 | 2-4 周 | 潜在客户培养 | | 挽回序列 | 2-3 封 | 1-3 天 | 购物车挽回 | | 再激活序列 | 3-5 封 | 1-2 周 | 沉睡用户唤醒 | **邮件内容结构：** 每封邮件应包含清晰的标题、个性化问候、价值内容、行动号召按钮和退订链接。邮件长度应控制在合理范围内，确保移动端阅读体验。资料来源：[skills/email-sequence/SKILL.md](skills/email-sequence/SKILL.md) ### 社交内容（social-content）社交内容技能专注于生成适合不同社交媒体平台的短格式内容，包括 LinkedIn、Twitter、Instagram 等主流平台的帖子和更新。 **平台适配策略：** | 平台 | 内容风格 | 推荐长度 | 视觉要求 | |-----|---------|---------|---------| | LinkedIn | 专业洞察、行业发展 | 150-300 字符 | 高质量配图 | | Twitter/X | 简洁有力、话题标签 | 280 字符以内 | 可选配图/GIF | | Instagram | 视觉驱动、故事化 | 短文案 + 话题 | 必须配图 | | Facebook | 社区互动、轻松对话 | 100-250 字符 | 吸引眼球配图 | **内容创作原则：** - 保持品牌声音一致性 - 使用强开场白吸引注意力 - 包含明确的互动号召 - 合理使用话题标签和 emoji 资料来源：[skills/social-content/SKILL.md](skills/social-content/SKILL.md) ### 图像创作（image）图像创作技能提供 AI 驱动的图像生成和设计能力，帮助营销团队快速创建各类视觉素材。该技能支持从提示词生成图像、图像编辑优化以及多尺寸适配输出。 **核心功能模块：** ```mermaid graph TD A[图像创作需求] --> B[创作类型选择] B --> C[AI 生成图像] B --> D[图像编辑优化] B --> E[尺寸适配输出] C --> F[营销素材图] C --> G[社交媒体配图] C --> H[产品展示图] D --> I[背景移除] D --> J[风格转换] D --> K[图像增强] E --> L[社交媒体尺寸] E --> M[广告素材尺寸] E --> N[网站图片优化] ``` 资料来源：[skills/image/SKILL.md](skills/image/SKILL.md) ### 视频内容（video）视频内容技能专注于产品演示、教程和营销视频的脚本创作与内容规划。该技能帮助团队高效规划视频结构、撰写吸引人的脚本，并确保视频内容与整体营销策略保持一致。 **视频类型支持：** - 产品功能演示 - 操作教程和指南 - 客户成功案例 - 品牌故事和理念传达 - 社交媒体短视频资料来源：[skills/video/SKILL.md](skills/video/SKILL.md) ## 工作流程集成内容与文案技能组支持与项目的分析和跟踪工具集成，实现内容效果的数据闭环： ```mermaid graph LR A[内容创作] --> B[GA4 分析跟踪] A --> C[邮件发送统计] A --> D[转化归因] B --> E[效果优化建议] C --> E D --> E E --> A ``` **典型使用场景：** 1. **落地页优化流程**：使用 copywriting 创建页面文案 → 通过 GA4 设置转化跟踪 → 分析用户行为数据 → 使用 copy-editing 优化文案 2. **邮件营销流程**：使用 cold-email 创建外联邮件 → 使用 email-sequence 设计培育序列 → 通过邮件平台发送 → 跟踪打开率和点击率 3. **社交媒体运营**：使用 social-content 创建帖子 → 使用 image 生成配图 → 发布到各平台 → 分析互动数据优化内容策略资料来源：[README.md](README.md) ## 工具集成内容与文案技能组与项目中的多种工具实现集成，提供了完整的营销技术栈支持： | 工具类别 | 集成工具 | 功能支持 | |---------|---------|---------| | 邮件发送 | Postmark, Mailchimp, ConvertKit | 邮件发送、模板管理、退订处理 | | 分析跟踪 | GA4 | 页面访问、事件跟踪、转化归因 | | 设计协作 | Figma | 设计稿同步、评论反馈 | | 社交管理 | Buffer, Hootsuite | 定时发布、内容日历 | | CRM 集成 | HubSpot, Salesforce | 线索管理、邮件序列触发 | 资料来源：[tools/REGISTRY.md](tools/REGISTRY.md) ## 最佳实践 ### 内容质量标准 - 所有文案应经过至少一轮审查和修改 - 保持品牌声音和语调的一致性 - 确保内容的准确性和可验证性 - 针对不同渠道进行内容适配 ### 版本控制与迭代 ```mermaid graph TD A[初稿创作] --> B[内部审查] B --> C{通过审核?} C -->|否| D[修改润色] D --> B C -->|是| E[A/B 测试变体] E --> F[数据分析] F --> G{效果达标?} G -->|否| D G -->|是| H[正式发布] ``` ### 性能指标监控内容效果应通过以下关键指标进行监控： - **落地页**：转化率、跳出率、停留时间 - **邮件**：打开率、点击率、退订率 - **社交**：互动率、分享数、关注增长 ## 总结内容与文案技能组为营销团队提供了从策略规划到执行落地的完整内容创作解决方案。通过模块化的技能设计和灵活的组合方式，团队可以根据具体需求选择合适的技能组合，快速生成高质量的营销内容。技能的标准化和最佳实践的固化，确保了内容产出的一致性和可扩展性。 --- ## SEO与发现技能组 ### 相关页面相关主题：[技能系统概览](#skills-overview), [CLI工具集](#cli-tools)

相关源码文件

以下源码文件用于生成本页说明： - [skills/seo-audit/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/seo-audit/SKILL.md) - [skills/ai-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/SKILL.md) - [skills/programmatic-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/programmatic-seo/SKILL.md) - [skills/site-architecture/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/SKILL.md) - [skills/competitor-alternatives/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-alternatives/SKILL.md) - [skills/schema-markup/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema-markup/SKILL.md) - [skills/aso-audit/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/aso-audit/SKILL.md)

# SEO与发现技能组 ## 概述 SEO与发现技能组是Marketing Skills仓库中专注于提升内容可发现性和搜索引擎排名的技能集合。该技能组包含七个核心技能模块，涵盖了从技术SEO审计到AI驱动的内容优化、从程序化页面生成到结构化数据标记的完整SEO工作流程。这些技能协同工作，帮助营销团队系统性地优化网站的搜索可见性，同时支持程序化SEO策略以实现规模化内容生产。技能组的设计遵循模块化原则，每个技能可以独立使用，也可以组合形成完整的SEO优化方案。资料来源：[README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md) ## 技能组架构 ```mermaid graph TD subgraph "SEO与发现技能组" A[seo-audit
SEO审计] B[ai-seo
AI驱动SEO] C[programmatic-seo
程序化SEO] D[site-architecture
网站架构] E[competitor-alternatives
竞品替代] F[schema-markup
结构化数据] G[aso-audit
ASO审计] end A --> D A --> F B --> F C --> D E --> A G --> A ``` ## 核心技能详解 ### 1. SEO审计 (seo-audit) SEO审计技能负责对网站进行全面的技术健康检查，识别影响搜索排名的技术问题。 #### 主要功能 | 功能类别 | 描述 | |---------|------| | 索引状态分析 | 检查页面是否被搜索引擎正确索引 | | 元数据审查 | 验证标题标签、描述标签的优化情况 | | 链接健康检查 | 识别断链、重定向问题和内部链接结构 | | 页面速度评估 | 测量Core Web Vitals指标 | | 移动友好性测试 | 确保移动端用户体验符合标准 | #### 集成工具该技能依赖以下集成工具进行数据收集和分析： - **Google Search Console** - 搜索表现数据、索引状态监控 - **Ahrefs** - 域名评级、反向链接分析、关键词排名 - **Screaming Frog** - 网站爬取和技术问题识别资料来源：[tools/integrations/google-search-console.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/google-search-console.md) ### 2. AI驱动SEO (ai-seo) AI驱动SEO技能专注于优化内容以获得AI助手的引用和推荐，这代表了搜索优化的新方向。 #### 生成引擎优化模式 ```mermaid graph LR A[高质量内容创作] --> B[统计引用块] A --> C[E-E-A-T信号] A --> D[自包含答案块] B --> E[AI引用机会增加] C --> E D --> E ``` #### 内容优化策略该技能采用多种GEO（生成引擎优化）模式来提升内容被AI引用的概率： **E-E-A-T信号块** 强调经验、专业性、权威性和可信度，特别适用于YMYL（Your Money Your Life）主题的内容。Google搜索质量评估指南确认，信任是最关键因素，可信度低的页面即使看起来专业权威也会被评为低E-E-A-T。 **自包含答案块** 创建可直接引用、独立成立的完整答案块，包含具体细节、数字或示例，便于AI助手直接提取使用。 **证据三明治结构** 将声明与支撑证据配对，包括数据点列表和将证据与可操作洞察联系起来的结论性陈述。资料来源：[skills/ai-seo/references/content-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/references/content-patterns.md) ### 3. 程序化SEO (programmatic-seo) 程序化SEO技能用于大规模页面生成，通过模板和数据驱动的方式批量创建针对特定关键词的优化页面。 #### 适用场景 | 场景 | 描述 | |------|------| | 地理位置页面 | 为每个城市/地区生成独立页面 | | FAQ页面群 | 按主题批量生成问答内容 | | 产品比较页面 | 基于产品属性自动生成对比表 | | 行业术语词典 | 批量创建词条定义页面 | #### 内容模型程序化SEO依赖结构化的内容类型定义，包括页面元数据和可编程字段。内容模型需要定义动态字段以支持程序化内容生成，同时包含标准SEO字段如metaTitle、metaDescription和slug。资料来源：[skills/programmatic-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/programmatic-seo/SKILL.md) ### 4. 网站架构 (site-architecture) 网站架构技能定义了页面的层级结构、导航系统和URL规范，确保搜索引擎能够有效抓取和理解网站内容。 #### 导航模式 **简单导航头** 适用于小型企业、简单SaaS或作品集网站，遵循以下规则： - Logo始终链接到首页 - CTA按钮位于最右侧，视觉上突出 - 按优先级排序（访问量最高的优先） - 当前页面获得视觉指示器（下划线、加粗或颜色变化） **大型菜单导航** 适用于功能丰富的SaaS、电子商务或有大量内容分类的网站： - 2-4列布局 - 按功能区域、用例或受众逻辑分组 - 底部包含"查看全部"链接 - 大型菜单内不嵌套下拉菜单 #### 内容模型网站架构技能定义了核心内容类型及其字段： | 内容类型 | 核心字段 | 用途 | |---------|---------|------| | Landing Page | title, headline, body, ctaText, ctaUrl | 转化导向页面 | | Blog Post | title, slug, author, publishDate, body, category | 博客文章 | | Documentation | title, slug, body, category | 帮助文档 | | Author | name, bio, avatar, socialLinks | 博客作者信息 | | CTA Block | heading, body, buttonText, buttonUrl, variant | 可复用CTA | #### SEO字段清单每个页面级内容类型都需要配置以下字段： | 字段 | 描述 | 建议长度 | |------|------|---------| | metaTitle | 元标题 | 50-60字符 | | metaDescription | 元描述 | 150-160字符 | | ogImage | 社交分享图 | 1200x630像素 | | slug | URL路径段 | 简短有意义 | | canonicalUrl | 规范链接 | 可选覆盖 | | noIndex | 索引排除 | 布尔值 | | structuredData | 结构化数据 | 可选JSON-LD | 资料来源：[skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md) ### 5. 竞品替代页面 (competitor-alternatives) 竞品替代技能用于创建针对竞争对手的比较页面，帮助用户发现和评估替代产品。 #### 研究流程 ```mermaid graph TD A[竞品URL] --> B[Firecrawl Map
发现站点结构] B --> C[识别关键页面] C --> D[Firecrawl Scrape
抓取页面内容] D --> E[提取定位和功能信息] E --> F[生成竞品档案] F --> G[创建替代对比页面] ``` #### 优先抓取页面类型 | 页面类型 | 提取内容 | |---------|---------| | 首页 | 标题、副标题、价值主张、主要CTA、社会证明 | | 定价页 | 定价层级、功能对比、计费选项、免费试用 | | 功能页 | 功能分类、主要功能、功能描述 | | 关于页 | 公司信息、团队背景、发展历程 | #### 数据工具 - **Firecrawl Map** - 发现站点结构，识别关键页面 - **Firecrawl Scrape** - 批量抓取页面内容 - **Firecrawl Extract** - 使用schema提取结构化数据资料来源：[skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md) ### 6. 结构化数据 (schema-markup) 结构化数据技能为网页添加Schema.org标记，帮助搜索引擎理解页面内容并生成丰富搜索结果。 #### 支持的Schema类型 **Organization** 用于品牌和组织信息，声明站点名称、标志和社交资料。 **WebSite** 用于整个网站，包含站点名称和搜索框配置，支持Sitelink搜索框。 **Article/BlogPosting** 用于博客文章和新闻，包含标题、图片、发布日期、作者和发布者信息。 **Product** 用于电商或SaaS产品页面，包含名称、图片、描述、价格和库存状态。 #### JSON-LD格式示例 ```json { "@context": "https://schema.org", "@type": "Article", "headline": "文章标题", "image": "https://example.com/image.jpg", "datePublished": "2024-01-15T08:00:00+00:00", "author": { "@type": "Person", "name": "作者名称" }, "publisher": { "@type": "Organization", "name": "公司名称", "logo": { "@type": "ImageObject", "url": "https://example.com/logo.png" } } } ``` 资料来源：[skills/schema-markup/references/schema-examples.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema-markup/references/schema-examples.md) ### 7. ASO审计 (aso-audit) ASO（应用商店优化）审计技能专注于提升移动应用在应用商店中的可见性，包括App Store和Google Play。 #### 审计维度 | 维度 | 描述 | |------|------| | 应用标题 | 关键词优化、品牌识别 | | 应用描述 | 关键词密度、价值主张 | | 截图和视频 | 视觉吸引力、功能展示 | | 评分和评论 | 用户反馈、问题识别 | | 关键词覆盖 | 搜索词排名监控 | 资料来源：[skills/aso-audit/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/aso-audit/SKILL.md) ## 工作流程整合 ### 完整SEO优化流程 ```mermaid graph TD subgraph "阶段一：技术基础" A1[网站架构规划] --> A2[URL结构设计] A2 --> A3[导航系统搭建] A3 --> A4[面包屑实现] end subgraph "阶段二：内容创建" B1[内容策略制定] --> B2[程序化页面生成] B2 --> B3[竞品替代页面] B3 --> B4[AI驱动内容优化] end subgraph "阶段三：技术优化" C1[结构化数据添加] --> C2[SEO审计执行] C2 --> C3[问题修复跟踪] C3 --> C4[持续监控] end A4 --> B1 B4 --> C1 C4 --> A1 ``` ### 技能间依赖关系 | 源技能 | 目标技能 | 依赖说明 | |-------|---------|---------| | site-architecture | seo-audit | 提供URL结构和导航基础 | | site-architecture | programmatic-seo | 定义内容模型和模板 | | seo-audit | schema-markup | 基于审计结果添加标记 | | ai-seo | schema-markup | E-E-A-T内容支持结构化数据 | | competitor-alternatives | seo-audit | 提供竞品分析输入 | ## 工具集成总览 | 工具类别 | 工具名称 | 用途 | |---------|---------|------| | 分析平台 | Google Search Console | 搜索表现、索引状态 | | SEO工具 | Ahrefs | 域名评级、关键词、外链 | | 内容管理 | Sanity | 无头CMS，内容建模 | | 数据源 | ZoomInfo | 公司和联系人数据 | | 链接管理 | Dub.co | 短链接、UTM追踪 | | 网站发布 | WordPress | 内容发布和媒体管理 | | 客户数据 | Optimizely | 实验和个性化 | 资料来源：[tools/integrations/ahrefs.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/ahrefs.md) ## 最佳实践 ### 内容创作标准 1. **E-E-A-T优先** - 在所有内容中强调经验、专业性、权威性和可信度 2. **自包含答案** - 创建能被AI直接引用的独立答案块 3. **统计引用** - 使用具体数据支撑声明，统计内容可提升15-30%的AI引用率 4. **自然语言** - 使用自然的疑问句式，匹配用户实际搜索意图 ### 技术实现要点 1. **SEO字段完整** - 每个页面必须包含metaTitle、metaDescription、slug 2. **结构化数据验证** - 使用Google Rich Results Test验证Schema标记 3. **导航一致性** - 保持全站导航模式统一，面包屑清晰准确 4. **性能优先** - 优化Core Web Vitals指标，特别是LCP和CLS ### 程序化SEO注意事项 1. **避免重复内容** - 确保程序化页面有足够的独特价值 2. **内部链接策略** - Hub-and-Spoke模型建立主题集群 3. **规范化处理** - 使用canonical标签防止内部重复 4. **分层架构** - 高权重页面支撑长尾页面 ## 总结 SEO与发现技能组提供了从技术审计到AI优化的完整SEO解决方案。通过整合这七个核心技能，营销团队可以系统性地提升网站在传统搜索引擎和AI助手中的可见性，实现可持续的有机流量增长。技能组的模块化设计允许团队根据具体需求选择使用单个技能或组合多个技能，形成定制化的SEO工作流程。 --- ## 增长与收入技能组 ### 相关页面相关主题：[技能系统概览](#skills-overview), [CLI工具集](#cli-tools)

相关源码文件

以下源码文件用于生成本页说明： - [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md) - [skills/site-architecture/references/mermaid-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/mermaid-templates.md) - [skills/content-strategy/references/headless-cms.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/content-strategy/references/headless-cms.md) - [skills/competitor-alternatives/references/templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-alternatives/references/templates.md) - [tools/integrations/postmark.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/postmark.md) - [tools/integrations/zoominfo.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/zoominfo.md)

# 增长与收入技能组 ## 概述增长与收入技能组是 marketingskills 项目中专注于业务扩张、变现策略和销售运营的技能集合。该技能组涵盖从获客增长到客户保留的完整业务增长周期，旨在帮助 SaaS 企业实现可持续的收入增长。根据项目结构，该技能组包含以下核心领域： | 技能分类 | 技能名称 | 用途说明 | |---------|---------|---------| | 增长工程 | `co-marketing` | 合作伙伴识别与联合营销活动 | | 增长工程 | `free-tool-strategy` | 营销工具与计算器策略 | | 增长工程 | `referral-program` | 推荐与联盟项目 | | 策略与变现 | `marketing-ideas` | 140个 SaaS 营销创意 | | 策略与变现 | `marketing-psychology` | 心理模型与用户心理 | | 策略与变现 | `launch-strategy` | 产品发布与公告 | | 策略与变现 | `pricing-strategy` | 定价、包装与商业化 | | 销售与运营 | `revops` | 潜在客户生命周期、评分、路由与管道管理 | | 销售与运营 | `sales-enablement` | 销售演示、单页资料、异议处理文档与演示脚本 | | 转化优化 | `page-cro` | 营销页面优化 | | 转化优化 | `signup-flow-cro` | 注册流程优化 | | 转化优化 | `onboarding-cro` | 激活流程优化 | | 转化优化 | `churn-prevention` | 流失防止、取消流程、挽留优惠与付款恢复 | | 付费分发 | `paid-ads` | Google、Meta、LinkedIn 广告活动 | | 付费分发 | `ad-creative` | 批量广告创意生成与迭代 | 资料来源：[README.md]() ## 架构总览增长与收入技能组采用分层架构，涵盖从获客到留存的全链路。 ```mermaid graph TD subgraph "获客层" PA[paid-ads
付费广告] CC[co-marketing
联合营销] FT[free-tool-strategy
免费工具策略] RP[referral-program
推荐计划] end subgraph "转化层" PC[page-cro
页面优化] SF[signup-flow-cro
注册流程] OB[onboarding-cro
激活流程] end subgraph "变现层" PS[pricing-strategy
定价策略] LS[launch-strategy
发布策略] SE[sales-enablement
销售赋能] end subgraph "留存层" CP[churn-prevention
流失防止] RV[revops
收入运营] end subgraph "策略层" MI[marketing-ideas
营销创意] MP[marketing-psychology
营销心理学] end PA --> PC CC --> PC FT --> PC RP --> PC PC --> SF SF --> OB OB --> PS PS --> SE SE --> RV OB --> CP CP --> RV LS --> PA MI --> CC MP --> FT style PA fill:#e1f5ff style PS fill:#fff3e0 style CP fill:#f3e5f5 style RV fill:#e8f5e9 ``` ## 核心技能详解 ### 1. 增长工程技能增长工程技能组专注于通过创新策略和合作伙伴关系实现用户增长。 #### 1.1 联合营销 (co-marketing) 联合营销技能帮助识别潜在合作伙伴并策划联合营销活动。该技能涵盖： - **合作伙伴识别**：根据目标受众重叠度、品牌定位匹配度评估合作伙伴 - **活动策划**：设计联合网络研讨会、内容合作、联合推广等活动 - **ROI 追踪**：建立双方认可的效果衡量指标 #### 1.2 免费工具策略 (free-tool-strategy) 免费工具策略技能用于设计营销导向的工具和计算器： - **工具类型**：ROI 计算器、ROI 预测工具、行业基准工具 - **获客机制**：通过工具使用引导用户留下联系方式 - **数据收集**：在用户使用工具过程中收集行为数据 ```mermaid graph LR A[用户访问
免费工具] --> B[使用工具
获得价值] B --> C[查看结果
需要邮箱] C --> D[获取报告
留下联系方式] D --> E[触发线索
培育流程] style A fill:#e3f2fd style E fill:#c8e6c9 ``` #### 1.3 推荐计划 (referral-program) 推荐计划技能涵盖推荐人和被推荐人的激励机制设计： - **双面奖励**：为推荐人和被推荐人提供双向奖励 - **分级机制**：根据推荐数量设置阶梯奖励 - **防刷机制**：识别虚假推荐和激励滥用 ### 2. 策略与变现技能 #### 2.1 营销创意 (marketing-ideas) 该技能提供 140 个 SaaS 营销创意，涵盖： - 内容营销策略 - 社交媒体增长策略 - 社区建设策略 - 合作伙伴策略 #### 2.2 营销心理学 (marketing-psychology) 运用心理模型优化营销效果： - **承诺与一致性**：通过小请求引导大承诺 - **社会认同**：展示用户评价和使用数据 - **稀缺性**：限时优惠和限量供应 - **锚定效应**：设置高价选项引导选择 #### 2.3 发布策略 (launch-strategy) 产品发布技能包含完整的发布流程： ```mermaid graph TD P1[预热期
建立期待] --> P2[预告期
功能揭秘] P2 --> P3[发布日
全面上线] P3 --> P4[跟进期
用户反馈] P4 --> P5[优化期
迭代改进] style P1 fill:#fff3e0 style P3 fill:#ffcdd2 style P5 fill:#c8e6c9 ``` #### 2.4 定价策略 (pricing-strategy) 定价策略技能覆盖定价、包装和商业化的各个方面： | 定价模式 | 适用场景 | 关键考量 | |---------|---------|---------| | 按用户数定价 | B2B SaaS | 团队规模与使用量匹配 | | 按功能分层 | 功能差异化物 | 功能分层与价值感知 | | 用量计费 | API 产品 | 成本结构与扩展性 | | 混合定价 | 复杂产品 | 基础订阅 + 额外用量 | **定价心理学要素：** - 锚定价格设置 - 视觉层次引导 - 价值对比框架 - 套餐捆绑策略 ### 3. 销售赋能技能 #### 3.1 收入运营 (revops) 收入运营技能覆盖销售运营的完整生命周期： ```mermaid graph TD LE[线索生成
Lead Generation] --> LEQ[线索资质认定
Lead Qualification] LEQ --> LH[线索分配
Lead Handoff] LH --> SQ[销售线索
Sales Qualified] SQ --> OP[商机管道
Opportunity] OP --> CN[谈判
Negotiation] CN --> CW[成交
Closed Won] CW --> IR[初始收入
Initial Revenue] style LE fill:#e3f2fd style SQ fill:#fff3e0 style CW fill:#c8e6c9 ``` **核心指标追踪：** - 线索转化率 (Lead Conversion Rate) - 销售周期 (Sales Cycle Length) - 管道覆盖率 (Pipeline Coverage) - 成交率 (Win Rate) #### 3.2 销售赋能 (sales-enablement) 销售赋能技能提供标准化的销售辅助材料： | 材料类型 | 用途 | 关键要素 | |---------|-----|---------| | 销售演示 | 客户会议 | 痛点共鸣、解决方案、案例证明 | | 单页资料 | 快速传递价值 | 单页概述、关键指标、CTA | | 异议处理 | 应对客户疑虑 | 常见反对意见及标准答复 | | 演示脚本 | 产品演示 | 关键功能点、价值语言 | ### 4. 转化优化技能 #### 4.1 页面转化优化 (page-cro) 营销页面优化涵盖以下关键元素： **首屏优化要素：** - 价值主张清晰表达 - 社会认同元素展示 - 主要 CTA 突出显示 **信任信号布局：** - 客户 logo 展示 - 评价和推荐 - 安全认证标识 #### 4.2 注册流程优化 (signup-flow-cro) 注册流程优化关注转化漏斗的每一步： ```mermaid graph LR A[开始注册] --> B{邮箱输入} B -->|成功| C{密码设置} B -->|失败| B C -->|成功| D{邮箱验证} C -->|失败| C D -->|成功| E[注册完成] D -->|失败| D style E fill:#c8e6c9 ``` **优化要点：** - 减少必填字段数量 - 实时表单验证 - 渐进式表单设计 - 社会化登录选项 #### 4.3 激活流程优化 (onboarding-cro) 新用户激活流程确保用户快速发现产品价值： - 引导式入职流程 - 个性化激活路径 - 关键里程碑设置 - 早期成功指标追踪 ### 5. 留存与流失防止 #### 5.1 流失防止 (churn-prevention) 流失防止技能覆盖整个客户生命周期： ```mermaid graph TD subgraph "客户成功管理" ON[新用户激活] --> UU[正常使用] UU --> HR[健康度监控] HR --> RI[风险识别] RI --> IR[干预措施] IR --> RS[问题解决] RS --> RU[恢复使用] end subgraph "风险信号" RI --> RS1[低活跃度] RI --> RS2[低功能使用] RI --> RS3[支持工单增加] RI --> RS4[支付问题] end style ON fill:#e3f2fd style RI fill:#ffcdd2 style RS fill:#c8e6c9 ``` **流失防止策略：** | 策略类型 | 触发条件 | 干预措施 | |---------|---------|---------| | 挽留优惠 | 检测到流失意向 | 折扣、增值功能 | | 主动关怀 | 使用频率下降 | 1v1 沟通、引导使用 | | Dunning | 支付失败 | 付款提醒、多方式重试 | | 取消流程 | 用户申请取消 | 取消原因收集、最终优惠 | ### 6. 付费分发技能 #### 6.1 付费广告 (paid-ads) 付费广告技能覆盖主流广告平台的投放策略： | 平台 | 适用目标 | 核心指标 | |-----|---------|---------| | Google Ads | 搜索意图明确 | CPC、转化率、质量得分 | | Meta Ads | 品牌认知、漏斗中层 | CPM、CPC、ROAS | | LinkedIn Ads | B2B 决策者触达 | CPM、CPC、线索成本 | **广告活动结构：** - 活动层级：Campaign → Ad Set → Ad - 受众分层：人口统计 + 兴趣 + 行为 - 出价策略：手动出价 vs 目标 ROAS #### 6.2 广告创意 (ad-creative) 广告创意技能支持批量生成和迭代优化： - 多变体 A/B 测试 - 素材规格适配（图片、视频、轮播） - 文案模板库 - 效果追踪与分析 ## 工具集成增长与收入技能组支持与多种营销工具集成： ### 客户数据与情报 | 工具 | 功能 | 集成方式 | |-----|-----|---------| | ZoomInfo | B2B 联系人数据 | API 批量查询 | **ZoomInfo 关键接口：** ```json // 联系人搜索 POST https://api.zoominfo.com/search/contact { "firstName": ["Jane"], "lastName": ["Doe"], "jobTitle": ["VP Marketing"], "companyName": ["Acme Corp"], "rpp": 25, "page": 1 } // 联系人富化 POST https://api.zoominfo.com/enrich/contact { "matchEmail": ["jane@acme.com"] } ``` 资料来源：[tools/integrations/zoominfo.md]() ### 邮件营销 | 工具 | 功能 | 集成方式 | |-----|-----|---------| | Postmark | 交易邮件、模板管理 | REST API | **Postmark 核心功能：** - 邮件模板创建与管理 - 批量发送与统计 - 退信处理与激活 - 打开和点击追踪资料来源：[tools/integrations/postmark.md]() ### 内容管理 | 工具 | 功能 | 适用场景 | |-----|-----|---------| | Sanity | 无头 CMS | 结构化内容管理 | **Sanity 内容类型设计：** | 内容类型 | 核心字段 | 用途 | |---------|---------|-----| | Page | title, slug, content, seo | 营销页面 | | BlogPost | title, body, author, category | 博客内容 | | Author | name, bio, avatar, socialLinks | 作者信息 | | CTA Block | heading, body, buttonText, buttonUrl | 可复用 CTA | 资料来源：[skills/content-strategy/references/headless-cms.md]() ## 最佳实践 ### 增长策略框架 1. **测量优先**：建立完整的数据追踪体系 2. **快速迭代**：小步快跑，持续优化 3. **用户洞察**：深入理解用户旅程和痛点 4. **跨职能协作**：增长、产品、销售协同 ### 收入运营流程 ```mermaid graph LR A[数据收集] --> B[分析洞察] B --> C[策略制定] C --> D[执行实施] D --> E[效果验证] E --> A style A fill:#e3f2fd style B fill:#fff3e0 style C fill:#f3e5f5 style D fill:#e8f5e9 style E fill:#ffecb3 ``` ### 流失防止机制 - **预警系统**：建立客户健康度评分模型 - **自动化干预**：基于触发的自动关怀流程 - **人工介入**：高价值客户的专属关怀 ## 相关资源 - **贡献指南**：[CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md) - 学习如何添加新技能 - **项目架构**：[CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md) - 项目结构说明 - **站点架构**：[skills/site-architecture/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/SKILL.md) - 页面层次结构设计 ## 总结增长与收入技能组构成了 marketingskills 项目中实现业务增长的核心能力矩阵。该技能组从获客增长（付费广告、联合营销、推荐计划）到转化优化（页面优化、注册流程、入职激活），再到变现策略（定价策略、销售赋能）和客户留存（收入运营、流失防止），覆盖了 SaaS 企业增长的全生命周期。通过灵活组合这些技能，营销团队可以构建完整的增长引擎，实现可持续的收入增长目标。 --- ## CLI工具集 ### 相关页面相关主题：[SEO与发现技能组](#seo-skills)

相关源码文件

以下源码文件用于生成本页说明： - [tools/REGISTRY.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/REGISTRY.md) - [tools/clis/README.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/README.md) - [tools/clis/google-ads.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/google-ads.js) - [tools/clis/meta-ads.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/meta-ads.js) - [tools/clis/ga4.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/ga4.js) - [tools/clis/hubspot.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/hubspot.js) - [tools/integrations/ahrefs.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/ahrefs.md) - [tools/integrations/zoominfo.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/zoominfo.md)

# CLI工具集 ## 概述 CLI工具集是marketingskills项目中的命令行接口模块，位于`tools/clis/`目录下。该模块为市场营销专业人员提供了一套统一的命令行工具，用于管理与Google Ads、Meta Ads、Google Analytics 4、HubSpot等主流营销平台的交互。 CLI工具集的主要目标是简化营销自动化工作流程，使营销人员能够在终端环境中直接执行广告管理、分析查询和CRM操作等任务。通过统一的命令行界面，用户可以快速集成到现有的开发或自动化流程中。 ## 架构设计 ```mermaid graph TD subgraph "CLI工具集架构" CLI["CLI入口
node cli-name.js"] REGISTRY["工具注册表
REGISTRY.md"] GOOGLE["google-ads.js"] META["meta-ads.js"] GA4["ga4.js"] HUBSPOT["hubspot.js"] OPTIMIZELY["optimizely.js"] LIVESTORM["livestorm.js"] end CLI --> REGISTRY REGISTRY --> GOOGLE REGISTRY --> META REGISTRY --> GA4 REGISTRY --> HUBSPOT REGISTRY --> OPTIMIZELY REGISTRY --> LIVESTORM GOOGLE --> GOOGLE_API["Google Ads API"] META --> META_API["Meta Marketing API"] GA4 --> GA4_API["GA4 Data API"] HUBSPOT --> HS_API["HubSpot API"] ``` ## 核心组件 ### 工具注册表工具注册表（`tools/REGISTRY.md`）是CLI工具集的核心配置文件，定义了所有可用工具的元数据。每个工具条目包含以下字段： | 字段 | 必填 | 说明 | |------|------|------| | `name` | 是 | 工具名称（小写字母、数字、连字符） | | `description` | 是 | 工具功能描述（1-1024字符） | | `license` | 否 | 许可证类型（默认MIT） | | `metadata` | 否 | 键值对元数据（作者、版本等） | **名称字段规则：** - 仅使用小写字母、数字和连字符 - 不能以连字符开头或结尾 - 禁止连续连字符 - 必须与父目录名称完全匹配 ### Google Ads CLI Google Ads命令行工具（`tools/clis/google-ads.js`）提供与Google Ads平台的交互能力。该工具支持广告系列管理、关键词查询和效果报告等核心功能。 **主要功能模块：** - 广告系列（Campaigns）管理 - 广告组（Ad Groups）操作 - 关键词（Keywords）查询 - 转化追踪配置 ### Meta Ads CLI Meta Ads命令行工具（`tools/clis/meta-ads.js`）用于管理Facebook和Instagram广告。该工具封装了Meta Marketing API的核心功能。 **支持的API端点类型：** - 账户层级操作 - 广告系列管理 - 受众定向 - 广告创意管理 ### Google Analytics 4 CLI GA4命令行工具（`tools/clis/ga4.js`）提供对Google Analytics 4 Data API的访问。该工具允许用户查询网站和应用的分析数据。 **关键指标类型：** | 类别 | 指标示例 | |------|----------| | 用户指标 | activeUsers, newUsers, totalUsers | | 会话指标 | sessions, bounces, sessionDuration | | 转化指标 | conversions, totalRevenue | | 事件指标 | eventCount, userEngagementDuration | ### HubSpot CLI HubSpot命令行工具（`tools/clis/hubspot.js`）集成HubSpot CRM API，支持联系人、公司和交易管理。 **核心功能：** - 联系人CRUD操作 - 公司数据管理 - 交易管道追踪 - 营销自动化工作流触发 ### Optimizely CLI Optimizely命令行工具（`tools/clis/optimizely.js`）提供实验平台的管理能力。 **命令结构：** ```bash optimizely [options] 可用命令： campaigns campaigns list --project-id experiments experiments list --project-id pages pages list --project-id 选项参数： --page 页码 --per-page 每页数量 --status 状态过滤（not_started|running|paused|archived） ``` ### Livestorm CLI Livestorm命令行工具（`tools/clis/livestorm.js`）管理虚拟活动和在线研讨会。 **命令体系：** | 命令 | 功能 | 子命令示例 | |------|------|------------| | `events` | 活动管理 | list, get, create, update, delete | | `sessions` | 场次管理 | list, create, delete, register | | `people` | 参与者 | list, get | | `webhooks` | Webhook | list, create, delete | | `organization` | 组织信息 | organization | ## 数据模型 ### 通用CLI输出格式所有CLI工具采用统一的JSON输出格式，便于后续处理和集成。 ```javascript // 成功响应 { "data": [...], "metadata": { "page": 1, "perPage": 20, "total": 100 } } // 错误响应 { "error": "错误消息", "code": "ERROR_CODE" } ``` ### 状态流转 ```mermaid stateDiagram-v2 [*] --> 初始化: CLI启动初始化 --> 认证: 加载配置认证 --> 就绪: Token验证就绪 --> 执行: 接收命令执行 --> 处理: 解析参数处理 --> API调用: 构建请求 API调用 --> 响应解析: 获取结果响应解析 --> 输出: 格式化JSON 输出 --> [*]: 完成认证 --> 错误: 认证失败执行 --> 错误: 参数错误错误 --> [*]: 退出 ``` ## 工具使用工作流 ```mermaid graph LR A["用户输入命令"] --> B["CLI解析器"] B --> C{"命令有效性"} C -->|有效| D["读取配置"] C -->|无效| E["显示帮助信息"] D --> F["调用工具模块"] F --> G["API认证"] G --> H["发送请求"] H --> I{"响应状态"} I -->|成功| J["解析响应数据"] I -->|失败| K["输出错误信息"] J --> L["格式化输出"] L --> M["终端显示"] ``` ## 与集成工具的关系 CLI工具集与`tools/integrations/`目录下的其他集成工具协同工作，形成完整的营销技术栈： | CLI工具 | 对应集成 | 主要用途 | |---------|----------|----------| | google-ads.js | - | 广告投放管理 | | meta-ads.js | - | 社交广告管理 | | ga4.js | - | 数据分析 | | hubspot.js | ahrefs.md, zoominfo.md | CRM与数据丰富 | | optimizely.js | - | A/B测试与实验 | | livestorm.js | - | 活动管理 | ## 安全与认证 ### 环境变量配置 CLI工具通过环境变量管理敏感凭证： ```bash # Google Ads export GOOGLE_ADS_DEVELOPER_TOKEN="your-token" export GOOGLE_ADS_CLIENT_ID="your-client-id" export GOOGLE_ADS_CLIENT_SECRET="your-secret" # Meta Ads export META_ACCESS_TOKEN="your-token" # GA4 export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json" # HubSpot export HUBSPOT_ACCESS_TOKEN="your-token" ``` ### 最佳实践 - 凭证不应硬编码在源码中 - 使用`.env`文件管理本地开发环境 - 生产环境使用密钥管理服务 - 定期轮换API访问令牌 ## 扩展指南 ### 新增CLI工具在`tools/clis/`目录下创建新的CLI工具文件： ``` tools/clis/ ├── new-tool.js └── ... ``` 工具文件应遵循以下结构： ```javascript #!/usr/bin/env node function main() { // 主逻辑 const result = { command: 'new-tool', options: { /* 参数定义 */ }, description: '工具功能描述' }; console.log(JSON.stringify(result, null, 2)); } main().catch(err => { console.error(JSON.stringify({ error: err.message })); process.exit(1); }); ``` ### 注册新工具在`tools/REGISTRY.md`中添加新工具条目，确保： - `name`字段与文件名匹配 - 提供清晰的`description` - 包含完整的`metadata`信息 ## 相关资源 - 集成工具文档：[tools/integrations/](../integrations/) - 工具注册表配置：[tools/REGISTRY.md](./REGISTRY.md) - 源码示例：[tools/clis/](./) --- --- ## Doramagic 踩坑日志项目：coreyhaines31/marketingskills 摘要：发现 19 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：身份坑 - 仓库名和安装名不一致。 ## 1. 身份坑 · 仓库名和安装名不一致 - 严重度：medium - 证据强度：runtime_trace - 发现：仓库名 `marketingskills` 与安装入口 `skills` 不完全一致。 - 对用户的影响：用户照着仓库名搜索包或照着包名找仓库时容易走错入口。 - 建议检查：在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。 - 复现命令：`npx skills` - 防护动作：页面必须同时展示 repo 名和真实安装入口，避免用户搜索错包。 - 证据：identity.distribution | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | repo=marketingskills; install=skills ## 2. 安装坑 · 来源证据：Add OpenAI Codex plugin support - 严重度：medium - 证据强度：source_linked - 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Add OpenAI Codex plugin support - 对用户的影响：可能增加新用户试用和生产接入成本。 - 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。 - 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - 证据：community_evidence:github | cevd_c087d3feeb494e9480713d6dc9e924f1 | https://github.com/coreyhaines31/marketingskills/issues/295 | 来源类型 github_issue 暴露的待验证使用条件。 ## 3. 安装坑 · 来源证据：Create official marketing skills plugin for Claude Code plugin marketplace - 严重度：medium - 证据强度：source_linked - 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Create official marketing skills plugin for Claude Code plugin marketplace - 对用户的影响：可能增加新用户试用和生产接入成本。 - 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - 证据：community_evidence:github | cevd_0887d9c4d8fa414a803dedc9b5ed3b7f | https://github.com/coreyhaines31/marketingskills/issues/229 | 来源类型 github_issue 暴露的待验证使用条件。 ## 4. 安装坑 · 来源证据：Feature Request: Add Prefix to skills - 严重度：medium - 证据强度：source_linked - 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Feature Request: Add Prefix to skills - 对用户的影响：可能增加新用户试用和生产接入成本。 - 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。 - 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - 证据：community_evidence:github | cevd_3e599cd97c324acd88021e15eff0d375 | https://github.com/coreyhaines31/marketingskills/issues/279 | 来源类型 github_issue 暴露的待验证使用条件。 ## 5. 安装坑 · 来源证据：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand - 严重度：medium - 证据强度：source_linked - 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand - 对用户的影响：可能影响升级、迁移或版本选择。 - 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - 证据：community_evidence:github | cevd_e6220468080c46c4801a7801b8cfbf84 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0 | 来源类型 github_release 暴露的待验证使用条件。 ## 6. 安装坑 · 来源证据：v1.9.0 — image skill, video skill, plugin fix - 严重度：medium - 证据强度：source_linked - 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.9.0 — image skill, video skill, plugin fix - 对用户的影响：可能增加新用户试用和生产接入成本。 - 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - 证据：community_evidence:github | cevd_b2e5d4f3b13b4cf9bf57f7d9883e6ca2 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0 | 来源类型 github_release 暴露的待验证使用条件。 ## 7. 配置坑 · 可能修改宿主 AI 配置 - 严重度：medium - 证据强度：source_linked - 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。 - 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。 - 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。 - 防护动作：涉及宿主配置目录时必须给回滚路径，不能只给安装命令。 - 证据：capability.host_targets | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | host_targets=claude, claude_code ## 8. 能力坑 · 能力判断依赖假设 - 严重度：medium - 证据强度：source_linked - 发现：README/documentation is current enough for a first validation pass. - 对用户的影响：假设不成立时，用户拿不到承诺的能力。 - 建议检查：将假设转成下游验证清单。 - 防护动作：假设必须转成验证项；没有验证结果前不能写成事实。 - 证据：capability.assumptions | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | README/documentation is current enough for a first validation pass. ## 9. 维护坑 · 维护活跃度未知 - 严重度：medium - 证据强度：source_linked - 发现：未记录 last_activity_observed。 - 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。 - 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。 - 防护动作：维护活跃度未知时，推荐强度不能标为高信任。 - 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | last_activity_observed missing ## 10. 安全/权限坑 · 下游验证发现风险项 - 严重度：medium - 证据强度：source_linked - 发现：no_demo - 对用户的影响：下游已经要求复核，不能在页面中弱化。 - 建议检查：进入安全/权限治理复核队列。 - 防护动作：下游风险存在时必须保持 review/recommendation 降级。 - 证据：downstream_validation.risk_items | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium ## 11. 安全/权限坑 · 存在安全注意事项 - 严重度：medium - 证据强度：source_linked - 发现：No sandbox install has been executed yet; downstream must verify before user use. - 对用户的影响：用户安装前需要知道权限边界和敏感操作。 - 建议检查：转成明确权限清单和安全审查提示。 - 防护动作：安全注意事项必须面向用户前置展示。 - 证据：risks.safety_notes | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | No sandbox install has been executed yet; downstream must verify before user use. ## 12. 安全/权限坑 · 存在评分风险 - 严重度：medium - 证据强度：source_linked - 发现：no_demo - 对用户的影响：风险会影响是否适合普通用户安装。 - 建议检查：把风险写入边界卡，并确认是否需要人工复核。 - 防护动作：评分风险必须进入边界卡，不能只作为内部分数。 - 证据：risks.scoring_risks | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium ## 13. 安全/权限坑 · 来源证据：v1.1.0 — Tools Registry, Progressive Disclosure & More - 严重度：medium - 证据强度：source_linked - 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.1.0 — Tools Registry, Progressive Disclosure & More - 对用户的影响：可能影响授权、密钥配置或安全边界。 - 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - 证据：community_evidence:github | cevd_2ce61abbfe664a1c884129cf5e26a47a | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.1.0 | 来源类型 github_release 暴露的待验证使用条件。 ## 14. 安全/权限坑 · 来源证据：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools - 严重度：medium - 证据强度：source_linked - 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools - 对用户的影响：可能影响授权、密钥配置或安全边界。 - 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - 证据：community_evidence:github | cevd_c9b5f529d1ae4679b15fcf45a148e130 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.2.0 | 来源讨论提到 node 相关条件，需在安装/试用前复核。 ## 15. 安全/权限坑 · 来源证据：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw - 严重度：medium - 证据强度：source_linked - 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw - 对用户的影响：可能影响授权、密钥配置或安全边界。 - 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - 证据：community_evidence:github | cevd_a8f99c9b2e1a41a284683c9ad456d8e8 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.5.0 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。 ## 16. 安全/权限坑 · 来源证据：v1.7.0 — ASO audit skill, Zapier SDK - 严重度：medium - 证据强度：source_linked - 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.7.0 — ASO audit skill, Zapier SDK - 对用户的影响：可能影响授权、密钥配置或安全边界。 - 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - 证据：community_evidence:github | cevd_21639af8f9f846c3920bd9368f4eb1ff | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.7.0 | 来源类型 github_release 暴露的待验证使用条件。 ## 17. 安全/权限坑 · 来源证据：v1.8.0 — 2 new skills, security hardening, plugin fix - 严重度：medium - 证据强度：source_linked - 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.8.0 — 2 new skills, security hardening, plugin fix - 对用户的影响：可能影响授权、密钥配置或安全边界。 - 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - 证据：community_evidence:github | cevd_3f54380df7c947deb428af9b2886a4a9 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.8.0 | 来源讨论提到 api key 相关条件，需在安装/试用前复核。 ## 18. 维护坑 · issue/PR 响应质量未知 - 严重度：low - 证据强度：source_linked - 发现：issue_or_pr_quality=unknown。 - 对用户的影响：用户无法判断遇到问题后是否有人维护。 - 建议检查：抽样最近 issue/PR，判断是否长期无人处理。 - 防护动作：issue/PR 响应未知时，必须提示维护风险。 - 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | issue_or_pr_quality=unknown ## 19. 维护坑 · 发布节奏不明确 - 严重度：low - 证据强度：source_linked - 发现：release_recency=unknown。 - 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。 - 建议检查：确认最近 release/tag 和 README 安装命令是否一致。 - 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。 - 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | release_recency=unknown