@topmindspace/topmind-writing-skills 0.8.33 → 0.8.35

package/CHANGELOG.md

@@ -1,3 +1,46 @@
+## [0.8.35] - 2026-10-14
+
+> 根包 0.8.34 → **0.8.35**（patch）；技能版本：topmind-briefs 0.2.17 → 0.2.18、topmind-format 0.1.2 → 0.1.3、topmind-viral-posts 0.3.9 → 0.3.10、
+> topmind-wechat-post 0.3.9 → 0.3.10、topmind-x-article 0.4.15 → 0.4.16；topmind-cover、topmind-poster 不变。
+
+### 变更（更正 0.8.34：短文用 emoji，段子不用）
+
+- **段子体完全不用 emoji**：不加人设点缀（🐔 🐱 🌱）、情绪表情和 emoji 列表符号；分点一条一行、靠行间空行区分，不加任何符号。
+- **短文体分点必须用 emoji 列表符号**，按 `emoji-system.md`（该体系只适用于短文体，段子配额全为 0）。
+- **`format_text.py --mode duanzi`**：去掉原文 emoji 与列表符号（Markdown 列表、🔹 等）后输出纯文字条目；不再接受 `--open` / `--close` / `--title-emoji`（报错退出 2）。
+- **`lint_x_post.py --duanzi`**：新增 W13，段子里出现任何 emoji（含点缀和列表符号）时警告。
+- 同步修正：`x-delivery-contract.md`（第一节改为短文 / 段子对照表，正反例更新）、`x-post-format.md`、`x-layout-patterns.md`、viral-posts SKILL / `patterns.md` / `tags-and-topics.md` 示例去 emoji、format SKILL 与示例、各 README。
+- 评测 63 → 66 条（新增段子零 emoji、段子拒绝点缀、短文 emoji 列表）；format 负向测试改为验证段子去 emoji、拒绝 `--open`、lint W13。
+
+## [0.8.34] - 2026-10-14
+
+> 根包 0.8.33 → **0.8.34**（patch）；技能版本：topmind-briefs 0.2.16 → 0.2.17、topmind-format 0.1.1 → 0.1.2、topmind-viral-posts 0.3.8 → 0.3.9、
+> topmind-wechat-post 0.3.8 → 0.3.9、topmind-x-article 0.4.14 → 0.4.15；topmind-cover、topmind-poster 不变。
+
+### 新增
+
+- **X 文本交付规约** `references/x-delivery-contract.md`（共享，分发到 briefs、format、viral-posts、wechat-post、x-article；各 SKILL.md 开头「必读必守」引用）：
+  - 列表：段子和短文都可以分点，分点必须用 emoji 列表符号，禁用 `- ` `* ` `1. `；段子体条目一条一行、行间空行。
+  - 交付分离：正文单独一个可直接复制的 `text` 块，只放可发布内容（标题、正文、emoji 列表、`来源：名称 URL` 行、末行话题标签）；信源清单、原图 / 配图建议、内部分类与备选标签、说明各自块外另列；多条帖子每条一块；落盘文件同理。附聊天交付正例 2 个、反例 1 个。
+- **`lint_x_post.py` W12**：正文里混入「信源：」「配图：」「说明：」「标签：」「【帖 N】」等非发布内容时警告。
+
+### 变更
+
+- **`format_text.py` 段子体支持列表**：`--mode duanzi` 把 Markdown 列表改成 emoji 列表符号，条目行间空行；`--split` 不拆列表条目。
+- **lint 列表判定**：只隔空行的列表项算同一个列表（段子体列表也查同层混用）；帖子首行的标题 emoji 不再算列表项。
+- 去掉「段子体不用列表符号」等矛盾措辞（`x-post-format.md`、`emoji-system.md`、format SKILL、viral-posts `patterns.md`）。
+- **viral-posts**：Output Contract 与示例改为每条正文单独成块，信源 / 原图 / 内部标签另列；`tags-and-topics.md` 的「标签项」改为块外「内部标签」。
+- **briefs**：交付格式按规约重写；`examples.md` 4 个示例改为中文、去掉正文里的 `[图]` 占位、补来源行；`platform-specs.md`、`style-guide.md` 的重复列表规则改为引用规约。
+- **x-article / wechat-post**：引用规约；x-article 交付物不用 `--list-style keep`。
+- 评测：更新 5 条、新增 4 条（段子分点、多条分块、format 段子列表、briefs 分块交付），共 63 条；format 负向测试补段子列表与 W12 用例。
+
+### 清理
+
+- `x-post-format.md` 重写精简（174 → 93 行）：删除与规约重复的「交付三块」、与 `emoji-system.md` 重复的 emoji 规则、与 `x-layout-patterns.md` 重复的「版式节奏」长段和重复示例。
+- briefs SKILL.md 删除与工作流重复的「配图铁律」节。
+- 删除 `topmind-wechat-post/references/design.md`（无引用；描述的桌面端对拍测试不在本仓库，已过时）。
+- README 中英文新增「X 文本统一规约」表，替换旧的 emoji 体系单行说明；版本号与能力描述同步。
+
 ## [0.8.33] - 2026-10-14
 
 > 根包 0.8.32 → **0.8.33**（patch）；技能版本：topmind-briefs 0.2.15 → 0.2.16、topmind-format 0.1.0 → 0.1.1、topmind-viral-posts 0.3.7 → 0.3.8、

package/README.en.md

@@ -43,21 +43,32 @@ npx @topmindspace/topmind-writing-skills install topmind-briefs
 
 ### topmind-viral-posts · X viral short posts
 
-18 post types plus hook × body × closer combinations, summarised from common high-engagement writing patterns in the Chinese X community (all examples are original): **duanzi layout** (one sentence per line, a blank line between lines), conversational tone, an engagement hook; original images first, optional generated image 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.
+18 post types plus hook × body × closer combinations, summarised from common high-engagement writing patterns in the Chinese X community (all examples are original): **duanzi layout** (one sentence per line, a blank line between lines), conversational tone, an engagement hook; original images first; asks before generating one via `topmind-cover`. Hashtags (1–3) are part of the post body; classification tags (type / purpose / platform / tone) are listed separately. Duanzi posts use no emoji at all — no persona motif, no reaction emoji, no bullet symbols; bullets are plain lines separated by blank lines. Each post is delivered in its own copyable block.
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-viral-posts
 ```
 
-### topmind-format · X plain-text formatter (new)
+### topmind-format · X plain-text formatter
 
-Paste existing text: **to duanzi** → one sentence per line with blank lines between; **to short post** → paragraphing, emoji bullets, a keyword-matched title emoji and the chicken/cat/plant persona motif (🐔 🐱 🌱 🌸) at the start or end. Layout only — words never change; `format_text.py` enforces fidelity.
+Paste existing text: **to duanzi** → one sentence per line with blank lines between, all emoji and bullet symbols removed; **to short post** → paragraphing, emoji bullets, a keyword-matched title emoji and the chicken/cat/plant persona motif (🐔 🐱 🌱 🌸) at the start or end. Layout only — words never change; `format_text.py` enforces fidelity.
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-format
 ```
 
-> **TopMind emoji system** (`emoji-system.md`, shared by briefs / viral-posts / format): 0–2 persona motifs at start/end only; 0–1 title emoji that must match the keyword; one bullet set per post; ≤3 decorative emoji in total.
+### Shared X plain-text rules (all skills that output X text)
+
+Single source in `shared/references/`, distributed to each skill's `references/` via the manifest:
+
+| Doc | Covers |
+|---|---|
+| `x-delivery-contract.md` (must read) | Short posts must use emoji bullets; duanzi posts use no emoji at all (plain bullet lines); never `- ` / `1. `; the post body is one copy-ready block (including the source line and hashtags); sources, original images, image suggestions, internal tags and notes are listed separately; one block per post |
+| `x-post-format.md` | No Markdown, bullet sets, spacing, sources, skeletons, images, WeChat → X |
+| `emoji-system.md` | The TopMind emoji system (short posts only): 0–2 persona motifs (🐔 🐱 🌱) at start/end; 0–1 keyword-matched title emoji; one bullet set per post |
+| `x-layout-patterns.md` | Layout patterns distilled from reference posts |
+
+Checks: `lint_x_post.py` (E1–E9 Markdown leftovers; W12 notes / sources / image lines / internal tags inside the post body; W13 any emoji in a duanzi post with `--duanzi`).
 
 ### topmind-cover · Cover art generation
 
@@ -91,15 +102,15 @@ npx @topmindspace/topmind-writing-skills install topmind-poster
 
 | Skill | Version | What it does |
 |-------|---------|--------------|
-| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.8** | WeChat article lifecycle: package, review, 3 quality gates, inline typography & publish checklist |
-| [`topmind-x-article`](./topmind-x-article/) | **0.4.14** | X long-form one-click publish: Markdown → one-click-copy HTML (images/prompt copy, click-to-zoom images) / plain-text fallback + cover + checklist |
+| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.10** | WeChat article lifecycle: package, review, 3 quality gates, inline typography & publish checklist |
+| [`topmind-x-article`](./topmind-x-article/) | **0.4.16** | 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.8** | 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.16** | Short-form briefs (WeChat + X): one topic, one chart; data rankings / paper explainers / product alerts / mechanism explainers; one plain-text X block (no HTML by default) with emoji bullets, source links and hashtag suggestions; fixed 3-part delivery (copyable plain text / source links / 1–2 original images); asks before generating any image when no original exists |
-| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.8** | X viral short posts: 18 template types + combinations, duanzi layout (blank line between lines), hashtags + classification tags, source links for factual posts; original images first; asks before generating a 16:9 image via topmind-cover |
-| [`topmind-format`](./topmind-format/) | **0.1.1** | X plain-text formatter: to duanzi (blank lines) / to short post (paragraphing + emoji system); layout only, words unchanged, with a fidelity check; 3-part delivery |
+| [`topmind-briefs`](./topmind-briefs/) | **0.2.18** | Short-form briefs (WeChat + X): one topic, one chart; data rankings / paper explainers / product alerts / mechanism explainers; one plain-text X block (no HTML by default) with emoji bullets, source links and hashtag suggestions; post body in its own copy-ready block, sources and 1–2 original images listed separately; asks before generating any image |
+| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.10** | X viral short posts: 18 template types + combinations, duanzi layout (blank lines, no emoji, plain bullet lines), one copy-ready block per post, hashtags in the body and classification tags listed separately; asks before generating an image |
+| [`topmind-format`](./topmind-format/) | **0.1.3** | X plain-text formatter: to duanzi (blank lines, no emoji) / to short post (paragraphing + emoji system); layout only, words unchanged, with a fidelity check; body delivered as its own block |
 | [`topmind-poster`](./topmind-poster/) | **0.1.5** | 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.33** (whole-repo same-tag releases).
+Installer [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) is **0.8.35** (whole-repo same-tag releases).
 
 ### Which skill, and how they combine
 

package/README.md

@@ -33,7 +33,7 @@ npx @topmindspace/topmind-writing-skills install topmind-x-article
 
 ### topmind-briefs · 干货短文
 
-公众号 + X 双平台干货短文：一件事讲透（数据榜单 / 论文解读 / 新品速递 / 机制讲解）。短文不是长文，**默认不出 HTML**：X 版是一段可直接复制的纯文本（分段换行、克制的 emoji、来源链接、0–2 个话题标签），公众号版约 300–800 字 Markdown。尊重原始信息、原图、原文；交付固定三块：可复制纯文本正文、原帖 / 信源地址（含发布时间）、1–2 张原图，没有原图时主动询问是否配图（可选 topmind-cover），不擅自生图。只起草不代发。
+公众号 + X 双平台干货短文：一件事讲透（数据榜单 / 论文解读 / 新品速递 / 机制讲解）。短文不是长文，**默认不出 HTML**：X 版是一段可直接复制的纯文本（分段换行、克制的 emoji、来源链接、0–2 个话题标签），公众号版约 300–800 字 Markdown。尊重原始信息、原图、原文；按 X 交付规约交付：正文单独一块可直接复制，信源（含发布时间）、1–2 张原图、说明各自另列；没有原图时主动询问是否配图（可选 topmind-cover），不擅自生图。只起草不代发。
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-briefs
@@ -41,7 +41,7 @@ npx @topmindspace/topmind-writing-skills install topmind-briefs
 
 ### topmind-viral-posts · X 引流段子/爆款短篇
 
-基于对 X 中文区常见高互动写法的归纳，提供 18 类型模板 + 钩子×主体×收尾组合玩法（示例均为自编），默认**段子体**（一句一行、行与行之间空一行）、口语化、带互动钩子，配图原图优先（官方 / 第三方 / 自己的后台截图），没有原图时先问是否配图、同意后走 topmind-cover 出图，并附**话题标签（1–3 个 hashtag）与内部分类标签**；X 稿不用 Markdown 列表，分点用 emoji 项目符号。
+基于对 X 中文区常见高互动写法的归纳，提供 18 类型模板 + 钩子×主体×收尾组合玩法（示例均为自编），默认**段子体**（一句一行、行与行之间空一行）、口语化、带互动钩子，配图原图优先（官方 / 第三方 / 自己的后台截图），没有原图时先问是否配图、同意后走 topmind-cover 出图，话题标签（1–3 个）在正文末行，内部分类标签另列；段子**完全不用 emoji**，分点不加符号、一条一行靠行间空行区分；每条正文单独一块。
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-viral-posts
@@ -49,15 +49,26 @@ npx @topmindspace/topmind-writing-skills install topmind-viral-posts
 
 > 18 类型：干货忠告 / 互关求粉 / 自嘲幽默 / 互动提问 / 打卡日常 / 新人报到 / **热点资讯**（基于真实检索，配官方原图可多图）/ 暴论 / 数据晒单 / 真诚交友 / 吐槽共鸣 / 干货技巧 / 经验忠告 / 执行清单 / **冷知识揭秘** / **差额冲刺** / **反差对照** / **自问自答**。
 
-### topmind-format · X 纯文本格式化（新）
+### topmind-format · X 纯文本格式化
 
-用户贴一段现成文字：**转段子** → 每句一行、行间空一行；**格式化成短文** → 合理分段换行、列表改 emoji、标题 emoji 对应关键词、开头结尾加鸡/猫/植物人设点缀（🐔 🐱 🌱 🌸）。只动排版不改字，`format_text.py` 自带原文保真校验。
+用户贴一段现成文字：**转段子** → 每句一行、行间空一行，去掉所有 emoji 与列表符号；**格式化成短文** → 合理分段换行、列表改 emoji、标题 emoji 对应关键词、开头结尾加鸡/猫/植物人设点缀（🐔 🐱 🌱 🌸）。只动排版不改字，`format_text.py` 自带原文保真校验。
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-format
 ```
 
-> **TopMind emoji 体系**（`emoji-system.md`，briefs / viral-posts / format 共用）：人设点缀 0–2 个只放首尾；标题 emoji 0–1 个、必须对上关键词；列表符号一帖一套；点缀类合计 ≤3。
+### X 文本统一规约（所有产出 X 纯文本的技能共用）
+
+共享文档在 `shared/references/`，经 manifest 分发到各技能 `references/`：
+
+| 文档 | 管什么 |
+|---|---|
+| `x-delivery-contract.md`（必读必守） | 短文分点必须用 emoji 列表符号，段子完全不用 emoji（分点不加符号），都禁用 `- ` `1. `；正文单独一个可直接复制的块（含来源行与话题标签），信源、原图、配图建议、内部标签、说明各自另列；多条帖子每条一块 |
+| `x-post-format.md` | 不用 Markdown、列表符号、留白、来源、骨架、配图、公众号稿→X 稿 |
+| `emoji-system.md` | TopMind emoji 体系唯一出处（只用于短文体）：人设点缀 🐔 🐱 🌱 0–2 个只放首尾；标题 emoji 0–1 个对上关键词；列表符号一帖一套 |
+| `x-layout-patterns.md` | 参考帖拆出的版式规律（首行给结论、列表引导语、【小标题】分节等） |
+
+检查：`lint_x_post.py`（E1–E9 Markdown 残留；W12 正文混入信源 / 配图 / 说明 / 内部标签；`--duanzi` 时 W13 段子里出现 emoji）。
 
 ### topmind-cover · 封面配图生成
 
@@ -91,21 +102,21 @@ npx @topmindspace/topmind-writing-skills install topmind-poster
 
 | 技能 | 版本 | 做什么 |
 |------|------|--------|
-| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.8** | 公众号文章全生命周期：交付包、审校改写、质量三关、微信内联排版与发布清单 |
-| [`topmind-x-article`](./topmind-x-article/) | **0.4.14** | X 长文一键发布：Markdown 原稿 → 一键复制 HTML（含配图/提示词复制、图片点击放大）/ 纯文本兜底 + 封面图 + 发布清单 |
+| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.10** | 公众号文章全生命周期：交付包、审校改写、质量三关、微信内联排版与发布清单 |
+| [`topmind-x-article`](./topmind-x-article/) | **0.4.16** | X 长文一键发布：Markdown 原稿 → 一键复制 HTML（含配图/提示词复制、图片点击放大）/ 纯文本兜底 + 封面图 + 发布清单 |
 | [`topmind-cover`](./topmind-cover/) | **0.4.8** | 文章封面配图（X / 公众号共用，X 主尺寸 1500×600 / 5:2）：震撼醒目主题突出；22 种封面风格库 + X 短文 16:9 封面场景 + 12 种标题花式 + 55 张示例图（22 种风格 × 2 尺寸 + 11 张变体样张） + 1 张风格总览图 |
-| [`topmind-briefs`](./topmind-briefs/) | **0.2.16** | 干货短文（公众号 + X 双平台）：一件事讲透，数据榜单/论文解读/新品速递；X 版一段纯文本（默认不出 HTML）+ emoji 列表 + 来源链接 + 话题标签建议；交付三块（纯文本 / 信源 / 1–2 张原图），无原图先询问配图 |
-| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.8** | X 引流段子/爆款短篇：18 大类型模板 + 组合玩法，段子体（行间空行）、事实类带来源链接、带话题标签与分类标签；配图原图优先，无原图先询问再走 topmind-cover 出 16:9 图 |
-| [`topmind-format`](./topmind-format/) | **0.1.1** | X 纯文本格式化：转段子（行间空行）/ 格式化成短文（分段 + emoji 体系），只动排版不改字，带原文保真校验；交付三块，无原图先询问配图 |
+| [`topmind-briefs`](./topmind-briefs/) | **0.2.18** | 干货短文（公众号 + X 双平台）：一件事讲透，数据榜单/论文解读/新品速递；X 版一段纯文本（默认不出 HTML）+ emoji 列表 + 来源链接 + 话题标签建议；正文单独成块，信源 / 原图另列，无原图先询问配图 |
+| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.10** | X 引流段子/爆款短篇：18 大类型模板 + 组合玩法，段子体（行间空行，零 emoji，分点不加符号）、每条正文单独成块、话题标签在正文、分类标签另列；无原图先询问再走 topmind-cover |
+| [`topmind-format`](./topmind-format/) | **0.1.3** | X 纯文本格式化：转段子（行间空行，零 emoji）/ 格式化成短文（分段 + emoji 体系），只动排版不改字，带原文保真校验；正文单独成块 |
 | [`topmind-poster`](./topmind-poster/) | **0.1.5** | HTML+CSS → 高清长图 / 海报 / 信息图 PNG：无头 Chrome 2× 截图 + 自动裁白；「一段一图」分段图批量出图（生成器 + 渲染器） |
 
-安装器 [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) 为 **0.8.33**（整仓同 tag 发版）。
+安装器 [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) 为 **0.8.35**（整仓同 tag 发版）。
 
 ### 怎么选、怎么组合
 
 | 你要做的事 | 用哪个 | 常见组合 |
 |---|---|---|
-| 一件事的干货短文（数据、榜单、发布） | `topmind-briefs` | → `topmind-format` 统一排版；没有原图 → `topmind-cover` 出 16:9 首图 |
+| 一件事的干货短文（数据、榜单、发布） | `topmind-briefs` | → `topmind-format` 统一排版；没有原图 → 先问，同意后 `topmind-cover` 出 16:9 首图 |
 | 引流段子、涨粉帖、互关帖 | `topmind-viral-posts` | → `topmind-format` 重排段子体；同一事件可配一条 briefs 干货版 |
 | 现成文字只要排版（转段子 / 格式化） | `topmind-format` | 只动排版不改字；要改写内容再转 briefs / viral-posts |
 | 数千字 X 长文 | `topmind-x-article` | + `topmind-cover`（5:2 封面）；短于一帖的内容走 briefs |
@@ -114,7 +125,7 @@ npx @topmindspace/topmind-writing-skills install topmind-poster
 
 > SKILL.md frontmatter 顶层只用 Agent Skills 规范字段（`name` / `description` / `license` / `metadata`），版本、`action_category`、`triggers` 等自定义字段放在 `metadata` 下（字符串值），能通过官方校验器 `skills-ref validate`。
 >
-> 共享脚本与 `writing-principles.md` 的唯一真源在 `shared/`，各技能目录保留逐字节副本（单独安装也能用）；改共享文件只改 `shared/`，再跑 `npm run sync:shared`，CI 用 `--check` 校验。
+> 共享脚本与共享文档（`writing-principles.md`、X 文本规约四件套）的唯一真源在 `shared/`，各技能目录保留逐字节副本（单独安装也能用）；改共享文件只改 `shared/`，再跑 `npm run sync:shared`，CI 用 `--check` 校验。
 >
 > npm 包不含 cover 的单风格样张（`assets/examples/<style>*.png`），只保留 `overview.png`；完整样张见 GitHub 仓库或 Release zip。
 

package/package.json

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

package/topmind-briefs/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.2.18 (2026-10-14)
+
+- 更正：共享规约改为「短文分点用 emoji 列表符号、段子完全不用 emoji」；`emoji-system.md` 标明只适用于短文体；`lint_x_post.py` 新增 `--duanzi`（W13）
+
+## 0.2.17 (2026-10-14)
+
+- 特性支持：接入共享 X 交付规约 `x-delivery-contract.md`（必读必守）——X 正文单独成块，信源 / 原图 / 说明另列；分点必须用 emoji 列表符号
+- 优化：`examples.md` 改为中文示例并去掉正文里的图片占位；`platform-specs.md`、`style-guide.md` 去重；删除重复的「配图铁律」节
+
 ## 0.2.16 (2026-10-14)
 
 - 特性支持：交付固定三块（可复制纯文本正文 / 原帖与信源地址 / 1–2 张原图）并附正例模板；没有原图时主动询问是否配图，不擅自生图

package/topmind-briefs/README.en.md

@@ -8,7 +8,7 @@ A brief is not a long-form article — **no HTML by default**: the X version is
 Original facts, images and quotes come first; a cover is optional when no original image exists. Every delivery lists
 each source's name, publish time and link.
 
-- Version: **v0.2.16** (ships with `@topmindspace/topmind-writing-skills@0.8.33`)
+- Version: **v0.2.18** (ships with `@topmindspace/topmind-writing-skills@0.8.35`)
 
 ## Install
 

package/topmind-briefs/README.md

@@ -6,7 +6,7 @@
 X 版是一段可直接复制的纯文本（分段换行 + 克制的 emoji + 来源链接），公众号版约 300–800 字 Markdown。
 尊重原始信息、原图、原文；配图原图优先，没有原图时封面可选（`topmind-cover`）；交付时写明信息来源、发布时间与来源链接。
 
-- 版本：**v0.2.16**（随 `@topmindspace/topmind-writing-skills@0.8.33` 发布）
+- 版本：**v0.2.18**（随 `@topmindspace/topmind-writing-skills@0.8.35` 发布）
 
 ## 安装
 

package/topmind-briefs/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: topmind-briefs
-description: "干货短文：一件事讲透，X + 公众号双平台。短文不是长文——默认不出 HTML：X 版是一段可直接复制的纯文本（首行给结论、合理分段换行、emoji 项目符号列表，emoji 只用 TopMind 体系，带来源链接，0–2 个话题标签），公众号版是 300–800 字 Markdown；交付固定三块：①可复制纯文本正文 ②原帖/信源地址 ③1–2 张原图（官方图、原帖图/截图）；没有原图时主动询问是否配图，不擅自生图。尊重原始信息、原图、原文。只交付不代发。Use when 写短文、公众号短文、X 短文、发快讯、简讯、速报、数据榜单、榜单速报、论文解读、新品速递、来篇短的、短平快、brief；信息密度型（数据、榜单、发布）走本技能。Do NOT use for 把现成文字格式化、转段子、排版（→ topmind-format）、X 长文与发 X 文章（→ topmind-x-article）、公众号长文与公众号排版 HTML（→ topmind-wechat-post）、引流互动型短帖、段子、涨粉帖、互关帖、爆款短篇（→ topmind-viral-posts）、单独出长图/海报/信息图 PNG（→ topmind-poster）、封面与头图（→ topmind-cover）、把稿子发出去（→ topmind-x，须用户确认）。"
+description: "干货短文：一件事讲透，X + 公众号双平台。短文不是长文——默认不出 HTML：X 版是一段可直接复制的纯文本（首行给结论、合理分段换行、emoji 项目符号列表，emoji 只用 TopMind 体系，带来源链接，0–2 个话题标签），公众号版是 300–800 字 Markdown；交付遵守 X 交付规约：正文单独成块可直接复制（含来源行与话题标签），信源、原图（1–2 张）、说明各自分块；分点必须用 emoji 列表符号；没有原图时主动询问是否配图，不擅自生图。尊重原始信息、原图、原文。只交付不代发。Use when 写短文、公众号短文、X 短文、发快讯、简讯、速报、数据榜单、榜单速报、论文解读、新品速递、来篇短的、短平快、brief；信息密度型（数据、榜单、发布）走本技能。Do NOT use for 把现成文字格式化、转段子、排版（→ topmind-format）、X 长文与发 X 文章（→ topmind-x-article）、公众号长文与公众号排版 HTML（→ topmind-wechat-post）、引流互动型短帖、段子、涨粉帖、互关帖、爆款短篇（→ topmind-viral-posts）、单独出长图/海报/信息图 PNG（→ topmind-poster）、封面与头图（→ topmind-cover）、把稿子发出去（→ topmind-x，须用户确认）。"
 license: MIT
 metadata:
-  version: "0.2.16"
+  version: "0.2.18"
   action_category: "write"
   triggers: "写短文, 公众号短文, X 短文, 发快讯, 快讯, 简讯, 速报, 干货短文, 论文解读, 数据榜单, 榜单速报, 新品速递, brief, 来篇短的, 短平快, 发个快讯"
   author: "TopMindSpace"
@@ -15,6 +15,8 @@ metadata:
 
 一件事，一段话，讲完就停。短文不是长文：**默认不出 HTML、不做排版包**，交付的是可以直接复制粘贴的文字。
 
+> **必读必守**：[references/x-delivery-contract.md](references/x-delivery-contract.md)——分点必须用 emoji 列表符号（禁用 `- ` `1. `）；X 正文单独一个 `text` 块、只放可发布内容；信源、原图、说明各自分块。
+
 - 跟 `topmind-viral-posts` 的区别：那是引流互动型段子（第一人称、钩子、涨粉）；这是**信息密度型干货短文**（数据、榜单、论文、新品，第三方客观口吻）。
 - 跟 `topmind-x-article` / `topmind-wechat-post` 的区别：那两个是长文（数千字、多节多图、HTML 发布包）；本技能 X 版一帖或 ≤3 条 thread，公众号版 300–800 字。
 - 现成文字只要排版 → `topmind-format`。
@@ -61,47 +63,17 @@ metadata:
    - 按 [references/writing-principles.md](references/writing-principles.md)「去 AI 味清单」过一遍；
    - `python3 scripts/lint_x_post.py X短文.txt`：错误清零（含 Markdown 列表/标题/加粗/引用/链接/删除线/代码围栏残留），W8（表情过多）/ W9（AI 套话）/ W10（缺来源）逐条处理；
    - 需要统一排版时可跑 `python3 scripts/format_text.py X短文.txt --mode short --out X短文.txt`（只动排版不改字）。
-7. **交付**（只交付，不发布）：见下节「交付格式」。
-
-## 交付格式（固定三块）
-
-默认交付纯文本，不生成 HTML。给用户的回复固定三块，顺序不变（规则见 [references/x-post-format.md](references/x-post-format.md)「交付三块」）：
-
-1. **① 正文（可直接复制）**：X 版纯文本放进 `text` 代码块（保证空行不丢），块内没有任何 Markdown 符号；用户要公众号版时，另起一个 `markdown` 代码块。
-2. **② 原帖 / 信源**：每条承重事实一行：`来源名称｜发布时间（注明时区）｜URL`。发布时间取原文页面上的时间，页面没有就写「未标注」，不猜。
-3. **③ 原图（1–2 张）**：`[图1] 图片地址或交付目录文件名 — 图注；来源：原帖 / 官网`。视频只给封面帧地址并注明「视频」。
-   没找到原图 → 写「未找到原图」，并在回复最后问一句：**「这条没有原图，要不要配图？可以用 topmind-cover 出一张 16:9 封面。」**
-
-### 正例模板
-
-````text
-① 正文（可直接复制）
-```text
-🆕 某编辑器 3.0 发布：补全延迟降到 200ms 内，免费版每月 50 次 🐱
-
-这次更新有三处变化：
+7. **交付**（只交付，不发布）：见下节「交付格式」；落盘时 `X短文.txt` 只放正文，信源 / 配图 / 说明写进 `交付说明.md`。
 
-🔹 补全延迟降到 200ms 内（厂商口径）
-🔹 支持多文件同时修改
-🔹 免费版每月 50 次
+## 交付格式
 
-对日常写小脚本的人，免费额度够用了。
+默认交付纯文本，不生成 HTML，严格按 [references/x-delivery-contract.md](references/x-delivery-contract.md)（含正反例）：
 
-来源：官方更新日志 https://example.com/changelog
-
-#AI编程
-```
-
-② 原帖 / 信源
-- 官方更新日志｜2026-10-13 09:00（UTC+8）｜https://example.com/changelog
-- 官方账号原帖｜2026-10-13 09:05（UTC+8）｜https://x.com/example/status/1234567890
-
-③ 原图
-[图1] https://example.com/images/release-3.png — 官方发布图，展示三项更新；来源：官方更新日志
-[图2] 01-原帖截图.png — 官方原帖截图；来源：官方账号原帖
-````
-
-（模板中的产品、数字与链接均为虚构演示。）没有原图时，③ 写「未找到原图」，结尾加上配图询问。
+1. **X 正文块**：一个 `text` 代码块，只放可发布内容——标题、正文、emoji 列表、`来源：名称 URL` 行、末行话题标签。thread 每条一块。
+2. **公众号版**（用户要时）：单独一个 `markdown` 块。
+3. **信源**：`来源名称｜发布时间（注明时区）｜URL`，每条承重事实一行；发布时间取原文页面，没有就写「未标注」。
+4. **原图**：1–2 张，`[图1] 图片地址或文件名 — 图注；来源`；视频给封面帧地址并注明。没有原图写「未找到原图」，最后问：「要不要配图？可以用 topmind-cover 出一张 16:9 封面。」
+5. **说明**（可选）：口径提醒、改动说明，放最后。
 
 **HTML 只在用户明确要求时出**（例如「出个一键复制 HTML」「公众号要排版好的版本」）：
 `python3 scripts/md2x-html.py X短文.md --out X短文.html --images-from 公众号短文.md`、
@@ -129,7 +101,7 @@ metadata:
 
 ## 话题标签
 
-X 版末尾给 0–2 个话题标签建议（另给 1 个备选），单独成行放在最后：榜单、发布类取榜单名或产品通用名，再加 1 个领域词；
+X 版末尾给 0–2 个话题标签（属正文；备选标签写在正文块外），单独成行放在最后：榜单、发布类取榜单名或产品通用名，再加 1 个领域词；
 不堆砌，不蹭无关热点，不用诱导互动或敏感标签；中文帖用中文话题，英文帖用英文驼峰。公众号稿不加话题标签。细则见 `references/platform-specs.md`。
 
 ## 内容类型（四种）
@@ -141,13 +113,6 @@ X 版末尾给 0–2 个话题标签建议（另给 1 个备选），单独成
 | 论文解读型 | 新论文、新方法 | 判断句开头 → 核心方法一句 + 3 条 emoji 要点 → 论文原图 |
 | 机制讲解型 | 技术原理、流程拆解 | 痛点一句 → 1️⃣2️⃣3️⃣ 分步 → 「简单来说」一句 → 流程图 |
 
-## 配图铁律
-
-- 交付 1–2 张原图（核心图），最多 4 张。每张图必须承载信息，装饰图不要。
-- 图注写一句，说明这张图在证明什么；X 版文字里用 [图1] 标注对应关系。
-- 图紧跟它证明的那段文字（公众号版）；图与文字不错位。
-- 封面不是必需品：有原图就用原图当首图；没有原图先问用户要不要配图，用户同意后才走 `topmind-cover`，不擅自生图。
-
 ## 和其他技能怎么配合
 
 | 场景 | 组合 |

package/topmind-briefs/package.json

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

package/topmind-briefs/references/emoji-system.md

@@ -1,6 +1,8 @@
 # TopMind emoji 体系（账号人设 · 标题 · 列表）
 
-> 适用：`topmind-briefs`（短文）、`topmind-viral-posts`（段子）、`topmind-format`（格式化）的 X 稿，以及其他技能派生 X 纯文本稿时。
+> 交付与列表规约见 `x-delivery-contract.md`（必读必守）。
+> **只用于短文体**：`topmind-briefs`（短文）、`topmind-format` 的「格式化成短文」、viral-posts 热点资讯型的短文版，以及其他技能派生的 X 短文稿。
+> **段子体完全不用 emoji**（`topmind-viral-posts` 段子、`topmind-format` 转段子）：不用人设点缀、情绪表情、标题 emoji，也不用 emoji 列表符号；分点就一条一行、靠行间空行区分。
 > 公众号稿正文不用人设点缀。列表符号的细则见 `x-post-format.md`，本文只定「用哪些、用几个、放哪里」。
 > **唯一真源**：本文是 TopMind emoji 体系的唯一出处（仓库 `shared/references/emoji-system.md`，各技能目录里是逐字节副本）。各技能 SKILL.md 只引用本文，不另写一套 emoji 规则；要改体系只改这里。
 
@@ -12,7 +14,7 @@
 | 标题 emoji | 一眼看出这帖讲什么 | 标题行行首 | 0–1 个 |
 | 列表符号 | 分点、步骤、对比 | 每条列表项行首 | 一套，见 `x-post-format.md` |
 
-三类之外的情绪表情（😂 🤝 😭）每帖最多 1 个，放在钩子或吐槽那一句的句尾。
+三类之外的情绪表情（😂 🤝 😭）短文一般不用。
 
 ## 二、人设点缀（账号 motif）
 
@@ -27,7 +29,7 @@
 
 用法：
 
-1. **开头**：放在第一行行尾，或单独一行（段子可以单独一行）。例：`说个冷知识 🐱`
+1. **开头**：放在第一行（标题行）行尾。例：`🆕 某编辑器 3.0 发布 🐱`
 2. **结尾**：放在最后一句行尾（话题标签之前）。例：`明天见 🌱`
 3. **不进正文和列表**：正文中间、列表项里不放人设 emoji。
 4. **严肃内容不放**：事故、伤亡、争议、监管处罚类帖子不用人设点缀，也不用情绪表情。
@@ -76,7 +78,7 @@
 
 | 体裁 | 人设点缀 | 标题 emoji | 列表符号 | 情绪表情 |
 |---|---|---|---|---|
-| 段子（topmind-viral-posts / 转段子） | 0–2 | 不用（段子没有标题行） | 一般不用列表 | ≤1 |
+| 段子（viral-posts 段子 / 转段子） | 0 | 0 | 0（分点不加符号，靠行间空行） | 0 |
 | 短文（topmind-briefs / 格式化成短文） | 0–2 | 0–1 | 一套 | 0 |
 | 严肃资讯 | 0 | 0–1（只用 ⚡ 📄 ⚠️ 📅） | • ▪ 或 🔹 | 0 |
 | 长帖资讯（【小标题】分节） | 0–1（只放结尾） | 0–1 | 一套或不用 | 0 |
@@ -85,22 +87,6 @@
 
 ## 七、示例（原创）
 
-段子：
-
-```text
-说个冷知识 🐱
-
-X 的创作者收益，看的不只是浏览量。
-
-付费蓝V用户的互动，权重明显更高。
-
-所以同样十万浏览，收益可能差很多。
-
-难怪大家都在找蓝V互动😂
-
-蓝V互关，评论区报到 🌱
-```
-
 短文：
 
 ```text
@@ -114,3 +100,15 @@ X 的创作者收益，看的不只是浏览量。
 
 #AI编程
 ```
+
+段子（零 emoji，对照用）：
+
+```text
+说个冷知识：
+
+X 的创作者收益，看的不只是浏览量。
+
+付费蓝V用户的互动，权重明显更高。
+
+蓝V互关，评论区报到
+```