Skip to content

topmindspace/topmind-writing-skills / topmind-revise

topmind-revise

Verified

审查、润色、精简或重写已有稿件,用“跟朋友说话 vs 完成写作任务”诊断去 AI 味,核对事实边界并保留作者真实口吻与褒贬。支持长文、短帖、回复、标题和改稿复盘学习;纯排版用 topmind-format,平台导出用对应长文技能。

FileKindSize
README.en.mdmarkdown1.8 KB
README.mdmarkdown2.1 KB
SKILL.mdskill md5.9 KB
examples/01-长文-改前.mdmarkdown853 B
examples/01-长文-改后.mdmarkdown478 B
examples/02-短文-改前.txtmarkdown503 B
examples/02-短文-改后.txtmarkdown314 B
examples/README.mdmarkdown1.4 KB
knowledge/README.mdmarkdown9.4 KB
knowledge/cards/atlas-local-fix.mdmarkdown781 B
knowledge/cards/brief-news-to-post.mdmarkdown3.0 KB
knowledge/cards/brief-news.mdmarkdown916 B
knowledge/cards/brief-paper.mdmarkdown760 B
knowledge/cards/brief-tools.mdmarkdown617 B
knowledge/cards/brief-value-first.mdmarkdown3.1 KB
knowledge/cards/cover-abstract.mdmarkdown1.3 KB
knowledge/cards/cover-brief.mdmarkdown1.3 KB
knowledge/cards/cover-collage.mdmarkdown1.3 KB
knowledge/cards/cover-color.mdmarkdown1.2 KB
knowledge/cards/cover-culture.mdmarkdown1013 B
knowledge/cards/cover-editorial.mdmarkdown1.2 KB
knowledge/cards/cover-material.mdmarkdown1.3 KB
knowledge/cards/cover-photo.mdmarkdown1.1 KB
knowledge/cards/cover-playful.mdmarkdown1.0 KB
knowledge/cards/cover-scene.mdmarkdown962 B
knowledge/cards/cover-series.mdmarkdown1017 B
knowledge/cards/cover-typography.mdmarkdown1.3 KB
knowledge/cards/creative-choice.mdmarkdown807 B
knowledge/cards/crop-independent.mdmarkdown719 B
knowledge/cards/de-ai-mechanisms.mdmarkdown3.6 KB
knowledge/cards/experience-loop.mdmarkdown801 B
knowledge/cards/format-fidelity.mdmarkdown501 B
knowledge/cards/format-layouts.mdmarkdown502 B
knowledge/cards/poster-paging.mdmarkdown726 B
knowledge/cards/poster-structure.mdmarkdown646 B
knowledge/cards/poster-voices.mdmarkdown530 B
knowledge/cards/reference-reading.mdmarkdown857 B
knowledge/cards/revise-depth.mdmarkdown677 B
knowledge/cards/revise-feedback.mdmarkdown609 B
knowledge/cards/revise-learn-from-edits.mdmarkdown3.1 KB
knowledge/cards/revise-preserve.mdmarkdown788 B
knowledge/cards/viral-mechanisms.mdmarkdown535 B
knowledge/cards/viral-observation.mdmarkdown544 B
knowledge/cards/viral-play-dumb.mdmarkdown2.8 KB
knowledge/cards/viral-replies.mdmarkdown722 B
knowledge/cards/visual-density-and-evidence.mdmarkdown2.8 KB
knowledge/cards/voice-peer-stance.mdmarkdown2.7 KB
knowledge/cards/wechat-decide.mdmarkdown746 B
knowledge/cards/wechat-explain.mdmarkdown820 B
knowledge/cards/wechat-plugin-and-review.mdmarkdown2.5 KB
knowledge/cards/wechat-story.mdmarkdown798 B
knowledge/cards/x-adapt.mdmarkdown643 B
knowledge/cards/x-argument.mdmarkdown770 B
knowledge/cards/x-evidence.mdmarkdown608 B
knowledge/index.jsonconfig39.9 KB
package.jsonmanifest421 B
references/calibration-drill.mdmarkdown3.7 KB
references/core-voice.mdmarkdown9.9 KB
references/creative-practice.mdmarkdown5.0 KB
references/de-ai-rules.mdmarkdown17.9 KB
references/examples.mdmarkdown1.9 KB
references/fact-check.mdmarkdown3.1 KB
references/image-sourcing.mdmarkdown2.7 KB
references/information-design.mdmarkdown5.0 KB
references/knowledge-library.mdmarkdown5.5 KB
references/report-template.mdmarkdown1.4 KB
references/research-mode.mdmarkdown1.6 KB
references/revision-workflow.mdmarkdown5.9 KB
references/social-writing-principles.mdmarkdown7.7 KB
scripts/audit-provenance.pyscript14.9 KB
scripts/audit_css.pyscript1.1 KB
scripts/audit_docs.pyscript3.1 KB
scripts/audit_skill.pyscript3.1 KB
scripts/audit_styles.pyscript1.6 KB
scripts/check_article.pyscript13.9 KB
scripts/count_words.pyscript3.0 KB
scripts/de_ai_lint.pyscript41.5 KB
scripts/info_design_hints.pyscript14.2 KB
scripts/knowledge.pyscript11.8 KB
scripts/lint_x_post.pyscript20.0 KB
scripts/negative_tests.pyscript16.0 KB
scripts/package_skill.pyscript6.6 KB
scripts/post_type_report.pyscript9.5 KB
scripts/revise_check.pyscript15.2 KB

scripts/negative_tests.py

View on GitHub
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""topmind-revise 异常输入测试:工具链在坏输入下干净失败、不崩溃,规则不误报(任一失败 → 退出码 1)。

覆盖:
  1. 自包含:不引用技能目录外的相对路径;共享规则与脚本随包自带
  2. audit_skill.py 在坏 frontmatter 上退出码 1;package_skill.py --check 在缺 README 时退出码 1
  3. de_ai_lint.py:强信号报 W、语境词只报 H、--strict 不被 H 卡住、读不到文件退出码 2
  4. revise_check.py:数字 / 引语变化被发现、--strict 退出码 1、过度改稿比例、坏输入退出码 2
  5. count_words.py:去掉标题和图片后计数
  6. examples:改前有 W、改后 0 W
  7. scripts/*.py 全部可编译
"""
from __future__ import annotations

import json
import re
import py_compile
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
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(args: list[str], cwd: Path = ROOT) -> subprocess.CompletedProcess:
    return subprocess.run([PY, *args], capture_output=True, text=True, timeout=60, cwd=str(cwd))


def no_tb(r: subprocess.CompletedProcess) -> bool:
    return "Traceback" not in (r.stderr or "") + (r.stdout or "")


def main() -> None:
    print("[negative_tests] topmind-revise")

    # 1. 自包含
    outside = []
    for md in [ROOT / "SKILL.md", *sorted((ROOT / "references").glob("*.md"))]:
        if not md.is_file():
            continue
        for link in re.findall(r"\]\(([^)]+)\)", md.read_text(encoding="utf-8")):
            if link.startswith(("https://", "http://", "mailto:", "#")):
                continue
            # ../knowledge is still inside a standalone skill; compare resolved paths.
            target = (md.parent / link.split("#")[0]).resolve()
            if not target.is_relative_to(ROOT.resolve()):
                outside.append(f"{md.relative_to(ROOT).as_posix()}: {link}")
    check("不引用技能目录外的相对路径", not outside, "、".join(outside))
    for ref in ("core-voice.md", "de-ai-rules.md", "revision-workflow.md", "image-sourcing.md",
                "fact-check.md", "report-template.md", "examples.md"):
        check(f"规则随包自带: references/{ref}", (ROOT / "references" / ref).is_file())
    for sc in ("de_ai_lint.py", "lint_x_post.py", "count_words.py", "revise_check.py", "audit-provenance.py",
               "check_article.py"):
        check(f"脚本随包自带: scripts/{sc}", (ROOT / "scripts" / sc).is_file())

    # 2. 坏 frontmatter / 缺 README
    with tempfile.TemporaryDirectory() as td:
        sk = Path(td) / "skill"
        shutil.copytree(ROOT, sk, ignore=shutil.ignore_patterns("dist", "__pycache__"))
        (sk / "SKILL.md").write_text("no frontmatter\n", encoding="utf-8")
        r = run(["scripts/audit_skill.py"], sk)
        check("audit_skill 在坏 frontmatter 上退出码=1 且无 Traceback", r.returncode == 1 and no_tb(r), f"rc={r.returncode}")
    with tempfile.TemporaryDirectory() as td:
        sk = Path(td) / "skill"
        shutil.copytree(ROOT, sk, ignore=shutil.ignore_patterns("dist", "__pycache__"))
        (sk / "README.md").unlink()
        r = run(["scripts/package_skill.py", "--check"], sk)
        check("package_skill --check 在缺 README 时退出码=1 且无 Traceback", r.returncode == 1 and no_tb(r), f"rc={r.returncode}")

    with tempfile.TemporaryDirectory() as td:
        t = Path(td)

        # 3. de_ai_lint
        bad = t / "bad.md"
        bad.write_text("# 标题\n\n值得注意的是,这不仅是一次升级,更是一场变革。\n\n如图所示,速度快了一倍。\n", encoding="utf-8")
        r = run(["scripts/de_ai_lint.py", str(bad), "--json"])
        data = json.loads(r.stdout or "[]") if r.returncode == 0 else []
        codes = {w.get("code") for item in data for w in item.get("warnings", [])}
        check("de_ai_lint:强信号报 W9", "W9" in codes, r.stdout[-300:] + r.stderr[-300:])
        check("de_ai_lint:复述图片报 W21", "W21" in codes, str(codes))
        ctx = t / "ctx.md"
        ctx.write_text("# 标题\n\n真正的难点不在模型,在数据清洗。\n", encoding="utf-8")
        r = run(["scripts/de_ai_lint.py", str(ctx), "--strict"])
        check("de_ai_lint:语境词只给 H,--strict 不失败", r.returncode == 0 and "[H1]" in r.stdout, r.stdout[-300:])
        r = run(["scripts/de_ai_lint.py", str(ctx), "--no-hints"])
        check("de_ai_lint:--no-hints 不打印提示", "[H" not in r.stdout, r.stdout[-200:])
        r = run(["scripts/de_ai_lint.py", str(t / "missing.md")])
        check("de_ai_lint:读不到文件退出码=2 且无 Traceback", r.returncode == 2 and no_tb(r), f"rc={r.returncode}")

        # 4. revise_check
        before = t / "before.md"
        after = t / "after.md"
        before.write_text("# 标题\n\n某框架三个月涨到 6 万星标,作者说「这个功能我们不会做」。\n\n可能下个月发布 2.0。\n", encoding="utf-8")
        after.write_text("# 标题\n\n某框架三个月涨到 8 万星标,作者说「这个功能不做」。\n\n下个月发布 2.0。\n", encoding="utf-8")
        r = run(["scripts/revise_check.py", str(before), str(after), "--json"])
        rep = json.loads(r.stdout or "{}") if r.returncode == 0 else {}
        fid = rep.get("保真", {})
        check("revise_check:发现数字变化", "6万" in "".join(fid.get("数字", {}).get("消失", [])), json.dumps(fid, ensure_ascii=False)[:300])
        check("revise_check:发现引语变化", bool(fid.get("引语", {}).get("消失")), json.dumps(fid, ensure_ascii=False)[:300])
        check("revise_check:发现确定性词消失", "可能" in fid.get("确定性词", {}).get("消失", []), json.dumps(fid, ensure_ascii=False)[:300])
        r = run(["scripts/revise_check.py", str(before), str(after), "--strict"])
        check("revise_check --strict:数字 / 引语变化 → 退出码 1", r.returncode == 1, f"rc={r.returncode}")
        r = run(["scripts/revise_check.py", str(before), str(before), "--strict"])
        check("revise_check --strict:原样 → 退出码 0", r.returncode == 0, f"rc={r.returncode} {r.stdout[-200:]}")
        rp = t / "report.md"
        r = run(["scripts/revise_check.py", str(before), str(after), "--report", str(rp)])
        check("revise_check --report 写出报告骨架", rp.is_file() and "## 未核实条目" in rp.read_text(encoding="utf-8"))
        r = run(["scripts/revise_check.py", str(before), str(t / "missing.md")])
        check("revise_check:读不到文件退出码=2 且无 Traceback", r.returncode == 2 and no_tb(r), f"rc={r.returncode}")
        # 按次数比:删掉一处「多半」、多引用一次数字都要看得见;「改前」这种短词不算引语
        cb, ca = t / "cnt_b.md", t / "cnt_a.md"
        cb.write_text("# t\n\n明年多半会涨,后年多半还涨,star 已经 39 万。\n", encoding="utf-8")
        ca.write_text("# t\n\n这一段里「改前」只是个标签。明年多半会涨,star 已经 39 万,比去年多 39 万。\n", encoding="utf-8")
        r = run(["scripts/revise_check.py", str(cb), str(ca), "--json"])
        fid = (json.loads(r.stdout or "{}") if r.returncode == 0 else {}).get("保真", {})
        check("revise_check:确定性词按次数比(多半 2→1)", any("多半(2→1)" in x for x in fid.get("确定性词", {}).get("次数变化", [])),
              json.dumps(fid, ensure_ascii=False)[:300])
        check("revise_check:数字按次数比(39万 1→2)", any(x.startswith("39万(1→2)") for x in fid.get("数字", {}).get("次数变化", [])),
              json.dumps(fid, ensure_ascii=False)[:300])
        check("revise_check:「改前」这种短词不算引语", not fid.get("引语", {}).get("新增"), json.dumps(fid, ensure_ascii=False)[:300])

        # 过度改稿:干净段落被大面积改写
        clean_b = t / "clean_b.md"
        clean_a = t / "clean_a.md"
        paras_b = [f"第{i}段讲的是版本 {i} 的变化,启动快了一些,内存少了一点。" for i in range(1, 6)]
        paras_a = [f"第{i}段讲版本 {i} 的变化:启动快了一些,内存也少了一点。" for i in range(1, 6)]
        clean_b.write_text("\n\n".join(paras_b) + "\n", encoding="utf-8")
        clean_a.write_text("\n\n".join(paras_a) + "\n", encoding="utf-8")
        r = run(["scripts/revise_check.py", str(clean_b), str(clean_a), "--json"])
        rep = json.loads(r.stdout or "{}") if r.returncode == 0 else {}
        check("revise_check:没命中的段落被大面积改写 → 提示过度改稿", rep.get("过度改稿", {}).get("over_edit") is True,
              json.dumps(rep.get("过度改稿"), ensure_ascii=False))
        # --declare:改动表里依据是事实 / 逻辑 / 作者意见的段落不计入;依据是规则编号的照算
        def declare_file(basis: str) -> Path:
            f = t / f"declare_{basis[:2]}.md"
            rows = "\n".join(f"| 改前第 {i} 段 | {basis} | {pb[:18]}… | … |" for i, pb in enumerate(paras_b, 1))
            f.write_text("# 改稿报告\n\n## 改动表\n\n| 位置 | 依据 | 原文 | 改后 |\n|---|---|---|---|\n" + rows + "\n", encoding="utf-8")
            return f
        r = run(["scripts/revise_check.py", str(clean_b), str(clean_a), "--json", "--declare", str(declare_file("② 逻辑"))])
        o = (json.loads(r.stdout or "{}") if r.returncode == 0 else {}).get("过度改稿", {})
        check("revise_check --declare:登记为逻辑关的改动不计入过度改稿", o.get("over_edit") is False and len(o.get("declared", [])) == 5,
              json.dumps(o, ensure_ascii=False)[:300])
        r = run(["scripts/revise_check.py", str(clean_b), str(clean_a), "--json", "--declare", str(declare_file("⓪ 结构"))])
        o = (json.loads(r.stdout or "{}") if r.returncode == 0 else {}).get("过度改稿", {})
        check("revise_check --declare:登记为⓪结构复查的改动不计入过度改稿", o.get("over_edit") is False and len(o.get("declared", [])) == 5,
              json.dumps(o, ensure_ascii=False)[:300])
        r = run(["scripts/revise_check.py", str(clean_b), str(clean_a), "--json", "--declare", str(declare_file("Z17 假强调"))])
        o = (json.loads(r.stdout or "{}") if r.returncode == 0 else {}).get("过度改稿", {})
        check("revise_check --declare:依据是规则编号的改动照算", o.get("over_edit") is True, json.dumps(o, ensure_ascii=False)[:300])
        r = run(["scripts/revise_check.py", str(clean_b), str(clean_a), "--declare", str(t / "nope.md")])
        check("revise_check --declare 读不到文件退出码=2 且无 Traceback", r.returncode == 2 and no_tb(r), f"rc={r.returncode}")
        # 报告骨架:改动表预填、剩余 H 也列进「保留未改的命中」、带人工检查清单
        hb, ha = t / "h_b.md", t / "h_a.md"
        hb.write_text("# t\n\n这是一段普通的介绍,讲本地存储。\n\n第二段保持不变,讲插件。\n", encoding="utf-8")
        ha.write_text("# t\n\n这是真正的本地存储,一段普通的介绍。\n\n第二段保持不变,讲插件。\n", encoding="utf-8")
        rp2 = t / "report2.md"
        run(["scripts/revise_check.py", str(hb), str(ha), "--report", str(rp2)])
        txt = rp2.read_text(encoding="utf-8") if rp2.is_file() else ""
        check("revise_check --report:改动表按 diff 预填", "| 改前第" in txt and "真正的本地存储" in txt, txt[:300])
        check("revise_check --report:剩余 H 列进保留未改的命中", "[H1]" in txt and "(一句判断)" in txt, txt[:500])
        check("revise_check --report:带人工检查清单", "## 人工检查" in txt and "- [ ]" in txt)
        lb, la = t / "long_b.md", t / "long_a.md"
        para = "某笔记工具这周发了新版,把同步改成了可选项,默认只存本地,用户自己决定要不要上云。"
        lb.write_text("# t\n\n" + "\n\n".join([para] * 5) + "\n", encoding="utf-8")
        la.write_text("# t\n\n" + para + "\n\n- 同步:可选\n- 存储:本地\n", encoding="utf-8")
        rp3 = t / "report3.md"
        r = run(["scripts/revise_check.py", str(lb), str(la), "--report", str(rp3)])
        t3 = rp3.read_text(encoding="utf-8") if rp3.is_file() else ""
        check("revise_check:长文给出改前 / 改后信息设计提示数(I,只提示)",
              "信息设计提示" in r.stdout and re.search(r"改前 [1-9]\d* 条 → 改后 0 条", t3) is not None, r.stdout[-300:] + t3[:200])
        check("revise_check --report:带信息设计诊断(⓪ 结构)且在改动表之前",
              "## 信息设计诊断" in txt and txt.find("## 信息设计诊断") < txt.find("## 改动表"), txt[:400])

        # 5. count_words
        cw = t / "cw.md"
        cw.write_text("---\ntitle: x\n---\n# 标题不算\n\n一二三四五。\n\n![图](a.png)\n\n六七八。\n", encoding="utf-8")
        r = run(["scripts/count_words.py", str(cw), "--json"])
        cnt = json.loads(r.stdout or "{}") if r.returncode == 0 else {}
        check("count_words:去掉 frontmatter / 标题 / 图片后计数", cnt.get("paragraphs") == 2 and cnt.get("chars", 0) >= 8, r.stdout)

    # 6. examples
    ex = ROOT / "examples"
    r = run(["scripts/de_ai_lint.py", str(ex / "01-长文-改前.md"), "--strict"])
    check("examples:改前有 W(--strict 退出码 1)", r.returncode == 1, f"rc={r.returncode}")
    r = run(["scripts/de_ai_lint.py", str(ex / "01-长文-改后.md"), "--strict"])
    check("examples:改后 0 W", r.returncode == 0, r.stdout[-300:])
    r = run(["scripts/lint_x_post.py", str(ex / "02-短文-改后.txt"), "--strict"])
    check("examples:短文改后通过 lint_x_post --strict", r.returncode == 0, r.stdout[-300:])

    # 6b. check_article:缺 frontmatter 字段 → E1,退出 1,无 Traceback
    with tempfile.TemporaryDirectory() as td:
        art = Path(td) / "某文"
        art.mkdir()
        (art / "某文.md").write_text("---\ntitle: 某文\n---\n\n# 某文\n\n正文。\n", encoding="utf-8")
        r = run(["scripts/check_article.py", str(art / "某文.md")])
        check("check_article 缺字段报 E1 并退出 1", r.returncode == 1 and "E1" in r.stdout and no_tb(r), r.stdout[-200:])
        # 草稿期占位截图:W4 不报错;改成定稿就是 E3
        art2 = Path(td) / "占位"
        art2.mkdir()
        fm = "---\ntitle: 占位\ndate: 2026-10-18\nstatus: {st}\ntags: [a]\ncover: cover/c.png\n---\n\n# 占位\n\n正文。\n\n![对练截图](images/01-对练截图.png)\n"
        (art2 / "占位.md").write_text(fm.format(st="草稿"), encoding="utf-8")
        r = run(["scripts/check_article.py", str(art2)])
        check("check_article 草稿期占位截图只给 W4", r.returncode == 0 and "W4" in r.stdout and "E3" not in r.stdout, r.stdout[-200:])
        (art2 / "占位.md").write_text(fm.format(st="定稿"), encoding="utf-8")
        r = run(["scripts/check_article.py", str(art2)])
        check("check_article 定稿时缺图仍是 E3", r.returncode == 1 and "E3" in r.stdout, r.stdout[-200:])
        (art2 / "占位.md").write_text(fm.format(st="草稿").replace("01-对练截图", "01-架构"), encoding="utf-8")
        r = run(["scripts/check_article.py", str(art2)])
        check("check_article 普通图片缺失仍是 E3(不是占位)", r.returncode == 1 and "E3" in r.stdout, r.stdout[-200:])

    # 7. 可编译
    for f in sorted((ROOT / "scripts").glob("*.py")):
        try:
            py_compile.compile(str(f), doraise=True, cfile=str(Path(tempfile.gettempdir()) / (f.stem + ".pyc")))
            ok = True
        except py_compile.PyCompileError:
            ok = False
        check(f"可编译: scripts/{f.name}", ok)

    if fails:
        print(f"\n[negative_tests] {len(fails)} 项失败")
        sys.exit(1)
    print("\n[negative_tests] 全部通过")


if __name__ == "__main__":
    main()
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall