@topmindspace/tms-skills 0.5.0 → 0.7.0

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

@@ -0,0 +1,55 @@
+# 风格指南 · 干货短文
+
+目标：读者划过去，3 秒内抓住那个数字/结论，心想"这篇有料"。
+
+## 三原则
+
+**短**：一件事讲完就停。X 版 280 字符内；公众号版 500 字内。
+**干**：每个字都承载信息。删掉所有"众所周知""值得一提的是"。
+**准**：数字有来源，判断有依据。不确定的写"据 X 报道"，不编。
+
+## 开头：四种起手（按真实帖子）
+
+- 数据型（@ArtificialAnlys）："[反直觉判断一句话]。On [基准], [最扎眼数字]。"
+- 速报型（@arena）："Big news: [模型] just landed #1 in [榜单] with [分数]!"
+- 论文型（@RulinShao）："‼️[加粗判断]: [一句话]! Introducing [X]"
+- 讲解型（@akshay_pachaar）："[X], clearly explained! [痛点一句话]"
+
+## 正文：列表 > 段落
+
+能用列表就不用段落。参考格式：
+
+```
+[结论一句话]
+
+- 关键数据 1
+- 关键数据 2
+- 关键数据 3
+
+[图]
+
+来源：[链接]
+```
+
+## 禁止清单
+
+- 禁止"首先、其次、最后""总而言之""值得一提的是""值得注意的是"
+- 禁止"赋能""抓手""闭环""底层逻辑"
+- 禁止铺垫三段再说结论
+- 禁止没有数据的形容词："大幅提升""显著改善"（改成具体数字）
+- 禁止感叹号连用
+- 禁止"家人们""老铁"式直播腔
+- 禁止正确的废话
+
+## 鼓励
+
+- 数字代替形容词："快 3 倍"不说"大幅提升"
+- 对比代替孤立数字："58 分，比 Opus 5.5 高 2 分"不说"58 分，很高"
+- 一句话判断收尾（可选）："这意味着 [对读者的意义]。"——只写一句，不展开
+- 来源链接放在最后，不打断阅读
+
+## 自检三问
+
+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()

package/topmind-briefs/scripts/audit_skill.py

@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""技能入口审计：SKILL.md 结构完整性（任一不过 → 退出码 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_skill] {NAME}")
+    text = (ROOT / "SKILL.md").read_text(encoding="utf-8")
+
+    m = re.search(r"^triggers:\s*\n((?:  - .+\n?)+)", text, re.M)
+    triggers = re.findall(r"^  - (.+)$", m.group(1), re.M) if m else []
+    check(len(triggers) >= 1, f"triggers ≥1（实 {len(triggers)}）")
+
+    check("When NOT to use" in text or "何时不用" in text, "含 When NOT to use / 何时不用")
+
+    has_workflow = bool(re.search(r"工作流|Workflow|用法|Usage", text))
+    check(has_workflow, "含工作流/用法说明")
+
+    fm = re.match(r"^---\r?\n([\s\S]*?)\r?\n---", text)
+    desc = ""
+    if fm:
+        dm = re.search(r'^description:\s*"([^"]*)"\s*$', fm.group(1), re.M)
+        if dm:
+            desc = dm.group(1).strip()
+        else:
+            dm = re.search(r"^description:\s*>\-\s*\n((?:[ \t]+.*\n?)+)", fm.group(1), re.M)
+            if dm:
+                desc = " ".join(l.strip() for l in dm.group(1).splitlines())
+    check("Use when" in desc or "用" in desc, "description 含使用场景")
+    check("Do NOT use" in desc or "不用" in desc, "description 含不适用场景")
+    check(len(desc) <= 1024, f"description ≤1024（实 {len(desc)}）")
+
+    if errors:
+        print(f"\n[audit_skill] {NAME}: {len(errors)} 项失败")
+        sys.exit(1)
+    print(f"\n[audit_skill] {NAME}: 全部通过")
+
+
+if __name__ == "__main__":
+    main()

package/topmind-briefs/scripts/audit_styles.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""样式资产审计：主题/风格资源有效性（任一不过 → 退出码 1）。
+
+本组技能无 CSS 样式表：若存在 assets/themes/*.json 则校验 JSON 可解析；
+references 风格文档非空（已由 audit_docs 覆盖，此处做存在性断言）。
+"""
+from __future__ import annotations
+
+import json
+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_styles] {NAME}")
+    themes = sorted((ROOT / "assets" / "themes").glob("*.json")) if (ROOT / "assets" / "themes").is_dir() else []
+    if themes:
+        for t in themes:
+            try:
+                json.loads(t.read_text(encoding="utf-8"))
+                check(True, f"assets/themes/{t.name} JSON 可解析")
+            except (OSError, json.JSONDecodeError) as e:
+                check(False, f"assets/themes/{t.name} 解析失败: {e}")
+    else:
+        check(True, "无主题 JSON 资产（本技能不依赖主题文件）")
+
+    refdir = ROOT / "references"
+    has_style_doc = refdir.is_dir() and any(refdir.glob("*.md"))
+    check(has_style_doc, "references 风格/格式文档存在")
+
+    if errors:
+        print(f"\n[audit_styles] {NAME}: {len(errors)} 项失败")
+        sys.exit(1)
+    print(f"\n[audit_styles] {NAME}: 全部通过")
+
+
+if __name__ == "__main__":
+    main()

package/topmind-briefs/scripts/negative_tests.py

@@ -0,0 +1,88 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""topmind-briefs 异常输入测试：技能工具链在坏输入下干净失败、不崩溃（任一失败 → 退出码 1）。
+
+覆盖：
+  1. 工作流引用的跨技能脚本存在（md2x-html.py / md2wechat.py 缺失即失败，不静默）
+  2. audit_skill.py 在 frontmatter 损坏的 SKILL.md 上退出码 1（不抛未捕获异常）
+  3. package_skill.py --check 在缺 README.md 的技能目录上退出码 1（不抛未捕获异常）
+  4. scripts/*.py 全部可编译
+"""
+from __future__ import annotations
+
+import shutil
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+    pass
+
+ROOT = Path(__file__).resolve().parent.parent
+REPO = ROOT.parent
+PY = sys.executable
+fails: list[str] = []
+
+
+def check(name: str, cond: bool, detail: str = "") -> None:
+    print(("  ✓ " if cond else "  ✗ ") + name + (f" — {detail}" if detail and not cond else ""))
+    if not cond:
+        fails.append(name)
+
+
+def run_quiet(args: list[str], cwd: Path) -> subprocess.CompletedProcess:
+    return subprocess.run([PY, *args], capture_output=True, text=True, timeout=60, cwd=str(cwd))
+
+
+def main() -> None:
+    print("[negative_tests] topmind-briefs")
+
+    # 1. 跨技能脚本依赖存在
+    for rel in ("topmind-x-article/scripts/md2x-html.py",
+                "topmind-wechat-post/scripts/md2wechat.py"):
+        p = REPO / rel
+        check(f"跨技能依赖存在: {rel}", p.is_file())
+
+    # 2. frontmatter 损坏 → audit_skill 退出 1 且不崩溃
+    with tempfile.TemporaryDirectory() as td:
+        t = Path(td)
+        shutil.copytree(ROOT, t / "skill", ignore=shutil.ignore_patterns("dist", "__pycache__"))
+        sk = t / "skill" / "SKILL.md"
+        sk.write_text("no frontmatter here\n# broken\n", encoding="utf-8")
+        r = run_quiet(["scripts/audit_skill.py"], t / "skill")
+        check("audit_skill 在坏 frontmatter 上退出码=1",
+              r.returncode == 1, f"rc={r.returncode}")
+        check("audit_skill 在坏 frontmatter 上无未捕获 Traceback",
+              "Traceback" not in (r.stderr or ""), (r.stderr or "")[-200:])
+
+    # 3. 缺 README.md → package_skill --check 退出 1 且不崩溃
+    with tempfile.TemporaryDirectory() as td:
+        t = Path(td)
+        shutil.copytree(ROOT, t / "skill", ignore=shutil.ignore_patterns("dist", "__pycache__"))
+        (t / "skill" / "README.md").unlink()
+        (t / "skill" / "README.en.md").unlink(missing_ok=True)
+        r = run_quiet(["scripts/package_skill.py", "--check"], t / "skill")
+        check("package_skill --check 在缺 README.md 时退出码=1",
+              r.returncode == 1, f"rc={r.returncode}")
+        check("package_skill --check 在缺 README.md 时无未捕获 Traceback",
+              "Traceback" not in (r.stderr or ""), (r.stderr or "")[-200:])
+
+    # 4. scripts/*.py 可编译（用内置 compile 只验语法，不写 .pyc，避免污染工作区）
+    for py in sorted((ROOT / "scripts").glob("*.py")):
+        try:
+            compile(py.read_text(encoding="utf-8"), str(py), "exec")
+            check(f"可编译: scripts/{py.name}", True)
+        except SyntaxError as e:
+            check(f"可编译: scripts/{py.name}", False, str(e))
+
+    if fails:
+        print(f"\n[negative_tests] topmind-briefs: {len(fails)} 项失败")
+        sys.exit(1)
+    print("\n[negative_tests] topmind-briefs: 全部通过")
+
+
+if __name__ == "__main__":
+    main()

package/topmind-briefs/scripts/package_skill.py

@@ -0,0 +1,188 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""技能分发包打包器（发布前完整性校验 + 发布清单）。
+
+用法:
+    python scripts/package_skill.py            # 校验 → 打包 → 写发布清单
+    python scripts/package_skill.py --check    # 只校验不打包（CI / 提交前自检）
+
+产物:
+    dist/<skill>.zip            分发包（解压目录名 = 技能名）
+    dist/<skill>.manifest.json  发布清单（版本 / 条目 / 大小 / SHA-256）
+
+校验（任一不过 → 退出码 1）:
+    · SKILL.md frontmatter 含 name / description；name 与目录名一致；
+      description ≤ 1024 字符（平台截断阈值）
+    · README.md / package.json 存在；package.json name 与技能名一致
+    · scripts/*.py 全部可编译；references/*.md 非空
+    · SKILL.md 引用的 references/<file> 全部存在
+    · 无 scripts/_* / __pycache__ / .env 等不应进包的文件
+"""
+from __future__ import annotations
+
+import hashlib
+import json
+import re
+import sys
+import zipfile
+from datetime import datetime, timezone
+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
+OUT = ROOT / "dist" / f"{NAME}.zip"
+MANIFEST = ROOT / "dist" / f"{NAME}.manifest.json"
+DESC_LIMIT = 1024
+
+INCLUDE = ["SKILL.md", "README.md", "package.json", "assets/", "references/", "scripts/", "evals/", "agents/"]
+EXCLUDE_RES = [
+    re.compile(r"(^|/)scripts/_"),
+    re.compile(r"(^|/)\.env($|\.)"),
+    re.compile(r"(^|/)__pycache__(/|$)"),
+    re.compile(r"(^|/)node_modules(/|$)"),
+    re.compile(r"(^|/)dist(/|$)"),
+]
+
+errors: list[str] = []
+
+
+def fail(msg: str) -> None:
+    errors.append(msg)
+    print(f"  ✗ {msg}")
+
+
+def ok(msg: str) -> None:
+    print(f"  ✓ {msg}")
+
+
+def read_frontmatter() -> dict:
+    text = (ROOT / "SKILL.md").read_text(encoding="utf-8")
+    m = re.match(r"^---\r?\n([\s\S]*?)\r?\n---", text)
+    if not m:
+        fail("SKILL.md 缺 frontmatter")
+        return {}
+    fm = m.group(1)
+    name = re.search(r"^name:\s*(\S+)\s*$", fm, re.M)
+    desc = ""
+    dm = re.search(r'^description:\s*"([^"]*)"\s*$', fm, re.M)
+    if dm:
+        desc = dm.group(1).strip()
+    else:
+        dm = re.search(r"^description:\s*>\-\s*\n((?:[ \t]+.*\n?)+)", fm, re.M)
+        if dm:
+            desc = " ".join(line.strip() for line in dm.group(1).splitlines() if line.strip())
+    return {"name": name.group(1) if name else "", "description": desc}
+
+
+def check() -> bool:
+    print(f"[check] {NAME}")
+    fm = read_frontmatter()
+    if fm.get("name") != NAME:
+        fail(f"frontmatter name={fm.get('name')!r} 与目录名 {NAME!r} 不一致")
+    else:
+        ok("name 与目录名一致")
+    desc = fm.get("description", "")
+    if not desc:
+        fail("description 为空")
+    elif len(desc) > DESC_LIMIT:
+        fail(f"description {len(desc)} 字符，超过 {DESC_LIMIT}")
+    else:
+        ok(f"description {len(desc)} 字符")
+
+    for f in ("README.md", "package.json"):
+        if not (ROOT / f).is_file():
+            fail(f"缺 {f}")
+        else:
+            ok(f"有 {f}")
+    try:
+        pkg = json.loads((ROOT / "package.json").read_text(encoding="utf-8"))
+        if pkg.get("name") != NAME:
+            fail(f"package.json name={pkg.get('name')!r} 与技能名不一致")
+        if not re.match(r"^\d+\.\d+\.\d+", str(pkg.get("version", ""))):
+            fail("package.json version 非 semver")
+    except (OSError, json.JSONDecodeError) as e:
+        fail(f"package.json 解析失败: {e}")
+
+    for p in ROOT.rglob("*"):
+        if not p.is_file() or ".git" in p.parts:
+            continue
+        rel = p.relative_to(ROOT).as_posix()
+        for rx in EXCLUDE_RES:
+            if rx.search(rel):
+                fail(f"不应进包的文件: {rel}")
+                break
+    ok("无禁用文件")
+
+    for py in sorted((ROOT / "scripts").glob("*.py")):
+        try:
+            compile(py.read_text(encoding="utf-8"), str(py), "exec")
+        except SyntaxError as e:
+            fail(f"{py.name} 编译失败: {e}")
+    ok("scripts/*.py 编译通过")
+
+    refdir = ROOT / "references"
+    if refdir.is_dir():
+        for md in sorted(refdir.glob("*.md")):
+            if md.stat().st_size == 0:
+                fail(f"references/{md.name} 为空")
+        skill_text = (ROOT / "SKILL.md").read_text(encoding="utf-8")
+        for ref in sorted(set(re.findall(r"references/([\w\-.]+\.md)", skill_text))):
+            if not (refdir / ref).is_file():
+                fail(f"SKILL.md 引用的 references/{ref} 不存在")
+        ok("references 完整性通过")
+
+    if errors:
+        print(f"\n[check] {NAME}: {len(errors)} 项失败")
+        return False
+    print(f"\n[check] {NAME}: 全部通过")
+    return True
+
+
+def package() -> None:
+    if not check():
+        sys.exit(1)
+    (ROOT / "dist").mkdir(exist_ok=True)
+    entries: list[str] = []
+    with zipfile.ZipFile(OUT, "w", zipfile.ZIP_DEFLATED) as z:
+        for p in sorted(ROOT.rglob("*")):
+            if not p.is_file() or ".git" in p.parts:
+                continue
+            rel = p.relative_to(ROOT)
+            rel_posix = rel.as_posix()
+            if any(rx.search(rel_posix) for rx in EXCLUDE_RES):
+                continue
+            if not any(
+                rel_posix == inc.rstrip("/") or rel_posix.startswith(inc)
+                for inc in INCLUDE
+                if inc.endswith("/")
+            ) and rel_posix not in INCLUDE:
+                continue
+            z.write(p, arcname=f"{NAME}/{rel_posix}")
+            entries.append(rel_posix)
+    sha = hashlib.sha256(OUT.read_bytes()).hexdigest()
+    pkg = json.loads((ROOT / "package.json").read_text(encoding="utf-8"))
+    manifest = {
+        "name": NAME,
+        "version": pkg.get("version"),
+        "built_at": datetime.now(timezone.utc).isoformat(),
+        "files": len(entries),
+        "sha256": sha,
+        "entries": entries,
+    }
+    MANIFEST.write_text(json.dumps(manifest, ensure_ascii=False, indent=2), encoding="utf-8")
+    print(f"\n[package] {OUT} ({len(entries)} 文件, sha256={sha[:12]}…)")
+
+
+def main() -> None:
+    if "--check" in sys.argv[1:]:
+        sys.exit(0 if check() else 1)
+    package()
+
+
+if __name__ == "__main__":
+    main()

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.2.0** (same tag as `@topmindspace/tms-skills@0.5.0`)
+- Version: **v0.3.0** (same tag as `@topmindspace/tms-skills@0.7.0`)
 
 ## Style gallery
 
@@ -26,20 +26,20 @@ npx @topmindspace/tms-skills install topmind-cover
 1. **Refine the title**: lock the title copy first (usually ≤ 10 chars) using that style's title rules; rewrite until it lands — no drawing yet.
 2. **Composition brief**: one-sentence brief (theme / audience / mood / visual metaphor / palette direction) before composing the prompt.
 3. Input: article title + 3 theme keywords + platform (x / wechat / both, default both).
-4. Generate with the agent's image-generation capability (landscape 16:9, 8% margin on all sides).
+4. Generate with the agent's image-generation capability (landscape 5:2, 8% margin on all sides).
 5. **Impact self-check** (required): pass every item in the [impact self-check list](./SKILL.md#冲击力自检清单); on failure, tweak the prompt and regenerate, max 3 attempts.
 6. Crop and save:
 
 ```bash
 python3 scripts/crop-cover.py <main-image> --out-dir <package>/images/
-# produces 00-封面.png (1200×675) + 00-封面-公众号.png (900×383, center crop)
+# produces 00-封面.png (1500x600) + 00-封面-公众号.png (900x383, center crop)
 ```
 
 ## Sizes
 
 | Platform | Size | Aspect |
 |----------|------|--------|
-| X Article cover | 1200×675 | 16:9 (master image) |
+| X Article cover | 1500x600 | 5:2 (master image) |
 | WeChat cover large image | 900×383 | 2.35:1 (center crop) |
 
 ## Design rules

package/topmind-cover/README.md

@@ -4,7 +4,7 @@
 
 为 X 长文和公众号文章生成封面图的可复用技能。目标：**震撼、醒目、主题突出**。
 
-- 版本：**v0.2.0**（与 `@topmindspace/tms-skills@0.5.0` 同 tag）
+- 版本：**v0.3.0**（与 `@topmindspace/tms-skills@0.7.0` 同 tag）
 
 ## 风格样张
 
@@ -26,20 +26,20 @@ npx @topmindspace/tms-skills install topmind-cover
 1. **标题提炼**：先定标题文案（一般 ≤10 字），用该风格章节的标题写法规范；不满意重写，不先画图。
 2. **构图简报**：一句话 brief（主题/受众/情绪/视觉隐喻/配色方向），组 prompt 前先写。
 3. 输入文章标题 + 3 个主题关键词 + 平台（x / wechat / both，默认 both）。
-4. 用 agent 的图片生成能力出图（横构图 16:9，四周留白 8%）。
+4. 用 agent 的图片生成能力出图（横构图 5:2，四周留白 8%）。
 5. **冲击力自检**（必做）：按 [SKILL.md 冲击力自检清单](./SKILL.md#冲击力自检清单) 逐项过；不通过→调 prompt 重生成，最多 3 次。
 6. 裁剪落盘：
 
 ```bash
 python3 scripts/crop-cover.py <主图> --out-dir <包>/images/
-# 产出 00-封面.png (1200×675) + 00-封面-公众号.png (900×383，中央裁剪)
+# 产出 00-封面.png (1500×600) + 00-封面-公众号.png (900×383，中央裁剪)
 ```
 
 ## 尺寸
 
 | 平台 | 尺寸 | 比例 |
 |------|------|------|
-| X Article 封面 | 1200×675 | 16:9（主图） |
+| X Article 封面 | 1500×600 | 5:2（主图） |
 | 公众号封面大图 | 900×383 | 2.35:1（中央裁） |
 
 ## 设计铁律

package/topmind-cover/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-cover
-version: 0.2.0
+version: 0.3.0
 description: "文章封面配图生成：X 长文与公众号共用。震撼、醒目、主题突出；平台尺寸规范、11 种风格模板、命名落盘、成图检查全流程覆盖。Use when 文章封面、封面图、头图、题图、cover。Do NOT use for 正文插图、PPT/报告封面。"
 action_category: write
 triggers:
@@ -75,10 +75,10 @@ updated: 2026-09-29
 
 | 平台 | 尺寸 | 比例 | 备注 |
 |------|------|------|------|
-| X Article 封面 | 1200×675 | 16:9 | 主尺寸，先按这个生成 |
-| 公众号封面大图 | 900×383 | 2.35:1 | 从 16:9 中央裁剪 |
+| X Article 封面 | 1500×600 | 5:2 | 主尺寸，先按这个生成 |
+| 公众号封面大图 | 900×383 | 2.35:1 | 从 5:2 主图中央裁剪（左右各裁约 3%） |
 
-生成 prompt 里写明"横构图 16:9"；公众号版用 `scripts/crop-cover.py` 从主图中央裁出，不重新生成（保系列一致）。
+生成 prompt 里写明"横构图 5:2"；公众号版用 `scripts/crop-cover.py` 从主图中央裁出，不重新生成（保系列一致）。
 
 ## 工作流
 
@@ -95,7 +95,7 @@ updated: 2026-09-29
    ```bash
    python3 scripts/crop-cover.py <主图> --out-dir <包>/images/
    ```
-   产出 `00-封面.png`（1200×675，X/公众号共用主文件）与 `00-封面-公众号.png`（900×383）。
+   产出 `00-封面.png`（1500×600，X/公众号共用主文件）与 `00-封面-公众号.png`（900×383）。
    公众号包规约：正文引用 `images/00-封面.png`，`图片上传清单.md` 登记两版。
 7. **系列感**：同一系列固定色系 + 版式语言，prompt 复用同一风格模板。
 

package/topmind-cover/assets/examples/README.md

@@ -5,6 +5,8 @@
 另附 `overview.png`（11 宫格总览：3 行 × 4 列缩略图 + 风格名标注，选风格时先看它）。
 
 - `<style>.png`（1200×675，X 长文封面 / 公众号共用主尺寸）
+  > 注：现行主尺寸已改为 1500×600（5:2），见 `../SKILL.md` 尺寸表。
+  > 本目录样张为 16:9 旧版，仅作风格参考，不重制。
 - `<style>-wechat.png`（900×383，公众号封面大图，中央裁剪版）
 - `<style>-alt.png`（1200×675，同风格第二张演示样张；白色清新 / 背景虚化 / 纸感拼贴
   三种新风格各有 2 张：主样张与 alt 样张用了不同的优选组合）