213 lines
9.5 KiB
Markdown
213 lines
9.5 KiB
Markdown
# MAOMOMO 文章生成器
|
||
|
||
这是一个面向 Codex 的中文写作技能，用来生成 MAOMOMO / 猫MOMO 风格的出海金融实操文章、文章大纲、发布用 Markdown、SEO 优化稿、独立配图 assets、ZIP 发布包，以及小红书卡片 / 多图 / 3:4 / 9:16 竖版 PNG 交付。
|
||
|
||
新版流程参考了 `codex-ppt-skill` 的阶段化设计：先确认来源和文章口径，再确认大纲 / 卡片结构与配图规划，最后写作或整理小红书文案、生成配图、QA、写入 `final_manifest.json`，并按渠道打包或 GitHub 分批交付。这样可以降低金融活动文章里最常见的翻车点：旧规则混入新稿、来源没读全、图片残留旧口径、只给正文不交付文件。
|
||
|
||
## 适用场景
|
||
|
||
适合以下内容：
|
||
|
||
- 港卡、香港银行、香港信用卡、外卡用卡攻略
|
||
- 银行活动、信用卡返现、券商迎新、羊毛活动
|
||
- 开户教程、保号教程、转账 / 入金 / 出金教程
|
||
- 美股券商、数字货币、欧元通道、汇款路径
|
||
- 避坑经验、实测记录、活动规则整理
|
||
- 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、final_manifest 和后端选择
|
||
├── github-delivery.md # GitHub 交付仓库、专用 KEY 和推送门禁
|
||
└── delivery-rules.md # 完整交付、GitHub 分批、打包和最终检查
|
||
```
|
||
|
||
## 安装方式
|
||
|
||
将本目录放到 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
|
||
把这个活动做成小红书 3:4 多图卡片，先给我确认 2D / 3D 视觉方向。
|
||
```
|
||
|
||
## 推荐提示词
|
||
|
||
生成完整文章：
|
||
|
||
```text
|
||
使用 $maomomo-article-writer，基于以下资料生成一篇发布用 Markdown 文章。要求包含头部元数据、太长不看版、操作步骤、常见翻车点、最后提醒、来源，以及 MAOMOMO 猫咪封面图提示词。
|
||
资料：
|
||
【粘贴活动规则、截图说明、链接或实测记录】
|
||
```
|
||
|
||
只生成大纲：
|
||
|
||
```text
|
||
使用 $maomomo-article-writer，先给我一篇关于【主题】的 MAOMOMO 风格大纲。请包含 5 个标题备选、文章结构、还需要确认的事实、图片规划。
|
||
```
|
||
|
||
只生成配图：
|
||
|
||
```text
|
||
使用 $maomomo-article-writer，为【主题】生成 MAOMOMO 风格封面图提示词、正文截图槽位和一张信息图提示词。不要写完整正文。
|
||
```
|
||
|
||
小红书卡片：
|
||
|
||
```text
|
||
使用 $maomomo-article-writer，做一组小红书 9:16 多图卡片。默认 2D 扁平风，要求每张独立 PNG，最后走 GitHub 分批交付。
|
||
```
|
||
|
||
GitHub 交付配置：
|
||
|
||
```text
|
||
使用 $maomomo-article-writer，先引导我配置 GitHub 交付仓库和专用 KEY，之后小红书卡片都走 GitHub 分批交付。
|
||
```
|
||
|
||
改写已有文章：
|
||
|
||
```text
|
||
使用 $maomomo-article-writer，把下面这篇文章改成 MAOMOMO 风格。要求结论前置、步骤更清楚、补充翻车点、保留来源和风险提示。
|
||
【粘贴原文】
|
||
```
|
||
|
||
## 输出内容
|
||
|
||
完整文章通常包含：
|
||
|
||
- 发布用头部元数据
|
||
- 标题和封面图提示词
|
||
- “太长不看版”
|
||
- 活动简介 / 背景
|
||
- 操作步骤或“怎么吃满”
|
||
- 关键条件
|
||
- 常见翻车点
|
||
- 实测、时间线或常见答疑
|
||
- 最后提醒和免责声明
|
||
- 来源链接
|
||
- 正文截图槽位和必要的信息图提示词
|
||
- `article.md`
|
||
- `assets/` 独立 PNG 配图目录
|
||
- `article_package.zip`
|
||
|
||
小红书卡片通常包含：
|
||
|
||
- 20 字内标题
|
||
- 小红书正文和 3-6 个话题标签
|
||
- 多张 3:4 或 9:16 独立 PNG
|
||
- `prompts/`、`slide_jobs.json`、`slide_run_state.json`
|
||
- `final_manifest.json`
|
||
- 可选 `watermarked_assets/`：用 `uv run python scripts/maomomo_tile_watermark.py` 生成 `MAOMOMO.COM` 45° 自动对比色半透明平铺水印版
|
||
- GitHub 分批链接
|
||
|
||
GitHub 分批交付前，技能会先引导配置：
|
||
|
||
- 专用私有交付仓库，例如 `OWNER/maomomo-delivery`
|
||
- `MAOMOMO_GITHUB_REPO`、`MAOMOMO_GITHUB_BRANCH`、`MAOMOMO_GITHUB_BASE_PATH`
|
||
- GitHub CLI 登录、fine-grained PAT，或 SSH deploy key
|
||
- 最小权限原则：只给交付仓库写入权限
|
||
- 密钥不进入聊天、prompt、manifest、状态文件、README、日志或 commit
|
||
|
||
如果事实不完整，技能会使用 `【待确认：...】` 标记缺口，而不是编造数字、日期、奖励或链接。
|
||
|
||
## 默认流程
|
||
|
||
完整交付任务通常按以下步骤执行：
|
||
|
||
1. 识别任务模式：完整文章、大纲、SEO 优化、改稿、配图或小红书卡片。
|
||
2. 读取来源并列出已读 / 未读材料，整理事实表和待确认项。
|
||
3. 确认文章范围、大纲 / 卡片结构、标题方向、核心口径和图片规划。
|
||
4. 写作或优化发布用 Markdown。
|
||
5. 确认配图风格；小红书卡片需先确认 2D / 3D 和 3:4 / 9:16，再生成或准备独立 PNG。
|
||
6. 检查来源、图片路径、风险提示、编辑痕迹、ZIP 或 `final_manifest.json`；需要 GitHub 交付时先确认仓库和专用 KEY 配置，最后交付文件路径或 GitHub 分批链接。
|
||
|
||
用户明确说“只要文字”“只要大纲”“不要图片”“不要打包”时，会按用户限制执行，不强行创建完整发布包。
|
||
|
||
## 资料准备建议
|
||
|
||
为了得到更可靠的文章，最好提供：
|
||
|
||
- 官方活动页、条款 PDF、公告或 App 截图
|
||
- 活动起止日期、奖励规则、封顶、门槛、资格限制
|
||
- 实测到账时间、账单显示、MCC、客服回复
|
||
- 邀请码、专属链接、注意事项
|
||
- 已有 MAOMOMO 参考文章链接
|
||
- 想要的文章用途：发布用 Markdown、大纲、改写、配图提示词
|
||
|
||
## 风格原则
|
||
|
||
文章应当：
|
||
|
||
- 先给结论，再讲步骤
|
||
- 多写实操数字、路径和坑点
|
||
- 语气像懂行朋友，不像官方宣传稿
|
||
- 涉及金融、券商、银行、数字货币和合规内容时，保留谨慎措辞
|
||
- 配图统一使用白橘猫、暖橙色、干净金融科技教程风
|
||
- 如果用户没有指定配图风格，先在 `recommended-styles.md` 和 `image-styles/` 中按文章类型推荐 2-3 个方向，例如 `clean-professional`、`data-card-dashboard`、`handdrawn-note`、`e-ink-editorial` 或 `xiaohongshu-vertical`。
|
||
- 小红书卡片出图前必须确认 `2D 扁平风` / `3D 轻拟物风` 和 `3:4` / `9:16`；用户没指定时默认推荐 2D，并按原生竖版重新构图，不能把横版图压进竖图。用户要求防盗图 / 水印时，可用 `uv run python scripts/maomomo_tile_watermark.py --input assets --output watermarked_assets` 生成 `MAOMOMO.COM` 45° 自动对比色半透明平铺水印版，并保留无水印原图。
|
||
|
||
文章不应当：
|
||
|
||
- 承诺一定获批、一定到账、稳赚或绝对安全
|
||
- 伪造真实 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、final manifest、GitHub 批次记录和脚本用法写在 `references/image-generation.md`，脚本为 `scripts/maomomo_image_gen.py` 和 `scripts/maomomo_job_state.py`。
|
||
- GitHub 交付仓库、专用 KEY / token / deploy key、环境变量、隐私边界和推送前检查写在 `references/github-delivery.md`。
|
||
- 完整交付、ZIP、GitHub 分批、附件和最终检查写在 `references/delivery-rules.md`。
|
||
- 修改技能展示名称或默认提示语时，同步更新 `agents/openai.yaml`。
|
||
- 如果新增具体行业资料、平台规则或长期复用模板，优先放入 `references/`，避免让 `SKILL.md` 过长。
|