拉尔夫营销专家

一个Claude Code 插件，为 SaaS 内容营销提供自主的 AI 文案撰写工具。

DeepWiki：点击此处了解更多

采用 拉尔夫·威格姆模式——一种在你熟睡时仍能持续产出内容的迭代式 AI 循环。

安装

选项 1：通过市场添加（推荐）

# 在 Claude Code 中，将仓库添加到市场：
/plugin marketplace add muratcankoylan/ralph-wiggum-marketer

# 然后安装插件：
/plugin install ralph-wiggum-marketer@muratcankoylan-ralph-wiggum-marketer

选项 2：本地测试（用于开发）

# 克隆仓库
git clone https://github.com/muratcankoylan/ralph-wiggum-marketer.git

# 使用插件目录运行 Claude Code
claude --plugin-dir ./ralph-wiggum-marketer

选项 3：交互式插件管理器

# 打开插件管理器：
/plugin

# 在交互式界面中浏览、搜索并安装

快速入门

# 1. 初始化一个新的内容项目
/ralph-init

# 2. 随时查看进度
/ralph-status

# 3. 如需取消，可执行
/ralph-cancel

命令

命令	描述
/ralph-init	在当前目录下初始化新内容项目
/ralph-marketer	启动自主文案撰写循环
/ralph-status	检查内容流程及进度
/ralph-cancel	取消当前运行的循环

工作原理

┌──────────────────────────────────────────────────────────────────┐
│                     多智能体生态系统                        │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌─────────────┐   ┌─────────────┐   ┌─────────────┐             │
│  │ 趋势洞察者  │   │ 研究助手    │   │ 产品/营销   │             │
│  │   代理      │   │   代理      │   │  团队       │             │
│  └──────┬──────┘   └──────┬──────┘   └──────┬──────┘             │
│         │                 │                 │                    │
│         ▼                 ▼                 ▼                    │
│  ┌────────────────────────────────────────────────────┐          │
│  │              SQLite 内容数据库               │          │
│  │  • 趋势     • 研究     • 沟通策略      │          │
│  └────────────────────────┬───────────────────────────┘          │
│                           │                                      │
│                           ▼                                      │
│  ┌────────────────────────────────────────────────────┐          │
│  │           拉尔夫文案撰写者                     │          │
│  │                                                     │         │
│  │   读取输入 → 规划内容 → 撰写初稿     │          │
│  │   → 审核并迭代 → 发布                 │          │
│  │                                                     │         │
│  │   记忆：git 提交记录 + progress.txt + prd.json    │          │
│  └────────────────────────────────────────────────────┘          │
│                           │                                      │
│                           ▼                                      │
│                    已发布的内容                             │
│              （博客、案例研究、社交媒体、新闻通讯）          │
└──────────────────────────────────────────────────────────────────┘

拉尔夫循环

1. 读取 PRD：检查 scripts/ralph/prd.json 中的任务
2. 查看进度：阅读 scripts/ralph/progress.txt 获取经验总结
3. 选择任务：找到 passes: false 且优先级最高的故事
4. 执行：按照验收标准完成任务
5. 验证：运行测试确保质量
6. 提交：将进展保存至 git
7. 更新：标记任务完成，并记录学习心得
8. 重复：循环直至所有任务完成

每次迭代都是全新的上下文窗口。记忆则通过文件持久化。

插件结构

ralph-wiggum-marketer/
├── .claude-plugin/
│   └── plugin.json          # 插件清单
├── commands/
│   ├── ralph-marketer.md    # 主循环命令
│   ├── ralph-init.md        # 项目初始化
│   ├── ralph-status.md      # 进度检查
│   └── ralph-cancel.md      # 取消循环
├── skills/
│   └── copywriter/
│       └── SKILL.md         # 文案撰写技能
├── hooks/
│   ├── hooks.json           # 钩子配置
│   └── stop-hook.sh         # 循环继续钩子
├── scripts/
│   └── src/                 # 数据库及工具脚本
├── templates/
│   ├── prd.json             # 任务模板
│   ├── progress.txt         # 进度日志模板
│   ├── prompt.md            # 代理指令模板
│   └── package.json         # 项目包配置模板
└── README.md

数据库表结构

输入表（来自其他智能体）

-- 来自趋势洞察者的趋势数据
trends (topic, description, source, relevance_score, status)

-- 来自研究助手的研究报告
research (title, summary, key_findings, data_points, category, status)

-- 来自产品/营销团队的沟通资料
communications (type, title, details, key_messages, target_audience, priority, status)

拉尔夫的工作区

-- 内容规划
content_plan (content_type, title, brief, target_keywords, status)

-- 进度中的稿件
drafts (plan_id, version, content, word_count, feedback)

-- 最终发布的内容
published (plan_id, final_content, meta_description)

-- 活动追踪
agent_log (action, details, created_at)

自定义

添加你自己的内容来源

编辑 src/db/seed.js：

// 添加一条趋势
insertTrend.run(
  '你的趋势主题',
  '趋势描述',
  '信息来源',
  85  // 相关性评分
);

// 添加一条沟通内容
insertComm.run(
  'product_update',
  '你的产品发布会',
  '详细说明其功能',
  JSON.stringify(['关键信息1', '关键信息2']),
  '目标受众',
  1  // 优先级
);

添加你自己的任务

编辑 scripts/ralph/prd.json：

{
  "id": "WRITE-004",
  "title": "撰写你的自定义博客",
  "acceptanceCriteria": [
    "不少于1000字",
    "包含3个数据点",
    "具备强有力的行动号召"
  ],
  "priority": 5,
  "passes": false
}

示例任务

默认的 PRD 包含 12 个故事：

1. SETUP-001：初始化数据库
2. PLAN-001：规划产品发布博客
3. WRITE-001：撰写发布博客初稿
4. PLAN-002：规划思想领导力博客
5. WRITE-002：撰写数据驱动型博客
6. REVIEW-001：审阅并优化草稿
7. PUBLISH-001：发布产品博客
8. PLAN-003：规划案例研究
9. WRITE-003：撰写案例研究
10. SOCIAL-001：创建社交媒体帖子
11. NEWSLETTER-001：起草新闻通讯
12. METRICS-001：记录最终指标

拉尔夫哲学

“拉尔夫是一个 Bash 循环。内存仅通过 Git 历史和文本文件得以保留。每一次迭代都是一次全新的上下文窗口。”

核心原则：

• 小故事 - 必须在一次迭代中完成
• 明确的标准 - 毫无歧义
• 快速反馈 - 每次迭代都进行测试
• 累积式学习 - 模式不断积累
• 坚持就是胜利 - 持续迭代

致谢

• 拉尔夫概念的原创者：@GeoffreyHuntley
• 官方拉尔夫插件：claude-plugins-official
• 视频教程：@mattpocockuk

许可证

MIT

Ralph Marketer 快速上手指南

Ralph Marketer 是一款基于 Claude Code 的插件，专为 SaaS 内容营销打造的自主 AI 文案助手。它采用"Ralph Wiggum 模式”，通过迭代循环在后台自动完成内容创作、审核与发布。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS 或 Windows (WSL2 推荐)
• 核心依赖：
  • Node.js (建议 v18+)
  • Git
  • Claude Code CLI：需已安装并配置好 API Key
• 网络环境：由于涉及 GitHub 仓库拉取及 AI 服务调用，请确保网络畅通。若访问 GitHub 较慢，可配置国内镜像加速或使用代理。

安装步骤

推荐使用 Marketplace 方式安装，最为简便。

方式一：通过 Marketplace 安装（推荐）

在终端中依次执行以下命令：

# 1. 将仓库添加为 Marketplace 源
/plugin marketplace add muratcankoylan/ralph-wiggum-marketer

# 2. 安装插件
/plugin install ralph-wiggum-marketer@muratcankoylan-ralph-wiggum-marketer

方式二：本地开发测试

如果您需要修改源码或进行调试：

# 1. 克隆仓库
git clone https://github.com/muratcankoylan/ralph-wiggum-marketer.git

# 2. 指定插件目录启动 Claude Code
claude --plugin-dir ./ralph-wiggum-marketer

方式三：交互式管理

# 打开插件管理器界面
/plugin
# 在 UI 中搜索 "ralph" 并进行浏览或安装

基本使用

安装完成后，您可以在任何项目目录中通过以下命令启动内容营销工作流。

1. 初始化项目

在当前目录下创建必要的项目结构和配置文件：

/ralph-init

2. 启动自主文案循环

启动 Ralph 代理，它将自动读取任务计划（prd.json），执行调研、写作、审核并发布内容：

/ralph-marketer

提示：该过程是异步迭代的。Ralph 会将每次迭代的记忆保存在 git 提交和文本文件中，即使中断也能恢复进度。

3. 查看进度

随时检查内容流水线和当前任务状态：

/ralph-status

4. 停止任务

如需紧急停止正在运行的循环：

/ralph-cancel

自定义任务（可选）

您可以通过编辑 scripts/ralph/prd.json 来定义自己的内容任务。例如添加一篇自定义博客任务：

{
  "id": "WRITE-004",
  "title": "Write your custom blog",
  "acceptanceCriteria": [
    "At least 1000 words",
    "Includes 3 data points",
    "Has compelling CTA"
  ],
  "priority": 5,
  "passes": false
}

修改后再次运行 /ralph-marketer 即可生效。