@topmindspace/tms-skills 0.2.0 → 0.3.0

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

@@ -0,0 +1,46 @@
+# topmind-x-article · One-Click X Long-Form Publishing
+
+**[中文](./README.md)** | English
+
+Turn a Markdown draft into a "copy → paste → publish" X long-form (Article) package.
+
+## Install
+
+```bash
+npx @topmindspace/tms-skills install topmind-x-article
+```
+
+## Usage
+
+```bash
+# 1. Draft → paste-ready plain text (the heart of one-click copying)
+python3 scripts/md2x.py <draft>.md --out <package>/X发布稿.txt
+
+# 2. Cover: generate a 1200×675 cover with topmind-cover
+
+# 3. Follow references/publish-checklist.md item by item
+```
+
+## Conversion rules
+
+The X Article editor has weak, unstable markdown support, so `md2x.py` converts to plain text per `references/x-format.md`: headings → plain text lines, horizontal rules (`---` / `***` / `___`) → blank lines, bold/italic markers removed (including `***bold-italic***`), links → `text（url）`, images → `[图N]` (image list appended at the end), tables → "item: value" lists.
+
+Read the result through once by hand after converting.
+
+## Publishing
+
+X long-form posts are currently published by hand-pasting into the X Article editor; the API does not publish long-form. After publishing, do per the checklist: pin a first comment with the extra info, fetch the full text back for verification.
+
+## External dependencies
+
+The following skills are **not in this repo** (usually provided by the user's local workbuddy environment). Missing ones disable the corresponding routed capability; the core flow (draft → text, cover, publish checklist) is unaffected:
+
+- `topmind-x`: 280-char short posts (its xurl only covers short posts, not long-form).
+- `topmind-capture`: the "archive only, don't publish" routing path.
+
+## Development
+
+```bash
+python3 scripts/package_skill.py --check   # pre-publish check
+python3 scripts/negative_tests.py          # bad-input tests
+```

package/topmind-x-article/README.md

@@ -1,5 +1,7 @@
 # topmind-x-article · X 长文一键发布
 
+[English](./README.en.md) | 中文
+
 把 Markdown 原稿变成"复制 → 粘贴 → 发"的 X 长文（Article）发布包。
 
 ## 安装
@@ -22,8 +24,9 @@ python3 scripts/md2x.py <原稿>.md --out <包>/X发布稿.txt
 ## 转换规则
 
 X Article 编辑器对 markdown 支持弱且不稳定，`md2x.py` 按 `references/x-format.md`
-转纯文本：标题→纯文本行、加粗/斜体去标记、链接→`文字（url）`、
-图片→`[图N]`（文末附配图清单）、表格→"项：值"列表。
+转纯文本：标题→纯文本行、分隔线（`---` / `***` / `___`）→空行、加粗/斜体去标记
+（含 `***粗斜体***`）、链接→`文字（url）`、图片→`[图N]`（文末附配图清单）、
+表格→"项：值"列表。
 
 转完必须人工通读一遍。
 
@@ -32,6 +35,14 @@ X Article 编辑器对 markdown 支持弱且不稳定，`md2x.py` 按 `reference
 X 长文目前走人工粘贴发布（X Article 编辑器），API 不发长文。
 发布后按清单做：首条评论置顶补信息、全文抓回核对。
 
+## 外部依赖
+
+以下技能**不在本仓库**（一般随用户侧 workbuddy 环境提供）。缺失时对应路由能力
+不可用，不影响本技能核心流程（原稿转文本、封面、发布清单）：
+
+- `topmind-x`：280 字短推文发布（其 xurl 只覆盖短推文，不发长文）。
+- `topmind-capture`：「只想存档不发布」时的收录路由。
+
 ## 开发
 
 ```bash

package/topmind-x-article/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: topmind-x-article
-version: 1.0.0
-description: "X 长文（Article）一键发布：Markdown 原稿 → 可直接粘贴的 X发布稿.txt + 封面图 + 发布清单。沉淀自实战。Use when X 长文、发 X 文章、X article、长文发 X。Do NOT use for 短推文（走推文流程）、公众号。"
+version: 0.1.0
+description: "X 长文（Article）一键发布：Markdown 原稿 → 可直接粘贴的 X发布稿.txt + 封面图 + 发布清单。沉淀自实战。Use when X 长文、发 X 文章、X article、长文发 X。Do NOT use for 短推文（→ topmind-x）、公众号。"
 action_category: write
 triggers:
   - X 长文
@@ -11,8 +11,9 @@ triggers:
 triggers_cn:
   - 写 X 长文
   - X 长文发布
-author: Muse
+author: TopMindspace
 license: MIT
+homepage: https://github.com/topmindspace/tms-skills#readme
 updated: 2026-09-29
 ---
 
@@ -58,5 +59,13 @@ updated: 2026-09-29
 ## When NOT to use
 
 - 280 字短推文 → `topmind-x`
-- 公众号 → `topmind-wechat`
+- 公众号 → `topmind-wechat-post`
 - 只想存档不发布 → `topmind-capture`
+
+## 外部依赖
+
+以下技能**不在本仓库**（一般随用户侧 workbuddy 环境提供）；缺失时对应路由能力不可用，
+本技能核心流程（原稿转文本、封面、发布清单）不受影响：
+
+- `topmind-x`：280 字短推文发布（其 xurl 只覆盖短推文，不发长文）。
+- `topmind-capture`：「只想存档不发布」时的收录路由。

package/topmind-x-article/scripts/audit_docs.py

@@ -48,6 +48,28 @@ def main() -> None:
                     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)

package/topmind-x-article/scripts/md2x.py

@@ -28,8 +28,9 @@ def convert(md: str):
     for raw in md.splitlines():
         line = raw.rstrip()
 
-        # frontmatter 直接跳过
-        if line.strip() == "---":
+        # 分割线 → 空行（frontmatter 已在 main() 去除，这里只剩正文分隔线）
+        if re.match(r"^(\*{3,}|-{3,}|_{3,})\s*$", line):
+            out_lines.append("")
             continue
 
         # 代码块：去围栏，内容缩进保留
@@ -69,7 +70,8 @@ def convert(md: str):
             out_lines.append(f"{label}：{rest}" if rest else label)
             continue
 
-        # 行内标记剥离
+        # 行内标记剥离（先 *** 再 ** 再 *，防残留）
+        line = re.sub(r"\*\*\*(.+?)\*\*\*", r"\1", line)  # 粗斜体
         line = re.sub(r"\*\*(.+?)\*\*", r"\1", line)      # 加粗
         line = re.sub(r"__(.+?)__", r"\1", line)
         line = re.sub(r"\*(.+?)\*", r"\1", line)          # 斜体