topmind-writing-skills

agent
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Basarisiz
  • fs.rmSync — Destructive file system operation in bin/topmind-writing-skills.js
  • process.env — Environment variable access in bin/topmind-writing-skills.js
  • fs module — File system access in bin/topmind-writing-skills.js
  • fs module — File system access in lib/host-pack.cjs
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

8 agent skills for human-sounding social writing: X posts/articles, WeChat posts, briefs, rewrites, formatting, covers & posters — ready for Claude Code, Cursor & Codex.

README.md

topmind-writing-skills

English | 中文

Release
npm
CI
License: MIT

让 AI 写出像人写的社交媒体内容。 段子、快讯、长文、排版、改稿、封面、长图,八个技能装进你的 AI 助手(Claude Code、Cursor、Codex……),说一句「来条段子」「发个快讯」「改稿」就开工。

topmind-writing-skills · 写作技能合集

npx @topmindspace/topmind-writing-skills install all      # 首次安装整套
npx @topmindspace/topmind-writing-skills@latest update    # 以后只更新已装技能

装好后直接对 AI 说「改这篇」「写条快讯」「给这篇做封面」。只想装一个,用 install topmind-revise 等技能 ID;list 查看全部。Desktop 和 Obsidian 已内置经过验证的写作快照,应用内更新从各自“关于与更新”进入,不需要再运行上面的 npx 命令。

宿主默认绑定活跃笔记,允许显式换稿。当前稿件、少量全局记忆和所选技能分层加载;其余资源按需读取,压缩不重置已完成操作和预算。

在 Desktop 与 Obsidian 中使用

默认内置 topmind-writing-skills 的版本化快照:改稿、只排版、短文、互动短帖、公众号、X 长文、封面与长图。写作仓独立迭代和发布,宿主内置经过验证的版本。

打开 Markdown,Desktop 从文章工具栏「写作」、应用、状态栏或命令面板进入;Obsidian 从 Ribbon、工作台、笔记/编辑器菜单或命令面板进入。选择动作先展示用途、目标和结果模式,明确开始后才发送 AI。源稿继续在主编辑器修改;选择格式和主题后生成预览,可复制正文或导出到源稿旁的 out/。旧 公众号稿.md 和文章目录可直接使用,不会被批量改名。

内置 HTML/文本排版无需 Python,预览与复制同源;源稿或图片改变后需要重新生成。扩展容器、图表源码、缺图和平台表格粘贴限制会显示诊断。封面生图、PNG 和外部发布依赖实际工具,复制不等于已发布。审校不使用“AI 味分数”作为定稿门槛。

只排版时保留原文、顺序和表达符号,审阅返回可落实的建议,改稿按作者授权调整内容。需要可复制成稿时,正文独立交付,核对信息与发布步骤另列。宿主按任务读取必要的参考和知识卡,样例提供可借鉴的处理方式。

宿主包运行时另外提供从源稿生成文章结果、从剪贴板 HTML 提取本地文本,以及长度规则集评估。长度入口只接受调用方传入的 JSON,本包不附带、也不启用真实平台规则。规则字段、日期和报告见 长度规则集运行契约。Unicode 码点上限不能代替 X 加权长度或目标编辑器里的最终核对。JavaScript 与 Python 渲染器的差异见 能力矩阵。

“关于与更新”分别展示 Desktop、核心技能、独立写作包和集成组件。写作资源可独立更新;编译进宿主的排版代码随宿主升级。受管包按身份隔离,覆盖本地定制会被阻止,失败保留旧版。Desktop 支持标准更新器下载后显式重启;签名、平台或渠道不支持时保留手动下载。

加选项,让经验帮助创作

  • 看过再借鉴:实际阅读参考作品和可见样张,迁移角度、组织、节奏与设计关系。
  • 按需探索:方向未定时试几种真的不同的写法;明确要一稿就交完成稿,不固定多稿与审批回合。
  • 偏好是选项:口吻、长度、emoji、开头结尾和视觉风格跟任务与作者走,模板可以拆、混合或不用。
  • 事实边界清楚:正文保留必要归因、近似值和不确定性;隐私、授权、文件恢复与输出完整性仍明确核对。
  • 工具帮助判断:lint 提示回到语境,词面分数不作定稿门槛;真实质量通过作者或读者使用验证。

完整方法与同素材样张见 创作实践,整改范围与验证见 审查报告。

能写什么

类别 技能 用途 你可以这样说
段子 topmind-viral-posts X 段子、观察反差与互动短帖,12 类创作切口与神回复 「来条段子」「不懂就问」「写个群聊体」
短文 topmind-briefs 高信噪比干货短文:提示词技巧、快讯改写、新品、榜单、论文、实测 「发个快讯」「来篇短的」「写条技巧帖」
长文 · X topmind-x-article X Article:单源 Markdown → 一键复制 HTML + 图文预览 「写 X 长文」「出一键复制版」
长文 · 公众号 topmind-wechat-post 公众号长文:质量三关、图片内嵌排版、发布清单 「写公众号」「公众号排版」
格式化 topmind-format 现成文字只改排版不改字:转段子、格式化成短文、几个开头拼成品 「转段子」「排一下版」
改稿 topmind-revise 结构 → 事实 → 逻辑 → 去 AI 味 → 保真审计;也能快审一条回复 「改稿」「去 AI 味」「看看这条回复」
封面 topmind-cover 小红书、抖音、公众号与 X 封面,含视频缩略图、叠字和多比例裁切 「做个封面」「头图」
长图 topmind-poster HTML → 高清长图 / 海报 / 信息图,文字数字逐字正确 「出张长图」「做个榜单图」

短文 = X 纯文本帖,1000 字以内都行;长文 = X Article 或公众号长文;段子 = 以观察、反差或幽默推进的短帖,排版按节奏选择。

创作方向与按需知识包

实施与验证见 整改执行记录。

8 个技能共同使用“方向—具体例子—适用条件—反例 / 例外”的知识组织方式。事实、排版与工具协议继续核对;字体、场景、篇幅、修辞与风格由任务选择,不用统一审美门槛。

内置 45 张知识卡(涵盖去 AI 味八大机制、邻座身位与体感换算、价值前置与负面边界、新闻通稿改写、装傻提问正反例、向改稿学习、插件推荐与评测保真、视觉密度与证据分区等)随每个技能独立分发;先查摘要,再读相关卡片。可以补充指定私有包或通过 scripts/knowledge.py add 随时扩展新的创作思考与策略。用法与维护见 知识包说明。

npm run knowledge:search -- "字体 场景 优雅" --skill topmind-cover --limit 3
npm run knowledge:check

封面参考提供 22 个可变风格入口、16 类构图关系、24 个组合方向和 12 份完整提示词;创作图册 有 8 组可见排版样张,可切换横竖布局。它们提供方法,不限定可创作范围,也不承诺流量效果。

多平台封面与图文

平台封面指南 提供主流平台封面尺寸速查与安全区法则:微信公众号宽图(900×383)与分享方图(900×900)从原图独立裁切、公众号图片消息(小绿书)与小红书笔记首选 1080×1440(3:4)、X Article 头图 1500×600(5:2)、X 短帖配图 1200×675(16:9)。

topmind-cover 的 landscape-pair 从同一张 16:9 母图(1920×1080)导出中央 4:3 主版(1080×810)和完整 16:9 备版;vertical-pair 从同一张 9:16 竖版母图(1080×1920)导出中央 3:4 主版(1080×1440)和完整 9:16 竖版。封面提示词区分「原生强文字模型直出」与「留白底图 + 脚本精确叠字」双路径,概念功能图诚实标注 功能示意,不是实拍。

段子与互动短帖:12 种创作切口

先想清楚这条帖子靠什么让读者停下来接话,再挑切口(早期肤浅的互关、出摊、打卡模式已清理):

写法 特点 典型开头 想要的评论
A1 装傻真提问 切身痛点 + 邻座商量 + 七分留白 用 XX 的兄弟,都…吗? 同行聊自己的用法与取舍
A2 扒料求证 线索 + 上次结果 + 猜测 XX 要上新了?! 补线索、猜结果
A3 故障求证 第一时间问挂没挂 XX 挂了吗? 「我也是」+ 接梗
A4 震惊算账体 反常细节愣一下 + 日常尺度换算 等一下,…??? 震惊、转发
A5 反直觉冷知识 刚发现 / 白干了 刚发现,XX 原来是… 「我也才知道」
A6 群聊 / 画面反差 每家一句「xx:」或动作对照 今日 XX 群: 接梗、补一家
A7 连续剧 同一主角的连续进展 栏目名 + Day N 竞猜、出主意
A8 额度侦探 真实数字换算成钱和时间 一上午跑了…账单… 晒自己的账
A9 站边轻判断 态度定性先行 + 关键事实 这定位其实就是…吧 两边讨论
A10 荒诞自嘲 集体痛点写成荒诞画面 以为…已经是极限了 共鸣、晒经历
A11 产品反转 具体产品 + 场景 + 动作反转 让某智能体帮我… 会心一笑、接梗
A12 借梗点题 新事套熟悉的旧梗 模型界的「双十一」来了 接梗、站队

每种切口都有适用题材、核心机制、装傻提问四类反例和原创示例,见 patterns.md。

短文:9 种内容类型

类型 首行怎么写 收尾
快讯(首发) 是什么 + 最狠的一个数,比读者认识的对手 「...」或不收
快讯(晚到) 换角度:实测、算账、求证 「...」
预告 / 传闻 「要来了?!」,动词照口径 「?!」
新品 / 工具 真疑问或一句真心推荐 「...」
羊毛 / 优惠 直说能马上拿到什么 不收
榜单 / 数据 谁第一、领先多少 不收
论文 一句结论 不收
实测 结果一句(翻车、快、贵) 自嘲或一个真问题
观点一句话 一句内行的轻判断 判断本身

以下是方向示例,不限定标点或收尾;时效已过时可补新角度,预告与发布保留状态差别。细则见 topmind-briefs。

看看效果

示例全部原创,名称和数字是虚构的。

段子 · A6 群聊体

今日模型群:

青鸟:新版本上线了,价格没动

Nova:我们也上线了,价格动了

小甲:你们上线前能不能先说一声

用户:我只想知道今天哪家不排队

段子 · A11 产品反转

让某编辑器的 agent 帮我整理仓库

它扫了一遍

说有个文件三个月没人动过

建议删掉

我点了确认

然后它自己的配置文件就没了

短文 · 快讯(首发)

某模型低调上线新版:编程评测 31 → 42,价格不变

网页、App、接口已全量切换,权重开源。

几项关键提升:

1)编程评测:31 → 42
2)推理评测:37 → 43
3)智能体评测:74 → 77,比某知名闭源模型高 3 分

单任务成本两毛钱出头...

正文保留“分数是厂商自测”等影响理解的归因与限定;详细来源、原图可另列,有用的链接也可随文。

去 AI 味 · 改前 → 改后

重磅!某编辑器 3.0 发布,AI 编程迎来新纪元!

更新内容:
🔹 补全更快
🔹 支持本地模型
🔹 插件市场改版

这不仅是一次更新,更是开发方式的变革。
某编辑器 3.0 发布,可以接本地模型了

更新内容:
· 补全更快
· 支持本地模型
· 插件市场改版

去掉了「重磅」和「新纪元」(播报腔)、「不仅…更是…」(递进套句)和升华收尾;首行换成读者最关心的那个变化。

更多示例:段子 · 短文 · 格式化 · 改稿 · X 长文 · 公众号 · 长图 · 封面

长文:结构按内容选择

一篇长文一个文件夹,article_scaffold.py 一条命令建好:

<文章名>/
├─ <文章名>.md    唯一源稿
├─ 骨架.md        主要信息、读者、主线与依据(按需)、每节要点 / 形式 / 图表计划
├─ 素材来源.md    每张图、每个数字的出处(不发布)
├─ images/  cover/  raw/自制图源/
└─ out/           X 长文 HTML、公众号 HTML、预览.png(随时可重建)
  • 主线:观点稿可列判断与反例,故事可列场景,教程可列任务与步骤,不凑固定数量。
  • 配图:原图、自制结构图和纯文字按理解价值选择,不设图片配额。
  • 图文预览:交付前生成 out/预览.png 先看一遍;X 粘贴不了的表格可以自动转成图。

写法规则:原则优先

所有技能共用一套分层规则(唯一真源 shared/references/,每个技能自带副本,单独安装也能用):

层 文件 管什么
写作原则 social-writing-principles.md 先想清楚传达什么、结论先行、每句有新信息、形式跟内容走、原图优先、站在读者那边
信息设计 information-design.md 先写骨架、内容 → 形式(列表 / 表格 / 图 / 段落)、篇幅和密度
措辞口吻 core-voice.md V01–V40 是标题、开头、数字、问句、回复、段子的场景选项
审稿 de-ai-rules.md + topmind-revise 去 AI 味(长文模式 + 社交短帖 S01–S10)、改写边界、保真审计

声音跟当前任务、作者样本、读者与体裁走,不把所有作者固定成同一种人设。

脚本只提示,人来判断

在对应技能目录里运行(如 topmind-briefs/、topmind-revise/):

python3 scripts/lint_x_post.py X短文.txt --kind news   # 快讯
python3 scripts/lint_x_post.py 段子.txt --duanzi        # 段子
python3 scripts/de_ai_lint.py 文章.md --genre long      # 长文
级别 含义 要求
E 格式问题 误带标记、图片占位;链接分离只在 --separate-links 启用 核对实际格式;特殊代码和引用按语义处理
W 编辑提示 句式、长度、标点、文字列表、正文链接等现象 按语境取用,可保留,无需逐条报告
H 提示 / I1–I9 语境词、首行偏长、归因与限定、播报模板;信息设计(长段、可转列表、素材罗列……) 只供判断,不进 --strict

作者有往期帖子数据时,post_type_report.py 可以统计自己哪些开头、收尾、类型表现更好,生成一份习惯摘要给改稿用;数据只留在作者本机。

怎么组合

你要做的事 组合
同一件事出快讯和段子 topmind-briefs 出快讯,topmind-viral-posts 出段子,事实保持一致
写好的文字只要排版 topmind-format;要改内容转 topmind-revise
X 长文 topmind-x-article + topmind-revise + topmind-cover
公众号长文 topmind-wechat-post + topmind-revise + topmind-cover
榜单长图 文案先由 topmind-briefs 写好,再交给 topmind-poster

所有技能只起草、不代发;发布由你确认。

安装

npm = 钉版本快照;GitHub = 跟仓库最新。

npx @topmindspace/topmind-writing-skills install all --to ./.claude/skills
npx @topmindspace/topmind-writing-skills status --to ./.claude/skills
npx @topmindspace/topmind-writing-skills@latest update --to ./.claude/skills
npx @topmindspace/topmind-writing-skills install topmind-briefs --to ./.claude/skills
npx @topmindspace/topmind-writing-skills install topmind-briefs --force --to ./.claude/skills
npx @topmindspace/topmind-writing-skills uninstall topmind-briefs --to ./.claude/skills
npx github:topmindspace/topmind-writing-skills update --to ./.claude/skills
  • install all 首次安装整套;update 默认只更新已装的技能,不会擅自加装新技能;status 显示当前包快照与安装目录的差异。三者都支持 --to 指定实际目录。
  • 不写 --to 时先找唯一的 TopMind 安装,再找唯一的技能目录或宿主配置;若同时存在多个候选,会列出目录并要求明确选择。没有宿主配置时使用当前项目的 ./.agents/skills。结果会打印实际目录。
  • 更新先复制到临时目录,完整后才替换;失败保留旧版。受管安装发现本地改动会停止,需明确 --force;强制替换时保留旧副本。升级早期未带安装记录的副本也会自动留备份。软链接或非同名技能目录不会被覆盖。
  • 同版本不重复复制;已装版本比包新时拒绝降级,除非显式 --force。升级后重新打开 AI 会话,让宿主重新发现技能。
  • 技能 id 不是独立 npm 包,不要 npm install topmind-briefs。

从本地仓库升级

本地未发布改动要从当前仓库安装,@latest 只包含 npm 已发布版本。先核实目标目录;已有跨工具软链接时更新其共享实际目录,保留链接关系。Codex 独立安装可在仓库根目录运行:

node bin/topmind-writing-skills.js status --to "$HOME/.codex/skills"
node bin/topmind-writing-skills.js update --to "$HOME/.codex/skills"

首次安装改用 install all;修改过技能内容而未改版本号时,用 install <id> --force --to <实际目录> 明确重装。CLI 只复制单个技能目录内的独立资源,不写入目标根目录的 shared/。

若 Codex 技能链接到其他共享目录,将 --to 换为核实后的实际目录;检查每项安装输出。安装了新技能或更新入口后,重开会话让宿主重新发现;同版本未发布内容需要明确加 --force 才会重装。

仓库结构与发布
topmind-writing-skills/
├─ topmind-*/                    # 八个技能(SKILL.md + references + scripts + examples)
├─ shared/                       # 共享脚本与写作规则的唯一真源(manifest.json 声明分发目标)
├─ bin/topmind-writing-skills.js # CLI:list / install / uninstall
├─ evals/                        # 路由评测用例(不进 npm 包)
├─ docs/                         # 发布规范 · CI 说明
└─ scripts/                      # 仓库级门禁、同步、隐私扫描
  • 改共享文件只改 shared/,再跑 npm run sync:shared;CI 校验各技能副本逐字节一致。
  • SKILL.md frontmatter 只用 Agent Skills 规范字段,能通过 skills-ref validate。
  • push main 后 GitHub 立即可见;打 tag vX.Y.Z 自动出 Release 并发布 npm。每个技能的版本号写在它自己的 SKILL.md 和 CHANGELOG 里。
  • 详见 docs/PUBLISHING.md · docs/ci.md。

正式商务演示用 topmind-presentation,单独安装。

许可证

MIT © TopMindspace — LICENSE

Yorumlar (0)

Sonuc bulunamadi