Skip to content

topmindspace/topmind-writing-skills / topmind-x-article

topmind-x-article

Verified

创作或整理 X Article 深度长文,支持论点推进、工具/插件介绍、产品实测评测与多源研究;按需导出可复制 HTML、纯文本、封面与发布清单。普通短帖用 topmind-briefs 或 topmind-viral-posts,纯格式化用 topmind-format。

FileKindSize
.gitignoreother31 B
README.en.mdmarkdown1.7 KB
README.mdmarkdown2.0 KB
SKILL.mdskill md4.6 KB
examples/01-长文-慢慢写.mdmarkdown1.8 KB
examples/02-长文-周末短途.mdmarkdown1.4 KB
examples/README.mdmarkdown716 B
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.jsonmanifest445 B
references/core-voice.mdmarkdown9.9 KB
references/creative-practice.mdmarkdown5.0 KB
references/de-ai-rules.mdmarkdown17.9 KB
references/image-sourcing.mdmarkdown2.7 KB
references/information-design.mdmarkdown5.0 KB
references/knowledge-library.mdmarkdown5.5 KB
references/platform-cover-specs.mdmarkdown7.4 KB
references/platform-operations.mdmarkdown2.5 KB
references/publish-checklist.mdmarkdown2.2 KB
references/research-mode.mdmarkdown1.6 KB
references/revision-workflow.mdmarkdown5.9 KB
references/social-writing-principles.mdmarkdown7.7 KB
references/workspace.mdmarkdown2.3 KB
references/x-delivery-contract.mdmarkdown3.6 KB
references/x-format.mdmarkdown3.5 KB
references/x-html-format.mdmarkdown6.8 KB
references/x-post-format.mdmarkdown2.5 KB
scripts/article_scaffold.pyscript5.6 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/md2x-html.pyscript39.8 KB
scripts/md2x.pyscript15.4 KB
scripts/negative_tests.pyscript10.5 KB
scripts/package_skill.pyscript6.6 KB
scripts/revise_check.pyscript15.2 KB

scripts/article_scaffold.py

View on GitHub
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""article_scaffold.py — 新建一篇长文的文章文件夹(单源结构)。

    python3 article_scaffold.py --title "文章标题" [--base 输出目录] [--tags AI,Agent] [--date 2026-10-18]
                                [--env 环境名] [--by 改稿人]

生成:
    <文章名>/
      <文章名>.md      唯一源稿(frontmatter 五个必填字段 + 可选 subtitle、多环境字段 + H1 标题)
      images/          正文配图,按出现顺序 01-xxx.png、02-xxx.png
      cover/           封面(cover-1500x600.png 等)
      骨架.md          动笔前的信息设计骨架:主要信息、读者、每节要点 / 形式 / 图表计划 / 字数(不发布)
      素材来源.md      每张图、每个数字的出处
      raw/             原始素材、截图、笔记(不发布)
      out/             派生产物(X长文.html、X发布稿.txt、公众号版 HTML),可随时重建
      参考/            其他环境写的同主题稿件和素材:参考-<环境>-<YYYYMMDD>.md,只作参考,永远不当源稿

多环境字段(可选,见 references/workspace.md「多环境协作」):updated_at 写当前时间(ISO 8601,带时区),
updated_env / updated_by 用 --env / --by 填,不填就留空;每次改稿时更新这三项,新旧以 updated_at 为准。
subtitle 可以留空:填了的话 md2wechat 写进图片上传清单的「摘要」,md2x-html 在页顶预览里给出(都不进正文)。
刚建好的文件夹跑 check_article.py 应该只有 W5(封面还没做)。
文件夹已存在就报错退出,绝不覆盖。文件名里的 / \\ : * ? " < > | 换成「-」,最长 80 字。
"""
import argparse
import datetime
import os
import re
import sys

UNSAFE_RE = re.compile(r'[/\\:*?"<>|\x00-\x1f]')
MAX_NAME = 80


def safe_name(title):
    name = UNSAFE_RE.sub("-", title.strip())
    name = re.sub(r"\s+", " ", name).strip(" .-")
    return name[:MAX_NAME].rstrip(" .-")


def now_iso():
    """当前时间,ISO 8601 带时区(如 2026-10-18T17:00:00+08:00)。"""
    return datetime.datetime.now().astimezone().isoformat(timespec="seconds")


def frontmatter(title, date, tags, env="", by="", updated_at=None):
    tag_list = ", ".join(tags)
    return ("---\n"
            "title: %s\n"
            "subtitle: \n"
            "date: %s\n"
            "status: 草稿\n"
            "updated_at: %s\n"
            "updated_env: %s\n"
            "updated_by: %s\n"
            "tags: [%s]\n"
            "cover: cover/cover-1500x600.png\n"
            "---\n" % (title, date, updated_at or now_iso(), env, by, tag_list))


SKELETON_TPL = """# 骨架

复杂稿可先梳理,也可通过草稿修订;按当前体裁取用,不发布。

类型:记录 / 观点 / 教程 / 资讯 / 方法论 / 架构 / 对比 / 随笔
主要信息:(读者带走什么)
读者:(已有知识与关心的问题)
篇幅:约 ____ 字(按任务调整)

## 主线与依据(按需)

观点稿:判断、依据、反例;教程:目标、前提、步骤;故事:场景、变化、细节。
无需凑固定数量判断、素材比例或自制图。

| 节 | 要点 | 形式 | 图表或材料(按需) | 字数 |
|---|---|---|---|---|
| | | | | |
"""


SOURCES_TPL = """# 素材来源

每张图、每个关键数字一行:用在哪、出处、取用日期。正文图片下方的「来源:」行从这里摘。

| 位置 | 内容 | 出处 | 日期 |
|---|---|---|---|
| images/01-xxx.png | | | |
"""


def scaffold(title, base, date=None, tags=None, env="", by=""):
    name = safe_name(title)
    if not name:
        raise ValueError("标题清洗后为空,换一个标题")
    root = os.path.join(base, name)
    if os.path.exists(root):
        raise FileExistsError("文件夹已存在,不覆盖:%s" % root)
    date = date or datetime.date.today().isoformat()
    tags = tags or []
    os.makedirs(root)
    for d in ("images", "cover", "raw", "out", "参考"):
        os.makedirs(os.path.join(root, d))
    md = os.path.join(root, name + ".md")
    with open(md, "w", encoding="utf-8") as f:
        f.write(frontmatter(name, date, tags, env, by))
        f.write("\n# %s\n\n" % name)
    with open(os.path.join(root, "骨架.md"), "w", encoding="utf-8") as f:
        f.write(SKELETON_TPL)
    with open(os.path.join(root, "素材来源.md"), "w", encoding="utf-8") as f:
        f.write(SOURCES_TPL)
    return root, md


def main():
    ap = argparse.ArgumentParser(description="新建长文文章文件夹(<文章名>/<文章名>.md 单源)")
    ap.add_argument("--title", required=True, help="文章标题,也是文件夹名和文件名")
    ap.add_argument("--base", default=".", help="在哪个目录下建(缺省当前目录)")
    ap.add_argument("--date", default=None, help="frontmatter date,缺省今天")
    ap.add_argument("--tags", default="", help="逗号分隔的标签")
    ap.add_argument("--env", default="", help="frontmatter updated_env:在哪个环境建的(如 主环境、本地),缺省留空")
    ap.add_argument("--by", default="", help="frontmatter updated_by:谁建的(如 agent、手动),缺省留空")
    args = ap.parse_args()
    tags = [t.strip() for t in re.split(r"[,,]", args.tags) if t.strip()]
    try:
        root, md = scaffold(args.title, args.base, args.date, tags, args.env, args.by)
    except (FileExistsError, ValueError) as e:
        print("错误:%s" % e, file=sys.stderr)
        return 1
    print("文章文件夹:%s" % root)
    print("源稿      :%s" % md)
    return 0


if __name__ == "__main__":
    sys.exit(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