maomomo-article-writer/README.md

176 lines
7.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 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-styles/ # 参考 codex-ppt 风格库拆分的出图风格 brief
├── 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、大纲、改写、配图提示词
## 风格原则
文章应当:
- 先给结论,再讲步骤
- 多写实操数字、路径和坑点
- 语气像懂行朋友,不像官方宣传稿
- 涉及金融、券商、银行、数字货币和合规内容时,保留谨慎措辞
- 配图统一使用白橘猫、暖橙色、干净金融科技教程风
- 如果用户没有指定配图风格,先在 `recommended-styles.md``image-styles/` 中按文章类型推荐 2-3 个方向,例如 `clean-professional`、`data-card-dashboard`、`handdrawn-note`、`e-ink-editorial` 或 `xiaohongshu-vertical`
文章不应当:
- 承诺一定获批、一定到账、稳赚或绝对安全
- 伪造真实 App 截图
- 把过期活动写成当前活动
- 用大段空泛背景拖慢读者获取答案
## 维护说明
- 主要触发说明和执行规则写在 `SKILL.md`
- 详细文章模板、标题套路和常用词写在 `references/style-guide.md`
- 来源核查、时效性、冲突口径和风险表达写在 `references/source-and-fact-check.md`
- 配图类型、猫咪视觉、文件命名和图片 QA 写在 `references/visual-assets.md`
- 推荐配图风格、适用场景和提示词片段写在 `references/recommended-styles.md`
- 具体出图风格 brief 放在 `references/image-styles/`,结构参考 `codex-ppt-skill` 的风格库。
- 图片 API/CLI fallback、批量 manifest 和脚本用法写在 `references/image-generation.md`,脚本为 `scripts/maomomo_image_gen.py`
- 完整交付、ZIP、附件和最终检查写在 `references/delivery-rules.md`
- 修改技能展示名称或默认提示语时,同步更新 `agents/openai.yaml`
- 如果新增具体行业资料、平台规则或长期复用模板,优先放入 `references/`,避免让 `SKILL.md` 过长。