@topmindspace/topmind-writing-skills 0.7.1

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@topmindspace/topmind-writing-skills",
+  "version": "0.7.1",
+  "description": "TopMindSpace 写作技能合集 — 通过 npm / npx 安装技能（公众号长文、X 长文/短文、封面图）。",
+  "license": "MIT",
+  "author": "TopMindspace",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/topmindspace/topmind-writing-skills.git"
+  },
+  "homepage": "https://github.com/topmindspace/topmind-writing-skills#readme",
+  "bugs": {
+    "url": "https://github.com/topmindspace/topmind-writing-skills/issues"
+  },
+  "keywords": [
+    "agent-skills",
+    "ai-skills",
+    "writing",
+    "wechat",
+    "x-twitter",
+    "briefs",
+    "cover"
+  ],
+  "type": "commonjs",
+  "bin": {
+    "topmind-writing-skills": "bin/topmind-writing-skills.js"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "README.en.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "topmind-briefs",
+    "topmind-cover",
+    "topmind-wechat-post",
+    "topmind-x-article"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "list": "node bin/topmind-writing-skills.js list",
+    "discover": "node scripts/discover_skills.js",
+    "sync:files": "node scripts/sync_npm_files.js",
+    "prepack": "node scripts/sync_npm_files.js",
+    "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); }\"",
+    "check": "node scripts/run_skill_gates.js check",
+    "privacy": "python3 scripts/ci_privacy_scan.py",
+    "audit": "node scripts/run_skill_gates.js audit",
+    "package:skill": "node scripts/run_skill_gates.js package"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/topmind-briefs/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## 0.2.0 (2026-10-01)
+
+- `--images-from 公众号短文.md` 派生图片顺序，禁止手工拼 `--images`（根治配图错位）
+- 构建后校验加：X 版内嵌图序列（无封面）与公众号版逐字节一致
+- 新增交付铁律（用原文件原样呈现）；语言铁律同步（默认中文）
+
+
+## 0.1.0 (2026-10-01)
+
+- 初始版本：干货短文（公众号 + X 双平台）
+- 工作流：定主题 → 找素材 → 写双版 → 自检 → 交付
+- 四种内容类型：数据榜单型 / 论文解读型 / 新品速递型 / 对比实测型
+- references：style-guide（开头扔结论/列表>段落/禁止清单）、
+  platform-specs（X ≤280字符 / 公众号 300–800字对照）、examples（4 类示例 + 反例）
+- 风格参考：@ArtificialAnlys、@arena、@akshay_pachaar、@RulinShao 等
+- 运营铁律：只起草不代发、数字必有来源、厂商数字标口径、不洗稿
+- 修订（2026-10-01）：字数口径统一为"X 一帖/短 thread，公众号约 300–800 字"；
+  交付明确为双版一键复制 HTML（X 走 md2x-html，公众号走 md2wechat --embed-images）；
+  构建后必跑嵌入图数量/顺序校验；配图位置铁律（图片紧跟相关段落）；
+  推测/判断必须显式标注"（推测）"与事实切割

package/topmind-briefs/README.en.md

@@ -0,0 +1,41 @@
+# topmind-briefs · Short-form briefs (WeChat + X)
+
+**[中文](./README.md)** | English
+
+One topic, one chart, then stop. Data-driven short posts: rankings, paper TL;DRs,
+product launches — one X post or short thread, ~300–800 words on WeChat,
+one-click-copy HTML for both.
+
+- Version: **v0.2.1** (same tag as `@topmindspace/topmind-writing-skills@0.7.1`)
+
+## Install
+
+```bash
+npx @topmindspace/topmind-writing-skills install topmind-briefs
+```
+
+## Usage
+
+```bash
+# X version (image order derived from the WeChat draft; never hand-order --images)
+md2x-html.py brief-x.md --out brief-x.html --images-from brief-wechat.md
+
+# WeChat version (images inlined as base64)
+md2wechat.py brief-wechat.md --out brief-wechat.html --embed-images
+```
+
+The scripts live in the script directories of the `topmind-x-article` and
+`topmind-wechat-post` skills (siblings of this skill). See [SKILL.md](./SKILL.md)
+for the full workflow.
+
+## Content types
+
+- Data rankings / ranking alerts / paper explainers / mechanism explainers
+  (four types calibrated against real posts, see SKILL.md)
+- Operating rules: draft only, never auto-post; every number needs a source;
+  vendor numbers labeled as vendor claims; no rewriting others' work
+
+## When NOT to use
+
+X long-form → `topmind-x-article`; WeChat long-form → `topmind-wechat-post`;
+personal short posts → `topmind-x-posts` (planned, not released).

package/topmind-briefs/README.md

@@ -0,0 +1,37 @@
+# topmind-briefs · 干货短文（公众号 + X 双平台）
+
+[English](./README.en.md) | 中文
+
+一件事，一张图，讲完就停。干货向短文：数据榜单、论文一句话解读、新品速递——
+X 一帖或短 thread，公众号约 300–800 字，双版一键复制 HTML。
+
+- 版本：**v0.2.1**（与 `@topmindspace/topmind-writing-skills@0.7.1` 同 tag）
+
+## 安装
+
+```bash
+npx @topmindspace/topmind-writing-skills install topmind-briefs
+```
+
+## 用法
+
+```bash
+# X 版（图片顺序从公众号稿派生，禁止手工拼 --images）
+md2x-html.py X短文.md --out X短文.html --images-from 公众号短文.md
+
+# 公众号版（图片 base64 内嵌）
+md2wechat.py 公众号短文.md --out 公众号版.html --embed-images
+```
+
+脚本分别在 `topmind-x-article` 与 `topmind-wechat-post` 两个技能的脚本目录下
+（与本技能同级目录）。工作流细节见 [SKILL.md](./SKILL.md)。
+
+## 内容类型
+
+- 数据榜单型 / 榜单速报型 / 论文解读型 / 机制讲解型（见 SKILL.md，四种按真实帖子校准）
+- 运营铁律：只起草不代发、数字必有来源、厂商数字标口径、不洗稿
+
+## 何时不用
+
+X 长文 → `topmind-x-article`；公众号长文 → `topmind-wechat-post`；
+个人向短帖 → `topmind-x-posts`（规划中，未发布）。

package/topmind-briefs/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: topmind-briefs
+version: 0.2.1
+description: >-
+  干货短文发布：公众号 + X 双平台，一件事讲透。X 一帖或短 thread，
+  公众号约 300–800 字；1 张核心图（榜单/基准/截图/表格），不废话。
+  Use when 写短文、发快讯、数据榜单、
+  论文一句话解读、新品速递、brief、快讯。Do NOT use for X 长文
+  （→ topmind-x-article）、公众号长文（→ topmind-wechat-post）、
+  个人向短帖（→ topmind-x-posts，规划中未发布）。
+action_category: write
+triggers:
+  - 写短文
+  - 发快讯
+  - 干货短文
+  - 一句话解读
+  - 数据榜单
+  - 新品速递
+  - brief
+  - 快讯
+triggers_cn:
+  - 来篇短的
+  - 短平快
+  - 发个快讯
+author: TopMindSpace
+license: MIT
+homepage: https://github.com/topmindspace/topmind-writing-skills#readme
+updated: 2026-10-01
+---
+
+# topmind-briefs · 干货短文（公众号 + X）
+
+一件事，一张图，讲完就停。跟 `topmind-x-posts`（规划中，未发布）的区别：
+那是个人向短帖（第一人称、暴论、真诚）；这是**干货向短文**（数据、榜单、
+论文、新品，第三方客观口吻）。
+
+## 何时不用
+
+- X 长文（数千字深度稿）→ `topmind-x-article`
+- 公众号长文 → `topmind-wechat-post`
+- 个人向短帖（第一人称、观点、段子）→ `topmind-x-posts`（规划中，未发布）
+- 需要多张配图、复杂排版的稿件（本技能只配 1 张核心图）
+
+## 语言铁律
+
+- **默认中文**：标题、正文、配图文案一律用中文写作，这是默认行为，不需要用户每次声明。
+- **英文是例外**：只有用户**明确说**"写英文文章/帖子"时才用英文。用户消息里夹杂英文词、
+  给英文参考素材、引用英文原文，都不算"要求写英文"。
+- 引用英文一手素材（论文标题、官方公告、图表原文）时保留英文原文，正文主体仍是中文，
+  必要时在旁给中文翻译。
+
+## 工作流
+
+1. **定主题**：用户给方向，或从热点里挑。一篇只讲一件事——
+   一个数据、一个榜单变化、一篇论文的核心结论、一个新品的关键参数。
+   定不下来就问：这篇让读者记住哪一个数字/结论？
+2. **找素材**：事实先核实（一手来源）。图优先找现成的：
+   官方截图 > 官方基准图 > 第三方榜单实拍 > 论文原图。
+   没有现成图才自制（只做对比表、趋势图这种信息图，不做装饰图）。
+3. **写**：按 `references/style-guide.md` 写。X 版和公众号版各写一版，
+   内容一致，篇幅按平台调整（见 `references/platform-specs.md`）。
+4. **自检**：过一遍禁止清单；确认每个数字都有来源；确认图和文字说的是同一件事；
+   推测/判断必须显式标注"（推测）"，与事实段落切割，不混写。
+5. **交付**：双版 HTML，一键复制（只交付，不发布）——
+   - X 版：`md2x-html.py X短文.md --out X短文.html --images-from 公众号短文.md`
+     （无封面；1–4 张图按 [图N] 顺序嵌入；thread 超长时拆条）。
+     **禁止手工拼 `--images`**：文件名排序 ≠ 文档顺序，手工传参曾导致整段配图错位；
+     脚本内置 `[图N]` 连续性 + 数量校验，不通过直接报错。
+   - 公众号版：`md2wechat.py --input 公众号短文.md --embed-images`
+     （图片 base64 内嵌，图注写在图下方）。
+   - 构建后必跑校验：嵌入图数量 = 文档图数量；嵌入图顺序 = 文档出现顺序
+     （逐张解码与源文件比对）；[图N] 编号连续；
+     X 版内嵌图序列（无封面）与公众号版逐字节一致。
+
+## 内容类型（四种，按真实帖子校准）
+
+| 类型 | 参考 | 结构 |
+|------|------|------|
+| 数据榜单型 | @ArtificialAnlys | 判断句开头 → 基准一句话 → 最扎眼数字 → 双图（解决率+成本） |
+| 榜单速报型 | @arena | "Big news:"+排名+分数 → 性价比 → 细分展开 → 纵向对比 → 榜单实拍 |
+| 论文解读型 | @RulinShao | 加粗判断 → "Introducing X"+3 bullets → 论文原图 |
+| 机制讲解型 | @akshay_pachaar | 痛点一句话 → 分步机制 → "To summarise:"三行 → 流程图/视频 |
+
+## 配图铁律
+
+- 一篇配 1 张核心图，最多 4 张。每张图必须承载信息，装饰图一律不要。
+- 图注一句话说明这张图在证明什么。
+- **位置**：图片必须紧跟它证明的那段文字之后（最多隔一段）；章节题图放在节首。
+  禁止"图堆在节末"、"图与文字错位到下一节"。
+- X：图片按顺序编号，文字里用 [图1] 标注对应关系。
+- 公众号：图片内嵌，图注写在图下方。
+- 校验脚本思路：对每张图，取其前后各 6 行文本，检查是否出现该图主题关键词
+  （如 Grok 图邻近必须有"Grok"）；不通过则人工核对。
+
+## 运营铁律
+
+- 只起草，不代发。发布前用户确认。
+- **交付铁律**：发布/分享时直接用交付的 HTML 原文件原样呈现，不临时重新生成版本。
+- 数字必须有来源；厂商数字标"厂商口径"。
+- 不洗稿：观点可以撞，表达必须原创。
+- 不碰医疗建议、投资建议、政治站队。

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

@@ -0,0 +1,21 @@
+{
+  "name": "topmind-briefs",
+  "version": "0.2.1",
+  "built_at": "2026-10-01T13:38:13.526837+00:00",
+  "files": 12,
+  "sha256": "be43875539f1f02a337187f9e644a684d9999e876eccf030af76265eb194f7c0",
+  "entries": [
+    "README.md",
+    "SKILL.md",
+    "package.json",
+    "references/examples.md",
+    "references/platform-specs.md",
+    "references/style-guide.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"
+  ]
+}

package/topmind-briefs/package-lock.json

@@ -0,0 +1,13 @@
+{
+  "name": "topmind-briefs",
+  "version": "0.2.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "topmind-briefs",
+      "version": "0.2.0",
+      "license": "MIT"
+    }
+  }
+}

package/topmind-briefs/package.json

@@ -0,0 +1 @@
+{"author":"TopMindSpace","description":"干货短文发布：公众号 + X 双平台，一件事讲透。300–800 字，1 张核心图，不废话。","license":"MIT","name":"topmind-briefs","private":true,"repository":{"directory":"topmind-briefs","type":"git","url":"git+https://github.com/topmindspace/topmind-writing-skills.git"},"version":"0.2.1"}

package/topmind-briefs/references/examples.md

@@ -0,0 +1,131 @@
+# 示例 · 干货短文（按真实帖子校准）
+
+> 说明：以下引用的是真实帖子的原文结构（含原文的 `- ` 列表写法，原样保留）。
+> 自己写 X 版时，列表符号按 `style-guide.md` 用纯文本 `• ` / `▪ ` / emoji
+>（X 不渲染 Markdown）。
+
+## 例 1：数据榜单型（@ArtificialAnlys 原文结构）
+
+原文模式：先抛一个反直觉判断 → 甩基准 → 给最扎眼的数字 → 图证明。
+
+```
+Restricting offensive without blocking defensive is difficult...
+
+On CyberGym-E2E-AA, some frontier models are safety blocked on 85%+ of tasks.
+
+The good news: with GPT-6 Luna or MiMo-V2.6-Pro, ~100 bug hunts in a 1M+ line
+codebase for ~$20 — up to 100x cheaper per task than Grok 4.7.
+
+[图：上下两张柱状图——任务解决率 vs 单任务成本]
+```
+
+结构拆解：
+1. 判断句开头（一句话观点）
+2. 基准是什么（一句话）
+3. 最扎眼的数字（85%+、~$20、100x）
+4. 图：解决率和成本两张图并置
+
+## 例 2：榜单速报型（@arena 原文结构）
+
+```
+Big news: Gemini 4 Argon (High) just landed #1 in Text Arena with 1525 pts,
+and #8 in Code Arena: WebDev with 1679 pts!
+
+Blended $8/MToken — the most cost efficient model on the Pareto frontier.
+
+#1 in Coding, Hard Prompts, Instruction Following, Longer Query, Creative Writing.
++20 pts above #2 Claude Opus 4.6 (High); leap from #11 (Gemini 3.8 Flash).
+
+[图：Text Arena + Code Arena 排行榜截图各一张]
+```
+
+结构拆解：
+1. "Big news:" + 排名 + 分数（开头即全部关键信息）
+2. 价格/性价比（一句话）
+3. 细分维度展开（列表）
+4. 纵向对比（比上次、比第二名）
+5. 图：排行榜实拍
+
+## 例 3：论文解读型（@RulinShao 原文结构）
+
+```
+‼️The Bitter Lesson for context management: Giving LMs unrestricted control
+over their context beats human-designed SOTA!
+
+Introducing 🩵Context Language Models (CLMs)🩵
+- Natively manage their own context
+- Treat context as a file
+- Learn policies in CLM weights, no harness
+
+[图：论文信息图——架构示意 + 四组结果曲线]
+```
+
+结构拆解：
+1. 加粗判断（"Bitter Lesson"式标题党，但后面有真东西）
+2. "Introducing X" + 3 条 bullet（每条 ≤10 词）
+3. 图：论文原图（架构 + 结果）
+
+## 例 4：机制讲解型（@akshay_pachaar 原文结构）
+
+```
+Jev for RAG, clearly explained!
+
+Hybrid search gives you a shortlist. It does not decide which passages
+contain evidence. That missing judgment is where Jev fits.
+
+→ Retrieve wide
+[一句话机制]
+
+→ Judge every candidate together
+[一句话机制]
+
+→ Let code apply the threshold
+[一句话机制]
+
+To summarise:
+- Retrieval finds the candidates.
+- Jev decides what deserves context.
+- The LLM writes the grounded answer.
+
+[视频：RAG 流程架构动画]
+```
+
+结构拆解：
+1. 标题句（"X, clearly explained!"）
+2. 痛点（一句话：现有方案缺什么）
+3. 机制分步（→ 标记，每步一句话）
+4. "To summarise:" 三行收束
+5. 媒体：流程图/动画 + 文章链接
+
+---
+
+## 公众号版改写示例（例 1 → 公众号）
+
+```markdown
+# 跑 100 次漏洞挖掘只要 $20：CyberGym-E2E-AA 基准实测
+
+> 想防住攻击又不误伤防御，太难了——前沿模型在 85%+ 的任务上被安全拦截直接拒绝回答。
+
+- 基准：CyberGym-E2E-AA，测从漏洞发现到补丁的全链路防御能力
+- 拦截率：部分前沿模型 85%+ 任务被安全机制拦掉
+- 成本：GPT-6 Luna / MiMo-V2.6-Pro 跑 ~100 次 bug hunt 约 $20，
+  单任务成本比 Grok 4.7 便宜 up to 100 倍
+
+![CyberGym-E2E-AA：任务解决率 vs 单任务成本](图)
+
+来源：Artificial Analysis
+```
+
+改写要点：X 版英文直发；公众号版加一句中文背景（"这是什么基准"），
+数字保留英文原样，结论不变。
+
+---
+
+## 反例（不要这样写）
+
+❌ "众所周知，AI 发展日新月异。最近，Google 发布了一款新模型，
+   引起了广泛关注。值得一提的是，这款模型在多个基准上表现出色…"
+   → 铺垫三段，结论藏在最后，没有具体数字。
+
+❌ "大幅提升""显著改善""表现优异"
+   → 没有数据的形容词，删掉或换成数字。

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

@@ -0,0 +1,63 @@
+# 平台规格 · 公众号 vs X
+
+同一件事，写两版。内容一致，篇幅和格式按平台调整。
+
+## X 版
+
+- 长度：280 字符内（一条）。超了就拆 thread，最多 3 条，每条都按单帖规格写（首条最重要，时间线上只显示首条和首图）。
+- 语言：默认中文。英文是例外：只有受众明确是英文区、或素材本身就是英文速报时才用英文（参考 @ArtificialAnlys 风格）；中文参考 @arena 风格。
+- 图片：1–4 张，首图最重要（时间线上只显示首图）。
+- 格式：纯文本 + 图片。不用 Markdown 标题（X 不渲染）。
+- **列表符号**：X 不渲染 Markdown，列表不用 `- ` / `1.` 这种 Markdown 语法，
+  用纯文本符号开头：`• ` 或 `▪ `，中文帖也可用 emoji（📌 📊 💡）开头。
+  Markdown 列表语法只用在公众号版。
+- 结尾：来源链接（缩短）。不加 hashtag，除非是榜单/活动官方 tag。
+- 交付：`md2x-html.py` 生成一键复制 HTML（`--images` 按 [图N] 文档顺序传图，
+  无封面），另附纯文本版方便直接粘贴。
+- 示例结构（注意列表符号是纯文本的 `•`，不是 Markdown）：
+  ```
+  [结论一句话]
+
+  • 数据 1
+  • 数据 2
+
+  [图1：榜单截图]
+
+  来源：链接
+  ```
+
+## 公众号版
+
+- 长度：300–800 字。比 X 版多 1–2 句背景（"这是什么榜单""为什么重要"）。
+- 标题：15 字内，带数字或结论。"[模型] 登顶 [榜单]：[分数]"。
+- 图片：1–4 张，base64 内嵌（`md2wechat --embed-images`）。
+- 格式：走 `topmind-wechat-post` 链路。标题 + 导语（一句话） + 列表 + 图 + 来源。
+- 不写"前言导读""小结"这种长文结构——短文不需要。
+- 交付：md2wechat 直接出 HTML（含一键复制按钮），原文件即发布用文件，不二次生成。
+- 示例结构：
+  ```markdown
+  # [标题]
+
+  > [一句话导语]
+
+  [结论段，2–3 句]
+
+  - 数据 1
+  - 数据 2
+  - 数据 3
+
+  ![图注](图)
+
+  来源：[链接]
+  ```
+
+## 对照表
+
+| | X 版 | 公众号版 |
+|---|---|---|
+| 长度 | ≤280 字符 | 300–800 字 |
+| 标题 | 无（首句即标题） | 15 字内 |
+| 背景 | 不写 | 1–2 句 |
+| 图片 | 1–4 张 | 1–4 张（内嵌） |
+| 来源 | 链接 | 链接 |
+| 语气 | 更短更冲 | 稍完整 |

package/topmind-briefs/references/style-guide.md

@@ -0,0 +1,60 @@
+# 风格指南 · 干货短文
+
+目标：读者划过去，3 秒内抓住那个数字/结论，心想"这篇有料"。
+
+## 三原则
+
+**短**：一件事讲完就停。X 版 280 字符内；公众号版 500 字内。
+**干**：每个字都承载信息。删掉所有"众所周知""值得一提的是"。
+**准**：数字有来源，判断有依据。不确定的写"据 X 报道"，不编。
+
+## 开头：四种起手（按真实帖子）
+
+- 数据型（@ArtificialAnlys）："[反直觉判断一句话]。On [基准], [最扎眼数字]。"
+- 速报型（@arena）："Big news: [模型] just landed #1 in [榜单] with [分数]!"
+- 论文型（@RulinShao）："‼️[加粗判断]: [一句话]! Introducing [X]"
+- 讲解型（@akshay_pachaar）："[X], clearly explained! [痛点一句话]"
+
+## 正文：列表 > 段落
+
+能用列表就不用段落。X 版用纯文本符号（`• ` / `▪ ` / emoji），
+不要用 Markdown 的 `- `（X 不渲染，见 platform-specs.md）。公众号版用 Markdown 列表。
+
+X 版参考格式：
+
+```
+[结论一句话]
+
+• 关键数据 1
+• 关键数据 2
+• 关键数据 3
+
+[图]
+
+来源：[链接]
+```
+
+## 禁止清单
+
+- 禁止"首先、其次、最后""总而言之""值得一提的是""值得注意的是"
+- 禁止"赋能""抓手""闭环""底层逻辑"
+- 禁止铺垫三段再说结论
+- 禁止没有数据的形容词："大幅提升""显著改善"（改成具体数字）
+- 禁止感叹号连用
+- 禁止"家人们""老铁"式直播腔
+- 禁止正确的废话
+
+## 鼓励
+
+- 数字代替形容词："快 3 倍"不说"大幅提升"
+- 对比代替孤立数字："58 分，比 Opus 5.5 高 2 分"不说"58 分，很高"
+- 一句话判断收尾（可选）："这意味着 [对读者的意义]。"——只写一句，不展开
+- 来源链接放在最后，不打断阅读
+- 允许短句和碎片化断句，像人说话一样写，不追求完整长句（去AI味）
+- 标题可以冲，但正文必须有真东西支撑，不做空转标题党
+
+## 自检三问
+
+1. 删掉一半字，核心结论还在吗？（在→删）
+2. 每个数字都能说出来源吗？（不能→删或补来源）
+3. 不看图，文字本身成立吗？不看文字，图本身有信息吗？（都成立→图和文各司其职）

package/topmind-briefs/scripts/audit_css.py

@@ -0,0 +1,39 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""CSS 审计：本组技能无 CSS 资产；若未来加入 .css 文件，则做括号配平基础检查。"""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+NAME = ROOT.name
+errors: list[str] = []
+
+
+def main() -> None:
+    print(f"[audit_css] {NAME}")
+    css_files = [p for p in ROOT.rglob("*.css") if ".git" not in p.parts and "dist" not in p.parts]
+    if not css_files:
+        print("  ✓ 无 CSS 资产，跳过")
+        print(f"\n[audit_css] {NAME}: 通过")
+        return
+    for css in css_files:
+        text = css.read_text(encoding="utf-8")
+        balanced = text.count("{") == text.count("}")
+        print(("  ✓ " if balanced else "  ✗ ") + f"{css.name} 括号配平")
+        if not balanced:
+            errors.append(css.name)
+    if errors:
+        print(f"\n[audit_css] {NAME}: {len(errors)} 项失败")
+        sys.exit(1)
+    print(f"\n[audit_css] {NAME}: 全部通过")
+
+
+if __name__ == "__main__":
+    main()

package/topmind-briefs/scripts/audit_docs.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""文档审计：references 完整性与内部链接可达性（任一不过 → 退出码 1）。"""
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+NAME = ROOT.name
+errors: list[str] = []
+
+
+def check(cond: bool, msg: str) -> None:
+    print(("  ✓ " if cond else "  ✗ ") + msg)
+    if not cond:
+        errors.append(msg)
+
+
+def main() -> None:
+    print(f"[audit_docs] {NAME}")
+    md_files = [p for p in ROOT.rglob("*.md") if ".git" not in p.parts and "dist" not in p.parts]
+    check(len(md_files) >= 2, f"md 文档 ≥2（实 {len(md_files)}，含 SKILL.md/README.md）")
+
+    refdir = ROOT / "references"
+    if refdir.is_dir():
+        refs = sorted(refdir.glob("*.md"))
+        check(len(refs) >= 1, f"references/*.md ≥1（实 {len(refs)}）")
+        for md in refs:
+            check(md.stat().st_size > 0, f"references/{md.name} 非空")
+
+    for md in md_files:
+        text = md.read_text(encoding="utf-8")
+        rel = md.relative_to(ROOT).as_posix()
+        for link in set(re.findall(r"\]\(([^)]+)\)", text)):
+            if link.startswith(("http://", "https://", "#", "mailto:")):
+                continue
+            target = (md.parent / link.split("#")[0]).resolve()
+            if link and not target.exists():
+                # 允许指向脚本/资源等非 md 文件的相对链接缺失检查放宽到 md
+                if target.suffix == ".md":
+                    check(False, f"{rel} 悬空链接: {link}")
+    check(True, "内部 md 链接可达")
+
+    # 反引号代码引用中的路径可达（审计 轻微-15 门禁盲区：之前只查 [text](path) 形式，
+    # `references/pan-style.md` 这类反引号引用曾漏网）。抓取反引号内的 references/*.md
+    # 与 scripts/* 路径并校验存在；glob/占位符写法（* ? < > |）跳过。
+    backtick_path_re = re.compile(r"(references|scripts)/([\w.\-/]+)")
+    line_suffix_re = re.compile(r":\d+(?:-\d+)?$")
+    backtick_bad = 0
+    for md in md_files:
+        text = md.read_text(encoding="utf-8")
+        rel = md.relative_to(ROOT).as_posix()
+        for span in set(re.findall(r"`([^`]+)`", text)):
+            for kind, p in backtick_path_re.findall(span):
+                p = line_suffix_re.sub("", p)
+                if not p or any(c in p for c in "*?<>|"):
+                    continue
+                target = md.parent / kind / p
+                if not target.exists():
+                    target = ROOT / kind / p
+                if not target.exists():
+                    backtick_bad += 1
+                    check(False, f"{rel} 反引号引用不可达: `{kind}/{p}`")
+    check(backtick_bad == 0, f"反引号内 references/scripts 引用可达（扫描 {len(md_files)} 个 md 文件）")
+
+    if errors:
+        print(f"\n[audit_docs] {NAME}: {len(errors)} 项失败")
+        sys.exit(1)
+    print(f"\n[audit_docs] {NAME}: 全部通过")
+
+
+if __name__ == "__main__":
+    main()