@topmindspace/topmind-writing-skills 0.7.1

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

@@ -0,0 +1,54 @@
+# topmind-cover · Cover Art Generation
+
+**[中文](./README.md)** | English
+
+A reusable skill for generating cover art for X long-form posts and WeChat articles. Goal: **striking, eye-catching, theme-focused**.
+
+- Version: **v0.3.0** (same tag as `@topmindspace/topmind-writing-skills@0.7.1`)
+
+## Style gallery
+
+<p align="center">
+  <img src="https://github.com/topmindspace/topmind-writing-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 11 cover-style overview" width="960" />
+</p>
+
+11 styles (clean white / background blur / paper collage / news flash / giant-type manifesto / tutorial steps / minimalist / editorial magazine / viral dry-goods / brand launch / fun IP, light-first ordering): use cases, palette stories, abstract design principles, and Chinese+English prompt recipes in [`references/cover-styles.md`](./references/cover-styles.md); full-size per-style shots in [`assets/examples/`](./assets/examples/). Prefer writing your own prompts and sending them straight to an image model (bypassing the skill)? See [`references/cover-prompts.md`](./references/cover-prompts.md) — a copy-paste prompt compendium plus cross-platform viral-cover research.
+
+## Install
+
+```bash
+npx @topmindspace/topmind-writing-skills install topmind-cover
+```
+
+## Usage
+
+0. **Pick a style**: choose 1 of 11 styles from `references/cover-styles.md` by topic (light-first) → check the example image to confirm the visual language.
+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 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 (1500x600) + 00-封面-公众号.png (900x383, center crop)
+```
+
+## Sizes
+
+| Platform | Size | Aspect |
+|----------|------|--------|
+| X Article cover | 1500x600 | 5:2 (master image) |
+| WeChat cover large image | 900×383 | 2.35:1 (center crop) |
+
+## Design rules
+
+One image, one theme; subject fills 40%+ of the frame; big title ≤ 10 chars, high contrast; avoid clutter, tiny dense text, and competing subjects. **Safe-zone rule**: title text and key subject must stay inside the central vertical 60% safe zone.
+
+## Development
+
+```bash
+python3 scripts/package_skill.py --check
+python3 scripts/negative_tests.py
+```

package/topmind-cover/README.md

@@ -0,0 +1,54 @@
+# topmind-cover · 封面配图生成
+
+[English](./README.en.md) | 中文
+
+为 X 长文和公众号文章生成封面图的可复用技能。目标：**震撼、醒目、主题突出**。
+
+- 版本：**v0.3.0**（与 `@topmindspace/topmind-writing-skills@0.7.1` 同 tag）
+
+## 风格样张
+
+<p align="center">
+  <img src="https://github.com/topmindspace/topmind-writing-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 11 封面风格总览" width="960" />
+</p>
+
+11 种风格（白色清新 / 背景虚化 / 纸感拼贴 / 资讯快报 / 巨字宣言 / 教程步骤 / 极简留白 / 杂志编辑 / 爆款干货 / 品牌发布 / IP 趣味，浅色优先排序）：适用场景、配色故事、抽象设计原则、中英 prompt 配方见 [`references/cover-styles.md`](./references/cover-styles.md)；单风格大图在 [`assets/examples/`](./assets/examples/)。想自己写提示词直接给 AI 生图（不走技能流程），看 [`references/cover-prompts.md`](./references/cover-prompts.md)（可直接拷贝的提示词大全 + 全平台爆款流派调研）。
+
+## 安装
+
+```bash
+npx @topmindspace/topmind-writing-skills install topmind-cover
+```
+
+## 用法
+
+0. **选风格**：按题材从 `references/cover-styles.md` 选 1 种（11 选 1，浅色优先）→ 看示例图确认视觉语言。
+1. **标题提炼**：先定标题文案（一般 ≤10 字），用该风格章节的标题写法规范；不满意重写，不先画图。
+2. **构图简报**：一句话 brief（主题/受众/情绪/视觉隐喻/配色方向），组 prompt 前先写。
+3. 输入文章标题 + 3 个主题关键词 + 平台（x / wechat / both，默认 both）。
+4. 用 agent 的图片生成能力出图（横构图 5:2，四周留白 8%）。
+5. **冲击力自检**（必做）：按 [SKILL.md 冲击力自检清单](./SKILL.md#冲击力自检清单) 逐项过；不通过→调 prompt 重生成，最多 3 次。
+6. 裁剪落盘：
+
+```bash
+python3 scripts/crop-cover.py <主图> --out-dir <包>/images/
+# 产出 00-封面.png (1500×600) + 00-封面-公众号.png (900×383，中央裁剪)
+```
+
+## 尺寸
+
+| 平台 | 尺寸 | 比例 |
+|------|------|------|
+| X Article 封面 | 1500×600 | 5:2（主图） |
+| 公众号封面大图 | 900×383 | 2.35:1（中央裁） |
+
+## 设计铁律
+
+一图一主题；主体占画面 40%+；大标题 ≤10 字高对比；忌元素堆砌、小字密排、多主体打架。**安全区铁律**：标题字与关键主体必须落在画面中央垂直 60% 安全区内。
+
+## 开发
+
+```bash
+python3 scripts/package_skill.py --check
+python3 scripts/negative_tests.py
+```

package/topmind-cover/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: topmind-cover
+version: 0.3.0
+description: "文章封面配图生成：X 长文与公众号共用。震撼、醒目、主题突出；平台尺寸规范、11 种风格模板、命名落盘、成图检查全流程覆盖。Use when 文章封面、封面图、头图、题图、cover。Do NOT use for 正文插图、PPT/报告封面。"
+action_category: write
+triggers:
+  - 封面
+  - 封面图
+  - 头图
+  - 题图
+  - 首图
+  - 配图
+  - 缩略图
+  - banner
+  - cover
+  - thumbnail
+triggers_cn:
+  - 公众号封面
+  - 公众号题图
+  - X 封面
+  - X 首图
+  - 文章封面
+author: TopMindspace
+license: MIT
+homepage: https://github.com/topmindspace/topmind-writing-skills#readme
+updated: 2026-09-29
+---
+
+# topmind-cover · 封面配图生成
+
+为 X 长文和公众号文章生成封面图。目标：**震撼、醒目、主题突出**。
+
+```
+标题提炼 → 构图简报 → 风格模板 → 生成 → 冲击力自检 → 裁剪双尺寸 → 落盘命名
+```
+
+## 风格索引（浅色优先：1~8 浅色，9~11 深色/高饱和）
+
+风格总览图见 `assets/examples/overview.png`（11 宫格：3 行 × 4 列，离线可看）。
+
+| 风格 | 首选题材 |
+|------|----------|
+| 白色清新 `white-clean` | 干货清单、实测盘点、效率/副业/职场 |
+| 背景虚化 `bg-blur` | 生活方式、职场日常、运动健康 |
+| 纸感拼贴 `paper-collage` | 手账、整理术、旧物改造 |
+| 资讯快报 `news-flash` | 资讯快讯、热点解读、揭秘类选题 |
+| 巨字宣言 `big-type` | 观点评论、深度长文、发布宣言 |
+| 教程步骤 `tutorial-steps` | 教程、上手指南、分步实操 |
+| 极简留白 `minimal` | 随笔、书评、轻观点 |
+| 杂志编辑 `magazine` | 深度访谈、人物特写、商业分析 |
+| 爆款干货 `gan-huo` | 干货清单、评测、盘点、实测筛选 |
+| 品牌发布 `brand-launch` | 产品发布、版本更新、官方白皮书 |
+| IP 趣味 `ip-fun` | 实战案例、数据战报、复盘、连载 |
+
+适用场景细则、配色故事、prompt 配方见 `references/cover-styles.md`；单风格大图 `assets/examples/<style>.png`。
+
+> 示例图为原创演示：只学设计原则，不临摹第三方版式（详见 `references/cover-styles.md` 顶部"原创铁律"）。
+
+## 意图判断 → 直出 / 讨论（生成前必做）
+
+默认按意图直出；意图模糊/多解/缺关键信息时先与用户确认（三问以内）。
+
+| # | 检查项 | 通过标准 | 不通过→追问（给选项，不给问答题） |
+|---|--------|----------|----------------------------------|
+| 1 | 标题确定 | 有明确标题文案（≤10 字），或用户给了原文可直接提炼 | 给 2 个备选标题让用户挑："用 A 还是 B？" |
+| 2 | 主题明确 | 能说清文章讲什么（3 个主题关键词） | 追问："这篇的核心主题是？"附 2~3 个关键词备选 |
+| 3 | 风格明确 | 题材对上某风格首选题材，或用户点名了风格 | 给 2~3 个候选风格 + 各一句话差异，让用户选 |
+| 4 | 关键信息有出处 | 数字/品牌/人物/署名等真实可查 | 缺→问；问不到→删掉该元素，**绝不编造** |
+
+- **四项全过 → 直接生成**，不问。
+- **任一项模糊/多解 → 先确认再生成**，问题总数 ≤3（风格、标题、内容各至多一问）。
+- 讨论时每个问题附 2~3 个具体备选，用户只做选择题。
+
+## 尺寸表
+
+| 平台 | 尺寸 | 比例 | 备注 |
+|------|------|------|------|
+| X Article 封面 | 1500×600 | 5:2 | 主尺寸，先按这个生成 |
+| 公众号封面大图 | 900×383 | 2.35:1 | 从 5:2 主图中央裁剪（左右各裁约 3%） |
+
+生成 prompt 里写明"横构图 5:2"；公众号版用 `scripts/crop-cover.py` 从主图中央裁出，不重新生成（保系列一致）。
+
+## 工作流
+
+0. **意图判断**（必做）：先过上方"意图判断 → 直出 / 讨论"决策流；意图明确→直接生成，模糊→三问以内确认。
+   **选风格（三步，必做）**：① 按题材从 `references/cover-styles.md` 选 1 种（11 选 1，浅色优先）→ ② 看 `assets/examples/<style>.png` 确认视觉语言 → ③ 看该风格章节的标题写法规范，心里有标题雏形。
+1. **标题提炼**（先定文案，不画图）：用所选风格在 `cover-styles.md` 对应章节的标题写法规范提炼标题（一般 ≤10 字）；不满意就重写，满意再进下一步。
+   - 坏："关于 Manus 2.0 的一些思考与体验"（长、没钩子）→ 好："Manus 2.0 实测"（短、有断言）
+2. **构图简报**（一句话 brief，组 prompt 前先写）：主题 + 受众 + 情绪 + 视觉隐喻 + 配色方向。
+   - 例："给 AI 从业者看的 Manus 2.0 实测封面，情绪'震撼但可信'，视觉隐喻是破壳而出的机械手，深空黑底 + 电光蓝强调。"
+3. **输入与组 prompt**：用步骤 1 定下的标题 + 3 个主题关键词 + 平台（`x` / `wechat` / `both`，默认 both；平台只影响 prompt 侧重，裁剪落盘永远产出双尺寸）。按风格配方组装 prompt，标题逐字写明（防 AI 自造错别字）。
+4. **生成**：`media.generate_image`，`name` 用 `<slug>-cover`。
+5. **冲击力自检**（必做）：过下方自检清单 9 项；不通过→调整 prompt 重生成，最多 3 次；3 次仍不过→换一种风格，或回步骤 1 重写标题。
+6. **裁剪落盘**：
+   ```bash
+   python3 scripts/crop-cover.py <主图> --out-dir <包>/images/
+   ```
+   产出 `00-封面.png`（1500×600，X/公众号共用主文件）与 `00-封面-公众号.png`（900×383）。
+   公众号包规约：正文引用 `images/00-封面.png`，`图片上传清单.md` 登记两版。
+7. **系列感**：同一系列固定色系 + 版式语言，prompt 复用同一风格模板。
+
+## 冲击力自检清单
+
+**生成后必过**。
+
+| # | 检查项 | 不通过怎么改 |
+|---|--------|--------------|
+| 1 | 3 秒测试：缩到 120px 宽，3 秒内读出标题并说清"这是什么" | 放大标题，删小字 |
+| 2 | 标题字高 ≥ 画面高度 1/4，空间允许时冲击 1/3 | 放大标题，其他元素让路 |
+| 3 | 对比果断：字色与底色明度差拉满（拒绝灰底白字式低对比） | 底色走极端（极深或极浅） |
+| 4 | 记忆点：3 秒后能向人描述出一个具体的东西 | 加一个形象/数字/符号/质感记忆点 |
+| 5 | 质感：背景有纹理、光影或描边，拒绝纯色死平 | 背景层加一层纸纹/噪点/光影 |
+| 6 | 标题字逐字正确：无 AI 自造错字/乱码/笔画粘连（含装饰导致） | 有错字/粘连→减装饰、缩短标题或修正标题写法后重生成 |
+| 7 | 标题与关键主体落在中央垂直 60% 安全区（900×383 裁剪不切字） | 把元素收拢进安全区 |
+| 8 | `references/impact-language.md` 20 条原则快速勾选 | 按"保守陷阱清单"逐项纠正 |
+| 9 | 装饰手法 ≤ 该风格指定数量（多了即乱；minimal 只许 1 种） | 超量→删掉最弱的一种装饰再生成 |
+
+## 设计铁律
+
+- 一图一主题；主体占画面 40% 以上，居中或三分法
+- 大标题 ≤10 字；对比与字高见冲击力自检 #2/#3
+- 四周 8% 安全边距，标题不贴边（中央 60% 安全区见自检 #7）
+- 忌：元素堆砌、小字密排、多主体打架
+
+## 外部依赖 / 规约来源
+
+"公众号包规约"（正文引用 `images/00-封面.png`、`图片上传清单.md` 登记两版）来自用户侧
+workbuddy 环境，仓库内无此文件；缺失时仍按固定命名落盘，不阻塞核心流程。
+
+## When NOT to use
+
+- 正文插图：主体是文字说明，按正文配图流程走
+- 报告/PPT 封面：走 `topmind-presentation`（仓库 `topmind-presentation`，已从本仓独立出去）
+- 只想找现成图：走 `image_search` 技能

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

@@ -0,0 +1,34 @@
+# 封面风格示例图
+
+26 张示例（随 npm 包发布，npx 安装即得）：11 种风格 × 2 种尺寸 = 22 张 + 3 张 alt 样张
++ 1 张 alt 微信尺寸版（`white-clean-alt-wechat.png`），
+另附 `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 样张用了不同的优选组合）
+- `<style>-alt-wechat.png`（900×383，alt 样张的公众号尺寸版；目前只有 white-clean 有，即
+  `white-clean-alt-wechat.png`，`crop-cover.py` 流程产出双尺寸，新增 alt 样张时一并产出）
+- `overview.png`（11 宫格总览：3 行 × 4 列缩略图 + 风格名标注，选风格时先看它）
+
+11 种风格（白色清新 `white-clean` / 背景虚化 `bg-blur` / 纸感拼贴 `paper-collage` /
+资讯快报 `news-flash` / 巨字宣言 `big-type` / 教程步骤 `tutorial-steps` /
+极简留白 `minimal` / 杂志编辑 `magazine` / 爆款干货 `gan-huo` / 品牌发布 `brand-launch` /
+IP 趣味 `ip-fun`，浅色优先排序）：适用场景索引与配方见 `../references/cover-styles.md`。
+
+## 原创与虚构声明（重要）
+
+本目录 26 张示例图均为**原创设计**（只演示抽象设计原则，不临摹任何第三方封面的
+版式与配色；复用本库设计时亦不得与第三方封面构成实质相似——只学原则，不学版式）。
+图中标题文案、数字、品牌名、署名均为**虚构演示内容**（如"破晓 6.0"、
+"@老周带单"）——直接复用前请换成自己的真实标题；凡封面上的数字必须在正文中有
+出处，严禁编造数据。
+
+## 复用声明
+
+**示例图可直接拿去用/改，作封面底图或风格参考。**拿去用时按 `scripts/crop-cover.py`
+的流程重新裁剪双尺寸并按包规约命名落盘；改图时保留原风格的配色与版式语言，
+只换主体与标题字，以维持系列感。