@topmindspace/topmind-writing-skills 0.8.23 → 0.8.24

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+## [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），随包发布，不影响使用
+
 ## [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 条目）。

package/README.en.md

@@ -80,7 +80,7 @@ npx @topmindspace/topmind-writing-skills install topmind-poster
 | [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.2** | X viral short posts: 14 template types (incl. trending-news type); prefer original images (official/third-party), generate only when none exists |
 | [`topmind-poster`](./topmind-poster/) | **0.1.1** | 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.23** (whole-repo same-tag releases).
+Installer [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) is **0.8.24** (whole-repo same-tag releases).
 
 > SKILL.md frontmatter uses only Agent Skills spec keys at the top level (`name` / `description` / `license` / `metadata`); version, `action_category`, `triggers` and other custom keys live under `metadata` as strings, so `skills-ref validate` passes. Shared scripts and `writing-principles.md` have a single source in `shared/`; skill folders keep byte-identical copies (CI checks with `node scripts/sync_shared.js --check`). The npm package ships only `overview.png` from the cover examples; the per-style samples and `references/cover-study/` images stay on GitHub / in the Release zip.
 

package/README.md

@@ -88,7 +88,7 @@ npx @topmindspace/topmind-writing-skills install topmind-poster
 | [`topmind-viral-posts`](./topmind-viral-posts/) | **0.3.2** | X 引流段子/爆款短篇：14 大类型模板（含热点资讯型）；配图原图优先（官方/第三方），无原图才生图（清新优雅/MD3商务风） |
 | [`topmind-poster`](./topmind-poster/) | **0.1.1** | HTML+CSS → 高清长图 / 海报 / 信息图 PNG：无头 Chrome 2× 截图 + 自动裁白；「一段一图」分段图批量出图（生成器 + 渲染器） |
 
-安装器 [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) 为 **0.8.23**（整仓同 tag 发版）。
+安装器 [`@topmindspace/topmind-writing-skills`](https://www.npmjs.com/package/@topmindspace/topmind-writing-skills) 为 **0.8.24**（整仓同 tag 发版）。
 
 > SKILL.md frontmatter 顶层只用 Agent Skills 规范字段（`name` / `description` / `license` / `metadata`），版本、`action_category`、`triggers` 等自定义字段放在 `metadata` 下（字符串值），能通过官方校验器 `skills-ref validate`。
 >

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/topmind-writing-skills",
-  "version": "0.8.23",
+  "version": "0.8.24",
   "description": "TopMindSpace 写作技能合集 — 通过 npm / npx 安装技能（公众号长文、X 长文、干货短文、X 引流短帖、封面图、长图海报）。只出稿与发布包，不代发。",
   "license": "MIT",
   "author": "TopMindspace",
@@ -41,7 +41,13 @@
     "topmind-x-article",
     "!topmind-cover/assets/examples/*.png",
     "topmind-cover/assets/examples/overview.png",
-    "!topmind-cover/references/cover-study/*.png"
+    "!topmind-cover/references/cover-study/*.png",
+    "!topmind-briefs/dist/",
+    "!topmind-cover/dist/",
+    "!topmind-poster/dist/",
+    "!topmind-viral-posts/dist/",
+    "!topmind-wechat-post/dist/",
+    "!topmind-x-article/dist/"
   ],
   "engines": {
     "node": ">=18"
@@ -53,6 +59,7 @@
     "sync:shared": "node scripts/sync_shared.js",
     "check:shared": "node scripts/sync_shared.js --check",
     "check:evals": "node scripts/check_evals.js",
+    "check:pack": "node scripts/check_npm_pack.js",
     "validate:spec": "bash -c 'for s in $(node scripts/discover_skills.js); do ${AGENTSKILLS:-agentskills} validate \"$s\" || exit 1; done'",
     "prepack": "node scripts/sync_npm_files.js --check && node scripts/sync_shared.js --check",
     "install:skills": "node -e \"const {discoverSkills}=require('./scripts/discover_skills'); const {spawnSync}=require('child_process'); for (const id of discoverSkills()) { const r=spawnSync(process.execPath,['bin/topmind-writing-skills.js','install',id],{stdio:'inherit'}); if(r.status) process.exit(r.status||1); }\"",

package/topmind-briefs/README.en.md

@@ -6,7 +6,7 @@ One topic, one chart, then stop. Data-driven short posts: rankings, paper TL;DRs
 product launches — one X post or short thread, ~300–800 Chinese characters on WeChat,
 one-click-copy HTML for both.
 
-- Version: **v0.2.8** (ships with `@topmindspace/topmind-writing-skills@0.8.23`)
+- Version: **v0.2.8** (ships with `@topmindspace/topmind-writing-skills@0.8.24`)
 
 ## Install
 

package/topmind-briefs/README.md

@@ -5,7 +5,7 @@
 一件事，一张图，讲完就停。干货向短文：数据榜单、论文一句话解读、新品速递——
 X 一帖或短 thread，公众号约 300–800 字，双版一键复制 HTML。
 
-- 版本：**v0.2.8**（随 `@topmindspace/topmind-writing-skills@0.8.23` 发布）
+- 版本：**v0.2.8**（随 `@topmindspace/topmind-writing-skills@0.8.24` 发布）
 
 ## 安装
 

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.2** (ships with `@topmindspace/topmind-writing-skills@0.8.23`)
+- Version: **v0.4.2** (ships with `@topmindspace/topmind-writing-skills@0.8.24`)
 
 ## Style gallery
 

package/topmind-cover/README.md

@@ -4,7 +4,7 @@
 
 为 X 长文和公众号文章生成封面图的可复用技能。目标：**震撼、醒目、主题突出**。
 
-- 版本：**v0.4.2**（随 `@topmindspace/topmind-writing-skills@0.8.23` 发布）
+- 版本：**v0.4.2**（随 `@topmindspace/topmind-writing-skills@0.8.24` 发布）
 
 ## 风格样张
 

package/topmind-poster/README.en.md

@@ -4,7 +4,7 @@
 
 Rankings, infographics, monthly-report long images, posters — plus the "one image per section" workflow for splitting a long article into N shareable images. Text is 100% controllable, diffable, and iterable.
 
-- Version: **v0.1.1** (ships with `@topmindspace/topmind-writing-skills@0.8.23`)
+- Version: **v0.1.1** (ships with `@topmindspace/topmind-writing-skills@0.8.24`)
 
 ## Install
 

package/topmind-poster/README.md

@@ -4,7 +4,7 @@
 
 榜单、信息图、月报长图、海报，以及「一段一图」的分段图批量出图。文本 100% 可控、可 diff、可迭代。
 
-- 版本：**v0.1.1**（随 `@topmindspace/topmind-writing-skills@0.8.23` 发布）
+- 版本：**v0.1.1**（随 `@topmindspace/topmind-writing-skills@0.8.24` 发布）
 
 ## 安装
 

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

@@ -4,7 +4,7 @@
 
 Short, real, hooked — read in 3 seconds, impossible not to like/comment/follow. 6 viral templates distilled from real high-engagement X posts in the Chinese community, each post paired with 1 image.
 
-- Version: **v0.3.2** (ships with `@topmindspace/topmind-writing-skills@0.8.23`)
+- Version: **v0.3.2** (ships with `@topmindspace/topmind-writing-skills@0.8.24`)
 
 ## Install
 

package/topmind-viral-posts/README.md

@@ -4,7 +4,7 @@
 
 短、真、钩子——3 秒看完，忍不住点赞/评论/关注。基于 X 中文区真实爆款帖提炼的 6 大类型模板，每帖配 1 张图。
 
-- 版本：**v0.3.2**（随 `@topmindspace/topmind-writing-skills@0.8.23` 发布）
+- 版本：**v0.3.2**（随 `@topmindspace/topmind-writing-skills@0.8.24` 发布）
 
 ## 安装
 

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

@@ -4,7 +4,7 @@
 
 Full lifecycle for WeChat articles: delivery package, review & rewrite, three quality gates, status sync, WeChat inline typography, and publish checklist.
 
-- Version: **v0.3.1** (ships with `@topmindspace/topmind-writing-skills@0.8.23`)
+- Version: **v0.3.1** (ships with `@topmindspace/topmind-writing-skills@0.8.24`)
 
 ## Install
 

package/topmind-wechat-post/README.md

@@ -4,7 +4,7 @@
 
 公众号文章全生命周期：交付包、审校改写、质量三关、状态同步、微信内联排版与发布清单。
 
-- 版本：**v0.3.1**（随 `@topmindspace/topmind-writing-skills@0.8.23` 发布）
+- 版本：**v0.3.1**（随 `@topmindspace/topmind-writing-skills@0.8.24` 发布）
 
 ## 安装
 

package/topmind-x-article/README.en.md

@@ -4,7 +4,7 @@
 
 Turn a Markdown draft into a "copy → paste → publish" X long-form (Article) package.
 
-- Version: **v0.4.8** (ships with `@topmindspace/topmind-writing-skills@0.8.23`)
+- Version: **v0.4.8** (ships with `@topmindspace/topmind-writing-skills@0.8.24`)
 
 ## Install
 

package/topmind-x-article/README.md

@@ -4,7 +4,7 @@
 
 把 Markdown 原稿变成"复制 → 粘贴 → 发"的 X 长文（Article）发布包。
 
-- 版本：**v0.4.8**（随 `@topmindspace/topmind-writing-skills@0.8.23` 发布）
+- 版本：**v0.4.8**（随 `@topmindspace/topmind-writing-skills@0.8.24` 发布）
 
 ## 安装
 

package/topmind-briefs/dist/topmind-briefs.manifest.json

@@ -1,24 +0,0 @@
-{
-  "name": "topmind-briefs",
-  "version": "0.2.8",
-  "built_at": "2026-10-08T04:04:14.564335+00:00",
-  "files": 15,
-  "sha256": "ee4f0ce91dc5c531c3fa9870b67e42b519119cc84a40f7c16fdba726abbd0214",
-  "entries": [
-    "README.md",
-    "SKILL.md",
-    "package.json",
-    "references/examples.md",
-    "references/platform-specs.md",
-    "references/style-guide.md",
-    "references/writing-principles.md",
-    "scripts/audit_css.py",
-    "scripts/audit_docs.py",
-    "scripts/audit_skill.py",
-    "scripts/audit_styles.py",
-    "scripts/md2wechat.py",
-    "scripts/md2x-html.py",
-    "scripts/negative_tests.py",
-    "scripts/package_skill.py"
-  ]
-}

package/topmind-poster/dist/topmind-poster.manifest.json

@@ -1,20 +0,0 @@
-{
-  "name": "topmind-poster",
-  "version": "0.1.1",
-  "built_at": "2026-10-08T04:04:16.058266+00:00",
-  "files": 11,
-  "sha256": "18a2f3cf44889b56b323136810a65ea16bb4a0d7993f3458ea0333bbe96617f0",
-  "entries": [
-    "README.md",
-    "SKILL.md",
-    "package.json",
-    "references/layout-recipes.md",
-    "scripts/audit_css.py",
-    "scripts/audit_docs.py",
-    "scripts/audit_skill.py",
-    "scripts/audit_styles.py",
-    "scripts/negative_tests.py",
-    "scripts/package_skill.py",
-    "scripts/render_poster.py"
-  ]
-}

package/topmind-viral-posts/dist/topmind-viral-posts.manifest.json

@@ -1,19 +0,0 @@
-{
-  "name": "topmind-viral-posts",
-  "version": "0.3.2",
-  "built_at": "2026-10-08T04:04:16.101788+00:00",
-  "files": 10,
-  "sha256": "eff72936d38989c8a48042e9c3dec529e7bb4b01b3f87c914741469ecfa0a1a8",
-  "entries": [
-    "README.md",
-    "SKILL.md",
-    "package.json",
-    "references/patterns.md",
-    "scripts/audit_css.py",
-    "scripts/audit_docs.py",
-    "scripts/audit_skill.py",
-    "scripts/audit_styles.py",
-    "scripts/negative_tests.py",
-    "scripts/package_skill.py"
-  ]
-}