@topmindspace/topmind-writing-skills 0.8.33 → 0.8.34

package/CHANGELOG.md

@@ -1,3 +1,32 @@
+## [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. Jokes may use bullets too — always emoji bullets, one per line with blank lines between. 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, bullets turned into emoji bullets; **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) | Bullets are always emoji bullets (jokes and briefs alike; no `- ` / `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: 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).
 
 ### 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.9** | WeChat article lifecycle: package, review, 3 quality gates, inline typography & publish checklist |
+| [`topmind-x-article`](./topmind-x-article/) | **0.4.15** | 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.17** | 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.9** | X viral short posts: 18 template types + combinations, duanzi layout (blank lines, emoji bullets), 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.2** | X plain-text formatter: to duanzi (blank lines) / 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.34** (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 列表符号（段子、短文都一样，禁用 `- ` `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 正文混入信源 / 配图 / 说明 / 内部标签）。
 
 ### 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.9** | 公众号文章全生命周期：交付包、审校改写、质量三关、微信内联排版与发布清单 |
+| [`topmind-x-article`](./topmind-x-article/) | **0.4.15** | 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.17** | 干货短文（公众号 + X 双平台）：一件事讲透，数据榜单/论文解读/新品速递；X 版一段纯文本（默认不出 HTML）+ emoji 列表 + 来源链接 + 话题标签建议；正文单独成块，信源 / 原图另列，无原图先询问配图 |
+| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.9** | X 引流段子/爆款短篇：18 大类型模板 + 组合玩法，段子体（行间空行，分点用 emoji 列表）、每条正文单独成块、话题标签在正文、分类标签另列；无原图先询问再走 topmind-cover |
+| [`topmind-format`](./topmind-format/) | **0.1.2** | 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.34**（整仓同 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.34",
   "description": "TopMindSpace 写作技能合集 — 通过 npm / npx 安装技能（公众号长文、X 长文、干货短文、X 引流短帖、封面图、长图海报）。只出稿与发布包，不代发。",
   "license": "MIT",
   "author": "TopMindspace",

package/topmind-briefs/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 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.17** (ships with `@topmindspace/topmind-writing-skills@0.8.34`)
 
 ## 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.17**（随 `@topmindspace/topmind-writing-skills@0.8.34` 发布）
 
 ## 安装
 

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.17"
   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.17"
 }

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

@@ -1,5 +1,6 @@
 # TopMind emoji 体系（账号人设 · 标题 · 列表）
 
+> 交付与列表规约见 `x-delivery-contract.md`（必读必守）。
 > 适用：`topmind-briefs`（短文）、`topmind-viral-posts`（段子）、`topmind-format`（格式化）的 X 稿，以及其他技能派生 X 纯文本稿时。
 > 公众号稿正文不用人设点缀。列表符号的细则见 `x-post-format.md`，本文只定「用哪些、用几个、放哪里」。
 > **唯一真源**：本文是 TopMind emoji 体系的唯一出处（仓库 `shared/references/emoji-system.md`，各技能目录里是逐字节副本）。各技能 SKILL.md 只引用本文，不另写一套 emoji 规则；要改体系只改这里。
@@ -76,7 +77,7 @@
 
 | 体裁 | 人设点缀 | 标题 emoji | 列表符号 | 情绪表情 |
 |---|---|---|---|---|
-| 段子（topmind-viral-posts / 转段子） | 0–2 | 不用（段子没有标题行） | 一般不用列表 | ≤1 |
+| 段子（topmind-viral-posts / 转段子） | 0–2 | 不用（段子没有标题行） | 分点时一套（条目间空一行） | ≤1 |
 | 短文（topmind-briefs / 格式化成短文） | 0–2 | 0–1 | 一套 | 0 |
 | 严肃资讯 | 0 | 0–1（只用 ⚡ 📄 ⚠️ 📅） | • ▪ 或 🔹 | 0 |
 | 长帖资讯（【小标题】分节） | 0–1（只放结尾） | 0–1 | 一套或不用 | 0 |

package/topmind-briefs/references/examples.md

@@ -1,171 +1,100 @@
 # 示例 · 干货短文（自编示例）
 
-> 说明：以下均为自己编写的示例，模型名、基准名、数字皆为虚构，仅用来演示各类型的结构，不对应任何真实帖子或账号。
-> 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` 对超长帖会给出字数警告，拆条后再检查。
+> 模型名、基准名、数字、链接皆为虚构，只演示结构。
+> 交付按 [x-delivery-contract.md](x-delivery-contract.md)：X 正文单独一个 `text` 块（含来源行与话题标签），信源、原图、说明块外另列；分点一律 emoji 列表符号，规则见 [x-post-format.md](x-post-format.md)。
+> 正文超过 280 加权字符时按 thread 拆条，每条一块。
 
 ## 例 1：数据榜单型
 
-结构模式：先抛一个反直觉判断 → 甩基准 → 给最扎眼的数字 → 图证明。
+结构：反直觉判断 → 基准一句 → 最扎眼数字 → 来源 → 标签。
 
-```
-A smaller model can still be the better buy.
+```text
+📊 小模型也可能更划算：ToyBench 上单任务成本约 0.25 美元
 
-On ToyBench-Tasks, Model A completes 64% of tasks at roughly $0.25 each.
+ToyBench-Tasks 测智能体完成多步任务的能力。
 
-For a 300-task run, that is about $75 in total,
-several times cheaper per task than Model B.
+模型 A 完成 64% 的任务，跑 300 个任务总计约 75 美元，单任务成本比模型 B 低数倍。
 
-[图：上下两张柱状图——任务完成率 vs 单任务成本]
+来源：ToyBench 官方榜单 https://example.com/toybench
 
-#ToyBench #AIAgents
+#ToyBench #AI智能体
 ```
 
-话题标签建议：`#ToyBench #AIAgents`（备选 `#LLMEval`）
-
-结构拆解：
-1. 判断句开头（观点一句）
-2. 基准是什么（一句）
-3. 最扎眼的数字（64%、~$75、几倍差价）
-4. 图：完成率和成本两张图并置
+信源：ToyBench 官方榜单｜2026-10-12（页面标注）｜https://example.com/toybench
+原图：[图1] https://example.com/toybench/chart.png — 完成率与单任务成本对比；来源：官方榜单
 
 ## 例 2：榜单速报型
 
-```
-Just in: Model C now sits at #2 on ToyArena Chat with 1380 pts,
-and #4 on ToyArena Code with 1310 pts.
-
-Price: $3 per million tokens, the lowest among the top five.
+结构：排名 + 分数开头 → 价格一句 → 「xx：」+ emoji 列表 → 纵向对比 → 来源 → 标签。
 
-Strongest categories:
-🔹 Math
-🔹 Long documents
-🔹 Multilingual prompts
+```text
+⚡ 模型 C 升到 ToyArena 对话榜第 2（1380 分）、代码榜第 4（1310 分）
 
-+12 pts over Model D; up three places since the last update.
+价格每百万 token 3 美元，前五名里最低。
 
-[图：两个榜单的排行榜截图各一张]
+最强的三个细分项：
 
-#ToyArena
-```
+🔹 数学
+🔹 长文档
+🔹 多语言
 
-话题标签建议：`#ToyArena`（备选 `#AIRankings`）
+比上次更新上升三位，领先模型 D 12 分。
 
-结构拆解：
-1. "Just in:" + 排名 + 分数（开头即全部关键信息）
-2. 价格/性价比（一句）
-3. 细分维度展开（emoji 列表，每条一行）
-4. 纵向对比（比上次、比邻位）
-5. 图：排行榜实拍
-
-## 例 3：论文解读型
+来源：ToyArena 榜单 https://example.com/toyarena
 
+#ToyArena
 ```
-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
 
-[图：论文信息图——流程示意 + 三组对比曲线]
+## 例 3：论文解读型
 
-#AIAgents #Memory
-```
+```text
+📄 智能体不用记完整对话，写几条笔记就够
 
-话题标签建议：`#AIAgents #Memory`（备选 `#PaperNotes`）
+新论文的思路：让智能体边干活边写自己的记忆笔记。
 
-结构拆解：
-1. 判断句开头（有观点，后面有实证；X 里不加粗，靠第一行位置突出）
-2. 方法名/思路一句 + 3 条 emoji 要点（每条 ≤10 词）
-3. 图：论文原图（流程 + 结果）
+🔹 留下一步需要的
+🔹 丢掉用不上的
+🔹 笔记存在普通文件里，不用额外服务
 
-## 例 4：机制讲解型
+来源：论文 https://example.com/paper
 
+#AI智能体
 ```
-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.
+## 例 4：机制讲解型（步骤）
 
-1️⃣ Put the stable text first
-[机制，一句]
+```text
+💡 提示缓存怎么帮你省 API 钱
 
-2️⃣ Send the changing part last
-[机制，一句]
+每次请求都在为同一段长前缀重复付费，缓存把这段前缀存下来，重复调用就不再全价计费。
 
-3️⃣ Check the hit rate in the usage report
-[机制，一句]
+1️⃣ 把固定不变的内容放在最前面
+2️⃣ 把会变的部分放在最后
+3️⃣ 在用量报表里看缓存命中率
 
-In short:
-🔹 Stable prefix: cached.
-🔹 Variable tail: billed normally.
-🔹 Savings show up as cache hits.
+简单来说：前缀命中缓存就便宜，尾部照常计费。
 
-[视频：缓存命中流程动画]
+来源：官方文档 https://example.com/docs/caching
 
-#PromptCaching #LLMOps
+#提示缓存
 ```
 
-话题标签建议：`#PromptCaching #LLMOps`（备选 `#APICost`）
+## 公众号版改写（例 1 → 公众号）
 
-结构拆解：
-1. 标题句（"How X works, step by step."）
-2. 痛点（一句：现有做法缺什么）
-3. 机制分步（1️⃣ 2️⃣ 3️⃣ 序号，每步一句）
-4. "In short:" 三行收束（🔹）
-5. 媒体：流程图/动画 + 文章链接
-
----
-
-## 公众号版改写示例（例 1 → 公众号）
+公众号版单独一个 `markdown` 块，内容与 X 版一致，只允许排版差异：
 
 ```markdown
-# 300 个任务约 $75：ToyBench-Tasks 基准实测
-
-> 小模型也可能更划算——在 ToyBench-Tasks 上，模型 A 以更低成本拿到了不错的完成率。
+# 300 个任务约 75 美元：ToyBench-Tasks 基准实测
 
 - 基准：ToyBench-Tasks，测智能体完成多步任务的能力
 - 完成率：模型 A 完成 64% 的任务
-- 成本：单任务约 $0.25，跑 300 个任务总计约 $75，
-  单任务成本比模型 B 低数倍
-
-![ToyBench-Tasks：任务完成率 vs 单任务成本](图)
-
-来源：某评测机构（示例）
-```
-
-改写要点：X 版英文直发；公众号版加一句中文背景（"这是什么基准"），
-数字保留英文原样，结论不变。
-
-### 公众号稿 → X 稿：列表怎么转
-
-同一选题的两个版本只允许排版差异，数字、结论、条数、顺序保持一致：
-
-```markdown
-<!-- 公众号稿：Markdown 列表 -->
-- 基准：ToyBench-Tasks
-- 完成率：模型 A 完成 64% 的任务
-  - 单任务成本约 $0.25
-```
+- 成本：单任务约 0.25 美元，300 个任务总计约 75 美元，比模型 B 低数倍
 
-```text
-X 稿：emoji 项目符号，二级条目缩进两格
-🔹 基准：ToyBench-Tasks
-🔹 完成率：模型 A 完成 64% 的任务
-  ▫️ 单任务成本约 $0.25
+来源：ToyBench 官方榜单（示例）
 ```
 
----
-
-## 反例（不要这样写）
-
-❌ "众所周知，AI 发展日新月异。最近，Google 发布了一款新模型，
-   引起了广泛关注。值得一提的是，这款模型在多个基准上表现出色…"
-   → 铺垫三段，结论藏在最后，没有具体数字。
+## 反例
 
-❌ "大幅提升""显著改善""表现优异"
-   → 没有数据的形容词，删掉或换成数字。
+- 「众所周知，AI 发展日新月异……值得一提的是……」→ 铺垫三段、结论藏在最后、没有数字。
+- 「大幅提升」「表现优异」→ 没有数据的形容词，换成数字或删掉。
+- 正文块里写 `[图：柱状图]`、`配图：`、`话题标签建议：` → 这些都在正文块外另列。