topmindspace/topmind-writing-skills / topmind-x-article
topmind-x-article
Verified创作或整理 X Article 深度长文,支持论点推进、工具/插件介绍、产品实测评测与多源研究;按需导出可复制 HTML、纯文本、封面与发布清单。普通短帖用 topmind-briefs 或 topmind-viral-posts,纯格式化用 topmind-format。
references/platform-operations.md
View on GitHub# 平台操作参考
按需查阅目录、脚本与导出细节。写法与质量判断见 SKILL.md 和共享经验;平台技术限制与审美选择分开处理。
## 目录约定
```
<文章名>/
├── <文章名>.md # 唯一源稿:改稿永远只改它
├── images/ # 01-xxx.png、02-xxx.png…,按正文出现顺序编号
├── cover/ # cover-1500x600.png 等(topmind-cover 产出,X 编辑器单独上传)
├── 素材来源.md # 私有:图源、承重事实来源、未核实条目
├── raw/ # 原始下载、截图、笔记(不发布)
└── out/ # 按需生成,可随时重建,不手改
├── X长文.html # 首选复制入口:浏览器打开,一键复制全文
├── X发布稿.txt # 纯文本兜底入口
└── 改稿报告.md # topmind-revise 的完整报告
```
旧结构(`公众号稿.md` + 派生 `X长文.md` + `[图N]`)只读兼容:
`python3 scripts/md2x-html.py X长文.md --out X长文.html --images-from 公众号稿.md` 仍可用,不自动迁移。
## 派生规则(历次配图错位与重号的结论)
- **单源**:只改 `<文章名>.md`,改完重新派生 `out/`;`out/` 里的文件不手改,不另存一份 X 稿。
- **图跟着文字走**:图片行紧跟它证明的那段文字(最多隔一段);改稿移动段落时,图片行一起搬。
- **编号 = 出现顺序**:`images/` 文件名编号与正文出现顺序一致,`check_article.py` 不一致就报 E4。
曾因按文件名排序手工传 `--images`(文件名顺序 ≠ 文档顺序)导致从某张图起整段错位一格;
现在 `md2x-html.py` 直接按文档顺序读 `![]()`,不再允许手工排序。
- **序号不叠加**:小标题手写「一、」时原样保留,派生时不再加序号(曾出现「一、一、」重号)。
- **构建后必查**:HTML 体积(有图时 MB 级)、data-URI 数量 = 图片数(+1 封面)、无 `:::` 残留;
抽查每张图前后几行是否出现该图主题词,章节题图只查节标题相关性。
- **封面不占编号**:正文图按 `[图1]…[图N]` 编号,封面单独上传;`X发布稿.txt` 的 `[图N]` 与 HTML 一致。
## 封面
Article 头图与账号主页 banner 是不同用途。1500×600 是本包预设,宽图、竖图或方图跨平台使用需分别构图、预览;依据与核验边界见 [平台封面参考](platform-cover-specs.md)。封面单独上传,不进入正文图编号。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |