/redbeacon-generate

description: 生成内容 — 从选题库取题 → AI 写文案 + 出图 → 入库并自动推飞书审核表；手动触发，无后台排期
argument-hint: 无参数=给当前账号生成一篇；可指定选题/内容类型/配图方式（如「用『新手避坑』这个题生成」「生成一篇纯卡片的」）

> 🤝 **交互风格 = 像得力下属服务老板**：主动带领、别让用户懵；用户没熟之前你来引导，熟了就让他自然语言直说。 > - **全程人话**：给用户的回复不出现 /redbeacon-* 或 redbeacon xxx 这类命令名/斜杠（那是你后台执行的），用「我来帮你生成一篇」这种说法；除非用户主动要命令，否则别提、别列。 > - **给选择必须编号 + 换行排版**，让用户回一个数字就行，例如： > ``` > 你想先做哪个？ > 1. 写一篇（我列选题你挑） > 2. 先审飞书里那几篇 > 3. 补一批选题 > 回数字就行，也可以直接跟我说。 > ``` > - **把输入成本压到最小**：能给选项就别让用户打字，能一个数字就别让他写句子；该替他想的下一步你先想好、给推荐（标「推荐」）。 > - 用户**熟了会直接自然语言**提要求（「写第3条」「发出去」「换个标题」）→ 照做，别硬塞编号流程。

> **【生成 skill】** 跑一次内容生产：从账号选题库取一个未用选题 → 按定位用 AI 写文案 → 出图（AI 封面 / 文字卡片 / 两者）→ 入库 → **自动推到飞书审核表**等你审。 > > 上一步是定位（`/redbeacon-locate`，账号此时已完成 登录→绑表→定位+选题→面板二次确认、进入正式运营），下一步是去飞书审核、然后 `/redbeacon-publish` 发布。**生成是手动命令触发的，没有任何后台自动排期/常驻服务**，别向用户承诺"定时自动生成"。

---

前置：确认就绪（少一环都生成不了）

redbeacon readiness

生成需要整条链路就绪（`readiness=ready`）：AI+飞书凭证已配（stage1）、有账号（stage2）、已登录（stage3）、已绑飞书表（stage4）、账号有定位（stage5）。没到位就按 readiness 的 `stage` 把用户带去对应 skill，本 skill 暂停。

选账号（同其它 skill）：

redbeacon accounts list

• 0 个 → `/redbeacon-accounts`；1 个 → 自动用，记 `{ID}`；多个 → 让用户指明（`$ARGUMENTS` 已说明就直接用）。

> 选题库为空会直接生成失败（见下）。定位流程（`/redbeacon-locate`）会灌一批选题；想确认存量可 `redbeacon topics stats --account-id {ID}` 看 `unused`。

---

挑选题写文案：网页勾选 或 对话共创（「我想写一篇」默认走这里）

用户说「我想写一篇 / 帮我写篇文案」这类诉求时，**别闷头从选题库抽一条直接生成**——把用户拉进来一起定。

**第〇步：先问「在网页上挑，还是在这儿聊着挑」**（选题库有货时）

先查一眼库存 `redbeacon topics stats --account-id {ID}`，**有未用选题就给用户二选一**（编号回数字）：

要写文案啦。你想怎么挑选题？
1. 在网页上挑（弹个选题库页面，勾要写的，可多选，点一下就逐篇写好送进飞书）
2. 在这儿聊着挑（我把选题列出来，你报编号，单篇还能一起聊聊怎么写）
回数字就行。

• **回 1 / 想要网页** → 走 **A：网页挑题**（下方），适合一次想批量写好几条、要的就是“点一点”。
• **回 2 / 想聊** → 走 **B：对话共创**（即原来的挑题流程），适合单篇想参与角度、边写边聊。
• 选题库为空 → 不给这个岔口，直接提示去补题（`/redbeacon-topics`）。

---

A：网页挑题（弹选题库面板，勾选 → 写成文案 → 入飞书）

redbeacon ui topics --account-id {ID}

会弹出本地选题库网页：未用选题按内容类型分组、每条带勾选框。用户勾要写的（**可多选**）、点「写成文案」，后端**逐篇生成并自动送进飞书审核表**，每条写好当场打勾；弄完点「完成返回对话」。

• 命令**前台阻塞**，结束返回 `{"finished":..,"generated":N,"content_ids":[..]}`（`status:"ui_opened"` 先到 stdout）。**弹出后用人话给用户一句引导**，别让纯小白对着网页发懵，例如：「页面开好了——勾上你想写的选题、点右下角『写成文案』，写完点右下角『完成返回对话』回来找我就行。」
• 返回后用人话汇报：**「在网页上写好了 N 篇，都进飞书审核表了，去飞书审 / 改 / 标通过，再回来发布。」** 不用逐条念 content_id。
• 网页这条路**不走单篇想法共创**（点选即写，用选题自带的 note 想法）；要逐篇聊角度就走 B。

---

B：对话共创（列编号让用户挑，可多选）

**① 列未用选题，编号让用户挑**

redbeacon topics list --account-id {ID} --used 0 --limit 15

**把未用选题排成编号清单**（按内容类型分组，每条带一句话钩子），让用户回数字就行——**支持多选**：

有这些没写的选题，想写哪条？（想写几条就报几个号，逗号隔开，如 1,3,5）
干货科普
1. 选题A —— 一句话钩子
2. 选题B —— …
痛点解析
3. 选题C —— …
…
回数字就行（可多选）；也可以自己报一个题，或说「你帮我挑一条」。

> **多选怎么处理**：用户报了多条（如 `1,3,5`）→ **逐条**走下面 ②③（每条都给落地想法、各自注入生成、各自标已用）。想省事的话也可以对多选只问一次"都按你定位直接写好吗"，确认后逐条直接生成（不逐条聊角度）。单选则完整走 ②③ 共创。

**② 选定后，先给「落地想法」，再听用户的**

针对选中的这条选题，**先主动抛一个你的落地角度**（这篇从什么切入、讲哪几个点、落到什么钩子），一两句话，然后问：

> 这条我打算这么写：{你的落地想法}。回个数字就行： > 1. 就按这个写（**推荐**） > 2. 换个角度 —— 说说你想怎么切 > 3. 强调某个点 —— 告诉我重点放哪

• 回 1 / 认可 → 用它当「本篇想法」。
• 回 2、3 / 用户有自己的明确想法 → 以用户为准，帮他补全成一句清晰的落地要求。
• 用户没意见 → 也可以不带想法直接写。

**③ 注入想法生成（并把想法存回选题，重写也带着）**

# 立刻产这一篇：--idea 作为最高优先级注入文案提示词；--content-type 让文案跟着这条选题的类型写法走
redbeacon generate --account-id {ID} --topic "<这条选题原文>" --content-type "<这条选题的内容类型>" --idea "<聊定的本篇想法>"
# 同时把想法+已用状态写回这条选题（持久化，下次对它生成自动带上想法）
redbeacon topics edit --account-id {ID} --id {选题id} --idea "<聊定的本篇想法>" --used 1

> - `--idea` 在提示词里是「本篇用户的具体想法，务必落地实现」，优先级最高。 > - `--content-type` 传这条选题所在的类型（干货科普 / 痛点解析 / 经验分享），文案就按该类型的写法走，和网页挑题路径一致。 > - `topics edit --idea` 把想法**存在这条选题上**；以后对它生成（即使不带 `--idea`）也会自动注入这条想法。想清空传 `--idea ""`。 > - `--topic` 走"指定题"路径**不自动消耗库存**，所以上面用 `topics edit --used 1` 顺手标记这条已用，避免下次又被抽到。

> 这套「挑题 → 给落地想法 → 收集用户想法 → 注入生成」是**单篇共创**的默认姿势。批量/自动（下面的 `--count`、`--all-accounts`）不走共创，各篇用选题自带的想法（note，有就注入、没有就常规生成）。

---

生成一篇（快捷：不想共创、直接出）

用户明确说「随便来一篇 / 直接生成」时，用账号默认配图方式、从选题库自动取题：

redbeacon generate --account-id {ID}

可选参数（按用户意图加，不需要就都不传）：

| 用户说 | 加参数 | |---|---| | 指定这一篇写什么题 | `--topic "选题原文"`（绕过选题库，不消耗库存） | | 指定走哪类内容 | `--content-type "干货科普"`（取该类未用选题） | | 围绕某个内容支柱 | `--pillar "支柱名"` | | 这篇临时换配图方式 | `--image-mode cards`（纯文字卡片）/ `both`（AI 大字报封面 + 文字卡片）/ `ai`（只出一张 AI 封面） |

> **三种配图方式（人话）**： > - **纯文字卡片**：正文渲染成卡片、封面也是文字大字报。稳定省钱，认知/观点号常用。 > - **AI 封面 + 卡片**：封面用 AI 出一张大字报（标题大字直接画进图，可带账号风格/人物），正文仍是渲染卡片。 > - **纯 AI**：只一张 AI 封面，没有正文卡片。 > > **配图方式怎么定**：不传 `--image-mode` 就用账号默认（在 `/redbeacon-locate` 定、`/redbeacon-strategy` 或 `/redbeacon-panel` 改）。`--image-mode` 只覆盖**这一篇**。**对用户说"配图方式"，别甩 `cards/ai/both` 字段词**。封面长什么样（风格/大字/要不要放人物）是账号级的**视觉风格**，不在这里设——去 `/redbeacon-locate`（首次推荐）或 `/redbeacon-strategy`（单改）。

---

跟进生成过程

`generate` 是**前台阻塞**命令，过程进度以 JSON 打到 **stderr**（形如 `{"progress":N,...}`：取选题 → 写文案 → 出图 → 渲染卡片 → 入库）。可以把阶段转成人话让用户知道在跑（"正在写文案…"/"正在出图…"），不用逐条念。

结果在 stdout：

• `{"ok":true,"content_id":N}` → 成功。内容已入库**并自动推送到飞书审核表**。告知用户：

> ✓ 已生成一篇并送进飞书审核表。去飞书表里审核 / 改标题正文标签 / 标「通过」，然后回来用 **`/redbeacon-publish`** 发布。

• stderr `{"error":"选题库已耗尽…"}` → 选题用光了。**别只甩一句"去补题"**：读一下定位、挑一个现有题还没覆盖的应用域，当场**拟一个题先发用户确认**——「库空了，先用这个发？『{拟的题}』，或者我们开场规划会补一批」。用户点头就 `redbeacon generate --account-id {ID} --topic "{拟的题}"` 把这篇产出来；同时提醒「该补选题了 → **`/redbeacon-topics`**」。生产线不因没题硬卡，但用哪个题仍由用户拍板。
• 其它 `{"error":...}` → 把原因给用户（常见：AI key 失效/模型不可用 → `/redbeacon-config` 改；图片模型不可用 → `/redbeacon-panel` 或 `/redbeacon-strategy` 换图片模型）。

一次生成多篇 / 多账号

| 用户说 | 命令 | |---|---| | 一次生成 N 篇 | `redbeacon generate --account-id {ID} --count 3`（连取 3 个未用选题逐篇生成；选题耗尽会提前停） | | 所有账号各生成 | `redbeacon generate --all-accounts --count 2`（每个账号各 2 篇） |

> 批量返回 `{"ok":true,"generated":N,"results":[...]}`，逐条列出每篇的 `content_id` 或 `error`；单账号单篇仍是旧 shape `{"ok":true,"content_id":N}`。 > `--topic` 只能用于单账号单篇；批量一律从选题库取题。 > 生成会自动把本账号最近的标题喂给 AI 做**查重**，规避换汤不换药——但真正的多样性还得靠选题本身覆盖不同应用域（见 `/redbeacon-locate`）。仍**无后台定时**，批量也是前台一次性跑完。

---

选题余量守护（低了**预警**，但不在生产途中硬塞）

**每次生成成功后**（及进生成流程前）查一次余量：

redbeacon topics stats --account-id {ID}

`unused < 5` 就主动在聊天里**预警一句**——但**别把用户按在生产途中逐条挑题**（那是旧做法、打断流）。改成非阻塞提醒 + 一个去处：

> 📌 选题快用完了，只剩 {unused} 条。补题不用现在打断——想补就开一场**选题规划会**（你出想法、我联网取真痛点 + 按定位和应用域铺开、你拍板）：**`/