maomomo-article-writer/README.md

MAOMOMO 文章生成器

这是一个面向 Codex 的中文写作技能，用来生成 MAOMOMO / 猫MOMO 风格的出海金融实操文章、文章大纲、发布用 Markdown、SEO 优化稿、独立配图 assets、ZIP 发布包，以及小红书卡片 / 多图 / 3:4 / 9:16 竖版 PNG 交付。

新版流程参考了 codex-ppt-skill 的阶段化设计：先确认来源和文章口径，再确认大纲 / 卡片结构与配图规划，最后写作或整理小红书文案、生成配图、QA、写入 final_manifest.json，并按渠道打包或 GitHub 分批交付。这样可以降低金融活动文章里最常见的翻车点：旧规则混入新稿、来源没读全、图片残留旧口径、只给正文不交付文件。

适用场景

适合以下内容：

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

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

文件结构

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 目录中，例如：

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

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

maomomo-article-writer

基本用法

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

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

也可以用自然语言触发：

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

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

把这个活动做成小红书 3:4 多图卡片，先给我确认 2D / 3D 视觉方向。

推荐提示词

生成完整文章：

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

只生成大纲：

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

只生成配图：

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

小红书卡片：

使用 $maomomo-article-writer，做一组小红书 9:16 多图卡片。默认 2D 扁平风，要求每张独立 PNG，最后走 GitHub 分批交付。

GitHub 交付配置：

使用 $maomomo-article-writer，先引导我配置 GitHub 交付仓库和专用 KEY，之后小红书卡片都走 GitHub 分批交付。

改写已有文章：

使用 $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 过长。