@topmindspace/topmind-writing-skills 0.8.48 → 0.8.49

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [0.8.49] - 2026-10-24
+
+> 根包 0.8.48 → **0.8.49**（patch）；技能版本：topmind-briefs 0.2.27 → 0.2.28、topmind-cover 0.4.16 → 0.4.17、topmind-viral-posts 0.3.19 → 0.3.20、topmind-wechat-post 0.3.19 → 0.3.20。其余技能不变。
+
+### 优化
+
+- 根 README 中英文对齐，安装与技能说明从使用者角度重写；topmind-briefs、topmind-viral-posts 的 README 同步。
+- 几处说明改得更直白：短文开头写法、风格表与段子表的表头、设计规范与主题映射的要点句、WARN 的含义。
+- CHANGELOG 去掉内部备注，只涉及发布流程与 CI 的条目压成一行。
+
 ## [0.8.48] - 2026-10-22
 
 > 全面优化：段子重组为 12 + 2 种写法，短文按 9 种内容类型写，去 AI 味规则新增社交短帖模式和问句口径条目，长文骨架先写「我的判断」并在交付前出图文预览；根 README 和各技能 README 改为能力优先。
@@ -345,7 +355,7 @@
 
 - **topmind-briefs**：短文不是长文，默认不出 HTML——X 版是一段纯文本，公众号版是 Markdown；HTML 脚本只在用户明确要求时使用。新增「尊重原始信息」铁律与交付格式，交付时写明信息来源、发布时间、来源链接与图片来源。
 - **配图口径统一**：原图优先；没有原图时封面可选（不再默认配封面）。`x-post-format.md`、briefs、viral-posts、cover 的「X 短文封面」场景说明同步。
-- **topmind-viral-posts**：类型从 14 扩到 18（新增冷知识揭秘、差额冲刺、反差对照、自问自答），新增「段子体排版」（一句一行、行间空行）与「组合玩法（钩子 × 主体 × 收尾）」两节、8 种常用组合；示例按用户提供的两条参考帖改写（未复制第三方截图与账号信息）；表情规则接入 emoji 体系。
+- **topmind-viral-posts**：类型从 14 扩到 18（新增冷知识揭秘、差额冲刺、反差对照、自问自答），新增「段子体排版」（一句一行、行间空行）与「组合玩法（钩子 × 主体 × 收尾）」两节、8 种常用组合；示例改为原创（不含第三方截图与账号信息）；表情规则接入 emoji 体系。
 
 ### 优化
 
@@ -460,44 +470,19 @@
 
 > 根包 0.8.24 → **0.8.25**（patch）；各技能版本不变。
 
-> - 优化：**npm 包不再带 package-lock.json**。0.8.24 的 npm 包里有 6 个锁文件：briefs、cover、wechat-post、x-article 提交在仓库里的 4 个，
->   以及技能门禁在 poster、viral-posts 下临时生成的 2 个。6 个技能都没有 npm 依赖，这些锁文件里没有锁定任何包，用户按目录安装也用不上
-> - 优化：技能门禁（`scripts/ci_skill_gates.sh`、`scripts/run_skill_gates.js install`）在技能没有运行时依赖时跳过 `npm install`，不再生成临时锁文件；
->   以后有依赖时，有锁文件用 `npm ci --omit=dev`，没有则用 `npm install --omit=dev --no-package-lock`
-> - 优化：删除仓库里 4 个空锁文件，`.gitignore` 忽略 `package-lock.json`（以后某个技能加了依赖，按注释为它加例外后提交）；
->   `scripts/sync_npm_files.js` 为每个技能生成 `!<skill>/package-lock.json` 排除项，`package.json` `files` 同步更新
-> - 优化：`scripts/check_npm_pack.js` 增加拦截 `package-lock.json`、`npm-shrinkwrap.json`、`node_modules/`
-> - 优化：CI 与 Release 的 `setup-node` 去掉 `cache: npm`（没有依赖可缓存，原先指向的 `topmind-briefs/package-lock.json` 已删除）
-> - 本地验证：全部门禁与打包步骤之后 `npm pack --dry-run`：123 → 117 个文件，锁文件 6 → 0；临时放入锁文件并去掉排除项时，`check_npm_pack.js` 报错退出
+> - 优化：npm 包不再附带空的 `package-lock.json`；其余为发布流程与 CI 调整，无用户可见变化
 
 ## [0.8.24] - 2026-10-08
 
 > 根包 0.8.23 → **0.8.24**（patch）；各技能版本不变。
 
-> - 优化：**npm 包不再带 Release 打包产物**。Release 流程在 `npm publish` 之前运行 `package_skill.py`，会在各技能下生成
->   `dist/`（`<skill>.zip` 与 `<skill>.manifest.json`），0.8.23 的 npm 包因此多带了 briefs / poster / viral-posts 的 6 个文件（约 111 KB）。
->   `scripts/sync_npm_files.js` 现在为每个发现到的技能生成 `!<skill>/dist/` 排除项，`package.json` `files` 同步更新；
->   这些产物仍作为 GitHub Release 附件发布
-> - 优化：新增 `scripts/check_npm_pack.js`（`npm run check:pack`），按 `npm pack --dry-run` 的实际文件清单检查，
->   出现 `dist/`、`release-assets/`、`__pycache__/`、`*.pyc` 即失败。Release 在打包之后、建 Release 之前运行；
->   CI `Skill package gates` 先按 Release 同口径真实打包再运行，问题在推送 main 时就能发现
-> - 优化：GitHub Actions 改用 Node 24 运行时的版本：`actions/checkout` v4 → v7、`actions/setup-node` v4 → v7、`actions/setup-python` v5 → v7、
->   `softprops/action-gh-release` v2 → v3；ci / release / deprecate-npm-2x 的 `node-version` 20 → 24（本地 Node 24 跑全部门禁与打包步骤通过）
-> - 优化：`runs-on` 由 `ubuntu-latest` 固定为 `ubuntu-24.04`：GitHub 在 2026-10-19 至 11-19 期间把 `ubuntu-latest` 逐步切到 Ubuntu 26.04，先停在当前已验证的镜像，切 26.04 另行验证后再改
-> - 本地验证：打包 6 个技能后 `npm pack --dry-run`：127 → 121 个文件，tarball 2,188,530 B → 2,090,653 B，
->   解包 2,842,215 B → 2,731,152 B，`dist/` 文件 6 → 0。完整走一遍 Release 步骤时为 123 个文件：技能门禁会在
->   poster、viral-posts 下临时生成无依赖的 `package-lock.json`（各约 200 B），随包发布，不影响使用
+> - 优化：npm 包不再附带 Release 打包产物（`dist/`），这些文件仍作为 GitHub Release 附件发布；其余为发布流程与 CI 调整
 
 ## [0.8.23] - 2026-10-08
 
 > 根包 0.8.22 → **0.8.23**（patch）；各技能版本不变。0.8.22 已打 tag 但未生成 Release、未发布 npm，其全部内容随 0.8.23 一并发布（见下方 0.8.22 条目）。
 
-> - 优化：**Release 打包不受运行时缓存影响**。`package_skill.py`（shared 真源 + 6 份副本）新增 `IGNORE_RES`，
->   `__pycache__/`、`*.pyc`、`*.pyo`、`.DS_Store` 在校验与打包时都直接跳过，不再判为「不应进包的文件」；
->   `scripts/_*`、`.env` 等仍按原规则拦截
-> - 优化：`release.yml` 在 job 级设置 `PYTHONDONTWRITEBYTECODE=1`，负向测试运行脚本时不写字节码缓存，打包与 npm 包保持干净
-> - 优化：CI `Skill package gates` 在负向测试之后追加「Release packaging check」，按 Release 同口径逐技能跑 `package_skill.py --check`，
->   打包问题在推送 main 时就能发现，不必等到打 tag
+> - 发布流程与 CI 调整，无用户可见变化
 
 ## [0.8.22] - 2026-10-08
 
@@ -510,7 +495,7 @@
 >     找不到时回落内置 `scan_ai_flavor_builtin.py` 并在 stderr 提示缺姿态维度（0.8.43 起改为环境变量 `$TOPMIND_AI_SCAN` 指定）
 >   - `md2wechat.py` 两版逐段比对：本仓 1801 行版本已包含旧版全部能力，并多出括号 URL、嵌套围栏、行内图片管线、
 >     原子写、坏输入干净报错等处理，保留本仓版本；旧版独有的左衬条样式、自我介绍签名行、minimal-ink 默认主题
->     是 2026-10-01/02 按用户要求去掉的，不恢复
+>     此前已去掉，不恢复
 >   - references 合入：`workflow.md` 补溯源审计步骤与 `word_count` 口径说明，`writing-quality.md` 补作者姿态分与清单文档误判说明
 > - 优化：**去掉写死的路径、类别编号与年份**。新增 `scripts/wechat_paths.py`，`new-article / sync-status / sync-mapping / push-to-topstream`
 >   共用：`--base` → `TOPMIND_WECHAT_BASE` → `--workspace` / `TOPMIND_WORKSPACE` 下按名称发现「长文」类别（兼容「创作」「专题」）
@@ -558,7 +543,7 @@
 >   含「一段一图」分段图批量出图工作流（生成器 + 渲染器）
 > - 新增 `scripts/render_poster.py`：一条命令跑完截图 → 扫底 → 裁切，支持批量、自动加大窗口重试、`--chrome` / `CHROME_PATH` 指定浏览器
 > - 新增 `references/layout-recipes.md`：画布尺寸 / 字号层级 / 浅底深底配色 / 栅格 / 进度条 / 常用版式模板
-> - 沉淀 7 个实测坑：macOS 沙箱下必须 `--no-sandbox`、柱状图填充整条消失（`<span>` 需 `display:block`）、
+> - 记录 7 条实测经验：macOS 沙箱下必须 `--no-sandbox`、柱状图填充整条消失（`<span>` 需 `display:block`）、
 >   裁切基准色不能取左上角（顶部装饰层会污染）、PNG 重采样反而变大、`str.format()` 拼 CSS 报 KeyError 等
 > - 定位说明：本技能只管**出图那一环**；封面走 `topmind-cover`，PPTX 走 `top-ppt-html`
 > - README 技能表补齐 **topmind-viral-posts**（英文版此前缺）、校正各技能版本号与安装器版本
@@ -567,15 +552,15 @@
 
 > 根包 0.8.18 → **0.8.19**（patch）；技能：topmind-viral-posts 0.3.0 → **0.3.1**（patch，纯运营 7 型并入）。
 
-> - topmind-viral-posts 新增 **8-14 型纯运营吸粉模板**（暴论型/数据晒单型/真诚交友型/吐槽共鸣型/干货技巧型/经验忠告型/执行清单型），基于 2026-10-03 用户提供的 10 张 X 爆款截图深度拆解
+> - topmind-viral-posts 新增 **8-14 型纯运营吸粉模板**（暴论型/数据晒单型/真诚交友型/吐槽共鸣型/干货技巧型/经验忠告型/执行清单型）
 > - 新增 **Hashtag 矩阵**（#蓝V互关 #follow #真诚交友 #浇朋友 黄金组合）与 **圈内用语词典**（浇朋友/蓝朋友/出摊/串门/上岸）
-> - 8-14 型为纯 X 运营/吸粉内容，不蹭新闻热点；双份真源合并，本地 skills/ 目录的 0.2.0 内容已并入正式仓库
+> - 8-14 型为纯 X 运营/吸粉内容，不蹭新闻热点
 
 ## [0.8.18] - 2026-10-03
 
 > 根包 0.8.17 → **0.8.18**（patch）；技能：topmind-wechat-post 0.3.1 → **0.3.2**（patch，衬条禁令铁律）。
 
-> - design.md 设计要点新增 **禁止顶部/侧边衬条和颜色条铁律**（用户明确）：用浅色调色板区分区块，不用硬色条；MD3 真风格 = 浅色调色块 + 圆角 + 柔和阴影 + 标签药丸
+> - design.md 设计要点新增 **禁止顶部/侧边衬条和颜色条铁律**：用浅色调色板区分区块，不用硬色条；MD3 真风格 = 浅色调色块 + 圆角 + 柔和阴影 + 标签药丸
 
 ## [0.8.17] - 2026-10-03
 
@@ -583,7 +568,7 @@
 
 > - design.md 新增 **MD3 卡片规范**：禁止 matplotlib 做信息图，走 HTML+CSS → Playwright 截图 → PNG 路线；卡片不要衬条，表格式图表用浅色风格
 > - writing-quality.md 事实关新增 **第三方图片核实三问**：数字是否过于整齐、时间是否对得上、总量是否对得上
-> - writing-quality.md 文字关新增 **去AI味补充清单**（用户亲口）："不是…是…"对比句式、一句话总结、真正的、过度简洁、中立措辞
+> - writing-quality.md 文字关新增 **去AI味补充清单**："不是…是…"对比句式、一句话总结、真正的、过度简洁、中立措辞
 
 ## [0.8.16] - 2026-10-03
 
@@ -669,7 +654,7 @@
 > 根包 0.8.6 → **0.8.7**（patch）；技能：topmind-briefs 0.2.4 → **0.2.5**、
 > topmind-x-article 0.4.5 → **0.4.6**、topmind-wechat-post 0.2.8 → **0.2.9**（patch）。
 >
-> - 全仓：writing-principles.md 第五节新增"很老"→"可以追溯很早之前"（用户亲口改稿）。
+> - 全仓：writing-principles.md 第五节新增"很老"→"可以追溯很早之前"。
 
 ## [0.8.6] - 2026-10-02
 
@@ -697,7 +682,7 @@
 > topmind-x-article 0.4.2 → **0.4.3**、topmind-cover 0.4.0 → **0.4.1**（均为 patch）。
 >
 > - wechat-post：`references/writing-principles.md` 新增第五节"措辞偏好"
->   （2026-10-02 用户亲手改稿确立：不用噱头式导语/"一句话"伪简洁/绝对化断言/
+>   （不用噱头式导语/"一句话"伪简洁/绝对化断言/
 >   "我的判断"/"全文的题眼"/"同一份报告"/"坑"字/看不懂的梗；断言留余地、
 >   简洁不取巧、评论腔删掉）；SKILL.md 实战沉淀追加 v2 措辞整改、PIL 结尾
 >   总结插图做法、topmind-cover 封面流程
@@ -1181,8 +1166,7 @@
 
 ### topmind-cover：6 张样张版式级重设计（差异化纠偏）
 
-- 用户指出第四轮样张仍是"翻版"（版式结构照搬 7 张参考封面，只换文案形象）。
-  本轮按**版式级标准**重做：只保留抽象原则（标题是视觉重心/信息分层/留白呼吸感），
+- 上一轮样张的版式结构与参考封面过于接近，本轮按**版式级标准**重做：只保留抽象原则（标题是视觉重心/信息分层/留白呼吸感），
   6 张重设计（gan-huo 居中构图+深炭灰暖橙、big-type 单行超大书法字+奶油亮底、
   brand-launch 深海军蓝+荧光绿、tutorial-steps 横向时间线+墨色题字、
   ip-fun 数字改右下角印章+橙黄暖色、news-flash 纯黑单色+纸纹+俯视静物大改），
@@ -1258,7 +1242,7 @@
   教程步骤（`tutorial-steps`）/ IP 趣味（`ip-fun`）/ 资讯快报（`news-flash`）/
   极简留白（`minimal`，保留）/ 杂志编辑（`magazine`，保留），
   每种含适用场景、构图公式、配色 hex、标题写法规范（4~8 字、数字/关键词彩色突出）、
-  中英 prompt 配方、避坑；删除旧 6 风格。
+  中英 prompt 配方、常见问题；删除旧 6 风格。
 - `assets/examples/` 样张全部重制：**16 张**（8 风格 × 1200×675 主图 + 900×383 公众号中央裁剪版）
   + `overview.png`（8 宫格总览图），逐张目检（标题逐字准确、无乱码、中央 60% 安全区），
   7 次返工均为"底部元素超出安全区"；旧 12 张移除。
@@ -1282,7 +1266,7 @@
 
 - `references/cover-styles.md` 扩为 **6 种风格库**：震撼大字报（`big-poster`）/ 科技未来感（`tech-future`）/
   杂志编辑风（`magazine`）/ 极简留白（`minimal`）/ 国潮插画（`guochao`）/ 赛博故障艺术（`cyber-glitch`），
-  每种含适用场景、配色 hex、字体建议、中英 prompt 配方、避坑。
+  每种含适用场景、配色 hex、字体建议、中英 prompt 配方、常见问题。
 - `assets/examples/` 新增 **12 张示例图**（6 风格 × 1200×675 主图 + 900×383 公众号中央裁剪版，共约 6.4MB），
   附 `assets/examples/README.md`（清单 + 安全区说明 + 复用声明），随 npm 包发布。
 - SKILL.md 工作流新增"**步骤 0 选风格**"（三步必做：按题材 6 选 1 → 看示例图 → 按配方组 prompt）。
@@ -1293,7 +1277,7 @@
 
 - top-ppt-html / topmind-wechat-post 的 SKILL.md `description` 改**第三人称**（降误触发）；
   topmind-cover `description` 同步微调（"一次配齐"→"全流程覆盖"），`triggers` 新增 `缩略图` / `thumbnail`。
-- topmind-wechat-post：站外取源坑与回推命令串收敛到 `references/workflow.md`，SKILL.md 只留索引；
+- topmind-wechat-post：站外取源注意事项与回推命令收敛到 `references/workflow.md`，SKILL.md 只留索引；
   新增跨技能路由索引（封面配图 → topmind-cover，X 长文 → topmind-x-article）；
   二级标题序号由排版层自动生成（不再手写）。
 - 各技能 README（中/英）与 SKILL.md 对齐：cover 新增风格库与示例图章节、用法改"步骤 0 选风格"；
@@ -1314,7 +1298,7 @@
   交付包 / 审校改写 / 质量三关（事实·逻辑·去 AI 味 ≥85）/ 状态同步 / 微信内联排版（`md2wechat --embed-images`）/ 发布清单。
   适配点：frontmatter 去 topmind-pack 专有键（`degradation`/`action_category`/`entrypoint`），
   跨 skill 引用改为通用表述，`writing-quality.md` 改用技能自带 `scan_ai_flavor.py`
-  （原引用本机私有路径），`md2wechat.py` 缺失输入改干净报错（原 Traceback）。
+  （不再依赖技能外的脚本），`md2wechat.py` 缺失输入改干净报错（原 Traceback）。
 - **topmind-x-article `0.1.0`**：X 长文一键发布。`md2x.py` 把 Markdown 转可直接粘贴进
   X Article 编辑器的纯文本（标题→纯文本行、加粗/斜体去标记、链接→`文字（url）`、
   图片→`[图N]`+文末配图清单、表格→"项：值"列表）；`references/publish-checklist.md`
@@ -1424,7 +1408,7 @@
 ### Craft · 结论条去 AI 味：取消左侧 accent 装饰轨
 
 #### 设计决策（硬原则）
-- **结论条无 left rail**：用户明确拒绝结论条左侧色条为 AI-flavored chrome。`.sowhat` / PPTX `soWhatBar()` 改为 **MD3 tonal surface 满铺**（`accent-soft` + 细描边）+ 舒适字阶 / `line-height:1.65` / 内边距 `--sp-5`/`--sp-6`；**禁止**竖色条、霓虹边、装饰 chip 当强调。
+- **结论条无 left rail**：结论条不用左侧色条。`.sowhat` / PPTX `soWhatBar()` 改为 **MD3 tonal surface 满铺**（`accent-soft` + 细描边）+ 舒适字阶 / `line-height:1.65` / 内边距 `--sp-5`/`--sp-6`；**禁止**竖色条、霓虹边、装饰 chip 当强调。
 - 写入 `design-system` §去 AI 味、`content-rules`、`components-atoms`、`SKILL`、`layout-constants.aiFlavor.visual.forbidConclusionLeftRail`。
 - 同类收口 `.note` 同步去掉左轨，改 tonal 细描边；`.flagbar`（待核实）保留细强调（功能态，非结论装饰）。
 
@@ -1661,7 +1645,7 @@
 
 ### top-ppt-html · Presentation Craft（Mode A 工艺）
 
-- **P0-1 图表多样性（用户明确保留）**：**不降** `minTypes.presentation`（仍为 **4**）；registry/advanced 图种保留。纪律改为「按内容选型拉开多样」+ 禁反模式（简单全幅 / 极偏 donut / 为过门禁硬上冷门图）；playbook §五 / layout-qa 同步。
+- **P0-1 图表多样性（保留）**：**不降** `minTypes.presentation`（仍为 **4**）；registry/advanced 图种保留。纪律改为「按内容选型拉开多样」+ 禁反模式（简单全幅 / 极偏 donut / 为过门禁硬上冷门图）；playbook §五 / layout-qa 同步。
 - **P0-2 default-surface**：升为 Mode A / Fast 演示主读面（12 页型 + 8 核图 + V1–V4；P5–P12/advanced 按需）；SKILL L2 索引指向。
 - **P0-3 layout-qa 默认**：`validate_report --strict` 在 presentation 下自动 `--layout-qa`；`quality_gate` 同口径；B/C 不强制。
 - **P0-4 主张标题**：Mode A action/claim title（禁话题标签）写入 content-rules / modes；校验 WARN。

package/README.en.md

@@ -28,7 +28,7 @@ npx @topmindspace/topmind-writing-skills list                          # see all
 
 ## What it writes
 
-| Category | Skill | In one line | Say |
+| Category | Skill | What it does | Say |
 |---|---|---|---|
 | Duanzi | [`topmind-viral-posts`](./topmind-viral-posts/) | One sentence per line, zero emoji, 14 patterns | "来条段子", "不懂就问", "写个群聊体" |
 | Briefs | [`topmind-briefs`](./topmind-briefs/) | One thing, then stop: news, previews, launches, deals, rankings, papers, hands-on | "发个快讯", "来篇短的", "写条预告" |
@@ -43,7 +43,7 @@ npx @topmindspace/topmind-writing-skills list                          # see all
 
 Decide **who you want in the replies**, then pick a pattern:
 
-| Pattern | In one line | Typical opening | Replies you want |
+| Pattern | What it is | Typical opening | Replies you want |
 |---|---|---|---|
 | A1 Genuine question | Play dumb, ask what you really don't know | "Doesn't anyone use…?" | Experts explaining |
 | A2 Leak check | Clue + last time + a guess | "XX is about to ship?!" | More clues, guesses |
@@ -172,6 +172,8 @@ The persona is **an ordinary person still learning**: talks about what they saw
 
 ### Scripts hint, people decide
 
+Run these inside the skill folder (for example `topmind-briefs/` or `topmind-revise/`):
+
 ```bash
 python3 scripts/lint_x_post.py X短文.txt --kind news   # news brief
 python3 scripts/lint_x_post.py 段子.txt --duanzi        # duanzi
@@ -232,7 +234,7 @@ topmind-writing-skills/
 - Pushing main is visible on GitHub immediately; a `vX.Y.Z` tag creates a Release and publishes to npm. Each skill's version lives in its own `SKILL.md` and the [CHANGELOG](./CHANGELOG.md).
 - See [docs/PUBLISHING.md](./docs/PUBLISHING.md) · [docs/ci.md](./docs/ci.md).
 
-> The business presentation skill now lives in its own repo: [`topmind-presentation`](https://github.com/topmindspace/topmind-presentation).
+For business presentations, install [`topmind-presentation`](https://github.com/topmindspace/topmind-presentation) separately.
 
 </details>
 

package/README.md

@@ -28,7 +28,7 @@ npx @topmindspace/topmind-writing-skills list                          # 看全
 
 ## 能写什么
 
-| 类别 | 技能 | 一句话 | 你可以这样说 |
+| 类别 | 技能 | 用途 | 你可以这样说 |
 |---|---|---|---|
 | 段子 | [`topmind-viral-posts`](./topmind-viral-posts/) | 一句一行、零 emoji 的 X 短帖，14 种写法 | 「来条段子」「不懂就问」「写个群聊体」 |
 | 短文 | [`topmind-briefs`](./topmind-briefs/) | 一件事讲完就停：快讯、预告、新品、羊毛、榜单、论文、实测 | 「发个快讯」「来篇短的」「写条预告」 |
@@ -39,13 +39,13 @@ npx @topmindspace/topmind-writing-skills list                          # 看全
 | 封面 | [`topmind-cover`](./topmind-cover/) | X 和公众号封面：22 种风格、标题逐字核对 | 「做个封面」「头图」 |
 | 长图 | [`topmind-poster`](./topmind-poster/) | HTML → 高清长图 / 海报 / 信息图，文字数字逐字正确 | 「出张长图」「做个榜单图」 |
 
-> **短文** = X 纯文本帖，1000 字以内都行；**长文** = X Article 或公众号长文；**段子** = 一句一行、行间空一行的短帖。
+**短文** = X 纯文本帖，1000 字以内都行；**长文** = X Article 或公众号长文；**段子** = 一句一行、行间空一行的短帖。
 
 ## 段子：14 种写法
 
 先想清楚**想让哪种人来评论**，再挑写法：
 
-| 写法 | 一句话 | 典型开头 | 想要的评论 |
+| 写法 | 特点 | 典型开头 | 想要的评论 |
 |---|---|---|---|
 | A1 不懂就问 | 装傻式真疑问 | 难道没人…吗？ | 懂行的人来解释 |
 | A2 扒料求证 | 线索 + 上次结果 + 猜测 | XX 要上新了？！ | 补线索、猜结果 |
@@ -72,7 +72,7 @@ npx @topmindspace/topmind-writing-skills list                          # 看全
 | 快讯（晚到） | 换角度：实测、算账、求证 | 「...」 |
 | 预告 / 传闻 | 「要来了？！」，动词照口径 | 「？！」 |
 | 新品 / 工具 | 真疑问或一句真心推荐 | 「...」 |
-| 羊毛 / 优惠 | 一句话说能马上拿到什么 | 不收 |
+| 羊毛 / 优惠 | 直说能马上拿到什么 | 不收 |
 | 榜单 / 数据 | 谁第一、领先多少 | 不收 |
 | 论文 | 一句结论 | 不收 |
 | 实测 | 结果一句（翻车、快、贵） | 自嘲或一个真问题 |
@@ -190,6 +190,8 @@ Nova：我们也上线了，价格动了
 
 ### 脚本只提示，人来判断
 
+在对应技能目录里运行（如 `topmind-briefs/`、`topmind-revise/`）：
+
 ```bash
 python3 scripts/lint_x_post.py X短文.txt --kind news   # 快讯
 python3 scripts/lint_x_post.py 段子.txt --duanzi        # 段子
@@ -250,7 +252,7 @@ topmind-writing-skills/
 - push main 后 GitHub 立即可见；打 tag `vX.Y.Z` 自动出 Release 并发布 npm。每个技能的版本号写在它自己的 `SKILL.md` 和 [CHANGELOG](./CHANGELOG.md) 里。
 - 详见 [docs/PUBLISHING.md](./docs/PUBLISHING.md) · [docs/ci.md](./docs/ci.md)。
 
-> 正式商务演示技能已独立成仓库：[`topmind-presentation`](https://github.com/topmindspace/topmind-presentation)。
+正式商务演示用 [`topmind-presentation`](https://github.com/topmindspace/topmind-presentation)，单独安装。
 
 </details>
 

package/package.json

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

package/topmind-briefs/README.en.md

@@ -4,7 +4,7 @@ English | [中文](./README.md)
 
 **One thing, then stop.** News, previews, launches, deals, rankings, papers, hands-on results and one-line takes: nine content types, each with its own opening and ending. The X version is one block of plain text you can paste straight in, facts and highlight at a glance; links, original images and caliber notes are delivered separately. The WeChat version is 300–800 characters of Markdown. Writes in Chinese by default.
 
-- Version: **v0.2.27**
+- Version: **v0.2.28**
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-briefs

package/topmind-briefs/README.md

@@ -4,7 +4,7 @@
 
 **一件事，讲完就停。** 快讯、预告、新品、羊毛、榜单、论文、实测、观点一句话，九种内容类型各有各的首行和收尾。X 版是一段可以直接复制的纯文本，一眼就看到事实和亮点；链接、原图、口径提醒另发。公众号版 300–800 字 Markdown。
 
-- 版本：**v0.2.27**
+- 版本：**v0.2.28**
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-briefs
@@ -20,7 +20,7 @@ npx @topmindspace/topmind-writing-skills install topmind-briefs
 | 快讯（晚到） | 首发窗口已过 | 换角度：实测、算账、求证 | 「...」 |
 | 预告 / 传闻 | 预告、灰度、文档里出现 | 「要来了？！」，动词照口径 | 「？！」 |
 | 新品 / 工具 | 好用的新东西 | 真疑问或一句真心推荐 | 「...」 |
-| 羊毛 / 优惠 | 限时、免费 | 一句话说能马上拿到什么 | 不收 |
+| 羊毛 / 优惠 | 限时、免费 | 直说能马上拿到什么 | 不收 |
 | 榜单 / 数据 | 排名变化、评测 | 谁第一、领先多少 | 不收 |
 | 论文 | 新方法、新结论 | 一句结论 | 不收 |
 | 实测 | 自己跑过 | 结果一句（翻车、快、贵） | 自嘲或一个真问题 |

package/topmind-briefs/SKILL.md

@@ -3,12 +3,12 @@ name: topmind-briefs
 description: "干货短文：一件事讲透，X + 公众号双平台。短文不是长文——默认不出 HTML：工作流按「核实一手信源 → 找原帖原图 → 写内容 → 排版」；X 版交付一段可直接复制的纯文本（一眼快餐：首行给最狠的事实，查证过程和口径不进正文；9 种内容类型：首发快讯、晚到快讯、预告传闻、新品推荐、羊毛优惠、榜单数据、论文、实测、观点一句话；首发窗口与时效；合理分段与列表、去 AI 味、emoji 可选、话题标签默认不带），链接（含来源）、原图（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.27"
+  version: "0.2.28"
   action_category: "write"
   triggers: "写短文, 公众号短文, X 短文, 发快讯, 快讯, 简讯, 速报, 干货短文, 预告, 新品速递, 工具推荐, 羊毛, 优惠, 论文解读, 数据榜单, 榜单速报, 实测, 经验一句话, brief, 来篇短的, 短平快, 发个快讯"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-writing-skills#readme"
-  updated: "2026-10-22"
+  updated: "2026-10-24"
 ---
 
 # topmind-briefs · 干货短文（X + 公众号）
@@ -42,7 +42,7 @@ metadata:
 | 快讯（晚到） | 首发窗口已过 | 换新角度：实测、算账、求证、把别人的争议接住 | 第一手数字或一个新事实 | 「...」 |
 | 预告 / 传闻 | 预告、文档里出现、灰度 | 动词照口径写：「要来了？！」「文档里已经改名了」 | 线索 + 官方还没给的东西，直说「还没公布」 | 「？！」 |
 | 新品 / 工具推荐 | 好用的新东西 | 真疑问（「难道没人用…吗？」）或一句真心推荐 | 两三个对读者有用的点（免费、手机能用、不用折腾） | 「...」 |
-| 羊毛 / 优惠 | 限时、免费、大促 | 一句话说能马上拿到什么 | 一句 + 一张图；截止时间写清 | 不收 |
+| 羊毛 / 优惠 | 限时、免费、大促 | 直说能马上拿到什么 | 一句 + 一张图；截止时间写清 | 不收 |
 | 榜单 / 数据 | 排名变化、基准评测 | 谁第一、领先多少 | 「1）」列前三 + 一张榜单原图 | 不收 |
 | 论文 | 新方法、新结论 | 一句结论 | 一句方法 + 3 条「·」要点 + 论文原图 | 不收 |
 | 实测 | 自己跑过 | 结果一句（翻车、快、贵） | 任务、数字、截图；数字必须是作者真跑出来的 | 自嘲，或一个真问题 |

package/topmind-briefs/package.json

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

package/topmind-briefs/references/platform-specs.md

@@ -79,7 +79,7 @@
 | 快讯（晚到） | 新角度：实测、算账、求证 |
 | 预告 / 传闻 | 「要来了？！」，动词照口径 |
 | 新品 / 工具 | 真疑问或一句真心推荐 |
-| 羊毛 | 一句话说能马上拿到什么 |
+| 羊毛 | 直说能马上拿到什么 |
 | 榜单 / 数据 | 谁第一、领先多少 |
 | 论文 | 一句结论，再一句讲新思路 |
 | 实测 | 结果一句 |

package/topmind-cover/README.en.md

@@ -4,7 +4,7 @@
 
 A reusable skill for generating cover art for X long-form posts and WeChat articles. Goal: **striking, eye-catching, theme-focused**.
 
-- Version: **v0.4.16**
+- Version: **v0.4.17**
 
 Say: "做个封面", "公众号头图", "X 长文头图", "X 短文封面".
 

package/topmind-cover/README.md

@@ -4,7 +4,7 @@
 
 为 X 长文和公众号文章生成封面图的可复用技能。目标：**震撼、醒目、主题突出**。
 
-- 版本：**v0.4.16**
+- 版本：**v0.4.17**
 
 你可以这样说：「做个封面」「公众号头图」「X 长文头图」「X 短文封面」。
 

package/topmind-cover/SKILL.md

@@ -3,12 +3,12 @@ name: topmind-cover
 description: "文章封面配图生成：X 长文与公众号共用，也为 X 短文 / 短帖在没有原图时出 16:9 首图，并供 topmind-briefs、topmind-viral-posts 的配图环节调用。震撼、醒目、主题突出；平台尺寸规范、22 种风格模板与风格组合、七层场景配方与中英提示词模板、默认 2–3 个方案、24 种标题花式与副信息组件、分层背景库、10 种构图骨架、TopMind IP 主角、七项评分重做门槛、生图 + 脚本叠字双路径、命名落盘全流程覆盖。Use when 文章封面、封面图、X 短文封面、短帖封面、头图、题图、首图、X 长文头图、公众号封面、公众号头图、封面风格、banner、cover、thumbnail。Do NOT use for 正文插图、长图、海报与信息图（→ topmind-poster）、短文与段子写稿（→ topmind-briefs / topmind-viral-posts）、PPT/报告封面与多页演示（→ topmind-presentation）。"
 license: MIT
 metadata:
-  version: "0.4.16"
+  version: "0.4.17"
   action_category: "write"
   triggers: "封面, 封面图, X 短文封面, 短帖封面, 头图, 题图, 首图, 封面配图, 缩略图, banner, cover, thumbnail, 公众号封面, 公众号题图, 公众号头图, X 封面, X 首图, X 长文头图, 文章封面, 封面风格"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-writing-skills#readme"
-  updated: "2026-10-22"
+  updated: "2026-10-24"
 ---
 
 # topmind-cover · 封面配图生成

package/topmind-cover/package.json

@@ -1,6 +1,6 @@
 {
   "name": "topmind-cover",
-  "version": "0.4.16",
+  "version": "0.4.17",
   "private": true,
   "description": "文章封面配图生成（X 长文 / 公众号共用）：震撼醒目主题突出，尺寸规范 + 11 种风格模板 + 裁剪落盘。",
   "license": "MIT",

package/topmind-cover/references/cover-styles.md

@@ -908,7 +908,7 @@ X 与公众号在手机端信息流里，左右边缘可能被平台图标/时
 
 ## 风格速查（22 种：1~12 浅色，13~22 深色/高饱和）
 
-| 风格 | 一句话 | 标题字号占比 | 首选题材 |
+| 风格 | 特点 | 标题字号占比 | 首选题材 |
 |---|---|---|---|
 | white-clean | 纯白底 + 冲击 1/3 的撞色巨标题 + 场景化插图 + 胶囊标签，清新透气 | 冲击 1/3 | 干货清单/实测盘点/效率职场 |
 | bg-blur | 浅色虚化摄影背景 + 锐利前景主体，大标题压清晰区 | 冲击 1/3 | 生活方式/职场日常/运动健康 |

package/topmind-cover/references/design-system.md

@@ -4,7 +4,7 @@
 > 管什么：标题与版式的层级、字号、网格、安全区、配色比例、字体搭配、设计模式和克制原则。场景怎么画看 `scene-builder.md`，风格配方看 `cover-styles.md`，字效写法看 `typography-system.md` 第十二章。
 > 依据：CRAP 四原则、视觉层级与 Z 形动线、缩略图可读性研究、WCAG 2.2 对比度、60-30-10 配色、模块化字号比例、字体搭配原则。来源见文末。
 
-**一句话**：一张封面只讲一件事。一个焦点、三级文字、一主一辅两种字体、一处重点处理，其余全部让路。
+**要点**：一张封面只讲一件事。一个焦点、三级文字、一主一辅两种字体、一处重点处理，其余全部让路。
 
 ## 一、可读性基准
 

package/topmind-viral-posts/README.en.md

@@ -4,7 +4,7 @@ English | [中文](./README.md)
 
 **One sentence per line, zero emoji, read in three seconds.** 12 topical patterns plus 2 relationship patterns, each with topics, hook, structure, ending, counter-examples and original samples. Decide who you want in the replies, then pick a pattern. The skill writes in Chinese by default.
 
-- Version: **v0.3.19**
+- Version: **v0.3.20**
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-viral-posts

package/topmind-viral-posts/README.md

@@ -4,7 +4,7 @@
 
 **一句一行、零 emoji、三秒看完的 X 短帖。** 12 种话题段子 + 2 种关系帖，每种都有适用题材、钩子、结构、收尾、反例和原创示例。先想清楚想让哪种人来评论，再挑写法。
 
-- 版本：**v0.3.19**
+- 版本：**v0.3.20**
 
 ```bash
 npx @topmindspace/topmind-writing-skills install topmind-viral-posts
@@ -14,7 +14,7 @@ npx @topmindspace/topmind-writing-skills install topmind-viral-posts
 
 ## 14 种写法
 
-| 写法 | 一句话 | 典型开头 | 想要的评论 |
+| 写法 | 特点 | 典型开头 | 想要的评论 |
 |---|---|---|---|
 | A1 不懂就问 | 装傻式真疑问 | 难道没人…吗？ | 懂行的人来解释 |
 | A2 扒料求证 | 线索 + 上次结果 + 猜测 | XX 要上新了？！ | 补线索、猜结果 |

package/topmind-viral-posts/SKILL.md

@@ -3,12 +3,12 @@ name: topmind-viral-posts
 description: "X 段子 / 爆款短篇：12 类话题段子（不懂就问、扒料求证、故障求证、卧槽体、冷知识、群聊对话、连续剧、算账、站边轻判断、荒诞自嘲、产品反转、借热点）+ 2 类关系帖（互关打卡、互助求码），每类写清适用题材、钩子、结构、收尾、反例和自写示例；动笔前先定「想让哪种人来评论」；段子体排版（一句一行、行间空一行、不用 emoji、对话写「xx：」、反转落在动作上）；真疑问可以问，套路互动钩子不用；话题标签默认不带、最多 2 个；配图按类型定，段子默认纯文字；回复和转发点评口吻；每条交付一段可直接复制的纯文本，链接、原图另发。只起草不代发。Use when 段子、写段子、引流段子、爆款短篇、爆款短文、不懂就问、冷知识段子、卧槽体、群聊体、连续剧、扒料、涨粉帖、互关帖、X 短帖、热点段子、蹭热点、新人报到、打卡帖、回复口吻、话题标签、viral post。Do NOT use for 把现成文字转段子或排版（→ topmind-format）、X 长文（→ topmind-x-article）、公众号文章（→ topmind-wechat-post）、快讯、新品、榜单、羊毛等干货短文（→ topmind-briefs）、封面（→ topmind-cover）、长图海报（→ topmind-poster）、单独改稿与去 AI 味（→ topmind-revise）、把帖子发出去（→ topmind-x，须用户确认）。"
 license: MIT
 metadata:
-  version: "0.3.19"
+  version: "0.3.20"
   action_category: "write"
   triggers: "引流段子, 段子, 写段子, 不懂就问, 冷知识段子, 卧槽体, 群聊体, 连续剧段子, 扒料, 故障帖, 冲粉帖, 爆款短篇, 爆款短文, 涨粉帖, 涨粉短帖, 涨粉段子, 互关帖, 互关求粉, X 短帖, 热点段子, 蹭热点, 新人报到, 打卡帖, 回复口吻, 话题标签, hashtag, traffic post, viral post, X 引流"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-writing-skills#readme"
-  updated: "2026-10-22"
+  updated: "2026-10-24"
 ---
 
 # topmind-viral-posts · X 段子 / 爆款短篇
@@ -28,7 +28,7 @@ metadata:
 
 ## 类型总表
 
-| 类型 | 一句话 | 典型钩子 | 想要的评论 |
+| 类型 | 特点 | 典型钩子 | 想要的评论 |
 |---|---|---|---|
 | A1 不懂就问 | 装傻式真疑问 | 难道没人…吗？/ 一直没想明白 | 懂行的人来解释 |
 | A2 扒料求证 | 线索 + 上次结果 + 猜测问句 | XX 要上新了？！ | 补线索、猜结果 |

package/topmind-viral-posts/package.json

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

package/topmind-wechat-post/README.en.md

@@ -4,7 +4,7 @@
 
 **The whole path of a WeChat article, from topic to publish checklist.** Single-source article folder, "my judgments" in the skeleton, three quality gates (facts / logic / de-AI, run by `topmind-revise`), WeChat layout with embedded images (paste and the images come along), a preview image before delivery, publish checklist and status sync.
 
-- Version: **v0.3.19**
+- Version: **v0.3.20**
 
 Say: "写公众号", "公众号排版", "公众号定稿", "出公众号发布清单".
 

package/topmind-wechat-post/README.md

@@ -4,7 +4,7 @@
 
 **从选题到发布清单，一篇公众号长文的完整流程。** 单源文章文件夹、骨架里先写「我的判断」、质量三关（事实 / 逻辑 / 去 AI 味，默认组合 `topmind-revise`）、图片内嵌的微信排版（粘贴即带图）、交付前的图文预览、发布清单和状态同步。
 
-- 版本：**v0.3.19**
+- 版本：**v0.3.20**
 
 你可以这样说：「写公众号」「公众号排版」「公众号定稿」「出公众号发布清单」。
 

package/topmind-wechat-post/SKILL.md

@@ -3,12 +3,12 @@ name: topmind-wechat-post
 description: "管一篇公众号文章从选题/底稿到发布清单的完整生命周期：单源文章文件夹 <文章名>/<文章名>.md、审校改写、质量三关（默认组合 topmind-revise：事实/逻辑/去AI味，含改稿保真溯源审计）、状态同步；用户要公众号版时再按需出微信内联 HTML 与发布清单到 out/。不代发。Use when 写公众号、写公众号文章、公众号长文、公众号排版、微信排版、公众号定稿、发公众号、公众号交付包、公众号发布清单、wechat、mp format。Do NOT use for 公众号短文与快讯（300–800 字，→ topmind-briefs）、X 帖子与段子（→ topmind-viral-posts；派生的 X 短帖交付一段可复制纯文本，链接、原图另发）、X 纯文本格式化与转段子（→ topmind-format）、X 长文（→ topmind-x-article）、封面与头图（→ topmind-cover）、长图与海报（→ topmind-poster）、只改错别字、小红书/知乎、纯网页发布、单独改稿与去 AI 味（→ topmind-revise）、通用长文写作（→ topmind-write）。"
 license: MIT
 metadata:
-  version: "0.3.19"
+  version: "0.3.20"
   action_category: "write"
   triggers: "公众号, 写公众号, 微信排版, 公众号排版, 公众号稿, 公众号长文, 排版这篇文章, 定稿, 发公众号, 公众号交付, wechat, mp format, 写公众号文章, 公众号排版定稿, 公众号发布清单"
   author: "TopMindSpace"
   homepage: "https://github.com/topmindspace/topmind-writing-skills#readme"
-  updated: "2026-10-22"
+  updated: "2026-10-24"
 ---
 
 # topmind-wechat-post · 公众号创作技能

package/topmind-wechat-post/package.json

@@ -1,6 +1,6 @@
 {
   "name": "topmind-wechat-post",
-  "version": "0.3.19",
+  "version": "0.3.20",
   "private": true,
   "description": "公众号文章全生命周期：交付包、审校改写、质量三关、状态同步、微信内联排版与发布清单。",
   "license": "MIT",

package/topmind-wechat-post/references/element-spec.md

@@ -156,4 +156,4 @@ px 固定宽度；`white-space:pre/nowrap`；`position/float/transform/opacity`
 `border-radius`（可能被丢，属优雅降级）、图片 `width:100%`、`id` 属性、
 `<img width="...">` 属性
 
-WARN 不是「可以忽略」，而是「已知风险，需确认是否可接受」。
+WARN 表示「已知风险，需确认是否可接受」，不能直接忽略。

package/topmind-wechat-post/references/theme-map.md

@@ -25,7 +25,7 @@ python3 scripts/md2wechat.py --list-themes
 
 ## 选题材的原则
 
-**一句话**：主题跟着**题材**走，不跟着心情走。同一个题材永远用同一套主题，
+**要点**：主题跟着**题材**走，不跟着心情走。同一个题材永远用同一套主题，
 读者才能形成视觉记忆。换题材时才换主题。
 
 | 判断依据 | 走哪个主题 |