项目简介

Marketing Skills 是一个面向 AI 代理（Agent）的营销技能集合库，旨在为自动化营销任务提供标准化的技能定义和操作指南。该项目通过结构化的技能模块，帮助 AI 代理执行各类营销工作，包括内容策略、SEO 优化、付费广告、网站架构设计等。

资料来源：CONTRIBUTING.md:1-5

核心设计理念

技能模块化

项目采用模块化设计，每个营销技能独立存放在 skills/ 目录下的子目录中。每个技能包含完整的指令、参考资料、脚本和资源文件，可被不同的 AI 代理平台调用。

跨代理兼容性

技能设计遵循跨平台兼容原则，确保同一套技能可以在多种 AI 代理环境中运行，包括 Codex、Cursor、Windsurf 等主流平台。

资料来源：CLAUDE.md:1-5

项目架构

整体架构图

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 元数据：

项目概述

Marketing Skills 是一个 AI 代理营销技能集合，为 AI 代理提供专业的营销知识和 workflows。当用户将这些技能添加到项目中时，代理能够识别营销任务并应用正确的框架和最佳实践。

核心概念

什么是技能（Skills）

技能是 Markdown 文件，为 AI 代理提供特定任务的专门知识和 workflows。每个技能包含：

• 触发短语和关键词
• 详细的使用说明
• 可选的参考资料、脚本和模板

技能层级结构

graph TD
    PMC["product-marketing-context<br/>(产品营销上下文)"]
    
    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 文件：

环境要求

硬件与操作系统要求

软件依赖

• Node.js: 版本 18.0.0 或更高
• npm: 版本 8.0.0 或更高（随 Node.js 一起安装）
• Git: 版本 2.30.0 或更高

快速安装

步骤一：克隆仓库

打开终端并执行以下命令：

git clone https://github.com/coreyhaines31/marketingskills.git
cd marketingskills

步骤二：安装依赖

项目使用 npm 管理依赖，执行安装命令：

npm install

此命令将读取 package.json 并安装所有必要的依赖包。

步骤三：验证安装

运行以下命令验证环境配置正确：

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 集成：

参考 skills/content-strategy/references/headless-cms.md 中的配置指南，定义内容模型包括：

{
  "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 技能目录包含：

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：

# 安装（如果需要全局安装）
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：

# 活动管理
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：

# 媒体管理
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：

# 用户管理
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。

# 初始化 Sanity 项目
sanity init

# 本地开发
sanity dev

# 部署 Studio
sanity deploy

# 导出数据集
sanity dataset export production ./backup.tar.gz

GROQ 查询示例：

// 获取最近10篇文章
const query = '*[_type == "post"][0..9]{title, slug}';

// 获取特定文章
const singlePost = '*[_type == "post" && slug.current == $slug][0]';

WordPress REST API

参考 tools/integrations/wordpress.md。

# 获取文章列表
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 命令：

# 列出文章
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。

# HubSpot CLI 安装
npm install -g @hubspot/cli

# 初始化项目
hs init

# 上传文件
hs upload src dest

# 监听变化
hs watch src dest

关键对象：

Postmark 邮件服务

参考 tools/integrations/postmark.md。

# 创建模板
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": "<html><body><p>Hello {{name}}</p></body></html>"
  }'

统计分析接口：

# 投递统计
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。

// 创建视频场景
const hyperframes = require('hyperframes');

const video = await hyperframes.createVideo({
  frames: [
    {
      html: `
        <div style="display:flex; align-items:center; justify-content:center;
                    height:100%; background:#1a1a2e; color:#fff; font-family:system-ui;">
          <h1 style="font-size:64px;">Welcome to Acme</h1>
        </div>
      `,
      duration: 3,
    },
    {
      html: `
        <div style="display:flex; flex-direction:column; align-items:center;
                    justify-content:center; height:100%; background:#000; color:#fff;
                    font-family:system-ui;">
          <h2 style="font-size:48px;">Ship faster with AI</h2>
        </div>
      `,
      duration: 3,
    },
  ],
  output: "intro.mp4",
  width: 1080,
  height: 1920,
  fps: 30,
});

Claude 插件配置

项目包含 Claude 插件配置，位于 .claude-plugin/ 目录。

plugin.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 文件并配置以下变量：

# 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 失败

# 清除缓存后重试
npm cache clean --force
rm -rf node_modules
npm install

CLI 工具无法执行

确保 Node.js 版本正确，并检查文件执行权限：

chmod +x tools/clis/*.js

环境变量未生效

确保 .env 文件位于项目根目录，或在执行命令前手动导出变量：

export $(cat .env | xargs)

相关资源

• 贡献指南：CONTRIBUTING.md
• 许可证：MIT License
• 问题反馈：GitHub Issues

贡献代码

欢迎提交 Pull Request 和 Issue。贡献前请阅读 CONTRIBUTING.md 了解：

1. 如何添加新的技能模块
2. 如何改进现有文档
3. 代码风格规范
4. 提交信息的格式要求

概述

技能系统（Agent Skills）是 Marketing Skills 项目中用于定义和封装营销自动化任务的核心组件。该系统基于 Agent Skills 规范，为 AI 代理提供标准化的技能描述和执行指南。

技能系统的设计目标是将复杂的营销任务（如竞争对手分析、SEO 优化、广告投放管理等）封装为可复用、可组合的模块，使 AI 代理能够根据用户需求自动调用相应的技能完成任务。

核心架构

技能目录结构

每个技能存放在独立的目录中，采用统一的目录结构组织各类资源：

skills/<skill-name>/
├── SKILL.md           # 必需 - 技能主指令文件
├── references/        # 可选 - 参考文档和指南
│   └── *.md
├── scripts/           # 可选 - 可执行脚本
│   └── *.py
└── assets/            # 可选 - 模板、数据文件
    └── *.json

技能定义规范

技能使用 YAML frontmatter 定义元数据，格式如下：

项目概述

Marketing Skills 是一个开源的营销技能库，旨在为营销专业人员提供可复用的技能模板、参考文档和工具集成。该项目采用模块化架构，将营销技能分为多个类别，每个类别包含主技能说明文件（SKILL.md）和可选的参考文档、脚本和资源文件。资料来源：CONTRIBUTING.md:1-10

技能架构

项目采用标准化目录结构管理各类营销技能，所有技能遵循统一的命名规范和元数据格式。资料来源：CONTRIBUTING.md:18-35

graph TD
    ROOT["marketingskills/"]
    ROOT --> SKILLS["skills/"]
    ROOT --> TOOLS["tools/"]
    
    SKILLS --> CAT1["竞争对手分析<br/>(competitor-profiling)"]
    SKILLS --> CAT2["付费广告<br/>(paid-ads)"]
    SKILLS --> CAT3["站点架构<br/>(site-architecture)"]
    SKILLS --> CAT4["AI SEO<br/>(ai-seo)"]
    SKILLS --> CAT5["分析追踪<br/>(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

该技能的数据采集结构如下：

技能执行流程采用 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

核心导航组件包括：

技能提供了 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

标准事件序列定义：

事件上下文包含会话信息、用户属性、时间戳等标准字段，确保数据一致性和可比性。

工具集成

邮件服务集成

Postmark 提供.Transactional 邮件 API 集成，支持模板管理、投递统计、退信管理和开点击追踪。资料来源：tools/integrations/postmark.md:1-25

内容管理系统集成

Sanity 作为结构化内容管理平台，支持博客、营销网站等多渠道内容交付。该集成提供文档查询（GROQ）、数据导入导出和实时协作编辑能力。资料来源：tools/integrations/sanity.md:1-35

关键对象类型：

网络研讨会集成

Livestorm 支持产品演示和网络研讨会的自动化管理，提供活动创建、注册管理、会话追踪和录制获取等功能。资料来源：tools/integrations/livestorm.md:1-30

CLI 工具 livestorm.js 提供命令行接口，支持活动的完整生命周期管理。资料来源：tools/clis/livestorm.js:1-25

# CLI 命令示例
node livestorm.js events list
node livestorm.js sessions create --event-id <id>
node livestorm.js people register --id <session> --email <email>

其他平台集成

CLI 工具

项目提供零依赖的 Node.js CLI 工具（Node 18+），位于 tools/clis/ 目录。资料来源：CLAUDE.md:12-18

验证方式：

# 语法检查
node --check tools/clis/<name>.js

# 显示帮助
node tools/clis/<name>.js

# 预览请求（不发送）
node tools/clis/<name>.js <cmd> --dry-run

技能贡献指南

目录命名规范

元数据格式

概述

转化率优化（CRO, Conversion Rate Optimization）技能组是 marketingskills 项目中的核心技能分类之一，专门用于指导 AI 代理执行各类转化率优化任务。该技能组通过结构化的指令模板，帮助自动化系统分析和改进用户旅程中的关键转化节点。

根据项目文档，转化率优化技能组包含六大核心技能，覆盖从落地页到付费升级的完整用户生命周期。

资料来源：README.md:1-30

技能分类体系

转化率优化技能组按照用户旅程的不同阶段划分为以下六个专门技能：

资料来源：README.md:18-26

技能结构规范

每个转化率优化技能遵循统一的项目结构规范：

skills/{skill-name}/
├── SKILL.md           # 必需 - 主指令文件
├── references/        # 可选 - 补充文档
├── scripts/           # 可选 - 可执行代码
└── assets/            # 可选 - 模板和数据文件

SKILL.md 文件规范

主指令文件必须包含 YAML 前置元数据：

概述

内容与文案技能组是 Marketing Skills 项目中专注于营销内容创作的核心模块，涵盖从文案撰写到视觉内容生成的完整内容营销工作流程。该技能组为营销团队提供了一套标准化的内容创作指南和最佳实践，帮助生成高质量的营销文案、邮件内容、社交媒体帖子以及图像和视频素材。

根据项目架构，内容与文案技能组主要包含以下核心技能：

资料来源：README.md

技能组架构

内容与文案技能组采用模块化设计，各技能既可独立使用，也可组合形成完整的内容营销流程。技能之间存在明确的数据流向和依赖关系：

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

文案编辑（Copy-editing）

文案编辑技能专注于对现有文案进行优化和润色，确保文案达到专业水准。该技能不从头创作内容，而是在既有文案基础上进行改进，提升可读性、说服力和品牌一致性。

适用场景：

• 现有营销页面的A/B测试变体创建
• 品牌语言规范化调整
• 语法和格式修正
• 语气和调性统一

冷启动邮件（cold-email）

冷启动邮件技能专为 B2B 销售场景设计，帮助营销人员快速生成有效的冷启动外联邮件。该技能涵盖单封邮件撰写和多步骤邮件序列编排。

核心功能：

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

自动化邮件序列（email-sequence）

自动化邮件序列技能帮助营销团队设计和创建多步骤的自动化邮件流程，用于客户培育、欢迎序列、购物车挽回等多种场景。

邮件序列类型：

邮件内容结构： 每封邮件应包含清晰的标题、个性化问候、价值内容、行动号召按钮和退订链接。邮件长度应控制在合理范围内，确保移动端阅读体验。

资料来源：skills/email-sequence/SKILL.md

社交内容（social-content）

社交内容技能专注于生成适合不同社交媒体平台的短格式内容，包括 LinkedIn、Twitter、Instagram 等主流平台的帖子和更新。

平台适配策略：

内容创作原则：

• 保持品牌声音一致性
• 使用强开场白吸引注意力
• 包含明确的互动号召
• 合理使用话题标签和 emoji

资料来源：skills/social-content/SKILL.md

图像创作（image）

图像创作技能提供 AI 驱动的图像生成和设计能力，帮助营销团队快速创建各类视觉素材。该技能支持从提示词生成图像、图像编辑优化以及多尺寸适配输出。

核心功能模块：

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

视频内容（video）

视频内容技能专注于产品演示、教程和营销视频的脚本创作与内容规划。该技能帮助团队高效规划视频结构、撰写吸引人的脚本，并确保视频内容与整体营销策略保持一致。

视频类型支持：

• 产品功能演示
• 操作教程和指南
• 客户成功案例
• 品牌故事和理念传达
• 社交媒体短视频

资料来源：skills/video/SKILL.md

工作流程集成

内容与文案技能组支持与项目的分析和跟踪工具集成，实现内容效果的数据闭环：

graph LR
    A[内容创作] --> B[GA4 分析跟踪]
    A --> C[邮件发送统计]
    A --> D[转化归因]
    
    B --> E[效果优化建议]
    C --> E
    D --> E
    
    E --> A

典型使用场景：

1. 落地页优化流程：使用 copywriting 创建页面文案 → 通过 GA4 设置转化跟踪 → 分析用户行为数据 → 使用 copy-editing 优化文案

1. 邮件营销流程：使用 cold-email 创建外联邮件 → 使用 email-sequence 设计培育序列 → 通过邮件平台发送 → 跟踪打开率和点击率

1. 社交媒体运营：使用 social-content 创建帖子 → 使用 image 生成配图 → 发布到各平台 → 分析互动数据优化内容策略

资料来源：README.md

工具集成

内容与文案技能组与项目中的多种工具实现集成，提供了完整的营销技术栈支持：

资料来源：tools/REGISTRY.md

最佳实践

内容质量标准

• 所有文案应经过至少一轮审查和修改
• 保持品牌声音和语调的一致性
• 确保内容的准确性和可验证性
• 针对不同渠道进行内容适配

版本控制与迭代

graph TD
    A[初稿创作] --> B[内部审查]
    B --> C{通过审核?}
    C -->|否| D[修改润色]
    D --> B
    C -->|是| E[A/B 测试变体]
    E --> F[数据分析]
    F --> G{效果达标?}
    G -->|否| D
    G -->|是| H[正式发布]

性能指标监控

内容效果应通过以下关键指标进行监控：

• 落地页：转化率、跳出率、停留时间
• 邮件：打开率、点击率、退订率
• 社交：互动率、分享数、关注增长

总结

内容与文案技能组为营销团队提供了从策略规划到执行落地的完整内容创作解决方案。通过模块化的技能设计和灵活的组合方式，团队可以根据具体需求选择合适的技能组合，快速生成高质量的营销内容。技能的标准化和最佳实践的固化，确保了内容产出的一致性和可扩展性。

概述

SEO与发现技能组是Marketing Skills仓库中专注于提升内容可发现性和搜索引擎排名的技能集合。该技能组包含七个核心技能模块，涵盖了从技术SEO审计到AI驱动的内容优化、从程序化页面生成到结构化数据标记的完整SEO工作流程。

这些技能协同工作，帮助营销团队系统性地优化网站的搜索可见性，同时支持程序化SEO策略以实现规模化内容生产。技能组的设计遵循模块化原则，每个技能可以独立使用，也可以组合形成完整的SEO优化方案。

资料来源：README.md

技能组架构

graph TD
    subgraph "SEO与发现技能组"
        A[seo-audit<br/>SEO审计]
        B[ai-seo<br/>AI驱动SEO]
        C[programmatic-seo<br/>程序化SEO]
        D[site-architecture<br/>网站架构]
        E[competitor-alternatives<br/>竞品替代]
        F[schema-markup<br/>结构化数据]
        G[aso-audit<br/>ASO审计]
    end
    
    A --> D
    A --> F
    B --> F
    C --> D
    E --> A
    G --> A

核心技能详解

1. SEO审计 (seo-audit)

SEO审计技能负责对网站进行全面的技术健康检查，识别影响搜索排名的技术问题。

#### 主要功能

#### 集成工具

该技能依赖以下集成工具进行数据收集和分析：

• Google Search Console - 搜索表现数据、索引状态监控
• Ahrefs - 域名评级、反向链接分析、关键词排名
• Screaming Frog - 网站爬取和技术问题识别

资料来源：tools/integrations/google-search-console.md

2. AI驱动SEO (ai-seo)

AI驱动SEO技能专注于优化内容以获得AI助手的引用和推荐，这代表了搜索优化的新方向。

#### 生成引擎优化模式

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

3. 程序化SEO (programmatic-seo)

程序化SEO技能用于大规模页面生成，通过模板和数据驱动的方式批量创建针对特定关键词的优化页面。

#### 适用场景

#### 内容模型

程序化SEO依赖结构化的内容类型定义，包括页面元数据和可编程字段。内容模型需要定义动态字段以支持程序化内容生成，同时包含标准SEO字段如metaTitle、metaDescription和slug。

资料来源：skills/programmatic-seo/SKILL.md

4. 网站架构 (site-architecture)

网站架构技能定义了页面的层级结构、导航系统和URL规范，确保搜索引擎能够有效抓取和理解网站内容。

#### 导航模式

简单导航头

适用于小型企业、简单SaaS或作品集网站，遵循以下规则：

• Logo始终链接到首页
• CTA按钮位于最右侧，视觉上突出
• 按优先级排序（访问量最高的优先）
• 当前页面获得视觉指示器（下划线、加粗或颜色变化）

大型菜单导航

适用于功能丰富的SaaS、电子商务或有大量内容分类的网站：

• 2-4列布局
• 按功能区域、用例或受众逻辑分组
• 底部包含"查看全部"链接
• 大型菜单内不嵌套下拉菜单

#### 内容模型

网站架构技能定义了核心内容类型及其字段：

#### SEO字段清单

每个页面级内容类型都需要配置以下字段：

资料来源：skills/site-architecture/references/navigation-patterns.md

5. 竞品替代页面 (competitor-alternatives)

竞品替代技能用于创建针对竞争对手的比较页面，帮助用户发现和评估替代产品。

#### 研究流程

graph TD
    A[竞品URL] --> B[Firecrawl Map<br/>发现站点结构]
    B --> C[识别关键页面]
    C --> D[Firecrawl Scrape<br/>抓取页面内容]
    D --> E[提取定位和功能信息]
    E --> F[生成竞品档案]
    F --> G[创建替代对比页面]

#### 优先抓取页面类型

#### 数据工具

• Firecrawl Map - 发现站点结构，识别关键页面
• Firecrawl Scrape - 批量抓取页面内容
• Firecrawl Extract - 使用schema提取结构化数据

资料来源：skills/competitor-profiling/SKILL.md

6. 结构化数据 (schema-markup)

结构化数据技能为网页添加Schema.org标记，帮助搜索引擎理解页面内容并生成丰富搜索结果。

#### 支持的Schema类型

Organization

用于品牌和组织信息，声明站点名称、标志和社交资料。

WebSite

用于整个网站，包含站点名称和搜索框配置，支持Sitelink搜索框。

Article/BlogPosting

用于博客文章和新闻，包含标题、图片、发布日期、作者和发布者信息。

Product

用于电商或SaaS产品页面，包含名称、图片、描述、价格和库存状态。

#### JSON-LD格式示例

{
  "@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

7. ASO审计 (aso-audit)

ASO（应用商店优化）审计技能专注于提升移动应用在应用商店中的可见性，包括App Store和Google Play。

#### 审计维度

资料来源：skills/aso-audit/SKILL.md

工作流程整合

完整SEO优化流程

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

技能间依赖关系

工具集成总览

资料来源：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工作流程。

概述

增长与收入技能组是 marketingskills 项目中专注于业务扩张、变现策略和销售运营的技能集合。该技能组涵盖从获客增长到客户保留的完整业务增长周期，旨在帮助 SaaS 企业实现可持续的收入增长。

根据项目结构，该技能组包含以下核心领域：

资料来源：README.md

架构总览

增长与收入技能组采用分层架构，涵盖从获客到留存的全链路。

graph TD
    subgraph "获客层"
        PA[paid-ads<br/>付费广告]
        CC[co-marketing<br/>联合营销]
        FT[free-tool-strategy<br/>免费工具策略]
        RP[referral-program<br/>推荐计划]
    end

    subgraph "转化层"
        PC[page-cro<br/>页面优化]
        SF[signup-flow-cro<br/>注册流程]
        OB[onboarding-cro<br/>激活流程]
    end

    subgraph "变现层"
        PS[pricing-strategy<br/>定价策略]
        LS[launch-strategy<br/>发布策略]
        SE[sales-enablement<br/>销售赋能]
    end

    subgraph "留存层"
        CP[churn-prevention<br/>流失防止]
        RV[revops<br/>收入运营]
    end

    subgraph "策略层"
        MI[marketing-ideas<br/>营销创意]
        MP[marketing-psychology<br/>营销心理学]
    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 预测工具、行业基准工具
• 获客机制：通过工具使用引导用户留下联系方式
• 数据收集：在用户使用工具过程中收集行为数据

graph LR
    A[用户访问<br/>免费工具] --> B[使用工具<br/>获得价值]
    B --> C[查看结果<br/>需要邮箱]
    C --> D[获取报告<br/>留下联系方式]
    D --> E[触发线索<br/>培育流程]
    
    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)

产品发布技能包含完整的发布流程：

graph TD
    P1[预热期<br/>建立期待] --> P2[预告期<br/>功能揭秘]
    P2 --> P3[发布日<br/>全面上线]
    P3 --> P4[跟进期<br/>用户反馈]
    P4 --> P5[优化期<br/>迭代改进]
    
    style P1 fill:#fff3e0
    style P3 fill:#ffcdd2
    style P5 fill:#c8e6c9

#### 2.4 定价策略 (pricing-strategy)

定价策略技能覆盖定价、包装和商业化的各个方面：

定价心理学要素：

• 锚定价格设置
• 视觉层次引导
• 价值对比框架
• 套餐捆绑策略

3. 销售赋能技能

#### 3.1 收入运营 (revops)

收入运营技能覆盖销售运营的完整生命周期：

graph TD
    LE[线索生成<br/>Lead Generation] --> LEQ[线索资质认定<br/>Lead Qualification]
    LEQ --> LH[线索分配<br/>Lead Handoff]
    LH --> SQ[销售线索<br/>Sales Qualified]
    SQ --> OP[商机管道<br/>Opportunity]
    OP --> CN[谈判<br/>Negotiation]
    CN --> CW[成交<br/>Closed Won]
    CW --> IR[初始收入<br/>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)

销售赋能技能提供标准化的销售辅助材料：

4. 转化优化技能

#### 4.1 页面转化优化 (page-cro)

营销页面优化涵盖以下关键元素：

首屏优化要素：

• 价值主张清晰表达
• 社会认同元素展示
• 主要 CTA 突出显示

信任信号布局：

• 客户 logo 展示
• 评价和推荐
• 安全认证标识

#### 4.2 注册流程优化 (signup-flow-cro)

注册流程优化关注转化漏斗的每一步：

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)

流失防止技能覆盖整个客户生命周期：

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

流失防止策略：

6. 付费分发技能

#### 6.1 付费广告 (paid-ads)

付费广告技能覆盖主流广告平台的投放策略：

广告活动结构：

• 活动层级：Campaign → Ad Set → Ad
• 受众分层：人口统计 + 兴趣 + 行为
• 出价策略：手动出价 vs 目标 ROAS

#### 6.2 广告创意 (ad-creative)

广告创意技能支持批量生成和迭代优化：

• 多变体 A/B 测试
• 素材规格适配（图片、视频、轮播）
• 文案模板库
• 效果追踪与分析

工具集成

增长与收入技能组支持与多种营销工具集成：

客户数据与情报

ZoomInfo 关键接口：

// 联系人搜索
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": ["[email protected]"]
}

资料来源：tools/integrations/zoominfo.md

邮件营销

Postmark 核心功能：

• 邮件模板创建与管理
• 批量发送与统计
• 退信处理与激活
• 打开和点击追踪

资料来源：tools/integrations/postmark.md

内容管理

Sanity 内容类型设计：

资料来源：skills/content-strategy/references/headless-cms.md

最佳实践

增长策略框架

1. 测量优先：建立完整的数据追踪体系
2. 快速迭代：小步快跑，持续优化
3. 用户洞察：深入理解用户旅程和痛点
4. 跨职能协作：增长、产品、销售协同

收入运营流程

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 - 学习如何添加新技能
• 项目架构：CLAUDE.md - 项目结构说明
• 站点架构：skills/site-architecture/SKILL.md - 页面层次结构设计

总结

增长与收入技能组构成了 marketingskills 项目中实现业务增长的核心能力矩阵。该技能组从获客增长（付费广告、联合营销、推荐计划）到转化优化（页面优化、注册流程、入职激活），再到变现策略（定价策略、销售赋能）和客户留存（收入运营、流失防止），覆盖了 SaaS 企业增长的全生命周期。

通过灵活组合这些技能，营销团队可以构建完整的增长引擎，实现可持续的收入增长目标。

概述

CLI工具集是marketingskills项目中的命令行接口模块，位于tools/clis/目录下。该模块为市场营销专业人员提供了一套统一的命令行工具，用于管理与Google Ads、Meta Ads、Google Analytics 4、HubSpot等主流营销平台的交互。

CLI工具集的主要目标是简化营销自动化工作流程，使营销人员能够在终端环境中直接执行广告管理、分析查询和CRM操作等任务。通过统一的命令行界面，用户可以快速集成到现有的开发或自动化流程中。

架构设计

graph TD
    subgraph "CLI工具集架构"
        CLI["CLI入口<br/>node cli-name.js"]
        REGISTRY["工具注册表<br/>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工具集的核心配置文件，定义了所有可用工具的元数据。每个工具条目包含以下字段：

名称字段规则：

• 仅使用小写字母、数字和连字符
• 不能以连字符开头或结尾
• 禁止连续连字符
• 必须与父目录名称完全匹配

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的访问。该工具允许用户查询网站和应用的分析数据。

关键指标类型：

HubSpot CLI

HubSpot命令行工具（tools/clis/hubspot.js）集成HubSpot CRM API，支持联系人、公司和交易管理。

核心功能：

• 联系人CRUD操作
• 公司数据管理
• 交易管道追踪
• 营销自动化工作流触发

Optimizely CLI

Optimizely命令行工具（tools/clis/optimizely.js）提供实验平台的管理能力。

命令结构：

optimizely <command> [options]

可用命令：
  campaigns   campaigns list --project-id <id>
  experiments experiments list --project-id <id>
  pages       pages list --project-id <id>
  
选项参数：
  --page <n>          页码
  --per-page <n>      每页数量
  --status <status>   状态过滤（not_started|running|paused|archived）

Livestorm CLI

Livestorm命令行工具（tools/clis/livestorm.js）管理虚拟活动和在线研讨会。

命令体系：

数据模型

通用CLI输出格式

所有CLI工具采用统一的JSON输出格式，便于后续处理和集成。

// 成功响应
{
  "data": [...],
  "metadata": {
    "page": 1,
    "perPage": 20,
    "total": 100
  }
}

// 错误响应
{
  "error": "错误消息",
  "code": "ERROR_CODE"
}

状态流转

stateDiagram-v2
    [*] --> 初始化: CLI启动
    初始化 --> 认证: 加载配置
    认证 --> 就绪: Token验证
    就绪 --> 执行: 接收命令
    执行 --> 处理: 解析参数
    处理 --> API调用: 构建请求
    API调用 --> 响应解析: 获取结果
    响应解析 --> 输出: 格式化JSON
    输出 --> [*]: 完成
    认证 --> 错误: 认证失败
    执行 --> 错误: 参数错误
    错误 --> [*]: 退出

工具使用工作流

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
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
└── ...

工具文件应遵循以下结构：

#!/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/
• 工具注册表配置：tools/REGISTRY.md
• 源码示例：tools/clis/

Pitfall Log / 踩坑日志

项目：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