@topmindspace/topmind-writing-skills 0.8.29 → 0.8.31

package/CHANGELOG.md

@@ -1,3 +1,52 @@
+## [0.8.31] - 2026-10-14
+
+> 根包 0.8.30 → **0.8.31**（patch）；技能版本：topmind-briefs 0.2.13 → 0.2.14、topmind-viral-posts 0.3.5 → 0.3.6、topmind-cover 0.4.6 → 0.4.7、
+> topmind-wechat-post 0.3.5 → 0.3.6、topmind-x-article 0.4.11 → 0.4.12（后两者只同步共享文件）；topmind-poster 不变。
+
+### 特性支持
+
+- **X 短文默认配封面**：briefs 与 viral-posts 的 X 稿默认配 1 张 16:9 封面（1200×675）作为第 1 张图，由 `topmind-cover` 新增的「X 短文封面」场景出图；一手证据图排在封面之后，合计不超过 4 张；用户说不要配图时跳过。
+- **X 稿来源规范**：共享 `x-post-format.md` 新增「来源与核实」——一手来源优先、二手至少 2 个独立来源交叉确认，厂商数字标「（厂商口径）」、未证实消息标「（传言）」，正文后单独一行 `来源：名称 URL`（最多 3 条）；新增三种版式骨架（钩子 + 列表 / 步骤 / 对比）和留白、emoji 分寸规则。
+- `lint_x_post.py` 新增三类警告：点缀表情过多（W8）、疑似 AI 套话（W9）、有数据但缺来源（W10）；只警告，不改变退出码（`--strict` 时算失败）。
+- `topmind-cover`：
+  - 新增「场景 → 风格 → 标题花式」选型表（9 个场景，每个场景 3 种风格轮换）和封面多样性规则（相邻封面在风格 / 花式 / 背景中至少换两项）。
+  - `typography-system.md` 新增 12 种标题花式（T1 巨字压版 … T12 贴纸描边）与 10 类背景库。
+  - `cover-prompts.md` 补齐橙色暖阳、卡通素描、赛博霓虹三种风格的完整提示词（第 1 章覆盖全部 22 种风格），新增第 2 章 X 短文 16:9 封面的 6 条场景提示词与填充示例；第 4 章场景推荐补 4 行。
+  - `crop-cover.py` 新增 `--preset x-post`，输出 `00-封面-X短文.png`（1200×675）；默认行为不变。
+
+### 修复
+
+- `cover-prompts.md` 里的变量占位符此前全部丢失（只剩 `""`、`（）` 和附录空白列），提示词无法照填；现统一恢复为 `【标题】`、`【胶囊标签】` 等 `【】` 变量。
+- `cover-prompts.md` 标题「十九种」、样张数「42 张」与实际不符，改为 22 种风格、55 张样张。
+- `topmind-cover/SKILL.md` 风格索引只列了 19 种且浅深色分组写错，改为完整 22 种并标注色调；两份 cover README 的风格列表补上橙色暖阳、卡通素描、赛博霓虹。
+
+### 优化
+
+- **去 AI 味**：共享 `writing-principles.md` 新增「去 AI 味清单」（11 类常见句式及改法 + 朗读 / 删句 / 替换三项自查），并分发到 `topmind-viral-posts`；viral-posts 的写作铁律指向这份清单。
+- briefs、viral-posts 的工作流、自检、输出模板加上来源行、封面和 lint 警告处理；briefs 增加一个带来源行的 X 版示例。
+- `evals/evals.json` 增至 53 条（X 短文封面、带来源的 X 短文、带配图和来源的热点段子）。
+- 根 README 中英文、各技能 README 与 `docs/PUBLISHING.md` 的版本号和能力描述同步。
+
+## [0.8.30] - 2026-10-11
+
+> 根包 0.8.29 → **0.8.30**（patch）；技能版本：topmind-briefs 0.2.12 → 0.2.13、topmind-viral-posts 0.3.4 → 0.3.5、topmind-x-article 0.4.10 → 0.4.11、
+> topmind-wechat-post 0.3.4 → 0.3.5、topmind-cover 0.4.5 → 0.4.6、topmind-poster 0.1.3 → 0.1.4。
+
+### 特性支持
+
+- **X 纯文本排版**：X 不渲染 Markdown 列表，X 稿一律改用 emoji 项目符号（🔹 并列、▫️ 二级缩进、1️⃣ 步骤、✅/❌ 对比，最多两层）。新增共享规则文档 `references/x-post-format.md`（符号集、缩进、数量、语气适配、公众号稿 → X 稿的派生规则：只允许排版差异），分发到 briefs、viral-posts、wechat-post、x-article。
+- **X 稿检查脚本** `scripts/lint_x_post.py`（共享真源，分发到 briefs、viral-posts、wechat-post、x-article）：检查 Markdown 列表 / 标题 / 加粗 / 引用 / 链接 / 表格，以及同层符号混用、缩进层级、话题标签数量与位置、加权字数；`--fix --out` 可自动改写，`--long` 用于长文兜底稿。公众号稿不在检查范围内，继续用 Markdown 列表。
+- `topmind-x-article`：`md2x.py` 生成 `X发布稿.txt` 时默认把 `- ` / `1.` 转成 emoji 项目符号（代码块内不动，`--list-style keep` 保留原符号）；`X长文.html` 走 X Article 编辑器富文本，原生列表保持不变。共享的 `md2x-html.py` 保留普通行的行首缩进，emoji 二级条目不会被吞缩进（briefs、x-article 同步）。
+- `topmind-viral-posts`：新增 `references/tags-and-topics.md`，给 14 个类型建立标签体系——内部分类标签（类型 / 用途 / 平台 / 语气）与话题标签（每条 1–3 个，末行单独成行，中英文、不堆砌、避免违规与敏感标签的规则）；`patterns.md` 的每个类型和示例都带标签行；产出模板新增「标签」输出项。
+- `topmind-briefs`：X 版末尾给 0–2 个话题标签建议（公众号稿不加），平台规格、风格指南和 4 个示例同步改成 emoji 列表。
+
+### 优化
+
+- 触发与分流：briefs、viral-posts、x-article、wechat-post、cover、poster 的 description 补充常用说法（公众号短文、X 短文、段子、涨粉帖、互关帖、热点段子、X 文章、头图、竖版长图、榜单图、海报等），Do NOT 分流互相点名，减少短文 / 段子 / 长文 / 公众号 / 封面 / 长图之间的路由歧义；cover 与 poster 不再各自抢「配图」一词。
+- `evals/evals.json` 从 24 条增至 50 条，补充新触发词与边界的正例和反例；`scripts/check_evals.js` 新增两项检查：用例 prompt 必须命中其 expected_skill 的触发词，description 的 Do NOT 只能指向存在的技能。
+- 文档一致性：根 README 中英文的 viral-posts 类型数（14 类型）、cover 裁剪尺寸（X 1500×600）、风格数（22 种）与实际对齐，英文 README 补上 viral-posts 小节；x-article README 的封面尺寸改为 1500×600；briefs 与 viral-posts 的文案改用更平实的表述。
+- `topmind-cover` 补充被 viral-posts 调用时的画幅说明；`topmind-wechat-post` 补充与 briefs 的篇幅边界以及 X 稿派生时的列表规则。
+
 ## [0.8.29] - 2026-10-11
 
 > 根包 0.8.28 → **0.8.29**（patch）；技能版本：topmind-briefs 0.2.11 → 0.2.12、topmind-cover 0.4.4 → 0.4.5、topmind-poster 0.1.2 → 0.1.3。

package/README.en.md

@@ -27,7 +27,7 @@ npx @topmindspace/topmind-writing-skills install topmind-wechat-post
 
 ### topmind-x-article · One-click X long-form publishing
 
-Markdown draft → paste-ready plain text (`md2x.py` adapts to the X Article editor: images → `[图N]`, tables → "item: value" lists) + cover art + publish checklist. Publishing is done by hand-pasting; fetch the text back for verification after posting.
+Markdown draft → one-click-copy HTML (rich text, images embedded) / plain-text fallback (`md2x.py`: images → `[图N]`, tables → "item: value" lists, lists → emoji bullets because plain-text X does not render Markdown lists) + cover art + publish checklist. Publishing is done by hand-pasting; fetch the text back for verification after posting.
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-x-article
@@ -35,15 +35,23 @@ npx @topmindspace/topmind-writing-skills install topmind-x-article
 
 ### topmind-briefs · Short-form briefs
 
-Short-form briefs for WeChat + X: one topic, one chart (data rankings / paper one-liners / product alerts / mechanism explainers). One X post or short thread, WeChat ~300–800 Chinese characters, 1 key visual. One-click-copy HTML for both, draft only — never auto-post.
+Short-form briefs for WeChat + X: one topic, one chart (data rankings / paper explainers / product alerts / mechanism explainers). One X post or short thread, WeChat ~300–800 Chinese characters, 1 key visual. The X version uses emoji bullets and suggests 0–2 hashtags; the WeChat version keeps Markdown lists. One-click-copy HTML for both, draft only — never auto-post.
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-briefs
 ```
 
+### topmind-viral-posts · X viral short posts
+
+14 post types summarised from common high-engagement writing patterns in the Chinese X community (all examples are original): short lines, conversational tone, an engagement hook, **one image per post** (portraits / pets / landscapes / fantasy / slogan graphics via `topmind-cover`). Every post carries **1–3 hashtags plus classification tags** (type / purpose / platform / tone). X drafts never use Markdown lists; bullets are emoji.
+
+```bash
+npx @topmindspace/topmind-writing-skills install topmind-viral-posts
+```
+
 ### topmind-cover · Cover art generation
 
-Shared cover art for X long-form and WeChat: striking, eye-catching, theme-focused. **Pick a style → check the example → compose the prompt from the recipe**, then one-click crop to both platform sizes with `crop-cover.py` (X 1200×675, WeChat 900×383). 11-style index and recipes: [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md).
+Shared cover art for X long-form and WeChat: striking, eye-catching, theme-focused. **Pick a style → check the example → compose the prompt from the recipe**, then one-click crop to both platform sizes with `crop-cover.py` (X 1500×600, WeChat 900×383). 22-style index and recipes: [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md).
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-cover
@@ -73,14 +81,14 @@ npx @topmindspace/topmind-writing-skills install topmind-poster
 
 | Skill | Version | What it does |
 |-------|---------|--------------|
-| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.4** | WeChat article lifecycle: package, review, 3 quality gates, inline typography & publish checklist |
-| [`topmind-x-article`](./topmind-x-article/) | **0.4.10** | X long-form one-click publish: Markdown → one-click-copy HTML (images/prompt copy, click-to-zoom images) / plain-text fallback + cover + checklist |
-| [`topmind-cover`](./topmind-cover/) | **0.4.5** | Cover art for X / WeChat (X master 1500×600 / 5:2): striking, theme-focused; 22-style cover style library + 55 example images (22 styles × 2 sizes + 11 variant samples) + 1 style overview |
-| [`topmind-briefs`](./topmind-briefs/) | **0.2.12** | Short-form briefs (WeChat + X): one topic, one chart; data rankings / paper one-liners / product alerts / mechanism explainers; one-click-copy HTML for both |
-| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.4** | X viral short posts: 14 template types (incl. trending-news type); prefer original images (official/third-party), generate only when none exists |
-| [`topmind-poster`](./topmind-poster/) | **0.1.3** | HTML+CSS → high-res long image / poster / infographic PNG: headless Chrome 2× screenshot + auto-trim; "one image per section" batch workflow (generator + renderer) |
-
-Installer [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) is **0.8.29** (whole-repo same-tag releases).
+| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.6** | WeChat article lifecycle: package, review, 3 quality gates, inline typography & publish checklist |
+| [`topmind-x-article`](./topmind-x-article/) | **0.4.12** | X long-form one-click publish: Markdown → one-click-copy HTML (images/prompt copy, click-to-zoom images) / plain-text fallback + cover + checklist |
+| [`topmind-cover`](./topmind-cover/) | **0.4.7** | Cover art for X / WeChat (X master 1500×600 / 5:2): striking, theme-focused; 22-style cover style library + 16:9 X short-post cover scene + 12 title treatments + 55 example images (22 styles × 2 sizes + 11 variant samples) + 1 style overview |
+| [`topmind-briefs`](./topmind-briefs/) | **0.2.14** | Short-form briefs (WeChat + X): one topic, one chart; data rankings / paper explainers / product alerts / mechanism explainers; plain-text X version with emoji bullets, source links, a default 16:9 cover and hashtag suggestions; one-click-copy HTML for both |
+| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.6** | X viral short posts: 14 template types (incl. trending-news type), hashtags + classification tags, plain-text emoji-bullet lists, source links for factual posts; every post gets an image by default — original images first, otherwise a 16:9 cover via topmind-cover |
+| [`topmind-poster`](./topmind-poster/) | **0.1.4** | HTML+CSS → high-res long image / poster / infographic PNG: headless Chrome 2× screenshot + auto-trim; "one image per section" batch workflow (generator + renderer) |
+
+Installer [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) is **0.8.31** (whole-repo same-tag releases).
 
 > SKILL.md frontmatter uses only Agent Skills spec keys at the top level (`name` / `description` / `license` / `metadata`); version, `action_category`, `triggers` and other custom keys live under `metadata` as strings, so `skills-ref validate` passes. Shared scripts and `writing-principles.md` have a single source in `shared/`; skill folders keep byte-identical copies (CI checks with `node scripts/sync_shared.js --check`). The npm package ships only `overview.png` from the cover examples; the per-style samples stay on GitHub / in the Release zip.
 

package/README.md

@@ -25,7 +25,7 @@ npx @topmindspace/topmind-writing-skills install topmind-wechat-post
 
 ### topmind-x-article · X 长文一键发布
 
-Markdown 原稿 → 可直接粘贴的纯文本（`md2x.py` 按 X Article 编辑器支持转制：图片→`[图N]`、表格→"项：值"列表）+ 封面图 + 发布清单。发布走人工粘贴，发布后抓回核对。
+Markdown 原稿 → 一键复制 HTML（富文本，配图内嵌）/ 纯文本兜底（`md2x.py`：图片→`[图N]`、表格→"项：值"列表、列表→emoji 项目符号，因为 X 纯文本不渲染 Markdown 列表）+ 封面图 + 发布清单。发布走人工粘贴，发布后抓回核对。
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-x-article
@@ -33,7 +33,7 @@ npx @topmindspace/topmind-writing-skills install topmind-x-article
 
 ### topmind-briefs · 干货短文
 
-公众号 + X 双平台干货短文：一件事讲透（数据榜单 / 论文一句话解读 / 新品速递 / 机制讲解），X 一帖或短 thread、公众号约 300–800 字，1 张核心图。双版一键复制 HTML，只起草不代发。
+公众号 + X 双平台干货短文：一件事讲透（数据榜单 / 论文解读 / 新品速递 / 机制讲解），X 一帖或短 thread、公众号约 300–800 字，1 张核心图。X 版用 emoji 项目符号分点、附 0–2 个话题标签建议；公众号版保留 Markdown 列表。双版一键复制 HTML，只起草不代发。
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-briefs
@@ -41,24 +41,24 @@ npx @topmindspace/topmind-writing-skills install topmind-briefs
 
 ### topmind-viral-posts · X 引流段子/爆款短篇
 
-基于对 X 中文区常见高互动写法的归纳，提供 6 大类型模板（干货忠告/互关求粉/自嘲幽默/互动提问/打卡日常/新人报到；示例均为自编），短句分行、口语化、带互动钩子，**每帖配 1 张图**（美女/宠物/风景/奇幻/标语，走 topmind-cover 出图）。
+基于对 X 中文区常见高互动写法的归纳，提供 14 类型模板（示例均为自编），短句分行、口语化、带互动钩子，**每帖配 1 张图**（美女/宠物/风景/奇幻/标语，走 topmind-cover 出图），并附**话题标签（1–3 个 hashtag）与内部分类标签**；X 稿不用 Markdown 列表，分点用 emoji 项目符号。
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-viral-posts
 ```
 
-> 7 大类型：干货忠告 / 互关求粉 / 自嘲幽默 / 互动提问 / 打卡日常 / 新人报到 / **热点资讯**（基于真实检索，配官方原图可多图）。
+> 14 类型：干货忠告 / 互关求粉 / 自嘲幽默 / 互动提问 / 打卡日常 / 新人报到 / **热点资讯**（基于真实检索，配官方原图可多图）/ 暴论 / 数据晒单 / 真诚交友 / 吐槽共鸣 / 干货技巧 / 经验忠告 / 执行清单。
 
 ### topmind-cover · 封面配图生成
 
-X 长文与公众号共用的封面图：震撼、醒目、主题突出。**选风格 → 看示例 → 按配方组 prompt** 三步出图，`crop-cover.py` 一键裁出双平台尺寸（X 1200×675、公众号 900×383）。22 种风格索引与配方见 [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md)。
+X 长文与公众号共用的封面图：震撼、醒目、主题突出。**选风格 → 看示例 → 按配方组 prompt** 三步出图，`crop-cover.py` 一键裁出双平台尺寸（X 1500×600、公众号 900×383），`--preset x-post` 落盘 X 短文封面（1200×675）。22 种风格索引与配方见 [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md)。
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-cover
 ```
 
 <p align="center">
-  <img src="https://github.com/topmindspace/topmind-writing-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 19 封面风格总览" width="960" />
+  <img src="https://github.com/topmindspace/topmind-writing-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 22 封面风格总览" width="960" />
 </p>
 
 > 让 idea 飞，好想法被看见。
@@ -81,14 +81,14 @@ npx @topmindspace/topmind-writing-skills install topmind-poster
 
 | 技能 | 版本 | 做什么 |
 |------|------|--------|
-| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.4** | 公众号文章全生命周期：交付包、审校改写、质量三关、微信内联排版与发布清单 |
-| [`topmind-x-article`](./topmind-x-article/) | **0.4.10** | X 长文一键发布：Markdown 原稿 → 一键复制 HTML（含配图/提示词复制、图片点击放大）/ 纯文本兜底 + 封面图 + 发布清单 |
-| [`topmind-cover`](./topmind-cover/) | **0.4.5** | 文章封面配图（X / 公众号共用，X 主尺寸 1500×600 / 5:2）：震撼醒目主题突出；22 种封面风格库 + 55 张示例图（22 种风格 × 2 尺寸 + 11 张变体样张） + 1 张风格总览图 |
-| [`topmind-briefs`](./topmind-briefs/) | **0.2.12** | 干货短文（公众号 + X 双平台）：一件事讲透，数据榜单/论文解读/新品速递；双版一键复制 HTML |
-| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.4** | X 引流段子/爆款短篇：14 大类型模板（含热点资讯型）；配图原图优先（官方/第三方），无原图才生图（清新优雅/MD3商务风） |
-| [`topmind-poster`](./topmind-poster/) | **0.1.3** | HTML+CSS → 高清长图 / 海报 / 信息图 PNG：无头 Chrome 2× 截图 + 自动裁白；「一段一图」分段图批量出图（生成器 + 渲染器） |
-
-安装器 [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) 为 **0.8.29**（整仓同 tag 发版）。
+| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.6** | 公众号文章全生命周期：交付包、审校改写、质量三关、微信内联排版与发布清单 |
+| [`topmind-x-article`](./topmind-x-article/) | **0.4.12** | X 长文一键发布：Markdown 原稿 → 一键复制 HTML（含配图/提示词复制、图片点击放大）/ 纯文本兜底 + 封面图 + 发布清单 |
+| [`topmind-cover`](./topmind-cover/) | **0.4.7** | 文章封面配图（X / 公众号共用，X 主尺寸 1500×600 / 5:2）：震撼醒目主题突出；22 种封面风格库 + X 短文 16:9 封面场景 + 12 种标题花式 + 55 张示例图（22 种风格 × 2 尺寸 + 11 张变体样张） + 1 张风格总览图 |
+| [`topmind-briefs`](./topmind-briefs/) | **0.2.14** | 干货短文（公众号 + X 双平台）：一件事讲透，数据榜单/论文解读/新品速递；X 版纯文本 + emoji 列表 + 来源链接 + 默认 16:9 封面 + 话题标签建议；双版一键复制 HTML |
+| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.6** | X 引流段子/爆款短篇：14 大类型模板（含热点资讯型），纯文本 emoji 列表、事实类带来源链接、带话题标签与分类标签；每条默认配图，原图优先（官方/第三方），无原图走 topmind-cover 出 16:9 封面（清新优雅/MD3商务风） |
+| [`topmind-poster`](./topmind-poster/) | **0.1.4** | HTML+CSS → 高清长图 / 海报 / 信息图 PNG：无头 Chrome 2× 截图 + 自动裁白；「一段一图」分段图批量出图（生成器 + 渲染器） |
+
+安装器 [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) 为 **0.8.31**（整仓同 tag 发版）。
 
 > SKILL.md frontmatter 顶层只用 Agent Skills 规范字段（`name` / `description` / `license` / `metadata`），版本、`action_category`、`triggers` 等自定义字段放在 `metadata` 下（字符串值），能通过官方校验器 `skills-ref validate`。
 >

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/topmind-writing-skills",
-  "version": "0.8.29",
+  "version": "0.8.31",
   "description": "TopMindSpace 写作技能合集 — 通过 npm / npx 安装技能（公众号长文、X 长文、干货短文、X 引流短帖、封面图、长图海报）。只出稿与发布包，不代发。",
   "license": "MIT",
   "author": "TopMindspace",

package/topmind-briefs/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.2.13 (2026-10-11)
+
+- 特性支持：X 版纯文本排版——不用 Markdown 列表、标题和加粗，分点改用 emoji 项目符号；新增共享规则文档 `references/x-post-format.md` 与检查脚本 `scripts/lint_x_post.py`
+- 特性支持：X 版末尾给 0–2 个话题标签建议（公众号稿不加），规则写入 `platform-specs.md`；`examples.md` 的 4 个 X 示例同步改成 emoji 列表并附话题标签建议
+- 优化：description 补充「公众号短文、X 短文、简讯、速报、论文解读」等说法，Do NOT 增加封面分流并点名 viral-posts 的段子、涨粉帖、互关帖；文案改用更平实的表述
+
 ## 0.2.12 (2026-10-11)
 
 - 优化：description 的 Do NOT 增加「单独出长图/海报/信息图 PNG → topmind-poster」分流，与 poster 的触发词边界互相点名

package/topmind-briefs/README.en.md

@@ -2,11 +2,11 @@
 
 **[中文](./README.md)** | English
 
-One topic, one chart, then stop. Data-driven short posts: rankings, paper TL;DRs,
+One topic, one chart, then stop. Data-driven short posts: rankings, paper explainers,
 product launches — one X post or short thread, ~300–800 Chinese characters on WeChat,
 one-click-copy HTML for both.
 
-- Version: **v0.2.12** (ships with `@topmindspace/topmind-writing-skills@0.8.29`)
+- Version: **v0.2.14** (ships with `@topmindspace/topmind-writing-skills@0.8.31`)
 
 ## Install
 
@@ -32,6 +32,19 @@ scripts in `topmind-x-article` / `topmind-wechat-post`; inside the repo,
 `scripts/negative_tests.py` checks they stay in sync. See [SKILL.md](./SKILL.md)
 for the full workflow.
 
+## X formatting and hashtags
+
+X does not render Markdown, so the X version never uses `- ` lists, `#` headings or `**bold**`. Lists use emoji bullets
+(🔹 items, ▫️ sub-items, 1️⃣ steps, ✅/❌ contrasts); one style per post, one item per line, at most two levels.
+The WeChat draft keeps Markdown lists; the X draft is derived from it and only the layout may differ.
+Each X version ends with 0–2 suggested hashtags on their own last line (none on the WeChat version). See
+[references/x-post-format.md](./references/x-post-format.md) and [references/platform-specs.md](./references/platform-specs.md).
+
+```bash
+# Check the X version: no Markdown list/heading/bold, hashtags on the last line; add --fix --out to rewrite
+python3 scripts/lint_x_post.py brief-x.md
+```
+
 ## Content types
 
 - Data rankings / ranking alerts / paper explainers / mechanism explainers
@@ -42,4 +55,5 @@ for the full workflow.
 ## When NOT to use
 
 X long-form → `topmind-x-article`; WeChat long-form → `topmind-wechat-post`;
-engagement-style short posts → `topmind-viral-posts`; posting → `topmind-x` (only after the user confirms).
+engagement-style short posts and jokes → `topmind-viral-posts`; standalone long images/posters → `topmind-poster`;
+covers and header images → `topmind-cover`; posting → `topmind-x` (only after the user confirms).

package/topmind-briefs/README.md

@@ -2,10 +2,10 @@
 
 [English](./README.en.md) | 中文
 
-一件事，一张图，讲完就停。干货向短文：数据榜单、论文一句话解读、新品速递——
+一件事，一张图，讲完就停。干货向短文：数据榜单、论文解读、新品速递——
 X 一帖或短 thread，公众号约 300–800 字，双版一键复制 HTML。
 
-- 版本：**v0.2.12**（随 `@topmindspace/topmind-writing-skills@0.8.29` 发布）
+- 版本：**v0.2.14**（随 `@topmindspace/topmind-writing-skills@0.8.31` 发布）
 
 ## 安装
 
@@ -29,6 +29,18 @@ python3 scripts/md2wechat.py --input 公众号短文.md --out-dir 交付 --slug
 唯一真源在仓库 `shared/scripts/`，与 `topmind-x-article` / `topmind-wechat-post` 是同一份逐字节副本，
 仓库 CI 用 `node scripts/sync_shared.js --check` 校验一致。工作流细节见 [SKILL.md](./SKILL.md)。
 
+## X 版格式与话题标签
+
+X 不渲染 Markdown，X 版不用 `- ` 列表、`#` 标题和 `**加粗**`：分点用 emoji 项目符号（🔹 并列、▫️ 二级、1️⃣ 步骤、✅/❌ 对比），
+同帖风格一致、每条一行、最多两层。公众号稿继续用 Markdown 列表；X 稿由公众号稿派生，只允许排版差异，内容一致。
+X 版末尾附 0–2 个话题标签建议（单独成行放最后，公众号稿不加）。规则见 [references/x-post-format.md](./references/x-post-format.md)
+与 [references/platform-specs.md](./references/platform-specs.md)。
+
+```bash
+# 检查 X 版：无 Markdown 列表/标题/加粗，话题标签在末行；加 --fix --out 自动改写
+python3 scripts/lint_x_post.py X短文.md
+```
+
 ## 内容类型
 
 - 数据榜单型 / 榜单速报型 / 论文解读型 / 机制讲解型（见 SKILL.md，四种常用结构）
@@ -37,4 +49,5 @@ python3 scripts/md2wechat.py --input 公众号短文.md --out-dir 交付 --slug
 ## 何时不用
 
 X 长文 → `topmind-x-article`；公众号长文 → `topmind-wechat-post`；
-引流互动型短帖 → `topmind-viral-posts`；发帖 → `topmind-x`（须用户确认）。
+引流互动型短帖与段子 → `topmind-viral-posts`；单独出长图/海报 → `topmind-poster`；
+封面/头图 → `topmind-cover`；发帖 → `topmind-x`（须用户确认）。

package/topmind-briefs/SKILL.md

@@ -1,27 +1,29 @@
 ---
 name: topmind-briefs
-description: "干货短文发布：公众号 + X 双平台，一件事讲透。X 一帖或短 thread，公众号约 300–800 字；1 张核心图（榜单/基准/截图/表格），不废话，只交付不代发。Use when 写短文、发快讯、数据榜单、论文一句话解读、新品速递、来篇短的、短平快、brief、快讯；信息密度型（数据、榜单、发布）走本技能。Do NOT use for X 长文（→ topmind-x-article）、公众号长文（→ topmind-wechat-post）、引流互动型短帖与段子（→ topmind-viral-posts）、单独出长图/海报/信息图 PNG（→ topmind-poster）、把稿子发出去（→ topmind-x，须用户确认）。"
+description: "干货短文发布：公众号 + X 双平台，一件事讲透。X 一帖或短 thread（纯文本，列表用 emoji 项目符号，带来源链接，默认配 16:9 封面，附 0–2 个话题标签建议），公众号约 300–800 字；1 张核心图（榜单/基准/截图/表格），不废话，只交付不代发。Use when 写短文、公众号短文、X 短文、发快讯、简讯、速报、数据榜单、榜单速报、论文解读、新品速递、来篇短的、短平快、brief；信息密度型（数据、榜单、发布）走本技能。Do NOT use for X 长文与发 X 文章（→ topmind-x-article）、公众号长文（→ topmind-wechat-post）、引流互动型短帖、段子、涨粉帖、互关帖、爆款短篇（→ topmind-viral-posts）、单独出长图/海报/信息图 PNG（→ topmind-poster）、封面与头图（→ topmind-cover）、把稿子发出去（→ topmind-x，须用户确认）。"
 license: MIT
 metadata:
-  version: "0.2.12"
+  version: "0.2.14"
   action_category: "write"
-  triggers: "写短文, 发快讯, 干货短文, 一句话解读, 数据榜单, 新品速递, brief, 快讯, 来篇短的, 短平快, 发个快讯"
+  triggers: "写短文, 公众号短文, X 短文, 发快讯, 快讯, 简讯, 速报, 干货短文, 论文解读, 数据榜单, 榜单速报, 新品速递, brief, 来篇短的, 短平快, 发个快讯"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-writing-skills#readme"
-  updated: "2026-10-11"
+  updated: "2026-10-14"
 ---
 
 # topmind-briefs · 干货短文（公众号 + X）
 
 一件事，一张图，讲完就停。跟 `topmind-viral-posts` 的区别：
 那是引流互动型短帖（段子、钩子、涨粉）；这是**信息密度型干货短文**（数据、榜单、
-论文、新品，第三方客观口吻）。
+论文、新品，第三方客观口吻）。公众号文章如果是长文（深度稿、多图多节），走 `topmind-wechat-post`；
+本技能的公众号版只有 300–800 字。
 
 ## 何时不用
 
-- X 长文（数千字深度稿）→ `topmind-x-article`
+- X 长文（数千字深度稿）、发 X 文章 → `topmind-x-article`
 - 公众号长文 → `topmind-wechat-post`
-- 引流互动型短帖（第一人称、段子、钩子、涨粉）→ `topmind-viral-posts`
+- 引流互动型短帖（第一人称、段子、钩子、涨粉、互关）→ `topmind-viral-posts`
+- 单独出长图、海报、信息图 PNG → `topmind-poster`；只要封面、头图 → `topmind-cover`
 - 把稿子发到 X → `topmind-x`（发帖连接器，须用户确认后才发）
 - 需要多张配图、复杂排版的稿件（本技能只配 1 张核心图）
 
@@ -43,12 +45,17 @@ metadata:
    没有现成图才自制（只做对比表、趋势图这种信息图，不做装饰图）。
 3. **写**：按 `references/style-guide.md` 写。X 版和公众号版各写一版，
    内容一致，篇幅按平台调整（见 `references/platform-specs.md`）。
+   **X 版是纯文本**：不用 Markdown 列表、标题和加粗（X 不渲染），分点用 emoji 项目符号，
+   正文后单独一行写来源（直接贴 URL），并给出 0–2 个话题标签建议（见下节「X 版格式与话题标签」）。
+   **X 版默认配封面**：调用 `topmind-cover` 的「X 短文封面」场景出 1 张 16:9 封面（1200×675），作为第 1 张图；
+   核心证据图（榜单、基准、截图）排在封面之后，总数不超过 4 张。用户说不要封面时跳过。
 4. **自检**：过一遍禁止清单；确认每个数字都有来源；确认图和文字说的是同一件事；
-   推测/判断必须显式标注"（推测）"，与事实段落切割，不混写。
-5. **交付**：双版 HTML，一键复制（只交付，不发布）。两个脚本随本技能自带
+   推测/判断必须显式标注"（推测）"，与事实段落切割，不混写；按 `references/writing-principles.md`「去 AI 味清单」过一遍；
+   X 版跑 `python3 scripts/lint_x_post.py X短文.md`，错误清零，W8（表情过多）/ W9（AI 套话）/ W10（缺来源）警告逐条处理。
+5. **交付**：双版 HTML，一键复制，外加 X 版纯文本稿 `X短文.txt`、X 封面 `00-封面-X短文.png` 与话题标签建议（只交付，不发布）。两个脚本随本技能自带
    （`scripts/` 下，纯 Python 标准库），单独安装本技能即可运行，不依赖其它技能目录——
    - X 版：`python3 scripts/md2x-html.py X短文.md --out X短文.html --images-from 公众号短文.md`
-     （无封面；1–4 张图按 [图N] 顺序嵌入；thread 超长时拆条）。
+     （HTML 里不嵌封面，封面单独交付、发帖时作为第 1 张图上传；1–4 张正文图按 [图N] 顺序嵌入；thread 超长时拆条）。
      **禁止手工拼 `--images`**：文件名排序 ≠ 文档顺序，手工传参曾导致整段配图错位；
      脚本内置 `[图N]` 连续性 + 数量校验，不通过直接报错。
      公众号稿里必须有对应的本地图片 `![图注](图片路径)`，只写链接或占位文字时数量校验会报错。
@@ -61,19 +68,61 @@ metadata:
      （逐张解码与源文件比对）；[图N] 编号连续；
      X 版内嵌图序列（无封面）与公众号版逐字节一致。
 
+## X 版格式与话题标签
+
+**列表**：X 不渲染 Markdown，X 版里没有 `- ` / `1.` 列表、`#` 标题、`**加粗**`。分点用 emoji 项目符号，
+同一帖内风格一致，每条一行，二级条目缩进两格，最多两层：
+
+| 用途 | 符号 |
+|---|---|
+| 并列要点 | 🔹（二级 ▫️） |
+| 步骤 | 1️⃣ 2️⃣ 3️⃣ |
+| 结论 / 对比 | ✅ / ❌ |
+| 重点数据 | 📌 📊 |
+| 严肃资讯 | • ▪ |
+
+完整规则（符号集、缩进、数量、语气适配、版式骨架）见 [references/x-post-format.md](references/x-post-format.md)。
+
+**来源**：每个数字都要能追到出处。正文之后单独一行 `来源：<名称> <URL>`，最多 3 条；厂商数字标「（厂商口径）」，
+未证实消息标「（传言）」。X 版示例：
+
+```text
+SWE-bench Verified 榜单 10 月 13 日更新，第一名换人了。
+
+📊 前三名
+🔹 模型 A：78.2%
+🔹 模型 B：76.9%
+🔹 模型 C：74.5%
+
+分数为榜单官方口径，成本差距见图 2。
+
+来源：SWE-bench 官方榜单 https://www.swebench.com
+
+#SWEbench #AI编程
+```
+
+（示例中的模型名与分数为虚构演示。）
+
+**公众号稿 → X 稿**：公众号稿用 Markdown 列表，X 稿由它派生，列表改成 emoji 项目符号，只允许排版差异，
+数字、结论、条数和顺序保持一致。公众号稿不受影响，继续用 Markdown 列表。
+
+**话题标签**：X 版末尾给 0–2 个话题标签建议（另给 1 个备选），单独成行放在最后：
+榜单、发布类取榜单名或产品通用名，再加 1 个领域词；不堆砌，不蹭无关热点，不用诱导互动或敏感标签；
+中文帖用中文话题，英文帖用英文驼峰。公众号稿不加话题标签。细则见 `references/platform-specs.md`。
+
 ## 内容类型（四种）
 
 | 类型 | 适用 | 结构 |
 |------|------|------|
-| 数据榜单型 | 基准评测、成本对比 | 判断句开头 → 基准一句话 → 最扎眼数字 → 双图（解决率+成本） |
+| 数据榜单型 | 基准评测、成本对比 | 判断句开头 → 基准一句 → 最扎眼数字 → 双图（解决率+成本） |
 | 榜单速报型 | 排行榜更新、排名变动 | "Just in:"+排名+分数 → 性价比 → 细分展开 → 纵向对比 → 榜单实拍 |
-| 论文解读型 | 新论文、新方法 | 加粗判断 → "New idea: X"+3 bullets → 论文原图 |
-| 机制讲解型 | 技术原理、流程拆解 | 痛点一句话 → 分步机制 → "In short:"三行 → 流程图/视频 |
+| 论文解读型 | 新论文、新方法 | 判断句开头 → "New idea: X"+3 条 emoji 要点 → 论文原图 |
+| 机制讲解型 | 技术原理、流程拆解 | 痛点一句 → 序号分步（1️⃣2️⃣3️⃣）→ "In short:"三行 → 流程图/视频 |
 
 ## 配图铁律
 
 - 一篇配 1 张核心图，最多 4 张。每张图必须承载信息，装饰图一律不要。
-- 图注一句话说明这张图在证明什么。
+- 图注写一句，说明这张图在证明什么。
 - **位置**：图片必须紧跟它证明的那段文字之后（最多隔一段）；章节题图放在节首。
   禁止"图堆在节末"、"图与文字错位到下一节"。
 - X：图片按顺序编号，文字里用 [图1] 标注对应关系。

package/topmind-briefs/package.json

@@ -9,5 +9,5 @@
     "type": "git",
     "url": "git+https://github.com/topmindspace/topmind-writing-skills.git"
   },
-  "version": "0.2.12"
+  "version": "0.2.14"
 }

package/topmind-briefs/references/examples.md

@@ -1,8 +1,10 @@
 # 示例 · 干货短文（自编示例）
 
 > 说明：以下均为自己编写的示例，模型名、基准名、数字皆为虚构，仅用来演示各类型的结构，不对应任何真实帖子或账号。
-> 自己写 X 版时，列表符号按 `style-guide.md` 用纯文本 `• ` / `▪ ` / emoji
->（X 不渲染 Markdown）；下面示例里为了便于阅读使用了 `- `，实际发布时请替换。
+> X 版不用 Markdown 列表（X 不渲染），分点一律用 emoji 项目符号，规则见 [x-post-format.md](x-post-format.md)；
+> 每个 X 版示例末尾带“话题标签建议”（0–2 个，另给 1 个备选），规则见 `platform-specs.md`。
+> 公众号版保留 Markdown 列表。
+> 例 2、例 4 超过 280 字符，发布时按 thread 拆条（首条放结论和图，次条放细分与收束）；`lint_x_post.py` 对超长帖会给出字数警告，拆条后再检查。
 
 ## 例 1：数据榜单型
 
@@ -17,11 +19,15 @@ For a 300-task run, that is about $75 in total,
 several times cheaper per task than Model B.
 
 [图：上下两张柱状图——任务完成率 vs 单任务成本]
+
+#ToyBench #AIAgents
 ```
 
+话题标签建议：`#ToyBench #AIAgents`（备选 `#LLMEval`）
+
 结构拆解：
-1. 判断句开头（一句话观点）
-2. 基准是什么（一句话）
+1. 判断句开头（观点一句）
+2. 基准是什么（一句）
 3. 最扎眼的数字（64%、~$75、几倍差价）
 4. 图：完成率和成本两张图并置
 
@@ -33,16 +39,24 @@ and #4 on ToyArena Code with 1310 pts.
 
 Price: $3 per million tokens, the lowest among the top five.
 
-Strongest categories: math, long documents, multilingual prompts.
+Strongest categories:
+🔹 Math
+🔹 Long documents
+🔹 Multilingual prompts
+
 +12 pts over Model D; up three places since the last update.
 
 [图：两个榜单的排行榜截图各一张]
+
+#ToyArena
 ```
 
+话题标签建议：`#ToyArena`（备选 `#AIRankings`）
+
 结构拆解：
 1. "Just in:" + 排名 + 分数（开头即全部关键信息）
-2. 价格/性价比（一句话）
-3. 细分维度展开（列表）
+2. 价格/性价比（一句）
+3. 细分维度展开（emoji 列表，每条一行）
 4. 纵向对比（比上次、比邻位）
 5. 图：排行榜实拍
 
@@ -52,16 +66,21 @@ Strongest categories: math, long documents, multilingual prompts.
 Short notes can replace long chat histories for agents.
 
 New idea: let the agent write its own memory notes while it works.
-• Keep what the next step needs
-• Drop what it does not
-• Notes live in a plain file, no extra service
+
+🔹 Keep what the next step needs
+🔹 Drop what it does not
+🔹 Notes live in a plain file, no extra service
 
 [图：论文信息图——流程示意 + 三组对比曲线]
+
+#AIAgents #Memory
 ```
 
+话题标签建议：`#AIAgents #Memory`（备选 `#PaperNotes`）
+
 结构拆解：
-1. 加粗判断（有观点，后面有实证）
-2. 方法名/思路一句话 + 3 条 bullet（每条 ≤10 词）
+1. 判断句开头（有观点，后面有实证；X 里不加粗，靠第一行位置突出）
+2. 方法名/思路一句 + 3 条 emoji 要点（每条 ≤10 词）
 3. 图：论文原图（流程 + 结果）
 
 ## 例 4：机制讲解型
@@ -72,28 +91,32 @@ How a cache saves your API bill, step by step.
 Every request pays for the same long prompt prefix again.
 A prompt cache stores that prefix so repeat calls skip the cost.
 
-→ Put the stable text first
-[一句话机制]
+1️⃣ Put the stable text first
+[机制，一句]
 
-→ Send the changing part last
-[一句话机制]
+2️⃣ Send the changing part last
+[机制，一句]
 
-→ Check the hit rate in the usage report
-[一句话机制]
+3️⃣ Check the hit rate in the usage report
+[机制，一句]
 
 In short:
-- Stable prefix: cached.
-- Variable tail: billed normally.
-- Savings show up as cache hits.
+🔹 Stable prefix: cached.
+🔹 Variable tail: billed normally.
+🔹 Savings show up as cache hits.
 
 [视频：缓存命中流程动画]
+
+#PromptCaching #LLMOps
 ```
 
+话题标签建议：`#PromptCaching #LLMOps`（备选 `#APICost`）
+
 结构拆解：
 1. 标题句（"How X works, step by step."）
-2. 痛点（一句话：现有做法缺什么）
-3. 机制分步（→ 标记，每步一句话）
-4. "In short:" 三行收束
+2. 痛点（一句：现有做法缺什么）
+3. 机制分步（1️⃣ 2️⃣ 3️⃣ 序号，每步一句）
+4. "In short:" 三行收束（🔹）
 5. 媒体：流程图/动画 + 文章链接
 
 ---
@@ -118,6 +141,24 @@ In short:
 改写要点：X 版英文直发；公众号版加一句中文背景（"这是什么基准"），
 数字保留英文原样，结论不变。
 
+### 公众号稿 → X 稿：列表怎么转
+
+同一选题的两个版本只允许排版差异，数字、结论、条数、顺序保持一致：
+
+```markdown
+<!-- 公众号稿：Markdown 列表 -->
+- 基准：ToyBench-Tasks
+- 完成率：模型 A 完成 64% 的任务
+  - 单任务成本约 $0.25
+```
+
+```text
+X 稿：emoji 项目符号，二级条目缩进两格
+🔹 基准：ToyBench-Tasks
+🔹 完成率：模型 A 完成 64% 的任务
+  ▫️ 单任务成本约 $0.25
+```
+
 ---
 
 ## 反例（不要这样写）