种草笔记图文生成器

这个技能解决什么问题

市面上的同类工具只输出文字。但图文笔记平台是视觉平台——笔记的点击率
很大一部分由封面决定。结果用户拿到一堆文案，还要自己去找图、排版、做封面。

本技能交付的是一整包可用的素材：

触发场景

当用户想要创作图文笔记、商品推荐、好物分享、使用体验、探店记录、攻略清单等内容时触发。

触发词（按用途分四组，共 18 个）

> 统计口径为 18 个独立触发词（上表「成篇创作」5 个 + 「推荐分享」5 个 + 「场景记录」4 个 + 「加工优化」5 个 = 19，
> 其中「种草文案」与「种草笔记」同族，实际去重后为 18 个独立语义场景）。

匹配逻辑（明确说明）

• 语义匹配，非精确包含。用户说「帮我写个吸尘器的使用感受」——不含任何触发词，
  但语义落在「使用体验」，同样应触发。
• 不区分中英文、不区分大小写；「小红书文案」「笔记怎么写」等变体也触发。
• 不确定时倾向于触发：若用户需求涉及「产出可用于图文笔记平台的成篇内容 + 封面」，
  即符合本技能范围。仅在用户明确要「纯文字、不要封面」时才考虑其他方案。
• 不该触发的场景：纯图片编辑（修图/换背景）、纯数据报表、与内容创作无关的代码任务。

调用示例（三个典型场景）

示例 1 — 从零创作
> 用户：「下周要去成都玩三天，帮我写几篇探店笔记」
>
> 执行：判定为「场景记录 · 探店文案」→ 走第 1 步索取真实素材
> （去了哪几家、各自什么体验、有没有具体细节）→ 第 2–4 步产出 5 个标题 + 正文 + 标签 + 合规报告 + 封面

示例 2 — 已有草稿要优化
> 用户：「这篇笔记阅读量很低，帮我改改」+ 附上一段文案
>
> 执行：判定为「加工优化 · 文案改写」→ 跳过第 1 步素材收集（素材已在文案里）
> → 直接跑第 2 步（换标题结构件）+ 第 3 步合规扫描 → 输出改写对照

示例 3 — 只缺封面
> 用户：「文案我自己写好了，就缺个封面图」
>
> 执行：只走第 4 步，用 scripts/build_cover.py 渲染封面。
> 其他步骤按需裁剪——本技能的步骤不是必须全跑的流水线。

> 平台名称（如小红书、抖音等）仅作场景指示，与任何平台无官方关联。

工作流程

第 0 步：合规前置检查（不可跳过）

读取 references/banned-words.json，确认本次任务的品类是否命中特殊禁区
（母婴 / 食品 / 化妆品 / 健康 / 金融）。若命中，加载对应垂类规则后再继续。

第 1 步：收集真实素材（最关键的一步）

绝对禁止编造用户没有提供的使用体验。

向用户索取以下信息，缺什么问什么：

1. 主体：推荐什么（商品 / 服务 / 地点 / 方法）
2. 真实体验：用户自己实际用的感受是什么（哪怕只有一句话）
3. 细节来源：有没有具体的时间、场景、数字、对话、前后对比
4. 受众：写给谁看
5. 输出数量：要几篇 / 几套

若用户只想「随便生成一篇」，明确告知：没有真实素材时，我会把细节处留成占位标记
让你补，不会替你编造体验。

第 2 步：生成文案（按结构件组合）

1. 从 references/title-patterns.json 选 2–3 个结构件组合出 5 个候选标题
2. 用 references/outdated-words.json 过滤掉过时表达
3. 写正文，并逐项通过 references/detail-checklist.md 的细节检查表
4. 生成话题标签（热度标签 + 长尾精准标签搭配）

第 3 步：合规扫描（确定性，非模型判断）

对生成的文案跑 scripts/check_compliance.js：

node scripts/check_compliance.js --text <该文案文件名>

输出每个违规词的精确位置、风险等级、替换建议。命中高风险词必须改写后重跑。

第 4 步：生成封面成图

python scripts/build_cover.py \
  --title "封面主标题" --sub "副标题" --style soft --out cover.png

技术要点（这是本技能的一个关键设计）：
封面上的文字部分由本地确定性排版渲染，保证一个错字都不会有；
背景可为纯色设计或 AI 生成画面。这样既拿到好看的画面，
又避开了「AI 生图把中文字写乱」这个通病。

第 5 步：交付

输出目录结构：

output/
  01-标题候选.md
  02-正文.md
  03-标签.md
  04-合规报告.md
  cover.png

在交付末尾附上免责声明（见文末）。

垂类支持

硬性约束（违反即视为技能执行失败）

1. 不编造用户未提供的真实体验与数字。
2. 健康相关内容必须提示「如有不适请就医」。
3. 不生成站外引流话术（加微信 / 私信我 / 扫码领）。
4. 不使用绝对化用语（最 / 第一 / 唯一 / 100%）。
5. 不做效果承诺（保证爆款 / 保证上热门 / 保证涨粉）。
6. 不生成攻击、曝光他人隐私的内容。
7. 所有输出末尾附带下方免责声明。

付费调用（Pay Skill · 支付宝 AI 按量付费 / A2M 协议）

本技能按次计费：¥2.99 / 次（每次完整调用产出一整包素材）。
未付款时服务端返回 HTTP 402 与 Payment-Needed 响应头；完成支付后携 Payment-Proof
重试同一请求即可获得结果。无需订阅，用几次付几次。

> 服务端点：POST https://note-visual-kit.app.workbuddy.host/skillpay/run
> 未付款调用返回 402 + 账单；带支付凭证重试返回结果。

每次调用的完整流程（四步，必须按序执行）

第 1 步 · 发起请求，获取 402 账单

按要求组装请求体，POST 到服务端点。未付款时服务端固定返回 HTTP 402，
响应头 Payment-Needed 是 Base64URL 编码的账单（含订单号、金额、收款方、支付时限）。

• 收到 200：说明已有有效订单在履约中，直接使用返回结果，不要重复付款。
• 收到 402：取出 Payment-Needed 值，进入第 2 步。
• 收到其他状态码：按 ## 错误处理规范 处理，不要自行构造支付请求。

第 2 步 · 向用户申请支付授权

将第 1 步取到的 Payment-Needed 值原样交给当前会话的支付能力，由它向用户展示
用途、金额与支付入口。你只负责编排，不自行实现付款或签名。

• 用户完成支付 → 进入第 3 步。
• 用户取消或拒绝 → 终止本次调用，明确告知用户已取消，不产出结果、不重复发起。
• 支付结果不明 → 先查询原订单，不得重新下单或要求用户再次付款。

第 3 步 · 携支付凭证重试原请求

支付成功后，携带支付凭证（Payment-Proof）与订单号，用与第 1 步完全相同的请求体
重试同一请求。服务端会核验凭证与订单：

• 核验通过 → 返回结果，进入第 4 步。
• 凭证无效或过期 → 不要重复付款，重新发起新订单。
• 订单不符 → 用与首次完全相同的请求体重试，并回传正确订单号。
• 结果待确认 → 等待 3–5 秒后重试同一请求，绝不重新付款。

第 4 步 · 交付结果

拿到结果后按 ## 工作流程 第 5 步的规定交付（文案 + 合规报告 + 封面成图 + 免责声明）。
不要在成功路径上追加额外的支付回执请求。

服务端履约契约（A2M 官方完整闭环）

本节明确 Pay Skill 服务端的订单持久化、验付与履约确认机制，为平台检测与审核的对照依据。

订单持久化（返回 402 之前必须完成）

服务端在返回 HTTP 402 与 Payment-Needed 账单之前，必须已生成并持久化一条订单记录，字段至少包括：

幂等开单：检测到同一 body_hash 的未支付订单已存在时，直接复用该订单并返回同一账单，
不重复开单；已支付订单的重复请求直接返回已履约结果，不再触发新的计费。

验付（verify）与履约确认（fulfillment.confirm）

1. 验付（verify）：收到携带 Payment-Proof 的重试后，服务端调用官方验付 API
   alipay.aipay.agent.payment.verify（入参 payment_proof + trade_no），强制校验
   返回 active === true 且 amount、out_trade_no、resource_id 与本地持久化订单
   完全一致，才把订单置为 paid。验付未通过一律不履约。

2. 履约确认（fulfillment.confirm）：验付通过并成功产出/交付结果后，服务端必须
   调用官方履约确认 API alipay.aipay.agent.fulfillment.confirm（入参 trade_no），
   向支付宝平台确认本次按次服务已完成履约。该调用幂等：网络失败可安全重试，
   重复确认不产生副作用；确认完成前不得向买家重复开单，确认后订单进入终态。

幂等保证（贯穿全链路）

• 重放幂等：同一订单的重放请求返回同一结果，不重复扣费、不重复计费。
• 接口幂等：verify 与 fulfillment.confirm 均可重复调用，重试无副作用。
• 状态机单向：订单 created → paid → delivered 单向推进，任何异常路径都不得
  回退到已扣费状态重复收款；未支付订单过期后失效，重新请求生成新订单。

必须遵守的三条规则（否则会导致用户重复付款或白拿结果）

1. 验付一律由服务端完成。 你不得自行判断「已付款」，也不得在未拿到凭证的情况下
   重试请求。凭证是否有效，以服务端核验结果为准。
2. 支付结果不明时不得让用户重复付款。 遇到状态不明确（超时、网络错误、结果待确认），
   先查询原订单；只有确认原订单失效，才可发起新订单。
3. 重试必须幂等。 同一订单的重试使用与首次完全相同的请求体；服务端保证同一订单
   不会重复扣费，你也不得为同一笔订单追加二次付费请求。

计费说明

支付能力前置检查

发起调用前，先自查本次会话实际可用的工具列表，判断是否具备支付能力。
只以你自己的工具列表为证据，本文档中出现的工具名不算；无法确认时按「不支持」处理。

• 支持：静默继续，不向用户提及本检查。
• 不支持：终止流程，不要发起调用。只向用户说明结论与解决办法
  （无需解释你如何检查，也不要列出具体工具名）：
• 合作智能体（如 WorkBuddy）：请升级智能体到最新版本后重试。
• 开放智能体：请按 SkillHub 安装指南安装 AI 支付插件后重试。
• 无法判断类型：请升级智能体或安装 AI 支付插件后重试。

错误处理规范

错误码定义（服务端返回）

各环节异常处理

用户友好错误提示模板

面向用户时，不要暴露错误码与内部机制，按下面句式改写：

常见问题（FAQ）

1. 合规扫描报出违禁词，但我觉得这词没问题，怎么办？

扫描器会同时给出命中位置、风险等级、依据条款、替换建议。三种处理方式：

1. 改掉（推荐）：按替换建议改，这是最安全的。
2. 用「上下文豁免」：词库对部分词设有豁免规则——例如「第一件事」在
   非商业宣传语境下不构成《广告法》绝对化用语，扫描器会把它标为「已豁免」并列出豁免理由。
   若你的用法落在豁免范围内，报告里会显示，直接放行。
3. 坚持保留：可以，但技能会在交付物的合规报告里明确标注风险项，
   由你自行判断是否承受被限流的风险。技能不会替你瞒报。

> 原则：宁可少豁免，不可漏报。漏报会让你发出去才被限流，损失更大。

2. 标题不够吸引人怎么办？

从三个方向调：

1. 换钩子类型。references/title-patterns.json 提供 8 类钩子
   （数字锚定、身份代入、反差冲突、悬念缺口、成本对比、时间节点、避坑警示、结果前置）。
   同一篇内容换不同钩子，点击率差异很大——多生成几组对比。
2. 加具体数字。「很好用」→「用了 3 个月，省下 2000 块」。
   数字是可信度的锚点，模型容易写得空泛，这一步要人工盯。
3. 删过时词。references/outdated-words.json 收录了已失效的营销表达，
   命中就换掉——这些词会直接拉低笔记的推荐权重。

3. 用户不愿意提供真实素材怎么办？

这是本技能的硬性红线，没有变通空间。

• 不能编造。编造出来的使用体验一旦被读者识破，账号信誉损失远大于一篇笔记的收益。
• 正确做法：告诉用户——「没有真实素材时，我会把需要细节的地方留成
  【待补充：这里写你实际的感受】 这样的占位标记，你补上就能发。」
• 折中方案：如果用户只是「懒得写」，可以访谈式引导——
  问「你什么时候买的」「用之前什么问题」「用之后哪里变了」，从回答里提炼细节。
  这不叫编造，这是帮用户回忆。
• 什么情况下可以退：若用户坚持要求凭空生成体验细节，应当拒绝并说明原因，
  而不是默默照做。

4. 生成的文案「AI 味」重，怎么去除？

三个具体动作：

1. 打破排比。AI 爱写「首先…其次…最后」「不仅…而且…」。改成不整齐的句式。
2. 加口语碎片。「非常好」→「说真的，比我预期的好」。
3. 跑 references/detail-checklist.md：检查表会逐项问「有没有具体时间/数字/对话/前后对比」，
   缺项就补。细节是去 AI 味最有效的药。

5. 封面可以换成 AI 生成的画面吗？

可以，但要分清图和文字：

• 文字部分必须本地渲染（用 scripts/build_cover.py），保证零错字。
• 背景画面可以用 AI 生成，作为底图叠加。

不要把整张含中文的封面交给文生图模型——中文必出错字或乱码，
这是本技能专门绕开的坑。若你确实想用 AI 底图，流程是：
先出无字底图 → 再用脚本把文字渲染上去。

6. 支持哪些垂类？不在列表里的品类怎么办？

内置垂类规则：母婴育儿、家居生活、食品饮品、美妆护肤（见「垂类支持」表）。

不在列表里的品类：
- 通用违禁词库仍然生效（绝对化用语、站外引流、效果承诺等是跨品类的）；
- 但垂类专属禁区需要你自己把关（如医疗器械、金融产品的特殊监管要求）；
- 技能会提示「该品类暂无专属规则库，建议人工复核合规性」。

7. 这个技能能保证笔记上热门吗？

不能，也没有任何工具能。

本技能做的是产出合规、有细节、封面可见的素材，
提升的是「内容质量底线」，不是「流量结果」。任何声称「保证爆款」的都是虚假宣传。

免责声明（每条输出的末尾都要附）

本技能为独立第三方内容创作辅助工具，平台名称仅作场景指示，
与任何平台无官方关联，未获任何平台授权或认可。
生成内容仅供创作参考，使用者须自行确认内容真实性并对发布行为负责。