From 286e28b7f3d556d873fdb6fcfa965ae5ddf9a896 Mon Sep 17 00:00:00 2001 From: hitsword Date: Sat, 27 Jun 2026 21:18:51 +0800 Subject: [PATCH] feat: improve maomomo article workflow --- README.md | 30 ++- SKILL.md | 369 ++++++++-------------------- agents/openai.yaml | 4 +- references/delivery-rules.md | 15 +- references/source-and-fact-check.md | 84 +++++++ references/visual-assets.md | 131 ++++++++++ 6 files changed, 360 insertions(+), 273 deletions(-) create mode 100644 references/source-and-fact-check.md create mode 100644 references/visual-assets.md diff --git a/README.md b/README.md index b8a99fb..5f03aef 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,8 @@ # MAOMOMO 文章生成器 -这是一个面向 Codex 的中文写作技能，用来生成 MAOMOMO / 猫MOMO 风格的出海金融实操文章、文章大纲、发布用 Markdown 和配图提示词。 +这是一个面向 Codex 的中文写作技能，用来生成 MAOMOMO / 猫MOMO 风格的出海金融实操文章、文章大纲、发布用 Markdown、SEO 优化稿、独立配图 assets 和 ZIP 发布包。 + +新版流程参考了 `codex-ppt-skill` 的阶段化设计：先确认来源和文章口径，再确认大纲与配图规划，最后写作、生成配图、QA 和打包交付。这样可以降低金融活动文章里最常见的翻车点：旧规则混入新稿、来源没读全、图片残留旧口径、只给正文不交付文件。 ## 适用场景 @@ -24,7 +26,10 @@ maomomo-article-writer/ ├── agents/ │ └── openai.yaml # 技能展示名称、简介和默认提示语 └── 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`。 -- 详细文章模板、标题套路、常用词和图片规则写在 `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`。 - 如果新增具体行业资料、平台规则或长期复用模板，优先放入 `references/`，避免让 `SKILL.md` 过长。 diff --git a/SKILL.md b/SKILL.md index 5f53f6d..90f7d70 100644 --- a/SKILL.md +++ b/SKILL.md @@ -1,275 +1,120 @@ --- 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 / 猫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 转成自然文章表达，不要写“应当写成”。 -- 用户说“这个口径 / 我的要求”：这是写作指令，不是正文素材。 -- 用户说“删掉几个字 / 某个词”：只删指定词，不扩大成删除整条、整段或整节。 -- 用户说“合并 3、4”或“6、7 合并”：只合并对应条目，保留原信息，必要时重排编号。 -- 用户反复纠正某个词，例如“更像”“可能”“最高”等，后续同文档同类位置都要检查并同步清理。 -- 用户确认的实测口径优先写成结论，不要反复声明“本文以实测为主”“官方条款仅供参考”等元叙述。 -- 改完必须检查正文是否残留编辑痕迹，例如“准确写法是”“不要写”“用户要求”“本文口径”“应当”。 - -## 实测活动文章规则 - -处理银行、支付、返现、优惠券、券商迎新等活动时，如果用户提供了明确实测经验，正文应优先呈现实操结论。 - -- 官方条款用于确认活动边界、日期、排除项和来源区。 -- 实测经验用于组织“怎么吃”“怎么判断出券”“哪里会翻车”。 -- 不要写成官方宣传稿，也不要把“官方条款仅供参考”作为正文口号反复出现。 -- 实测结论要直接写，例如“按支付宝账号算”“按卡算”“先刷后返”“不出券先看账号”。 -- 对用户明确确认的口径，不要再写“更像”“可能”“大致”等模糊词。 -- 仍要避免绝对承诺到账、稳赚、一定成功；可用“直到名额耗尽或风控拦截”等实际限制表达。 - -## 输出模式 - -根据用户要求选择输出形态： - -- 用户说“生成文章”“写完整草稿”“发布用 Markdown”“使用 skill 生成文章”“完整文章”“打包”“一键下载”“文章和配图一起”：默认进入完整交付模式，输出 Markdown 文件、`assets/` 独立配图目录和 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`、调试标记或工具残留。 -- 语气不像官方营销稿，也没有无依据保证。 +- 用户的修改要求默认是编辑指令，不是正文素材。 +- 只改用户指定范围；不要因为“删掉几个字”误删整段。 +- 用户确认的实测口径优先写成结论，不反复声明“本文以实测为主”等元叙述。 +- 对同类模糊词同步检查，例如“更像”“可能”“大致”“疑似”，但不要机械删除必要的不确定表达。 +- 改完必须检查正文是否残留“不要写”“用户要求”“准确写法是”“本文口径”“应当写成”等编辑痕迹。 +- 文件交付任务改完后重新检查 Markdown、assets 和 ZIP 是否是最新版本。 + +## 验收标准 + +完整交付必须满足： + +- `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 文章类型、标题套路、语气、结构模板、小红书模式和写作细节。 +- `references/visual-assets.md`：配图类型、猫咪视觉、文件命名、Markdown 插图、禁止伪造截图和图片 QA。 +- `references/delivery-rules.md`：完整交付、ZIP、更新打包、附件策略和最终检查清单。 diff --git a/agents/openai.yaml b/agents/openai.yaml index 667b9b6..945d989 100644 --- a/agents/openai.yaml +++ b/agents/openai.yaml @@ -1,7 +1,7 @@ interface: display_name: "MAOMOMO 文章生成器" - short_description: "生成 MAOMOMO 文章、配图和 ZIP 发布包" - default_prompt: "使用 $maomomo-article-writer 生成或优化一篇 MAOMOMO 风格的中文出海金融实操文章，并交付 Markdown、assets 独立配图目录和 ZIP 包。" + short_description: "阶段化生成 MAOMOMO 文章、配图和 ZIP 发布包" + default_prompt: "使用 $maomomo-article-writer 生成或优化一篇 MAOMOMO 风格的中文出海金融实操文章。请先核查来源和口径，再交付 Markdown、assets 独立配图目录和 ZIP 包。" policy: allow_implicit_invocation: true diff --git a/references/delivery-rules.md b/references/delivery-rules.md index 018c7f8..ea5fd4e 100644 --- a/references/delivery-rules.md +++ b/references/delivery-rules.md @@ -24,16 +24,16 @@ 1. 读取并核对用户提供的所有官方链接、PDF、参考文章和条款。 2. 输出发布用 Markdown 文件，而不是只在聊天框展示正文。 3. 生成或准备多张独立高清 PNG 配图，放入 `assets/` 目录。 -4. 将图片以相对路径插入 Markdown，例如 `![图片说明](assets/01-cover.png)`。 +4. 将图片以相对路径插入 Markdown，例如 `![图片说明](assets/hsbc-mastercard-alipay-campaign-01-cover.png)`。 5. 创建 ZIP 包，结构类似： ```text article_package.zip article.md assets/ - 01-cover.png - 02-overview.png - 03-timeline.png + hsbc-mastercard-alipay-campaign-01-cover.png + hsbc-mastercard-alipay-campaign-02-overview.png + hsbc-mastercard-alipay-campaign-03-timeline.png ``` 6. 最终回复只给下载链接和极简说明。 @@ -54,6 +54,8 @@ article_package.zip ## 配图执行规则 +具体视觉风格、图片清单、文件命名、Markdown 插图和图片 QA 规则见 `references/visual-assets.md`。本节只规定完整交付时的执行边界。 + 当用户要求“配图也按 Skill”“高清配图”“精美配图”“生成配图”“文章和配图一起”时： - 必须生成独立 PNG 图片文件，而不是只给提示词。 @@ -63,8 +65,8 @@ article_package.zip - 不得伪造真实 App 截图。 - 生成图应明确是“MAOMOMO 风格示意图 / 信息图”。 - 生成后必须保存到 `assets/`，并插入 Markdown。 -- 图片文件名使用稳定英文小写命名，例如 `01-cover.png`、`02-overview.png`、`03-timeline.png`、`04-key-rule.png`、`05-strategy.png`、`06-pitfalls.png`。 -- 不要使用中文文件名作为最终 assets 文件名，避免站点路径兼容问题。 +- 图片文件名使用稳定英文小写命名，并包含主题前缀，例如 `hsbc-mastercard-alipay-campaign-01-cover.png`。 +- 不要使用中文文件名或缺少主题前缀的通用文件名作为最终 assets 文件名，避免站点路径兼容和多文章混淆问题。 ## 图片生成偏差处理 @@ -119,6 +121,7 @@ article_package.zip - `assets/` 目录已生成。 - 所有 Markdown 图片路径都能对应到真实图片文件。 - 图片是多张独立 PNG，不是一张大图代替全部。 +- 图片文件名包含文章主题前缀，未沿用旧文章文件名。 - 文末来源区只包含实际使用的来源。 - 正文没有 `contentReference`、`oaicite`、调试标记或工具残留。 - 用户要求删除的分支，标题、正文、配图清单和来源区都已删除干净。 diff --git a/references/source-and-fact-check.md b/references/source-and-fact-check.md new file mode 100644 index 0000000..b67c38c --- /dev/null +++ b/references/source-and-fact-check.md @@ -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`、模型内部引用或工具残留。 diff --git a/references/visual-assets.md b/references/visual-assets.md new file mode 100644 index 0000000..52283b7 --- /dev/null +++ b/references/visual-assets.md @@ -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 场景。 +- 每张图独立主题明确，不是同一画面的机械变体。