hitsword
/
maomomo-article-writer
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

feat: improve maomomo article workflow

main
hitsword 2026-06-27 21:18:51 +08:00
parent f92c4e5e9d
commit 286e28b7f3
6 changed files with 360 additions and 273 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
README.md
View File

@ -1,6 +1,8 @@
# MAOMOMO 文章生成器 # MAOMOMO 文章生成器
这是一个面向 Codex 的中文写作技能，用来生成 MAOMOMO / 猫MOMO 风格的出海金融实操文章、文章大纲、发布用 Markdown 和配图提示词。 这是一个面向 Codex 的中文写作技能，用来生成 MAOMOMO / 猫MOMO 风格的出海金融实操文章、文章大纲、发布用 Markdown、SEO 优化稿、独立配图 assets 和 ZIP 发布包。
新版流程参考了 `codex-ppt-skill` 的阶段化设计：先确认来源和文章口径，再确认大纲与配图规划，最后写作、生成配图、QA 和打包交付。这样可以降低金融活动文章里最常见的翻车点：旧规则混入新稿、来源没读全、图片残留旧口径、只给正文不交付文件。
## 适用场景 ## 适用场景
@ -24,7 +26,10 @@ maomomo-article-writer/
├── agents/ ├── agents/
│ └── openai.yaml # 技能展示名称、简介和默认提示语 │ └── openai.yaml # 技能展示名称、简介和默认提示语
└── references/ └── references/
└── style-guide.md # MAOMOMO 写作风格、模板和图片规则 ├── source-and-fact-check.md # 来源读取、事实核查和风险口径
├── style-guide.md # MAOMOMO 写作风格、模板和文章骨架
├── visual-assets.md # 配图清单、视觉规则和图片 QA
└── delivery-rules.md # 完整交付、打包和最终检查
``` ```
## 安装方式 ## 安装方式
@ -103,9 +108,25 @@ maomomo-article-writer
- 最后提醒和免责声明 - 最后提醒和免责声明
- 来源链接 - 来源链接
- 正文截图槽位和必要的信息图提示词 - 正文截图槽位和必要的信息图提示词
- `article.md`
- `assets/` 独立 PNG 配图目录
- `article_package.zip`
如果事实不完整，技能会使用 `【待确认：...】` 标记缺口，而不是编造数字、日期、奖励或链接。 如果事实不完整，技能会使用 `【待确认：...】` 标记缺口，而不是编造数字、日期、奖励或链接。
## 默认流程
完整交付任务通常按以下步骤执行：
1. 识别任务模式：完整文章、大纲、SEO 优化、改稿、配图或小红书版。
2. 读取来源并列出已读 / 未读材料，整理事实表和待确认项。
3. 确认文章范围、大纲、标题方向、核心口径和图片规划。
4. 写作或优化发布用 Markdown。
5. 生成或准备独立 PNG 配图，插入 Markdown。
6. 检查来源、图片路径、风险提示、编辑痕迹和 ZIP 内容，最后交付文件路径。
用户明确说“只要文字”“只要大纲”“不要图片”“不要打包”时，会按用户限制执行，不强行创建完整发布包。
## 资料准备建议 ## 资料准备建议
为了得到更可靠的文章，最好提供： 为了得到更可靠的文章，最好提供：
@ -137,6 +158,9 @@ maomomo-article-writer
## 维护说明 ## 维护说明
- 主要触发说明和执行规则写在 `SKILL.md`。 - 主要触发说明和执行规则写在 `SKILL.md`。
- 详细文章模板、标题套路、常用词和图片规则写在 `references/style-guide.md`。 - 详细文章模板、标题套路和常用词写在 `references/style-guide.md`。
- 来源核查、时效性、冲突口径和风险表达写在 `references/source-and-fact-check.md`。
- 配图类型、猫咪视觉、文件命名和图片 QA 写在 `references/visual-assets.md`。
- 完整交付、ZIP、附件和最终检查写在 `references/delivery-rules.md`。
- 修改技能展示名称或默认提示语时，同步更新 `agents/openai.yaml`。 - 修改技能展示名称或默认提示语时，同步更新 `agents/openai.yaml`。
- 如果新增具体行业资料、平台规则或长期复用模板，优先放入 `references/`，避免让 `SKILL.md` 过长。 - 如果新增具体行业资料、平台规则或长期复用模板，优先放入 `references/`，避免让 `SKILL.md` 过长。

369
SKILL.md
View File

@ -1,275 +1,120 @@
--- ---
name: maomomo-article-writer name: maomomo-article-writer
description: 生成符合 maomomo / 猫momo 风格的中文实操文章、发布用 markdown、文章大纲、seo 优化稿、独立高清配图和 zip 打包交付。适用于 maomomo.com、出海金融、港卡、香港银行、香港信用卡、美股券商、数字货币、汇款、支付优化、羊毛活动、开户教程、保号教程、避坑经验等主题。用户要求使用 skill 生成文章、配图、发布包、打包、一键下载、完整交付，或说“配图也按 skill”时，默认必须输出 markdown 文件、assets 独立配图目录和 zip 包，而不是只输出正文、片段或提示词。 description: 生成或优化符合 maomomo / 猫MOMO 风格的中文出海金融实操文章、发布用 Markdown、SEO 稿、配图规划、独立高清配图 assets 和 ZIP 发布包。适用于 maomomo.com、港卡、香港银行、香港信用卡、美股券商、数字货币、汇款、支付优化、返现活动、开户教程、保号教程、避坑经验、官方条款整理和实测攻略。用户要求使用 skill、按猫MOMO风格、完整文章、发布用 Markdown、配图、打包、一键下载或最终交付时触发。
--- ---
# MAOMOMO 文章生成器 # MAOMOMO 文章生成器
使用本技能生成 MAOMOMO / 猫MOMO 风格的中文实操文章、文章大纲、发布用 Markdown、SEO 优化稿、配图提示词、独立配图和打包交付文件。 本技能用于把主题、资料、链接、PDF、截图或已有 Markdown 转成 MAOMOMO / 猫MOMO 风格的中文实操文章，并在需要时交付可发布文件包。
输出要像一篇一手整理的出海金融攻略：结论靠前、步骤清楚、坑点明确、语气轻松但不轻浮，并且对金融、活动、合规、费用、奖励等时效性内容保持谨慎。 文章要像一手整理的出海金融攻略：结论靠前、步骤清楚、坑点明确、语气轻松但不轻浮。涉及金融、活动、合规、费用、奖励、账户规则和数字货币时，必须谨慎核查并避免承诺式表达。
## 工作流程 ## 使用边界
1. 先判断文章类型：活动 / 羊毛攻略、开户教程、转账 / 出入金教程、保号 / 账户维护、用卡姿势、对比总结、避坑经验。 适合：
2. 遇到费用、活动时间、奖励门槛、账户规则、信用卡返现、券商迎新、转账路径、数字货币出入金、合规要求等内容，先查证最新信息。优先使用官方条款、官方 App 显示、用户提供材料和 MAOMOMO 现有文章。
3. 默认使用中文写作。段落要短，数字要具体，App 菜单名 / 操作名要尽量写清楚，多用“怎么做”“哪里会翻车”“怎么吃满”的表达。
4. 每篇完整文章都要包含猫咪主题视觉规划和实际交付文件：封面图、正文截图槽位、必要时的流程图 / 表格图 / 路线图，以及 `article.md`、`assets/` 和 ZIP 包。
5. 涉及金融产品、银行、券商、数字货币、汇款、奖励活动或合规事项时，要写明来源链接和有效期，并加入保守的风险提示。
6. 用户上传或提供现有 Markdown 时，先完整阅读原文，再判断主题、核心概念、文章结构和需要配图的位置；不要沿用旧文章的银行名、邀请码、日期、收益率、奖励金额、产品名、图名或图片内容。
7. 交付前执行质量检查，避免写成官方宣传稿、SEO 空文或未经确认的承诺式内容。
生成完整文章、配图或打包交付时，必须先读取 `references/delivery-rules.md` 并按其中规则执行；同时读取 `references/style-guide.md` 获取更细的文章模板、标题套路、常用词、图片规则和不同类型文章骨架。 - 银行、港卡、香港信用卡、券商、数字货币、汇款、支付、账户维护、返现和羊毛活动。
- 活动规则整理、开户教程、转账 / 入金 / 出金教程、保号方案、用卡姿势、对比总结、避坑经验。
- 已有文章 SEO 优化、发布用 Markdown、配图规划、独立配图、ZIP 打包和后续改稿。
不适合：
- 给出投资、法律、税务或合规结论。
- 承诺一定获批、一定到账、稳赚、无风险、绝对安全。
- 伪造真实 App 截图、账单、官方 Logo 使用场景或用户没有提供的实测证据。
## 硬性约束
- 读写 Markdown、JSON、CSV、HTML、代码或文本文件时显式使用 UTF-8。
- 处理用户上传或提供的 Markdown / PDF / 官方链接 / 参考文章时，必须先完整读取或说明无法读取的部分，再写最终稿。
- 费用、活动日期、奖励门槛、账户规则、返现、券商迎新、转账路径、数字货币出入金和合规事项，必须优先核查最新信息。优先级：用户提供的最新官方材料 > 官方页面 / 条款 PDF / App 显示 > 用户实测 > MAOMOMO 旧文 > 其他参考。
- 没有被确认的数字、日期、奖励、链接、邀请码、产品名和规则，不得编造；可用 `【待确认：...】` 标出缺口。
- 完整交付模式下，不能只在聊天里输出正文；必须生成 Markdown 文件、`assets/` 目录和 ZIP 包，除非用户明确说只要文字、只要大纲、不要图片、不要打包或先不生成文件。
- 配图文件必须是独立 PNG；不要用一张大拼图代替多张图，不要只给提示词冒充图片文件。
- 后续改稿必须更新文件本体；影响图片、来源区、标题、摘要或 ZIP 时同步更新。
## 可见进度
复杂任务使用一个用户可见 checklist，并且同一时间只推进一个步骤：
1. 识别任务模式、来源和事实缺口。
2. 确认文章大纲、口径和素材映射。
3. 写作或优化发布用 Markdown。
4. 规划并生成 / 准备配图 assets。
5. QA、重新打包并交付最终文件。
不要因为聊天里说“已完成”就标记完成；用实际文件、已读取来源、已生成图片和 ZIP 作为完成证据。
## 默认工作流
1. 判断任务模式。
- 完整交付、只要大纲、只要正文、只要配图、SEO 优化、改稿更新、小红书发布版。
- 判断是否涉及金融 / 活动 / 合规事实核查。
- 完整交付或打包任务先读 `references/delivery-rules.md`。
2. 读取来源并建立事实表。
- 涉及官方规则、活动或金融产品时，先读 `references/source-and-fact-check.md`。
- 列出用户提供的所有来源，并标记已读 / 未读 / 无法读取。
- 提炼日期、门槛、奖励、限制、费用、适用对象、实测口径和冲突点。
3. 确认范围和大纲。
- 写最终稿前先给出文章类型、目标读者、标题方向、核心口径、章节结构、来源缺口和图片规划。
- 若存在多个活动分支、旧版活动、小众资格或来源冲突，先建议主文范围，等用户确认后再写最终稿。
- 用户明确要求“直接生成”时，可以继续执行，但所有未确认事实必须标 `【待确认：...】`。
4. 写作或优化文章。
- 写作前读 `references/style-guide.md`。
- 先结论、再步骤、再坑点；段落短，数字具体，App 菜单名 / 操作名尽量写清楚。
- 发布用 Markdown 使用 frontmatter、H1、太长不看版、正文、最后提醒和来源区。
- SEO 优化既要改标题、摘要、slug / tags / categories、图片 alt，也要清理无效来源和发布残留。
5. 配图规划和生成。
- 需要配图时读 `references/visual-assets.md`。
- 先生成图片清单：类型、标题、放置位置、核心文案、文件名、alt text、是否依赖用户截图。
- 每张图独立生成或准备为高清 PNG，放入 `assets/`，用相对路径插入 Markdown。
- 没有真实截图时只能生成“示意图 / 信息图”，不能伪造官方 App 截图。
6. 打包与最终 QA。
- 完整交付、文件交付或改稿打包前读 `references/delivery-rules.md`。
- 检查 Markdown 图片路径、来源区、编辑痕迹、待确认项、金融风险提示、用户要求删除内容和 ZIP 内容。
- 最终回复保持简短：给出 Markdown、assets 目录和 ZIP 路径，以及必要限制。
## 模式选择
- “生成文章”“完整文章”“发布用 Markdown”“使用 skill”“按 skill”“文章和配图一起”“打包”“一键下载”“最终交付”：完整交付模式。
- “只要大纲”“先列结构”：只输出标题备选、大纲、事实缺口、来源清单和图片规划。
- “只要文字”“不要图片”“不要打包”“先不要生成文件”：按用户限制输出，不强制创建文件包。
- “SEO 优化”“配图”“打包”且用户提供已有 Markdown：读取原文后输出优化版 Markdown、assets 和 ZIP。
- “小红书”“4 图看完”“发小红书”：读 `references/style-guide.md` 的小红书规则，并按 9:16 竖图规划。
- 后续说“删掉 X”“合并 3、4”“不要写 Y”“改成 Z”：视为编辑指令，不要把指令原样写进正文。
## 改稿协作规则 ## 改稿协作规则
用户后续改稿时，所有要求都先视为编辑指令，不得原样写入文章正文。 - 用户的修改要求默认是编辑指令，不是正文素材。
- 只改用户指定范围；不要因为“删掉几个字”误删整段。
- 用户说“不要写 X”：删除或改写 X，不要在正文解释“不要写 X”。 - 用户确认的实测口径优先写成结论，不反复声明“本文以实测为主”等元叙述。
- 用户说“应当写成 Y”：把 Y 转成自然文章表达，不要写“应当写成”。 - 对同类模糊词同步检查，例如“更像”“可能”“大致”“疑似”，但不要机械删除必要的不确定表达。
- 用户说“这个口径 / 我的要求”：这是写作指令，不是正文素材。 - 改完必须检查正文是否残留“不要写”“用户要求”“准确写法是”“本文口径”“应当写成”等编辑痕迹。
- 用户说“删掉几个字 / 某个词”：只删指定词，不扩大成删除整条、整段或整节。 - 文件交付任务改完后重新检查 Markdown、assets 和 ZIP 是否是最新版本。
- 用户说“合并 3、4”或“6、7 合并”：只合并对应条目，保留原信息，必要时重排编号。
- 用户反复纠正某个词，例如“更像”“可能”“最高”等，后续同文档同类位置都要检查并同步清理。 ## 验收标准
- 用户确认的实测口径优先写成结论，不要反复声明“本文以实测为主”“官方条款仅供参考”等元叙述。
- 改完必须检查正文是否残留编辑痕迹，例如“准确写法是”“不要写”“用户要求”“本文口径”“应当”。 完整交付必须满足：
## 实测活动文章规则 - `article.md` 或用户指定的 Markdown 文件存在。
- `assets/` 存在，且 Markdown 中每个图片路径都能对应真实文件。
处理银行、支付、返现、优惠券、券商迎新等活动时，如果用户提供了明确实测经验，正文应优先呈现实操结论。 - 需要配图时，每张配图是独立 PNG，并且含 MAOMOMO 品牌识别。
- ZIP 包存在，包含最终 Markdown 和 `assets/`。
- 官方条款用于确认活动边界、日期、排除项和来源区。 - 来源区只保留文章实际使用的来源；未读或无法确认的来源不得假装已确认。
- 实测经验用于组织“怎么吃”“怎么判断出券”“哪里会翻车”。 - 正文没有 `contentReference`、`oaicite`、调试标记、模型解释或编辑指令残留。
- 不要写成官方宣传稿，也不要把“官方条款仅供参考”作为正文口号反复出现。 - 金融、银行、券商、数字货币、汇款、税务或合规内容包含保守风险提示。
- 实测结论要直接写，例如“按支付宝账号算”“按卡算”“先刷后返”“不出券先看账号”。 - 用户要求删除或收敛的分支，不残留在标题、摘要、正文、图片 alt、配图清单、来源区或 ZIP。
- 对用户明确确认的口径，不要再写“更像”“可能”“大致”等模糊词。
- 仍要避免绝对承诺到账、稳赚、一定成功；可用“直到名额耗尽或风控拦截”等实际限制表达。 如果无法完成，最终回复必须说明：阻塞阶段、缺失材料或失败工具、已完成文件路径、未完成项和下一步需要什么。
## 输出模式 ## Reference Map
根据用户要求选择输出形态： - `references/source-and-fact-check.md`：来源读取、事实表、时效性、冲突口径和金融风险核查。
- `references/style-guide.md`：MAOMOMO 文章类型、标题套路、语气、结构模板、小红书模式和写作细节。
- 用户说“生成文章”“写完整草稿”“发布用 Markdown”“使用 skill 生成文章”“完整文章”“打包”“一键下载”“文章和配图一起”：默认进入完整交付模式，输出 Markdown 文件、`assets/` 独立配图目录和 ZIP 包。 - `references/visual-assets.md`：配图类型、猫咪视觉、文件命名、Markdown 插图、禁止伪造截图和图片 QA。
- 用户说“只要大纲”“先列结构”：输出标题备选、文章结构、需要确认的关键事实、图片规划。 - `references/delivery-rules.md`：完整交付、ZIP、更新打包、附件策略和最终检查清单。
- 用户说“图片风格”“配图提示词”“封面图”：只输出封面图提示词、正文截图槽位、信息图提示词和替代文本。
- 用户上传 Markdown 并要求“SEO 优化”“配图”“独立生成图片”“打包”“一键下载”：输出 SEO 优化后的 Markdown、插入正文的多张独立配图、`assets/` 文件夹和 ZIP 包；最后只给下载链接或本地文件路径以及简短说明。
- 用户只给了主题但事实不全：可以先出草稿，但所有未确认内容必须标成 `【待确认：...】`，不要编造数字、链接、奖励或规则。
- 用户明确说“只要文字”“不要图片”“不要打包”“先不要生成文件”“先只要大纲”时，按用户的限制输出，不强行生成完整文件包。
## 强制完整交付规则
当用户请求包含“使用 skill 生成文章”“按 skill 生成”“配图也按 skill”“完整文章”“发布用 Markdown”“打包”“一键下载”“给我文件”“文章和配图一起”“生成文章 + 配图”或“最终交付”等表达时，必须默认进入完整交付模式，除非用户明确要求只要文字、大纲、不要图片、不要打包或先不生成文件。
完整交付模式必须一次性完成：读取并核对所有用户提供的官方链接、PDF、参考文章和条款；生成发布用 Markdown 文件；生成或准备多张独立高清 PNG 配图并放入 `assets/`；用相对路径插入 Markdown；创建 ZIP 包；最终回复只给 Markdown 和 ZIP 下载链接或本地路径以及极简说明。若工具、图片生成、文件写入或资料缺失导致无法完成，必须明确失败点并尽量交付已完成部分，不要用正文或配图提示词代替文件。
## 文章生成任务的默认交付物
当用户没有特别说明“只要草稿”“先别生成文件”时，MAOMOMO 文章任务默认交付：
- `article.md`
- `assets/` 独立配图目录
- `article_package.zip`
聊天框正文只用于简短说明，不要把完整文章作为唯一交付物。用户后续要求修改文章内容时，必须更新 Markdown 文件本体；若修改影响配图、配图清单、来源区或 ZIP 包，必须同步更新并重新打包。
## 官方来源完整性检查
处理金融活动、银行活动、券商活动、返现活动、奖励活动时，必须先列出用户提供的所有来源链接，并逐个确认是否已读取：
```text
已读取来源：
- 官方活动页：已读 / 未读
- 主活动条款 PDF：已读 / 未读
- 额外活动条款 PDF：已读 / 未读
- 参考文章：已读 / 未读
```
如果用户提供了多个 PDF，不能只读其中一部分就开始写最终稿。后续补充新的官方条款 PDF 时，必须重新校正文章中相关规则并说明更新点。若主活动 PDF、补充条款 PDF、活动页存在口径差异，优先以最新官方条款 PDF 为准，并在文章里提示“以官方条款和 App 实际显示为准”。
## 范围收敛规则
如果活动有主活动、额外会员活动、年龄限定活动、旧版活动对比或小众资格优惠等多个分支，先判断是否适合放入主文。
默认主文优先保留大多数读者适用的主活动；小众分支只放到“补充说明”“关联阅读”或“可选阅读”。用户要求删除某个分支时，必须同步删除正文、标题、摘要、标签、配图清单、图片 alt 文案、来源区和 ZIP 包里的相关内容，不要让已删除分支残留在来源区、配图清单或图片文件名里。
## SEO 优化与配图打包模式
当用户提供现有 Markdown 并要求优化、配图或打包时，按这个顺序执行：
1. 读取原文，判断文章主题、核心概念、目标读者和现有结构。
2. 在不编造事实的前提下优化 `title`、`description` / `excerpt`、`slug`、`categories`、`tags`、标题层级、太长不看版、图片 alt text、风险提示、来源区和正文逻辑顺序。
3. 自动规划正文配图清单，标明每张图的类型、标题、放置位置、核心文案、关键数字、文件名和 alt text。
4. 逐张独立生成或准备配图，保存到 `assets/`，再把最终图片插入 Markdown 对应位置。
5. 创建 ZIP 包，结构应包含优化后的 Markdown 和 `assets/` 目录。
6. 最终回复保持简短，只提供 ZIP 和 Markdown 的下载链接或本地路径；不要长篇解释过程。
配图数量按内容决定：短文章 4-6 张，普通攻略 6-8 张，长文章 / 多步骤教程 / 多活动整理 8-12 张。默认目标是 6-10 张独立配图；不要为了凑数量硬加图，也不要把多个不同主题硬塞进一张大图。
常见配图类型：
- 封面图：文章主题、核心利益点 / 核心问题、产品或场景元素、MAOMOMO 白橘猫视觉元素。
- 总览图：适合活动整理、产品对比、教程总览，展示主要活动、核心条件、关键数字、适合人群和结论。
- 流程图：适合开户、转账、入金、注册、申请、使用路径，展示 Step 1 / Step 2 / Step 3、操作顺序、注意事项和关键入口。
- 表格图 / 对比图：适合多个产品、多个方案、多个活动对比，展示名称、条件、奖励、成本、适合谁和不适合谁。
- 计算图：适合收益、返现、年化、费用测算，展示公式、输入数字、结果、保守假设和风险提醒。
- 时间线图：适合活动日期、到账时间、任务周期、持有期、截止日，展示开始日期、截止日期、关键节点和最容易错过的时间。
- 避坑图：适合“常见翻车点”“注意事项”“风险提醒”，展示容易犯的错、不能补救的点、费用 / 规则 / 时效风险和正确姿势。
- FAQ 图：适合文章最后的常见问题，展示 3-5 个高频问题、简短答案和决策提示。
配图生成硬性要求：
- 每张图都要独立生成高清 PNG；不要拼图，不要从拼图里裁切，不要只生成一张总图。
- 如果用户要求最终图片文件，不要只给提示词；必须把图片文件插入 Markdown 并纳入 ZIP。
- 不要伪造真实 App 截图；没有真实截图时，只能做“示意图”或“插画示意”。
- 涉及银行、支付机构、卡组织、券商或品牌时，可以使用中性的产品场景元素，但不要把第三方品牌 LOGO 放在猫咪身上、猫咪衣服上或猫咪身体部位上；例如 HSBC / 汇丰 LOGO 不得出现在猫身上。
- 每张图都必须打上清晰的 `MAOMOMO` 文字作为站点 LOGO / 品牌标识，可放在角落、水印、标题区或猫咪旁边，但不要遮挡关键信息。
- 每张图都要有独立主题，信息量适中，文字清晰，文件名 SEO 友好。
- 图片文件名必须包含文章标题 / 主题前缀，例如 `hsbc-mastercard-alipay-campaign-01-cover.png`；不要使用 `01-cover.png`、`02-overview.png` 这类缺少主题前缀的通用文件名。
- 图片说明必须根据图片内容写，不要都写成“配图”。
图片文件建议放在，并且文件名必须加文章标题 / 主题前缀，避免只用 `01-cover.png` 这类通用名。前缀用英文 slug 或拼音 slug，保持 SEO 友好，例如：
```text
assets/
hsbc-mastercard-alipay-campaign-01-cover.png
hsbc-mastercard-alipay-campaign-02-overview.png
hsbc-mastercard-alipay-campaign-03-step-guide.png
hsbc-mastercard-alipay-campaign-04-comparison.png
hsbc-mastercard-alipay-campaign-05-calculation.png
hsbc-mastercard-alipay-campaign-06-timeline.png
hsbc-mastercard-alipay-campaign-07-common-pitfalls.png
hsbc-mastercard-alipay-campaign-08-faq.png
```
也可以按具体主题使用更具体的英文或拼音文件名，例如 `hsbc-mastercard-alipay-campaign-01-cover.png`、`hong-kong-bank-account-03-application-flow.png`、`alipay-hk-cashback-05-return-calculation.png`。不要沿用上一篇文章的固定文件名或无主题前缀文件名，除非主题刚好一致。
Markdown 插图路径统一使用：
```markdown
![图片说明](assets/文件名.png)
```
插图位置要贴合正文：封面图放在标题下方；总览图放在活动 / 产品介绍后；流程图放在步骤段落前后；计算图放在公式或测算表格后；时间线图放在日期说明后；避坑图放在翻车点段落后；FAQ 图放在常见问题段落前后。
ZIP 结构：
```text
article_seo_with_images_package.zip
article_seo_with_images.md
assets/
hsbc-mastercard-alipay-campaign-01-cover.png
hsbc-mastercard-alipay-campaign-02-overview.png
hsbc-mastercard-alipay-campaign-03-step-guide.png
```
完成后回复格式可参考：
```markdown
已完成。
- [下载 ZIP：Markdown + 独立配图](...)
- [下载 Markdown](...)
ZIP 内包含：
- SEO 优化后的 Markdown
- assets 文件夹
- 多张独立生成的 PNG 配图
```
## 发布用文章结构
当用户需要发布用 Markdown 草稿时，开头使用头部元数据：
```yaml
---
title: "文章标题"
excerpt: "一句话说明本文整理什么、适合谁、核心收益或风险点。"
categories:
- "银行"
tags:
- "港卡"
---
```
默认正文结构如下；如主题更适合其他结构，可按文章类型调整：
```markdown
# 标题
![封面图提示：...](image-placeholder)
## 太长不看版
> 1. ...
> 2. ...
> 3. ...
## 一、为什么值得看 / 活动简介 / 背景
## 二、怎么操作 / 怎么吃满
## 三、关键条件
## 四、常见翻车点
## 五、实测 / 时间线 / 常见答疑
## 最后提醒
## 来源
```
标题和小标题要偏实操，不要写得太学院派。优先使用“太长不看版”“保姆式教程”“怎么吃满”“常见翻车点”“最后提醒”“如果已经这样操作还有救吗”这类 MAOMOMO 式标题。
## 写作口吻
- 像一个懂行朋友在分享可执行路线，不要像银行、券商或 SEO 营销号。
- 先给结论，再讲原因和步骤。
- 句子直接，段落短。一个段落通常只讲一个实操点。
- 可以自然使用“众所周知”“重点来了”“翻车点”“闭眼薅”“无脑刷”“保姆式教程”“只看这个就够”“实测”“以官方条款 / App 实际显示为准”等表达。
- 轻微俏皮可以，但不要堆梗、堆感叹号、堆 emoji，也不要制造焦虑。
- 不承诺一定获批、一定到账、一定拿奖、稳赚、绝对安全，也不替用户做法律、税务、投资或合规判断。
## 图片与视觉方向
完整文章至少包含：
- 1 个带 MAOMOMO 猫咪识别的封面图提示词。
- 关键 App 操作、证明材料或结果展示的正文截图槽位。
- 涉及转账路径、返现计算、活动门槛、路线对比时，补充一张表格图 / 路线图 / 时间线图提示词。
猫咪视觉识别：
- 友好的白橘猫吉祥物，圆脸、小爪子、暖橙点缀，整体是干净的金融科技教程风。
- 猫咪可以作为向导、指示贴纸、水印或提醒牌，不要抢走数字、步骤和截图的主视觉。
- 猫咪身上不要出现第三方品牌 LOGO、银行 LOGO、卡组织 LOGO 或支付机构 LOGO；品牌元素应放在卡片、页面、标签或背景场景里，且不能让人误以为是猫咪本身的标识。
- 每张图都要包含清晰可见的 `MAOMOMO` 文字 LOGO，作为站点品牌识别；位置可统一放在右上角、右下角或封面标题区。
- 封面图要把产品语境和猫咪元素结合起来，例如猫咪拿着港卡、指向 App 页面、守着转账路线图、坐在返现计算器旁边。
- 不伪造银行或券商 App 截图。没有真实截图时，只能写成“示意图”或“插画示意”。
## 来源区规则
- 活动时间、截止日期、条款变更、实测时间线必须写具体日期。
- 奖励、费用、资格、监管产品、账户规则等信息，尽量链接官方条款或官方页面。
- 引用 MAOMOMO 时，要链接具体文章或页面，不只放首页。
- 发布用 Markdown 正文不要保留模型内部引用残留、`contentReference`、`oaicite` 或其他不可发布标记；正文里可用自然语言说明“根据官方条款整理”。
- 所有链接统一放在文末 `## 来源` 区；来源区只保留最终文章实际使用的来源。用户要求删除某个活动分支时，对应来源也必须删除。
- 涉及金融、银行、券商、数字货币、汇款、税务或合规时，加入简短免责声明：
```text
本文为经验整理，不构成金融、投资、法律或税务建议；活动和规则可能随时调整，请以官方条款、App 实际显示及当地法规为准。
```
- 无法确认的信息要明确标注，例如“公开页面暂时无法确认”“需要二次确认”“以到账 / 账单 / MCC 实际显示为准”。
## 质量检查
交付前确认：
- 标题包含产品 / 主题，以及具体利益点或问题点。
- 开头第一屏已经给出实操结论。
- 数字、门槛、日期、邀请码、链接、币种和单位写清楚。
- 至少有一个“常见翻车点 / 风险提醒”部分。
- 图片提示词包含猫咪元素；每张图都有 `MAOMOMO` 文字 LOGO；猫咪身上没有第三方品牌 LOGO；并且没有把生成图伪装成真实截图。
- 来源放在文末，官方来源和 MAOMOMO 来源分清楚。
- 正文没有 `contentReference`、`oaicite`、调试标记或工具残留。
- 语气不像官方营销稿，也没有无依据保证。

4
agents/openai.yaml
View File

@ -1,7 +1,7 @@
interface: interface:
display_name: "MAOMOMO 文章生成器" display_name: "MAOMOMO 文章生成器"
short_description: "生成 MAOMOMO 文章、配图和 ZIP 发布包" short_description: "阶段化生成 MAOMOMO 文章、配图和 ZIP 发布包"
default_prompt: "使用 $maomomo-article-writer 生成或优化一篇 MAOMOMO 风格的中文出海金融实操文章，并交付 Markdown、assets 独立配图目录和 ZIP 包。" default_prompt: "使用 $maomomo-article-writer 生成或优化一篇 MAOMOMO 风格的中文出海金融实操文章。请先核查来源和口径，再交付 Markdown、assets 独立配图目录和 ZIP 包。"
policy: policy:
allow_implicit_invocation: true allow_implicit_invocation: true

15
references/delivery-rules.md
View File

@ -24,16 +24,16 @@
1. 读取并核对用户提供的所有官方链接、PDF、参考文章和条款。 1. 读取并核对用户提供的所有官方链接、PDF、参考文章和条款。
2. 输出发布用 Markdown 文件，而不是只在聊天框展示正文。 2. 输出发布用 Markdown 文件，而不是只在聊天框展示正文。
3. 生成或准备多张独立高清 PNG 配图，放入 `assets/` 目录。 3. 生成或准备多张独立高清 PNG 配图，放入 `assets/` 目录。
4. 将图片以相对路径插入 Markdown，例如 `![图片说明](assets/01-cover.png)`。 4. 将图片以相对路径插入 Markdown，例如 `![图片说明](assets/hsbc-mastercard-alipay-campaign-01-cover.png)`。
5. 创建 ZIP 包，结构类似： 5. 创建 ZIP 包，结构类似：
```text ```text
article_package.zip article_package.zip
article.md article.md
assets/ assets/
01-cover.png hsbc-mastercard-alipay-campaign-01-cover.png
02-overview.png hsbc-mastercard-alipay-campaign-02-overview.png
03-timeline.png hsbc-mastercard-alipay-campaign-03-timeline.png
``` ```
6. 最终回复只给下载链接和极简说明。 6. 最终回复只给下载链接和极简说明。
@ -54,6 +54,8 @@ article_package.zip
## 配图执行规则 ## 配图执行规则
具体视觉风格、图片清单、文件命名、Markdown 插图和图片 QA 规则见 `references/visual-assets.md`。本节只规定完整交付时的执行边界。
当用户要求“配图也按 Skill”“高清配图”“精美配图”“生成配图”“文章和配图一起”时： 当用户要求“配图也按 Skill”“高清配图”“精美配图”“生成配图”“文章和配图一起”时：
- 必须生成独立 PNG 图片文件，而不是只给提示词。 - 必须生成独立 PNG 图片文件，而不是只给提示词。
@ -63,8 +65,8 @@ article_package.zip
- 不得伪造真实 App 截图。 - 不得伪造真实 App 截图。
- 生成图应明确是“MAOMOMO 风格示意图 / 信息图”。 - 生成图应明确是“MAOMOMO 风格示意图 / 信息图”。
- 生成后必须保存到 `assets/`，并插入 Markdown。 - 生成后必须保存到 `assets/`，并插入 Markdown。
- 图片文件名使用稳定英文小写命名，例如 `01-cover.png`、`02-overview.png`、`03-timeline.png`、`04-key-rule.png`、`05-strategy.png`、`06-pitfalls.png`。 - 图片文件名使用稳定英文小写命名，并包含主题前缀，例如 `hsbc-mastercard-alipay-campaign-01-cover.png`。
- 不要使用中文文件名作为最终 assets 文件名，避免站点路径兼容问题。 - 不要使用中文文件名或缺少主题前缀的通用文件名作为最终 assets 文件名，避免站点路径兼容和多文章混淆问题。
## 图片生成偏差处理 ## 图片生成偏差处理
@ -119,6 +121,7 @@ article_package.zip
- `assets/` 目录已生成。 - `assets/` 目录已生成。
- 所有 Markdown 图片路径都能对应到真实图片文件。 - 所有 Markdown 图片路径都能对应到真实图片文件。
- 图片是多张独立 PNG，不是一张大图代替全部。 - 图片是多张独立 PNG，不是一张大图代替全部。
- 图片文件名包含文章主题前缀，未沿用旧文章文件名。
- 文末来源区只包含实际使用的来源。 - 文末来源区只包含实际使用的来源。
- 正文没有 `contentReference`、`oaicite`、调试标记或工具残留。 - 正文没有 `contentReference`、`oaicite`、调试标记或工具残留。
- 用户要求删除的分支，标题、正文、配图清单和来源区都已删除干净。 - 用户要求删除的分支，标题、正文、配图清单和来源区都已删除干净。

84
references/source-and-fact-check.md 100644
View File

@ -0,0 +1,84 @@
# 来源与事实核查规则
写最终稿前，只要涉及费用、活动、返现、奖励、账户规则、开户资格、转账路径、数字货币出入金、税务、法律或合规事项，就先读本文件。
## 来源读取顺序
优先级从高到低：
1. 用户提供的最新官方材料：活动页、条款 PDF、App 截图、邮件、公告、客服记录。
2. 官方网站、官方 App、官方 PDF 或官方公告。
3. 用户提供的实测记录、账单截图、到账记录和社群反馈。
4. MAOMOMO 现有文章或用户指定参考文章。
5. 其他公开资料。
如果用户要求“最新”“当前”“今天还能不能用”等时效性判断，必须联网或读取用户提供的新材料确认。不要只依赖旧文章或模型记忆。
## 已读来源清单
涉及活动、金融产品或官方规则时，先向用户列出来源读取状态：
```text
已读取来源：
- 官方活动页：已读 / 未读 / 无法读取
- 主活动条款 PDF：已读 / 未读 / 无法读取
- 补充条款 PDF：已读 / 未读 / 无法读取
- App / 邮件 / 客服截图：已读 / 未读 / 无法读取
- 用户实测记录：已读 / 未读 / 无法读取
- 参考文章：已读 / 未读 / 无法读取
```
如果有多个 PDF 或多个官方页面，不能只读其中一部分就写最终稿。无法读取时要说明影响，例如“无法确认活动截止日，只能标待确认”。
## 事实表
写稿前整理这些字段，缺失就标 `【待确认：...】`：
| 字段 | 要确认的内容 |
|---|---|
| 时间 | 活动开始日、截止日、登记日、交易日、入账日、奖励发放日 |
| 对象 | 地区、年龄、账户类型、新老客户、卡种、会员等级、邀请渠道 |
| 门槛 | 单笔 / 累计金额、交易次数、入金金额、持有期、任务顺序 |
| 奖励 | 比例、金额、封顶、名额、是否先到先得、是否可叠加 |
| 排除项 | 不支持渠道、排除 MCC、转账 / 充值 / 现金类交易、退款规则 |
| 成本 | 年费、汇款费、点差、交易费、税费、潜在机会成本 |
| 实测 | 用户实测是否成功、按账号还是按卡、多久到账、账单怎么显示 |
| 风险 | 风控、活动变更、资格审核、投资波动、汇率、税务和合规限制 |
## 口径冲突处理
- 最新官方条款优先于旧活动页。
- App 实际显示优先于旧文章截图。
- 官方条款用于确定边界、日期、排除项和资格；用户实测用于组织“怎么吃”“哪里会翻车”。
- 用户确认的实测口径可以直接写成结论，但不要写成绝对承诺。
- 如果主活动、额外会员活动、年龄限定活动或旧版活动混在一起，先建议主文只保留大多数读者适用内容，小众分支放“补充说明”或删去。
- 来源差异无法解决时，在正文用保守表达，并在来源区说明以官方条款和 App 实际显示为准。
## 风险表达
禁止：
- “稳赚”“无风险套利”“一定到账”“一定获批”“闭眼稳赚”“保证拿满”。
- 把股票、ETF、基金、数字货币、汇率敞口说成存款或保本产品。
- 替用户给出法律、税务、投资或合规结论。
推荐：
- “适合本来就有相关消费 / 入金 / 交易需求的人。”
- “最终是否计入活动，以银行 / 券商系统记录为准。”
- “活动可能随时调整，操作前建议二次确认 App 和官方条款。”
- “股票 / ETF / 数字货币存在价格波动、汇率、买卖差价、成交滑点、交易成本和税务风险。”
默认免责声明：
```text
本文为经验整理，不构成金融、投资、法律或税务建议；活动和规则可能随时调整，请以官方条款、App 实际显示及当地法规为准。
```
## 来源区
- 所有链接统一放在文末 `## 来源` 区。
- 来源区只保留最终文章实际使用的来源。
- 引用 MAOMOMO 时链接具体文章或页面，不只放首页。
- 用户要求删除某个活动分支时，对应来源也要删除。
- 发布用 Markdown 不保留 `contentReference`、`oaicite`、模型内部引用或工具残留。

131
references/visual-assets.md 100644
View File

@ -0,0 +1,131 @@
# MAOMOMO 配图与视觉资产规则
需要生成、准备、插入或更新配图时，先读本文件。
## 配图交付原则
- 完整文章默认配独立 PNG：短文章 4-6 张，普通攻略 6-8 张，长教程 / 多活动整理 8-12 张。
- 不为凑数量硬加图；每张图必须服务正文。
- 每张图独立生成或准备，不要用一张拼图、长图或总图代替全部。
- 生成图必须是“示意图 / 信息图 / 教程视觉”，不得伪造真实 App 截图、账单或官方页面。
- 用户提供真实截图时，优先用真实截图，并隐去姓名、账号、余额、地址、手机号、二维码、交易号等个人信息。
- 每张图必须包含清晰可见的 `MAOMOMO` 标识。
## 常见配图类型
| 类型 | 用途 |
|---|---|
| 封面图 | 文章主题、核心利益点 / 核心问题、猫咪识别和产品场景 |
| 总览图 | 活动、产品、规则或教程的核心信息总览 |
| 流程图 | 开户、注册、转账、入金、申请、报名、设置路径 |
| 表格图 / 对比图 | 多产品、多方案、多活动、支持 / 不支持渠道对比 |
| 计算图 | 返现、收益、费用、年化、门槛和封顶测算 |
| 时间线图 | 活动日期、到账时间、任务周期、持有期、截止日 |
| 避坑图 | 常见翻车点、不能补救的点、费用 / 规则 / 时效风险 |
| FAQ 图 | 3-5 个高频问题和简短答案 |
## 图片清单格式
生成图片前先规划清单：
```markdown
| 文件名 | 类型 | 放置位置 | 核心文案 | alt text | 依赖素材 |
|---|---|---|---|---|---|
| hong-kong-bank-account-01-cover.png | 封面 | 标题下方 | 港卡保号关键点 | MAOMOMO 港卡保号教程封面图 | 无 |
| hong-kong-bank-account-02-flow.png | 流程图 | 操作步骤前 | 三步完成账户活跃 | 港卡保号操作流程图 | 用户截图 1 |
```
确认用户不需要先看清单时，可以直接执行，但最终必须让文件名、alt text 和插图位置与正文一致。
## 文件命名
图片文件名必须 SEO 友好，并包含主题前缀：
```text
assets/
hsbc-mastercard-alipay-campaign-01-cover.png
hsbc-mastercard-alipay-campaign-02-overview.png
hsbc-mastercard-alipay-campaign-03-step-guide.png
hsbc-mastercard-alipay-campaign-04-comparison.png
hsbc-mastercard-alipay-campaign-05-calculation.png
hsbc-mastercard-alipay-campaign-06-timeline.png
hsbc-mastercard-alipay-campaign-07-common-pitfalls.png
hsbc-mastercard-alipay-campaign-08-faq.png
```
规则：
- 使用英文小写、数字和连字符。
- 不使用中文文件名。
- 不使用 `01-cover.png`、`02-overview.png` 这类缺少主题前缀的通用文件名。
- 后续改稿删除某个活动分支时，相关文件名、alt text、正文引用和 ZIP 中旧图都要同步清理。
## Markdown 插图
统一使用相对路径：
```markdown
![图片说明](assets/文件名.png)
```
插图位置：
- 封面图放在标题下方。
- 总览图放在活动 / 产品介绍之后。
- 流程图放在步骤段落前后。
- 计算图放在公式或测算表格后。
- 时间线图放在日期说明后。
- 避坑图放在翻车点段落后。
- FAQ 图放在常见问题段落前后。
图片说明必须根据图片内容写，不要都写成“配图”。
## 猫咪视觉识别
基础方向：
```text
MAOMOMO 风格中文金融教程信息图，干净明亮白色背景，暖橙色点缀，友好的白橘猫吉祥物，圆脸、小爪子，现代 App 仪表盘质感，清晰中文标题和卡片信息层级，实用而非奢华，包含 MAOMOMO 标识，不使用未经提供的真实银行标志，不伪造真实截图。
```
猫咪可以：
- 指向关键数字。
- 拿着通用卡片。
- 坐在手机、账本、路线图或计算器旁。
- 举“实测”“注意”“先登记”提示牌。
猫咪不能：
- 穿戴或承载第三方银行、卡组织、券商、支付机构 Logo。
- 盖住关键数字、日期、步骤和风险提示。
- 变成幼稚主角，压过金融教程信息。
## 主题追加元素
- 信用卡 / 返现：通用信用卡、小票、购物篮、返现计算器、Apple Pay 风格通用符号。
- 银行账户 / 保号：账户余额仪表、保险库、日历、警示标、活跃度卡片。
- 转账 / 入金：路线箭头、HKD / EUR / USD 标签、手机转账示意界面、勾选标记。
- 券商活动：股票礼品卡、K 线图、欢迎信封、香港天际线线稿。
- 数字货币：硬件钱包、钱包 App、欧元通道、区块链节点路线；画面克制，避免暴富感。
## 小红书图
用户说“小红书”“4 图看完”“发小红书”时：
- 生成 4 张 9:16 竖版 PNG，不复用文章横版图。
- 每张图有 MAOMOMO 标识或猫咪水印。
- 手机端可读，大字少字。
- 默认结构：封面、核心拆解、操作流程、避坑总结。
## 图片 QA
交付前检查：
- 文件真实存在，格式为 PNG。
- Markdown 路径能打开对应文件。
- 图片文字清楚，无乱码、错字和过期金额。
- 标题、金额、日期、规则与最终文章口径一致。
- 没有真实个人信息。
- 没有伪造官方 App 页面或未经授权的品牌 Logo 场景。
- 每张图独立主题明确，不是同一画面的机械变体。