# MAOMOMO 文章生成器

这是一个面向 Codex 的中文写作技能，用来生成 MAOMOMO / 猫MOMO 风格的出海金融实操文章、文章大纲、发布用 Markdown、SEO 优化稿、独立配图 assets 和 ZIP 发布包。

新版流程参考了 `codex-ppt-skill` 的阶段化设计：先确认来源和文章口径，再确认大纲与配图规划，最后写作、生成配图、QA 和打包交付。这样可以降低金融活动文章里最常见的翻车点：旧规则混入新稿、来源没读全、图片残留旧口径、只给正文不交付文件。

## 适用场景

适合以下内容：

- 港卡、香港银行、香港信用卡、外卡用卡攻略
- 银行活动、信用卡返现、券商迎新、羊毛活动
- 开户教程、保号教程、转账 / 入金 / 出金教程
- 美股券商、数字货币、欧元通道、汇款路径
- 避坑经验、实测记录、活动规则整理
- MAOMOMO 风格封面图、截图槽位和信息图提示词

不适合直接生成投资建议、法律意见、税务结论或任何“保证获批 / 稳赚 / 一定到账”的承诺型内容。

## 文件结构

```text
maomomo-article-writer/
├── SKILL.md                 # Codex 实际读取的技能说明
├── README.md                # 面向使用者的说明文档
├── agents/
│   └── openai.yaml          # 技能展示名称、简介和默认提示语
├── scripts/
│   └── maomomo_image_gen.py # OpenAI 兼容 API/CLI 配图 fallback
└── references/
    ├── source-and-fact-check.md # 来源读取、事实核查和风险口径
    ├── style-guide.md           # MAOMOMO 写作风格、模板和文章骨架
    ├── visual-assets.md         # 配图清单、视觉规则和图片 QA
    ├── recommended-styles.md    # 推荐配图风格和提示词片段
    ├── image-generation.md      # 图片生成脚本、manifest 和后端选择
    └── delivery-rules.md        # 完整交付、打包和最终检查
```

## 安装方式

将本目录放到 Codex 可发现的 skills 目录中，例如：

```powershell
C:\Users\<你的用户名>\.codex\skills\maomomo-article-writer
```

如果已经在其他目录开发，可以把整个文件夹复制或同步到 `.codex\skills`。目录名建议保持为：

```text
maomomo-article-writer
```

## 基本用法

在 Codex 中可以直接点名技能：

```text
使用 $maomomo-article-writer 写一篇汇丰香港环球转账到蚂蚁澳门的保姆式教程。
```

也可以用自然语言触发：

```text
帮我写一篇 MAOMOMO 风格的港卡返现攻略，要有封面图提示词和截图槽位。
```

```text
把这个银行活动整理成猫MOMO风格文章，重点写怎么吃满和常见翻车点。
```

## 推荐提示词

生成完整文章：

```text
使用 $maomomo-article-writer，基于以下资料生成一篇发布用 Markdown 文章。要求包含头部元数据、太长不看版、操作步骤、常见翻车点、最后提醒、来源，以及 MAOMOMO 猫咪封面图提示词。
资料：
【粘贴活动规则、截图说明、链接或实测记录】
```

只生成大纲：

```text
使用 $maomomo-article-writer，先给我一篇关于【主题】的 MAOMOMO 风格大纲。请包含 5 个标题备选、文章结构、还需要确认的事实、图片规划。
```

只生成配图：

```text
使用 $maomomo-article-writer，为【主题】生成 MAOMOMO 风格封面图提示词、正文截图槽位和一张信息图提示词。不要写完整正文。
```

改写已有文章：

```text
使用 $maomomo-article-writer，把下面这篇文章改成 MAOMOMO 风格。要求结论前置、步骤更清楚、补充翻车点、保留来源和风险提示。
【粘贴原文】
```

## 输出内容

完整文章通常包含：

- 发布用头部元数据
- 标题和封面图提示词
- “太长不看版”
- 活动简介 / 背景
- 操作步骤或“怎么吃满”
- 关键条件
- 常见翻车点
- 实测、时间线或常见答疑
- 最后提醒和免责声明
- 来源链接
- 正文截图槽位和必要的信息图提示词
- `article.md`
- `assets/` 独立 PNG 配图目录
- `article_package.zip`

如果事实不完整，技能会使用 `【待确认：...】` 标记缺口，而不是编造数字、日期、奖励或链接。

## 默认流程

完整交付任务通常按以下步骤执行：

1. 识别任务模式：完整文章、大纲、SEO 优化、改稿、配图或小红书版。
2. 读取来源并列出已读 / 未读材料，整理事实表和待确认项。
3. 确认文章范围、大纲、标题方向、核心口径和图片规划。
4. 写作或优化发布用 Markdown。
5. 确认配图风格，生成或准备独立 PNG 配图，插入 Markdown。
6. 检查来源、图片路径、风险提示、编辑痕迹和 ZIP 内容，最后交付文件路径。

用户明确说“只要文字”“只要大纲”“不要图片”“不要打包”时，会按用户限制执行，不强行创建完整发布包。

## 资料准备建议

为了得到更可靠的文章，最好提供：

- 官方活动页、条款 PDF、公告或 App 截图
- 活动起止日期、奖励规则、封顶、门槛、资格限制
- 实测到账时间、账单显示、MCC、客服回复
- 邀请码、专属链接、注意事项
- 已有 MAOMOMO 参考文章链接
- 想要的文章用途：发布用 Markdown、大纲、改写、配图提示词

## 风格原则

文章应当：

- 先给结论，再讲步骤
- 多写实操数字、路径和坑点
- 语气像懂行朋友，不像官方宣传稿
- 涉及金融、券商、银行、数字货币和合规内容时，保留谨慎措辞
- 配图统一使用白橘猫、暖橙色、干净金融科技教程风
- 如果用户没有指定配图风格，先在 `warm-fintech-guide`、`data-card-dashboard`、`clean-editorial`、`handdrawn-note`、`xiaohongshu-vertical` 中推荐 2-3 个方向。

文章不应当：

- 承诺一定获批、一定到账、稳赚或绝对安全
- 伪造真实 App 截图
- 把过期活动写成当前活动
- 用大段空泛背景拖慢读者获取答案

## 维护说明

- 主要触发说明和执行规则写在 `SKILL.md`。
- 详细文章模板、标题套路和常用词写在 `references/style-guide.md`。
- 来源核查、时效性、冲突口径和风险表达写在 `references/source-and-fact-check.md`。
- 配图类型、猫咪视觉、文件命名和图片 QA 写在 `references/visual-assets.md`。
- 推荐配图风格、适用场景和提示词片段写在 `references/recommended-styles.md`。
- 图片 API/CLI fallback、批量 manifest 和脚本用法写在 `references/image-generation.md`，脚本为 `scripts/maomomo_image_gen.py`。
- 完整交付、ZIP、附件和最终检查写在 `references/delivery-rules.md`。
- 修改技能展示名称或默认提示语时，同步更新 `agents/openai.yaml`。
- 如果新增具体行业资料、平台规则或长期复用模板，优先放入 `references/`，避免让 `SKILL.md` 过长。