@topmindspace/topmind-writing-skills 0.8.43 → 0.8.45

package/CHANGELOG.md

@@ -1,3 +1,45 @@
+## [0.8.45] - 2026-10-18
+
+> 根包 0.8.44 → **0.8.45**（patch）；技能版本：topmind-wechat-post 0.3.15 → 0.3.16、topmind-x-article 0.4.21 → 0.4.22、topmind-revise 0.1.0 → 0.1.1、topmind-briefs 0.2.23 → 0.2.24、topmind-cover 0.4.12 → 0.4.13、topmind-format 0.1.8 → 0.1.9、topmind-viral-posts 0.3.15 → 0.3.16（后四个只是随包共享副本更新）；topmind-poster 0.1.6 不变。
+
+### 新增（长文交付改造：单源 Markdown，HTML 按需）
+
+- 长文改为一个文章文件夹 `<文章名>/`：唯一源稿 `<文章名>.md`（frontmatter 五项 title / date / status / tags / cover，H1 = title = 文件名）、`images/`（按出现顺序编号）、`cover/`、私有 `素材来源.md`、`raw/`、`out/`（派生产物，可随时重建）。默认只交付 Markdown，Obsidian 里直接能看；要 X 版或公众号版时再派生到 `out/`。
+- 新增共享脚本 `article_scaffold.py`（建文章文件夹；文件名安全化、最长 80 字；已存在就报错，不覆盖）和 `check_article.py`（E 级：frontmatter 五项、标题一致、图片存在、编号顺序与出现顺序一致（后出现的图序号反而更小才报）、无 `![[ ]]` / callout / `:::`；W 级：没被引用的图、远程图片、编号不连续或带 11a 这类插入后缀、自制图标注 W18；有 E 退出码 1）。
+- topmind-wechat-post / topmind-x-article 默认组合 topmind-revise：写完先由 revise 执行改稿与质量三关（嵌入模式，完整报告落 `out/改稿报告.md`），HTML / 纯文本只在用户要时生成。
+
+### 变更
+
+- `md2x-html.py`：源稿没有 `[图N]` 时直接按文档顺序读独占一行的 `![]()`（路径相对 md 所在目录，代码块内不动，远程图片跳过并告警），不再需要派生 `X长文.md`；图片下一行的「来源：」渲染成小号灰字图注；`--cover` 缺省读 frontmatter 的 `cover`；`--out` 缺省 `<文章文件夹>/out/X长文.html`；有 `[图N]` 却没给图片来源时直接报错。`--images-from` / `--images` 旧用法保留。
+- `md2x.py`：列表默认 `plain`（「· 」「1）」，二级缩进两格），`--list-style emoji` 可选；`--out` 缺省 `out/X发布稿.txt`。
+- `md2wechat.py`：二级标题有手写序号（「一、」「1.」）时原样保留，不再剥离、不再叠加自动编号，导读用「·」；新增 `--auto-number` 恢复旧行为；`--out-dir` 缺省 `<输入目录>/out`、`--slug` 缺省文件名、`--asset-root` 缺省输入目录；图片后的「来源：」行渲染成图注。
+- wechat-post：`new-article.py` 默认建新结构，`--legacy --slug` 保留旧的 `YYYY-MM-DD-slug/公众号稿.md`；`sync-status.py` / `sync-mapping.py` / `push-to-topstream.py` 新旧结构都认，新结构只改 frontmatter 的 status、不改目录名，旧包的 `-released` 改名逻辑不变；`lint-wechat.py` 对新源稿里的 `:::` 报错（`公众号稿.md` 或 `--legacy` 只告警）；`direction / source_file / target_file / word_count` 改为可选字段。
+- `de_ai_lint.py` 的 W18：图片下一行写了「来源：自制，数据：…」也算标清楚；`audit-provenance.py` 的 `--draft` 可以直接给文章文件夹。
+- 文档：wechat-post / x-article 的 SKILL.md、README 与 references（workflow、typography-rules、element-spec、known-pits、x-html-format、x-format、publish-checklist）换成新文件夹与按需派生；x-article 的「文本派生铁律」「HTML 占位符」「配图错位」三节合并为「派生规则」；`writing-principles.md` 第六节改为「单源、按需派生」。
+- 旧交付包只读兼容，不自动迁移。
+
+## [0.8.44] - 2026-10-18
+
+> 根包 0.8.43 → **0.8.44**（patch）；技能版本：新增 topmind-revise **0.1.0**；topmind-briefs 0.2.22 → 0.2.23、topmind-cover 0.4.11 → 0.4.12、topmind-format 0.1.7 → 0.1.8、topmind-viral-posts 0.3.14 → 0.3.15、topmind-wechat-post 0.3.14 → 0.3.15、topmind-x-article 0.4.20 → 0.4.21；topmind-poster 0.1.6 不变。
+
+### 新增（规则层三层设计 + 改稿与质检技能）
+
+- 新技能 **topmind-revise（改稿与质检）**：四种模式（只审不改 / 改稿 / 嵌入 / 快审），流程「事实 → 逻辑 → 删冗余 → 去 AI 味 → 核心经验对照 → 排版 → 保真审计 → 过度改稿检查」；每处改动对应规则编号或作者意见，没命中的段落不动。
+- 新增共享规约 `core-voice.md`：V01–V33 场景规则（标题、开头、收尾、数字、引用、来源行、列表、emoji、回复、段子配方等）与文体速查表；briefs、viral-posts、format、wechat-post、x-article、cover、revise 随包自带。
+- `de-ai-rules.md` 升级到 v2：改写边界补「何时不改」「有作者样本就跟样本」；Z01–Z38 加信号强弱与脚本列，新增单句收尾、格言式伪深度、和假想敌辩论、句式开头复读、小节过渡句、复述图片、「人名说：」、新闻式精确等条目；P03 对首行「？！」豁免；「怎么跑」改为 E 清零、W 有结论、H 只提示。
+- 新增共享脚本 `de_ai_lint.py`：W 警告 + H 提示两级，`--genre long|short|duanzi|reply|title`、`--json`、`--no-hints`、`--strict`（H 不计入）；新增 W19「人名说：」、W20 过渡句 / 不言自明的引导语、W21 复述图片，以及 H1–H12（语境词、短文「！！」一处、我认为、新闻式精确、对仗收句、来源行描述图、emoji 过密、无效信息、说教式反问标题、段落超过 3 句、短文话题标签超过 2 个、长文「人名说：」）。
+- 新增共享脚本 `count_words.py`（统一字数口径）、`revise_check.py`（数字 / 引语 / 英文专名 / 确定性词保真比对 + 过度改稿比例 + 改稿报告骨架）；`audit-provenance.py` 从 wechat-post 移到 `shared/`，分发给 wechat-post、x-article、revise。
+- 仓库级规则回归 `scripts/test_lint_rules.py`（不应报 38 条、应报 W 26 条、应报 H 14 条），接入 `ci_skill_gates.sh`。
+
+### 变更
+
+- `lint_x_post.py` 的去 AI 味部分改为复用 `de_ai_lint.py`，原有错误 / 警告编号和参数不变；新增 `--genre`、`--no-hints`，汇总行增加「提示」数；`--fix --style` 默认改为纯文本列表（「·」「1）」），要 emoji 时加 `--style emoji`。
+- 从 W 降为 H 的语境词：「一文读懂」「毫无疑问 / 不可否认」「归根结底」「真正的」「重磅 / 里程碑」「未来已来 / 拭目以待」「总结来说 / 总的来说」；「综上所述」「首先 / 其次 / 最后」「真正的 X 从来不是」等仍是 W。
+- `writing-principles.md`：标题不反问、不说教（一.5）；措辞偏好、吸引力清单、长文改稿按 core-voice 收紧（过去一句 + 图、未来用「预计 / 大概率」、按读者三档解释概念、段落 2–3 句）；涉及国内厂商改为「不贬低、不站队、不传谣」。`revision-workflow.md` 重写为 revise 的完整流程（没装 revise 时手动走）。
+- X 文本规约：列表默认「·」、行多用「1）」，emoji 只给短列表；短文事实讲完就停、不硬加收尾句；话题标签默认 2 个（运营段子 1–3 个）；`image-sourcing.md` 补「来源：」行写法。
+- briefs：首行一句话题陈述、示例去掉收尾句；viral-posts：互动钩子只限运营引流类，新增「段子配方」「回复与转发点评」两节和一个话题段子示例；format：H 提示不写进「建议改」，改写转 revise；cover：封面大字由文章标题提炼、主题词直给；wechat-post / x-article：质量三关可由 revise 执行，引语正文写「人名：中文意思」，媒体转述点名媒体，开头改为引用 core-voice V05；`scan_ai_flavor_builtin.py` 改为直接复用 `de_ai_lint.py`。
+- evals 新增 revise 5 条（含 2 条负例）及 briefs / x-article / wechat-post 与 revise 的组合用例；现成稿子的润色、去 AI 味改稿改由 revise 承接。
+
 ## [0.8.43] - 2026-10-17
 
 > 根包 0.8.42 → **0.8.43**（patch）；技能版本：topmind-briefs 0.2.21 → 0.2.22、topmind-format 0.1.6 → 0.1.7、topmind-viral-posts 0.3.13 → 0.3.14、topmind-wechat-post 0.3.13 → 0.3.14、topmind-x-article 0.4.19 → 0.4.20。

package/README.en.md

@@ -9,7 +9,7 @@
 [![CI](https://img.shields.io/github/actions/workflow/status/topmindspace/topmind-writing-skills/ci.yml?style=flat-square&label=CI)](https://github.com/topmindspace/topmind-writing-skills/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square)](LICENSE)
 
-**TopMindSpace writing-skills collection** — WeChat articles, X long-form posts, short-form briefs, viral short posts, cover art, long-image rendering: six skills, one repo.
+**TopMindSpace writing-skills collection** — WeChat articles, X long-form posts, short-form briefs, viral short posts, revision and quality checks, cover art, long-image rendering: seven skills, one repo.
 
 <p align="center">
   <img src="docs/assets/writing-cover.png" alt="topmind-writing-skills · writing skills collection" width="960" />
@@ -19,7 +19,7 @@
 
 ### topmind-wechat-post · WeChat article authoring
 
-Full lifecycle for WeChat articles: delivery package, review & rewrite, three quality gates (facts / logic / de-AI-flavor), WeChat inline typography (images must be embedded), publish checklist and status sync. Python stdlib only — zero dependencies.
+Full lifecycle for WeChat articles: single-source article folder (`<title>/<title>.md`), review & rewrite, three quality gates (run by topmind-revise by default: facts / logic / de-AI-flavor), WeChat inline typography on request (images must be embedded, output goes to `out/`), publish checklist and status sync. Hand-written heading numbers are kept as written; legacy `公众号稿.md` packages stay readable. Python stdlib only — zero dependencies.
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-wechat-post
@@ -27,7 +27,7 @@ npx @topmindspace/topmind-writing-skills install topmind-wechat-post
 
 ### topmind-x-article · One-click X long-form publishing
 
-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.
+Delivers one `<title>.md` by default (after topmind-revise); when you want to post on X, derives into `out/` on request: one-click-copy HTML (rich text; reads the source's `![]()` lines and embeds images in order, "来源：" lines become captions) / plain-text fallback (`md2x.py`: images → `[图N]`, tables → "item: value" lists, lists → "·" / "1）" with emoji optional, 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
@@ -57,18 +57,26 @@ Paste existing text: **to duanzi** → one sentence per line with blank lines be
 npx @topmindspace/topmind-writing-skills install topmind-format
 ```
 
+### topmind-revise · Revision and quality check
+
+Makes a draft shorter, more accurate and closer to the author's voice, and proves the facts survived. Four modes: audit (report only), revise (back up, then write back), embed (called by the WeChat / X long-form skills; returns only the final draft) and quick (titles, short posts, one-liners, replies). Pipeline: facts → logic → cut redundancy → de-AI → voice check → layout → fidelity check → over-edit check; `revise_check.py` diffs numbers, quotes, proper nouns and hedging words, and reports the share of clean paragraphs that were rewritten anyway.
+
+```bash
+npx @topmindspace/topmind-writing-skills install topmind-revise
+```
+
 ### 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-post workflow: sources → original post/images → content → layout; emoji optional for short posts (emoji or 「1）」/「·」/【headings】 bullets), none at all in duanzi; never `- ` / `1. `; the X short-post / duanzi body is one copy-ready plain-text block (hashtags last); **links (including sources), original images and generated images are sent separately**; X long-form and WeChat articles may keep in-text links |
+| `x-delivery-contract.md` (must read) | Short-post workflow: sources → original post/images → content → layout; emoji optional for short posts (bullets default to 「·」, 「1）」 for longer lists, emoji only for short lists, 【headings】 for longer posts), none at all in duanzi; never `- ` / `1. `; the X short-post / duanzi body is one copy-ready plain-text block (hashtags last); **links (including sources), original images and generated images are sent separately**; X long-form and WeChat articles may keep in-text links |
 | `x-post-format.md` | No Markdown, bullet sets, spacing, sources, skeletons, images, WeChat → X |
 | `emoji-system.md` | The TopMind emoji system (short posts only, optional): 0–2 persona motifs (🐔 🐱 🌱) at start/end; 0–1 keyword-matched title emoji; one bullet set per post |
 | `x-layout-patterns.md` | Layout patterns in our own words |
 
-Checks: `lint_x_post.py` (E1–E9 Markdown leftovers; E10–E12 URLs / source lines / image notes in the body; W9 AI-sounding phrases, W10 first line too long for a hook, W12 notes / internal tags in the body; W14 long-form paragraph too long, W15 / W16 Chinese / English structural patterns, W17 punctuation tics, W18 self-made image without data source; W13 any emoji in a duanzi post with `--duanzi`; `--long` skips E10–E12 for long-form; `--md` runs the content warnings on Markdown drafts). De-AI rule table: `de-ai-rules.md`; hook checklist: section 5.5 of `writing-principles.md`.
+Checks: `lint_x_post.py` reports three levels. **E errors** (E1–E9 Markdown leftovers; E10–E12 URLs / source lines / image notes in the body) must be zero. **W warnings** (W9 AI-sounding phrases, W10 first line too long, W12 notes / internal tags, W14 paragraph too long, W15 / W16 Chinese / English structural patterns, W17 punctuation tics, W18 self-made image without data source, W19 「name 说：」, W20 transition sentences, W21 retelling an image; W13 any emoji in a duanzi post with `--duanzi`) each need a decision. **H hints** (context words, news-style precision, parallel closing lines, emoji density, etc.) are advisory and never fail `--strict`. Pick the genre with `--genre long|short|duanzi|reply|title`; hide hints with `--no-hints`. The de-AI part shares one rule set with `de_ai_lint.py` (`de-ai-rules.md`).
 
 ### topmind-cover · Cover art generation
 
@@ -99,13 +107,21 @@ npx @topmindspace/topmind-writing-skills install topmind-poster
 > Also do not install the old package's `^2` (2.0.0–2.1.1 deprecated).
 
 
-## Shared writing workflow (since 0.8.43)
+## Shared writing workflow (since 0.8.44: three layers)
+
+The writing skills share one rule set (`shared/references/`, copied into each skill so standalone installs work):
+
+| Layer | Files | Covers |
+|---|---|---|
+| Voice | `core-voice.md` | Scenario rules (V01–V33): titles, openings, endings, numbers, quotes, source lines, lists, emoji, replies, joke recipe |
+| De-AI | `de-ai-rules.md` + `de_ai_lint.py` | Rewrite boundaries plus structural patterns (Z / E / P codes); the linter reports W (each needs a decision) and H (advisory) |
+| Execution | `topmind-revise` | Runs `revision-workflow.md` end to end, with a fidelity check, an over-edit check and a revision report |
 
-briefs, viral-posts, x-article and wechat-post share three references (`shared/references/`, copied into each skill):
+Also:
 
-- **Originals first** (`image-sourcing.md`): find official / original-post / third-party images before writing and log sources in a private list inside the delivery package; self-made charts are a fallback and must be labeled 自制 with the data source.
-- **De-AI pass is mandatory** (`de-ai-rules.md`): Chinese and English structural-pattern table plus rewrite boundaries (change wording, never facts or certainty). `lint_x_post.py` checks the scriptable part: W9 stock phrases, W15 Chinese structural patterns, W16 English structural patterns, W17 punctuation tics, W18 unlabeled self-made images; use `--md` for WeChat drafts. topmind-format reports hits without rewriting.
-- **Fixed revision order** (`revision-workflow.md`): logic & facts → cut redundancy → de-AI → layout; back up first and report before/after word counts every round.
+- **Originals first** (`image-sourcing.md`): find official / original-post / third-party images before writing and log sources in the private `素材来源.md` inside the article folder; self-made charts are a fallback and must be labeled 自制 with the data source.
+- **De-AI pass is mandatory**: rewrite boundaries first (change wording, never facts or certainty); W warnings need a decision rather than a zero count; the regression set `scripts/test_lint_rules.py` keeps normal writing from being flagged. topmind-format reports hits without rewriting.
+- **Fixed revision order** (`revision-workflow.md`): facts → logic → cut redundancy → de-AI → voice check → layout → fidelity check → over-edit check; back up first and report before/after word counts (`count_words.py`). `topmind-revise` runs it when installed.
 
 ## Original examples
 
@@ -116,6 +132,7 @@ Every skill ships sample outputs written by us (fictional or neutral topics; no
 | topmind-viral-posts (one-liners) | [`topmind-viral-posts/examples/`](./topmind-viral-posts/examples/) |
 | topmind-briefs (short posts) | [`topmind-briefs/examples/`](./topmind-briefs/examples/) |
 | topmind-format (formatting) | [`topmind-format/examples/`](./topmind-format/examples/) |
+| topmind-revise (revision) | [`topmind-revise/examples/`](./topmind-revise/examples/) |
 | topmind-x-article (X long-form) | [`topmind-x-article/examples/`](./topmind-x-article/examples/) |
 | topmind-wechat-post (WeChat) | [`topmind-wechat-post/examples/`](./topmind-wechat-post/examples/) |
 | topmind-poster (posters) | [`topmind-poster/examples/`](./topmind-poster/examples/) |
@@ -128,15 +145,16 @@ Every skill ships sample outputs written by us (fictional or neutral topics; no
 
 | Skill | Version | What it does |
 |-------|---------|--------------|
-| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.14** | WeChat article lifecycle: package, review, 3 quality gates, inline typography & publish checklist |
-| [`topmind-x-article`](./topmind-x-article/) | **0.4.20** | 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.11** | 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 + 24 title treatments + 7-layer scene recipe + 55 example images (22 styles × 2 sizes + 11 variant samples) + 1 style overview |
-| [`topmind-briefs`](./topmind-briefs/) | **0.2.22** | Short-form briefs (WeChat + X): one topic, one chart; data rankings / paper explainers / product alerts / mechanism explainers; sources → images → content → layout; one copy-ready plain-text X block (no HTML by default, emoji optional, no AI tone), links / images sent separately; asks before generating any image |
-| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.14** | X viral short posts: 18 template types + combinations, duanzi layout (blank lines, no emoji, plain bullet lines), one copy-ready plain-text block per post with hashtags last, links / images sent separately, classification tags listed separately; asks before generating an image |
-| [`topmind-format`](./topmind-format/) | **0.1.7** | X plain-text formatter: to duanzi (blank lines, no emoji) / to short post (paragraphing + sensible lists, emoji optional); layout only, words unchanged, with a fidelity check; one copy-ready plain-text body, links / images sent separately |
+| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.16** | WeChat article lifecycle: single-source article folder, review, 3 quality gates (revise by default), inline typography on request & publish checklist |
+| [`topmind-x-article`](./topmind-x-article/) | **0.4.22** | X long-form: single-source Markdown (revise by default) → on-request one-click-copy HTML (images/prompt copy, click-to-zoom images) / plain-text fallback + cover + checklist |
+| [`topmind-cover`](./topmind-cover/) | **0.4.13** | 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 + 24 title treatments + 7-layer scene recipe + 55 example images (22 styles × 2 sizes + 11 variant samples) + 1 style overview |
+| [`topmind-briefs`](./topmind-briefs/) | **0.2.24** | Short-form briefs (WeChat + X): one topic, one chart; data rankings / paper explainers / product alerts / mechanism explainers; sources → images → content → layout; one copy-ready plain-text X block (no HTML by default, emoji optional, no AI tone), links / images sent separately; asks before generating any image |
+| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.16** | X viral short posts: 18 template types + combinations, duanzi layout (blank lines, no emoji, plain bullet lines), one copy-ready plain-text block per post with hashtags last, links / images sent separately, classification tags listed separately; asks before generating an image |
+| [`topmind-format`](./topmind-format/) | **0.1.9** | X plain-text formatter: to duanzi (blank lines, no emoji) / to short post (paragraphing + sensible lists, emoji optional); layout only, words unchanged, with a fidelity check; one copy-ready plain-text body, links / images sent separately |
+| [`topmind-revise`](./topmind-revise/) | **0.1.1** | Revision and quality check: edit, tighten, de-AI, three quality gates and fidelity audit; four modes (audit / revise / embed / quick); every change maps to a rule code, with an over-edit guard; the long-form skills use it by default |
 | [`topmind-poster`](./topmind-poster/) | **0.1.6** | 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.43** (whole-repo same-tag releases).
+Installer [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) is **0.8.45** (whole-repo same-tag releases).
 
 ### Which skill, and how they combine
 
@@ -144,12 +162,13 @@ Installer [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package
 |---|---|---|
 | A data-driven brief (numbers, rankings, launches) | `topmind-briefs` | → `topmind-format` for layout; no original image → `topmind-cover` 16:9 |
 | Engagement jokes, follower posts | `topmind-viral-posts` | → `topmind-format` to re-lay duanzi; pair with a briefs version for the same event |
-| Existing text, layout only | `topmind-format` | words unchanged; rewriting → briefs / viral-posts |
-| Thousands-of-words X article | `topmind-x-article` | + `topmind-cover` (5:2); shorter than a post → briefs |
-| WeChat long-form & layout | `topmind-wechat-post` | + `topmind-cover`; 300–800-char briefs → briefs |
+| Existing text, layout only | `topmind-format` | words unchanged; rewriting → `topmind-revise` |
+| Edit, tighten, de-AI, quality check | `topmind-revise` | standalone, or called by x-article / wechat-post after drafting |
+| Thousands-of-words X article | `topmind-x-article` | + `topmind-revise` + `topmind-cover` (5:2); shorter than a post → briefs |
+| WeChat long-form & layout | `topmind-wechat-post` | + `topmind-revise` + `topmind-cover`; 300–800-char briefs → briefs |
 | Long images, posters, infographics | `topmind-poster` | copy written first by briefs / wechat-post |
 
-> 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.
+> 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 references (`core-voice.md`, `de-ai-rules.md`, `writing-principles.md` and more) 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.
 
 ## Install
 
@@ -181,6 +200,7 @@ topmind-writing-skills/
 ├─ topmind-briefs/                    # skill (SKILL.md + assets + references + scripts)
 ├─ topmind-viral-posts/               # skill (X viral short posts, duanzi layout)
 ├─ topmind-format/                    # skill (X plain-text formatter: duanzi / short post)
+├─ topmind-revise/                    # skill (revision and quality check)
 ├─ topmind-poster/                    # skill (HTML → high-res long image / section images)
 ├─ topmind-cover/                     # skill
 ├─ topmind-wechat-post/               # skill

package/README.md

@@ -7,7 +7,7 @@
 [![CI](https://img.shields.io/github/actions/workflow/status/topmindspace/topmind-writing-skills/ci.yml?style=flat-square&label=CI)](https://github.com/topmindspace/topmind-writing-skills/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square)](LICENSE)
 
-**TopMindSpace 写作技能合集** —— 公众号文章、X 长文、干货短文、引流段子、封面配图、长图出图：六个技能，一个仓库。
+**TopMindSpace 写作技能合集** —— 公众号文章、X 长文、干货短文、引流段子、改稿与质检、封面配图、长图出图：七个技能，一个仓库。
 
 <p align="center">
   <img src="docs/assets/writing-cover.png" alt="topmind-writing-skills · 写作技能合集" width="960" />
@@ -17,7 +17,7 @@
 
 ### topmind-wechat-post · 公众号创作
 
-公众号文章全生命周期：交付包、审校改写、质量三关（事实 / 逻辑 / 去 AI 味）、微信内联排版（图片必内嵌）、发布清单与状态同步。脚本纯 Python 标准库，零依赖。
+公众号文章全生命周期：单源文章文件夹（`<文章名>/<文章名>.md`）、审校改写、质量三关（默认组合 topmind-revise：事实 / 逻辑 / 去 AI 味）、按需出微信内联排版（图片必内嵌，产物进 `out/`）、发布清单与状态同步。手写小标题序号原样保留；旧 `公众号稿.md` 交付包只读兼容。脚本纯 Python 标准库，零依赖。
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-wechat-post
@@ -25,7 +25,7 @@ npx @topmindspace/topmind-writing-skills install topmind-wechat-post
 
 ### topmind-x-article · X 长文一键发布
 
-Markdown 原稿 → 一键复制 HTML（富文本，配图内嵌）/ 纯文本兜底（`md2x.py`：图片→`[图N]`、表格→"项：值"列表、列表→emoji 项目符号，因为 X 纯文本不渲染 Markdown 列表）+ 封面图 + 发布清单。发布走人工粘贴，发布后抓回核对。
+默认交付一份 `<文章名>.md`（先过 topmind-revise）；要发 X 时再按需派生到 `out/`：一键复制 HTML（富文本，直接读源稿的 `![]()` 按顺序内嵌配图，「来源：」行成图注）/ 纯文本兜底（`md2x.py`：图片→`[图N]`、表格→"项：值"列表、列表→「·」「1）」，emoji 可选，因为 X 纯文本不渲染 Markdown 列表）+ 封面图 + 发布清单。发布走人工粘贴，发布后抓回核对。
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-x-article
@@ -57,18 +57,26 @@ npx @topmindspace/topmind-writing-skills install topmind-viral-posts
 npx @topmindspace/topmind-writing-skills install topmind-format
 ```
 
+### topmind-revise · 改稿与质检
+
+把一篇稿子改得更短、更准、更像作者本人，并且能证明没改坏事实。四种模式：只审不改（出改稿报告）、改稿（先备份再写回）、嵌入（公众号 / X 长文写完默认调用，只回终稿）、快审（标题、短文、段子、回复）。流程：事实 → 逻辑 → 删冗余 → 去 AI 味 → 核心经验对照 → 排版 → 保真审计 → 过度改稿检查；`revise_check.py` 比对数字、引语、专名和确定性词，并统计「没命中却被改写」的段落占比。
+
+```bash
+npx @topmindspace/topmind-writing-skills install topmind-revise
+```
+
 ### X 文本统一规约（所有产出 X 纯文本的技能共用）
 
 共享文档在 `shared/references/`，经 manifest 分发到各技能 `references/`：
 
 | 文档 | 管什么 |
 |---|---|
-| `x-delivery-contract.md`（必读必守） | 短文工作流：信源 → 原帖原图 → 内容 → 排版；短文 emoji 不强制（分点可用 emoji 或「1）」「·」【小标题】），段子完全不用 emoji，都禁用 `- ` `1. `；X 短文 / 段子的正文是一段可直接复制的纯文本（话题标签在末行），**链接（含来源）、原图、配图另发**；X 长文与公众号长文可保留文内链接 |
+| `x-delivery-contract.md`（必读必守） | 短文工作流：信源 → 原帖原图 → 内容 → 排版；短文 emoji 不强制（分点默认「·」，行多用「1）」，短列表才用 emoji，较长短文用【小标题】），段子完全不用 emoji，都禁用 `- ` `1. `；X 短文 / 段子的正文是一段可直接复制的纯文本（话题标签在末行），**链接（含来源）、原图、配图另发**；X 长文与公众号长文可保留文内链接 |
 | `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 残留；E10–E12 正文有 URL / 来源行 / 配图说明；W9 AI 套话、W10 首行太长不像钩子、W12 混入说明 / 内部标签；W14 长文单段过长、W15 / W16 中英文结构套话、W17 标点腔、W18 自制图没标数据来源；`--duanzi` 时 W13 段子里出现 emoji；`--long` 长文不查 E10–E12；`--md` 查 Markdown 稿的内容类警告）。去 AI 味规则表在 `de-ai-rules.md`，吸引力清单在 `writing-principles.md` 第五点五节。
+检查：`lint_x_post.py` 分三级——**E 错误**（E1–E9 Markdown 残留；E10–E12 正文有 URL / 来源行 / 配图说明）必须清零；**W 警告**（W9 AI 套话、W10 首行太长、W12 混入说明 / 内部标签、W14 单段过长、W15 / W16 中英文结构套话、W17 标点腔、W18 自制图没标数据来源、W19「人名说：」、W20 过渡句、W21 复述图片；`--duanzi` 时 W13 段子里出现 emoji）每条要有结论；**H 提示**（语境词、新闻式精确、对仗收句、emoji 过密等）只供判断，不计入 `--strict`。`--genre long|short|duanzi|reply|title` 选文体，`--no-hints` 关掉提示。去 AI 味部分和 `de_ai_lint.py` 是同一份规则（`de-ai-rules.md`）。
 
 ### topmind-cover · 封面配图生成
 
@@ -99,13 +107,21 @@ npx @topmindspace/topmind-writing-skills install topmind-poster
 > 也不要安装旧包的 `^2`（2.0.0–2.1.1 已弃用）。
 
 
-## 共用写作流程（0.8.43 起）
+## 共用写作流程（0.8.44 起：三层设计）
+
+写作技能共用一套规则（`shared/references/`，各技能自带副本，单独安装也能用）：
+
+| 层 | 文件 | 管什么 |
+|---|---|---|
+| 核心经验 | `core-voice.md` | 场景规则（V01–V33）：标题、开头、收尾、数字、引用、来源行、列表、emoji、回复、段子配方…… |
+| 去 AI 味 | `de-ai-rules.md` + `de_ai_lint.py` | 改写边界 + 结构模式（Z / E / P 编号）；脚本分 W 警告（每条要有结论）和 H 提示（只供判断） |
+| 执行 | `topmind-revise` | 按 `revision-workflow.md` 跑完改稿流程、保真审计和过度改稿检查，出改稿报告 |
 
-briefs、viral-posts、x-article、wechat-post 共用三份规约（`shared/references/`，各技能自带副本）：
+另外：
 
-- **原图优先**（`image-sourcing.md`）：写字之前先找官方 / 原帖 / 第三方原图，来源记进交付包里的私有信源清单；自制图只作兜底，标「自制」和数据来源。
-- **去 AI 味必过**（`de-ai-rules.md`）：中英文结构模式规则表 + 改写边界（只改表达，不改事实和确定性）。`lint_x_post.py` 自动查能脚本化的部分：W9 套话词、W15 中文结构套话、W16 英文结构套话、W17 标点腔、W18 自制图标注；公众号稿用 `--md`。topmind-format 只报告命中、不改字。
-- **固定改稿流程**（`revision-workflow.md`）：逻辑与事实 → 删冗余 → 去 AI 味 → 排版；每轮先备份，报改前 / 改后字数。
+- **原图优先**（`image-sourcing.md`）：写字之前先找官方 / 原帖 / 第三方原图，来源记进文章文件夹里的私有 `素材来源.md`；自制图只作兜底，标「自制」和数据来源。
+- **去 AI 味必过**：先守改写边界（只改表达，不改事实和确定性）；W 警告不要求清零，要求每条有结论；规则回归测试 `scripts/test_lint_rules.py` 守住「不应报」的正常写法。topmind-format 只报告命中、不改字。
+- **固定改稿流程**（`revision-workflow.md`）：事实 → 逻辑 → 删冗余 → 去 AI 味 → 核心经验对照 → 排版 → 保真审计 → 过度改稿检查；每轮先备份，报改前 / 改后字数（`count_words.py`）。装了 `topmind-revise` 就由它执行。
 
 ## 原创示例
 
@@ -116,6 +132,7 @@ briefs、viral-posts、x-article、wechat-post 共用三份规约（`shared/refe
 | topmind-viral-posts（段子） | [`topmind-viral-posts/examples/`](./topmind-viral-posts/examples/) |
 | topmind-briefs（短文） | [`topmind-briefs/examples/`](./topmind-briefs/examples/) |
 | topmind-format（排版） | [`topmind-format/examples/`](./topmind-format/examples/) |
+| topmind-revise（改稿） | [`topmind-revise/examples/`](./topmind-revise/examples/) |
 | topmind-x-article（X 长文） | [`topmind-x-article/examples/`](./topmind-x-article/examples/) |
 | topmind-wechat-post（公众号） | [`topmind-wechat-post/examples/`](./topmind-wechat-post/examples/) |
 | topmind-poster（长图海报） | [`topmind-poster/examples/`](./topmind-poster/examples/) |
@@ -128,15 +145,16 @@ briefs、viral-posts、x-article、wechat-post 共用三份规约（`shared/refe
 
 | 技能 | 版本 | 做什么 |
 |------|------|--------|
-| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.14** | 公众号文章全生命周期：交付包、审校改写、质量三关、微信内联排版与发布清单 |
-| [`topmind-x-article`](./topmind-x-article/) | **0.4.20** | X 长文一键发布：Markdown 原稿 → 一键复制 HTML（含配图/提示词复制、图片点击放大）/ 纯文本兜底 + 封面图 + 发布清单 |
-| [`topmind-cover`](./topmind-cover/) | **0.4.11** | 文章封面配图（X / 公众号共用，X 主尺寸 1500×600 / 5:2）：震撼醒目主题突出；22 种封面风格库 + X 短文 16:9 封面场景 + 24 种标题花式 + 七层场景配方 + 55 张示例图（22 种风格 × 2 尺寸 + 11 张变体样张） + 1 张风格总览图 |
-| [`topmind-briefs`](./topmind-briefs/) | **0.2.22** | 干货短文（公众号 + X 双平台）：一件事讲透，数据榜单/论文解读/新品速递；信源 → 原图 → 内容 → 排版；X 版交付一段可复制纯文本（默认不出 HTML，emoji 可选，去 AI 味），链接 / 原图 / 配图另发，无原图先询问配图 |
-| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.14** | X 引流段子/爆款短篇：18 大类型模板 + 组合玩法，段子体（行间空行，零 emoji，分点不加符号）、每条一段可复制纯文本、话题标签在末行，链接 / 原图另发、分类标签另列；无原图先询问再走 topmind-cover |
-| [`topmind-format`](./topmind-format/) | **0.1.7** | X 纯文本格式化：转段子（行间空行，零 emoji）/ 格式化成短文（分段 + 合理列表，emoji 可选），只动排版不改字，带原文保真校验；交付一段可复制纯文本，链接 / 原图另发 |
+| [`topmind-wechat-post`](./topmind-wechat-post/) | **0.3.16** | 公众号文章全生命周期：单源文章文件夹、审校改写、质量三关（默认组合 revise）、按需出微信内联排版与发布清单 |
+| [`topmind-x-article`](./topmind-x-article/) | **0.4.22** | X 长文：单源 Markdown（默认组合 revise）→ 按需出一键复制 HTML（含配图/提示词复制、图片点击放大）/ 纯文本兜底 + 封面图 + 发布清单 |
+| [`topmind-cover`](./topmind-cover/) | **0.4.13** | 文章封面配图（X / 公众号共用，X 主尺寸 1500×600 / 5:2）：震撼醒目主题突出；22 种封面风格库 + X 短文 16:9 封面场景 + 24 种标题花式 + 七层场景配方 + 55 张示例图（22 种风格 × 2 尺寸 + 11 张变体样张） + 1 张风格总览图 |
+| [`topmind-briefs`](./topmind-briefs/) | **0.2.24** | 干货短文（公众号 + X 双平台）：一件事讲透，数据榜单/论文解读/新品速递；信源 → 原图 → 内容 → 排版；X 版交付一段可复制纯文本（默认不出 HTML，emoji 可选，去 AI 味），链接 / 原图 / 配图另发，无原图先询问配图 |
+| [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.16** | X 引流段子/爆款短篇：18 大类型模板 + 组合玩法，段子体（行间空行，零 emoji，分点不加符号）、每条一段可复制纯文本、话题标签在末行，链接 / 原图另发、分类标签另列；无原图先询问再走 topmind-cover |
+| [`topmind-format`](./topmind-format/) | **0.1.9** | X 纯文本格式化：转段子（行间空行，零 emoji）/ 格式化成短文（分段 + 合理列表，emoji 可选），只动排版不改字，带原文保真校验；交付一段可复制纯文本，链接 / 原图另发 |
+| [`topmind-revise`](./topmind-revise/) | **0.1.1** | 改稿与质检：改稿、精简、去 AI 味、质量三关与保真审计；四种模式（只审不改 / 改稿 / 嵌入 / 快审），每处改动对应规则编号，防过度改稿；长文技能默认组合 |
 | [`topmind-poster`](./topmind-poster/) | **0.1.6** | HTML+CSS → 高清长图 / 海报 / 信息图 PNG：无头 Chrome 2× 截图 + 自动裁白；「一段一图」分段图批量出图（生成器 + 渲染器） |
 
-安装器 [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) 为 **0.8.43**（整仓同 tag 发版）。
+安装器 [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) 为 **0.8.45**（整仓同 tag 发版）。
 
 ### 怎么选、怎么组合
 
@@ -144,14 +162,15 @@ briefs、viral-posts、x-article、wechat-post 共用三份规约（`shared/refe
 |---|---|---|
 | 一件事的干货短文（数据、榜单、发布） | `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 |
-| 公众号长文与排版 | `topmind-wechat-post` | + `topmind-cover`；300–800 字短文走 briefs |
+| 现成文字只要排版（转段子 / 格式化） | `topmind-format` | 只动排版不改字；要改写内容转 `topmind-revise` |
+| 改稿、精简、去 AI 味、质检 | `topmind-revise` | 单独用；或被 x-article / wechat-post 写完长文时调用 |
+| 数千字 X 长文 | `topmind-x-article` | + `topmind-revise`（改稿质检）+ `topmind-cover`（5:2 封面）；短于一帖的内容走 briefs |
+| 公众号长文与排版 | `topmind-wechat-post` | + `topmind-revise`（质量三关）+ `topmind-cover`；300–800 字短文走 briefs |
 | 长图、海报、信息图 PNG | `topmind-poster` | 文案先由 briefs / wechat-post 写好 |
 
 > SKILL.md frontmatter 顶层只用 Agent Skills 规范字段（`name` / `description` / `license` / `metadata`），版本、`action_category`、`triggers` 等自定义字段放在 `metadata` 下（字符串值），能通过官方校验器 `skills-ref validate`。
 >
-> 共享脚本与共享文档（`writing-principles.md`、X 文本规约四件套）的唯一真源在 `shared/`，各技能目录保留逐字节副本（单独安装也能用）；改共享文件只改 `shared/`，再跑 `npm run sync:shared`，CI 用 `--check` 校验。
+> 共享脚本与共享文档（`core-voice.md`、`de-ai-rules.md`、`writing-principles.md`、X 文本规约四件套等）的唯一真源在 `shared/`，各技能目录保留逐字节副本（单独安装也能用）；改共享文件只改 `shared/`，再跑 `npm run sync:shared`，CI 用 `--check` 校验。
 >
 > npm 包不含 cover 的单风格样张（`assets/examples/<style>*.png`），只保留 `overview.png`；完整样张见 GitHub 仓库或 Release zip。
 
@@ -185,6 +204,7 @@ topmind-writing-skills/
 ├─ topmind-briefs/               # 技能（SKILL.md + assets + references + scripts）
 ├─ topmind-viral-posts/          # 技能（X 引流段子/爆款短篇，段子体）
 ├─ topmind-format/               # 技能（X 纯文本格式化：转段子 / 格式化成短文）
+├─ topmind-revise/               # 技能（改稿与质检）
 ├─ topmind-poster/               # 技能（HTML → 高清长图 / 分段图）
 ├─ topmind-cover/                # 技能
 ├─ topmind-wechat-post/          # 技能

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@topmindspace/topmind-writing-skills",
-  "version": "0.8.43",
-  "description": "TopMindSpace 写作技能合集 — 通过 npm / npx 安装技能（公众号长文、X 长文、干货短文、X 引流短帖、封面图、长图海报）。只出稿与发布包，不代发。",
+  "version": "0.8.45",
+  "description": "TopMindSpace 写作技能合集 — 通过 npm / npx 安装技能（公众号长文、X 长文、干货短文、X 引流短帖、改稿与质检、封面图、长图海报）。只出稿与发布包，不代发。",
   "license": "MIT",
   "author": "TopMindspace",
   "repository": {
@@ -20,6 +20,7 @@
     "x-twitter",
     "briefs",
     "viral-posts",
+    "revise",
     "cover",
     "poster"
   ],
@@ -37,6 +38,7 @@
     "topmind-cover",
     "topmind-format",
     "topmind-poster",
+    "topmind-revise",
     "topmind-viral-posts",
     "topmind-wechat-post",
     "topmind-x-article",
@@ -46,6 +48,7 @@
     "!topmind-cover/dist/",
     "!topmind-format/dist/",
     "!topmind-poster/dist/",
+    "!topmind-revise/dist/",
     "!topmind-viral-posts/dist/",
     "!topmind-wechat-post/dist/",
     "!topmind-x-article/dist/",
@@ -53,6 +56,7 @@
     "!topmind-cover/package-lock.json",
     "!topmind-format/package-lock.json",
     "!topmind-poster/package-lock.json",
+    "!topmind-revise/package-lock.json",
     "!topmind-viral-posts/package-lock.json",
     "!topmind-wechat-post/package-lock.json",
     "!topmind-x-article/package-lock.json"

package/topmind-briefs/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.2.24 (2026-10-18)
+
+- 随包共享脚本更新：`md2x-html.py` 能直接读源稿的 `![]()` 按顺序嵌图、「来源：」行渲染成图注、`--out` 缺省 `out/X长文.html`（原有 `--images-from` 用法不变）；`md2wechat.py` 默认保留手写小标题序号（`--auto-number` 恢复旧行为），`--out-dir` / `--slug` 有缺省值
+- `de_ai_lint.py` 的 W18：图片下一行写了「来源：自制，数据：…」也算标清楚
+
+## 0.2.23 (2026-10-18)
+
+- 写法规则改为引用共享的 `core-voice.md`：首行一句话题陈述、事实讲完就停（去掉收尾句）、列表默认「·」、话题标签默认 2 个；引语正文写「人名：中文意思」；未完全确认的热点首行用一次「？！」，不写泛泛的「据报道」
+- lint 分 W 警告 / H 提示两级：W 每条要有结论，H 只供判断；公众号版改跑 `de_ai_lint.py`
+- 用户要改稿时转 `topmind-revise`，没装就按随包 `revision-workflow.md` 手动走
+
 ## 0.2.22 (2026-10-17)
 
 - 去 AI 味改为必过步骤（`de-ai-rules.md`，lint 新增 W15–W18 与 `--md`）；写字前先找原图（`image-sourcing.md`）；改稿按固定四步（`revision-workflow.md`）

package/topmind-briefs/README.en.md

@@ -7,7 +7,7 @@ A brief is not a long-form article — **no HTML by default**: the workflow is v
 The X version is one copy-ready plain-text block (emoji optional); **links (including sources), original images and any generated images are sent separately**, never mixed into the body.
 The WeChat version is ~300–800 Chinese characters of Markdown. With no original image it asks before generating one.
 
-- Version: **v0.2.22** (ships with `@topmindspace/topmind-writing-skills@0.8.43`)
+- Version: **v0.2.24** (ships with `@topmindspace/topmind-writing-skills@0.8.45`)
 
 ## Install
 

package/topmind-briefs/README.md

@@ -7,7 +7,7 @@
 X 版交付一段可直接复制的纯文本（emoji 可选），**链接（含来源）、原图、配图另发**，不和正文混在一起；公众号版约 300–800 字 Markdown。
 没有原图时先问要不要配图（`topmind-cover`）；链接那一条写明来源名称、发布时间与 URL。
 
-- 版本：**v0.2.22**（随 `@topmindspace/topmind-writing-skills@0.8.43` 发布）
+- 版本：**v0.2.24**（随 `@topmindspace/topmind-writing-skills@0.8.45` 发布）
 
 ## 安装
 

package/topmind-briefs/SKILL.md

@@ -1,21 +1,22 @@
 ---
 name: topmind-briefs
-description: "干货短文：一件事讲透，X + 公众号双平台。短文不是长文——默认不出 HTML：工作流按「核实一手信源 → 找原帖原图 → 写内容 → 排版」；X 版交付一段可直接复制的纯文本（首行钩子、合理分段与列表、去 AI 味、emoji 可选且只用 TopMind 体系、末行 0–2 个话题标签），链接（含来源）、原图（1–2 张）、配图另发，绝不混进正文；公众号版是 300–800 字 Markdown；没有原图时主动询问是否配图，不擅自生图。尊重原始信息、原图、原文。只交付不代发。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 版交付一段可直接复制的纯文本（首行一句话题陈述、合理分段与列表、去 AI 味、emoji 可选且只用 TopMind 体系、末行默认 2 个话题标签），链接（含来源）、原图（1–2 张）、配图另发，绝不混进正文；公众号版是 300–800 字 Markdown；没有原图时主动询问是否配图，不擅自生图。尊重原始信息、原图、原文。只交付不代发。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）、单独改稿、去 AI 味与质检（→ topmind-revise）、把稿子发出去（→ topmind-x，须用户确认）。"
 license: MIT
 metadata:
-  version: "0.2.22"
+  version: "0.2.24"
   action_category: "write"
   triggers: "写短文, 公众号短文, X 短文, 发快讯, 快讯, 简讯, 速报, 干货短文, 论文解读, 数据榜单, 榜单速报, 新品速递, brief, 来篇短的, 短平快, 发个快讯"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-writing-skills#readme"
-  updated: "2026-10-14"
+  updated: "2026-10-18"
 ---
 
 # topmind-briefs · 干货短文（X + 公众号）
 
 一件事，一段话，讲完就停。短文不是长文：**默认不出 HTML、不做排版包**，交付的是可以直接复制粘贴的文字。
 
-> **必读必守**：[references/x-delivery-contract.md](references/x-delivery-contract.md)——X 正文是一段可直接复制的纯文本，**不含 URL 和来源行**；链接一条、图片一条另发。分点可用 emoji 或「1）」「·」【小标题】，禁用 `- ` `1. `；emoji 不强制。
+> **必读必守**：[references/x-delivery-contract.md](references/x-delivery-contract.md)——X 正文是一段可直接复制的纯文本，**不含 URL 和来源行**；链接一条、图片一条另发。分点默认「·」，行多用「1）」，短列表才用 emoji，禁用 `- ` `1. `；emoji 不强制。
+> **写法规则**：[references/core-voice.md](references/core-voice.md) 的短文条目（V01 V05 V08–V13 V16 V20–V22 V24–V28 V32）；去 AI 味按 [references/de-ai-rules.md](references/de-ai-rules.md)。
 
 - 跟 `topmind-viral-posts` 的区别：那是引流互动型段子（第一人称、钩子、涨粉）；这是**信息密度型干货短文**（数据、榜单、论文、新品，第三方客观口吻）。
 - 跟 `topmind-x-article` / `topmind-wechat-post` 的区别：那两个是长文（数千字、多节多图、HTML 发布包）；本技能 X 版是一条纯文本短文（约 1000 字内），公众号版 300–800 字。
@@ -28,20 +29,21 @@ metadata:
 - 公众号长文、公众号排版 HTML → `topmind-wechat-post`
 - 引流互动型短帖（第一人称、段子、钩子、涨粉、互关）→ `topmind-viral-posts`
 - 单独出长图、海报、信息图 PNG → `topmind-poster`；只要封面、头图 → `topmind-cover`
+- 单独改一篇现成稿子、去 AI 味、质检 → `topmind-revise`
 - 把稿子发到 X → `topmind-x`（发帖连接器，须用户确认后才发）
 
 ## 语言铁律
 
 - **默认中文**：标题、正文、配图说明一律用中文，不需要用户每次声明。
 - **英文是例外**：只有用户**明确说**「写英文」时才用英文。消息里夹英文词、给英文素材、引用英文原文，都不算要求写英文。
-- 引用英文一手素材（论文标题、官方公告、图表原文）时保留原文，必要时在旁给中文翻译。
+- 官方产品名、论文标题保留英文；引语正文写「人名：中文意思」，英文原文记进素材来源，不在正文里原文加括注（core-voice V13）。
 
 ## 尊重原始信息（铁律）
 
 1. **原始信息**：事实、数字、时间以一手来源为准（官方公告、更新日志、论文、原帖、财报）；二手报道至少找 2 个独立来源交叉确认，无法核实的承重事实删掉。
 2. **原文**：引用原话时逐字照录并加「」，写明出处；不把转述写成引语，不改原文数字的单位和口径。
 3. **原图**：配图用官方截图 > 官方基准图 > 第三方榜单实拍 > 论文原图，保留原图不裁掉关键信息，不用 AI 图冒充原图。
-4. **口径标注**：厂商数字标「（厂商口径）」，未证实消息标「（传言）」，自己的判断标「（推测）」或写成「现在看起来…」，与事实分开写。
+4. **口径标注**：厂商数字标「（厂商口径）」；有一手信源但还没完全确认的热点，短文直陈并在首行用一次「？！」，不写泛泛的「据报道」，纯传闻不写（core-voice V22）；自己的判断写成「预计」「大概率」「现在看起来…」，与事实分开写，不用「我认为」。
 5. **不洗稿**：观点可以撞，表达必须原创；不照搬聚合站或别人帖子的行文。
 
 ## 工作流
@@ -51,23 +53,23 @@ metadata:
 1. **核实信源**：一篇只讲一件事（一个数据、一个榜单变化、一篇论文的核心结论、一个新品的关键参数）。先找一手来源（官方公告、更新日志、论文、仓库、当事人原帖）；厂商数字标「官方称 / 厂商口径」，传言标「据传 / 未证实」。记下每条的**来源名称、发布时间（时区）、URL**——这些另发给用户，不进正文。
 2. **找原帖、原图**（写字之前，按 [references/image-sourcing.md](references/image-sourcing.md)）：原帖链接、官方图 / 截图 1–2 张，来源记进交付说明；自制图只作兜底，标「自制」和数据来源。
 3. **写内容**：
-   - 首行是钩子：「是什么 + 最扎眼的事实」，约 30 字内，只看首行也拿到信息；
-   - 具体数字和场景，说人话，最后一句给判断、建议或具体问题（不复述、不升华）；
-   - **去 AI 味（必过）**：按 [references/de-ai-rules.md](references/de-ai-rules.md) 逐条过（先守改写边界：只改表达，不改事实和确定性），再对照 [references/writing-principles.md](references/writing-principles.md) 第五点五节「吸引力清单」；
+   - 首行一句简单的话题陈述：「是什么 + 最关键的事实」，约 30 字内，只看首行也拿到信息；不用设问钩子，真里程碑把「第一」放句首（core-voice V05、V20）；
+   - 具体数字和场景，说人话，事实讲完就停，不硬加收尾句（V10）；对比给出对象和定语，不写「约 / 左右」，不用千分位（V12）；
+   - **去 AI 味（必过）**：按 [references/de-ai-rules.md](references/de-ai-rules.md) 逐条过（先守改写边界：只改表达，不改事实和确定性），再对照 [references/core-voice.md](references/core-voice.md) 短文条目和 [references/writing-principles.md](references/writing-principles.md) 第五点五节「吸引力清单」；
    - 出处在正文里只用文字点到（「官方称」「据论文」），不贴 URL、不写来源行。
 4. **排版**（目标：方便阅读），按 [references/platform-specs.md](references/platform-specs.md)、[references/x-post-format.md](references/x-post-format.md)、[references/x-layout-patterns.md](references/x-layout-patterns.md)：
    - 一段 1–3 行，段间空一行；3–7 条并列信息才用列表，前一行写「xx：」引导语，2 条就写成两句；
-   - 分点任选一套：emoji（🔹 / 1️⃣ / ✅❌）或纯文本（「1）」「·」【小标题】分节），禁用 `- ` `* ` `1. `；
+   - 分点默认「·」，行多或有顺序用「1）」，短列表（3–4 条）才用 emoji（🔹 / 1️⃣ / ✅❌），较长短文用【小标题】分节；禁用 `- ` `* ` `1. `（V25）；
    - emoji **不强制**；要用就只用 TopMind 体系（[references/emoji-system.md](references/emoji-system.md)）：标题 emoji 0–1 个且对上关键词，人设点缀 0–2 个只放首尾，严肃资讯不放；
    - 中英混排：英文专名保留原文，中英之间加半角空格；
-   - 最后一行 0–2 个话题标签；不用 Markdown（X 不渲染）。
+   - 最后一行默认 2 个话题标签（宽泛词 + 主题词，V27）；不用 Markdown（X 不渲染）。
 4. **写公众号版**（用户要双平台时）：300–800 字 Markdown，内容与 X 版一致，只允许排版差异；不写前言导读。
 5. **配图**：原图优先，交付 1–2 张（官方图、原帖配图 / 原帖截图、基准图、榜单实拍），每张写一句图注说明它证明什么；给可直接打开的图片地址，能下载就下载到交付目录。**没有可用原图时，必须主动问用户「要不要配图？可以用 topmind-cover 出一张 16:9 封面」**，用户说要再调用 `topmind-cover` 的「X 短文封面」（16:9，1200×675）；不擅自生图。
 6. **自检**：
    - 每个数字都能在另发的链接里找到出处；图和文字说的是同一件事；推测已标注；
-   - `python3 scripts/lint_x_post.py X短文.txt`：错误清零（Markdown 残留，以及 E10 正文有 URL、E11 有来源行、E12 有配图说明），W9（AI 套话）/ W15–W16（中英文结构套话）/ W17（标点腔）/ W10（首行太长）/ W8（表情过多）逐条处理；公众号版跑 `lint_x_post.py 公众号短文.md --md`；
+   - `python3 scripts/lint_x_post.py X短文.txt`：E 错误清零（Markdown 残留，以及 E10 正文有 URL、E11 有来源行、E12 有配图说明）；W 警告每条要有结论（改掉，或在说明里写保留理由）；H 提示只供判断，不要求改；公众号版跑 `python3 scripts/de_ai_lint.py 公众号短文.md`；
    - 需要统一排版时可跑 `python3 scripts/format_text.py X短文.txt --mode short --out X短文.txt`（只动排版不改字；正文里的链接、来源行会被拿出来另列）。
-   - 用户要求改稿时，按 [references/revision-workflow.md](references/revision-workflow.md)：备份 → 逻辑与事实 → 删冗余 → 去 AI 味 → 排版，报改前 / 改后字数。
+   - 用户要求改稿时，转 `topmind-revise`（`mode=revise genre=short`）；没装时按 [references/revision-workflow.md](references/revision-workflow.md) 手动走：备份 → 事实 → 逻辑 → 删冗余 → 去 AI 味 → 核心经验对照 → 排版 → 保真审计，报改前 / 改后字数（`python3 scripts/count_words.py`）。
 7. **交付**（只交付，不发布）：见下节「交付格式」；落盘时 `X短文.txt` 只放正文，链接 / 图片 / 说明写进 `交付说明.md`。
 
 ## 交付格式
@@ -97,19 +99,17 @@ SWE-bench 榜单换了第一：领先只有 1.3 分
 2）模型 B：76.9%
 3）模型 C：74.5%
 
-分差不到 4 个点，选模型先看单任务成本，别只看名次。
-
-#SWEbench #AI编程
+#AI #SWEbench
 ```
 
 链接（另发）：`ToyBench 官方榜单｜2026-10-13（UTC）｜https://example.com/toybench`
 图片（另发）：`[图1] 榜单截图 — 前三名分数；来源：官方榜单`
 
-（示例中的模型名与分数为虚构演示；同一条也可以用 🔹 列表加 📊 标题 emoji。更多示例见 [references/examples.md](references/examples.md)。）
+（示例中的模型名与分数为虚构演示；事实讲完就停，不加收尾句。更多示例见 [references/examples.md](references/examples.md)。）
 
 ## 话题标签
 
-X 版末尾给 0–2 个话题标签（属正文，是正文最后一行；备选标签写在说明里），单独成行放在最后：榜单、发布类取榜单名或产品通用名，再加 1 个领域词；
+X 版末尾默认给 2 个话题标签（属正文，是正文最后一行；备选标签写在说明里）：一个宽泛词（如 #AI）+ 一个主题词（榜单名、产品通用名或领域词）；
 不堆砌，不蹭无关热点，不用诱导互动或敏感标签；中文帖用中文话题，英文帖用英文驼峰。公众号稿不加话题标签。细则见 `references/platform-specs.md`。
 
 ## 内容类型（四种）
@@ -119,13 +119,14 @@ X 版末尾给 0–2 个话题标签（属正文，是正文最后一行；备
 | 数据榜单型 | 基准评测、成本对比 | 判断句开头 → 基准一句 → 最扎眼数字 → 核心图（解决率 / 成本） |
 | 榜单速报型 | 排行榜更新、排名变动 | 排名 + 分数 → 性价比 → 细分展开 → 纵向对比 → 榜单实拍 |
 | 论文解读型 | 新论文、新方法 | 判断句开头 → 核心方法一句 + 3 条要点 → 论文原图（另发） |
-| 机制讲解型 | 技术原理、流程拆解 | 痛点一句 → 1）2）3）或 1️⃣2️⃣3️⃣ 分步 → 一句结论 → 流程图（另发） |
+| 机制讲解型 | 技术原理、流程拆解 | 痛点一句 → 1）2）3）分步 → 流程图（另发） |
 
 ## 和其他技能怎么配合
 
 | 场景 | 组合 |
 |---|---|
 | 写完再统一排版 | 本技能 → `topmind-format` 短文体（只排版不改字） |
+| 用户要改稿、过一遍质检 | 本技能 → `topmind-revise`（`mode=revise genre=short`） |
 | 没有原图、用户同意配图 | 本技能 → `topmind-cover`「X 短文封面」 |
 | 内容太多、写成长文 | 转 `topmind-x-article`（X 长文）或 `topmind-wechat-post`（公众号长文） |
 | 要一张数据长图 | 本技能出文案 → `topmind-poster` 出图 |

package/topmind-briefs/examples/01-X/347/237/255/346/226/207-/347/274/226/350/276/221/345/231/250/345/217/221/345/270/203.txt

@@ -4,10 +4,10 @@
 
 这次更新主要改了三处：
 
-🔹 离线模式：本地运行常用功能，草稿不出设备
-🔹 更快的启动：官方称冷启动时间缩短一半
-🔹 新的导出：一键导出公众号和 X 两种格式
+· 离线模式：本地运行常用功能，草稿不出设备
+· 更快的启动：官方称冷启动时间缩短一半
+· 新的导出：一键导出公众号和 X 两种格式
 
-老用户在设置里检查更新即可，免费升级。
+老用户免费升级。
 
-#写作工具
+#AI #写作工具

package/topmind-briefs/examples/02-X/347/237/255/346/226/207-/345/237/216/345/270/202/345/205/254/345/233/255.txt

@@ -8,6 +8,4 @@
 · 一半以上带儿童游乐区
 · 夜间照明到晚上十点
 
-周末想找个近处走走，可以从家附近那座开始。
-
-明天见 🌱
+🌱