简诗 AI Markdown 排版美化
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fccf428b/markdown-layout-formatting-optimizer。
技能介绍
问题:内容能读,但重点说不清
写笔记、整理会议纪要或技术文档时,常见情况是内容本身没问题,读者却抓不住重点:段落里混着多个主题,结论埋在叙述中,命令和路径没有标记成 行内代码,中英文之间缺少空格。手工改一轮很费时间,交给改写类工具又会被顺带换掉措辞。
这个技能解决的是后一类问题:只动排版,不动内容。
核心原则与处理流程
SKILL.md 把原则写在最前面:只调整格式、修正明显笔误,绝不添加、删除或重写任何内容。
流程分两个阶段,先分析再排版:
- 识别内容类型:判断输入是已有 Markdown 还是纯文本,并让用户在「优化 / 保留原文 / 仅排版」三种模式里选一个。交互优先使用运行时自带的提问工具,例如
AskUserQuestion;没有这类工具时退化为编号纯文本提问。 - 读者视角分析:整理核心论点、关键结论、被埋进散文里的并列项和结构问题,写成
{original-filename}-analysis.md,作为后续排版的蓝图。 - 补齐 frontmatter:生成
title、slug、summary、description,并检查同目录是否存在imgs/cover.png用作封面。 - 执行排版:补标题层级、把并列项抽成列表、对比转表格、命令和技术词标注为代码,只加中性描述性标题,不加带情绪的标题。
- 运行排版脚本:入口是
scripts/main.ts.md.md,配合quotes和autocorrect两个脚本,分别处理全角引号替换、CJK/英文间距、CJK 强调标点问题;运行时按 bun →npx -y bun的顺序解析。
结果写入 {original-filename}-formatted.md,原文件保留备份,最后输出一份改动报告。
适用边界与注意点
- 不做内容决策:不扩写、不缩写、不换说法,除章节标题外不添加解释性文字。
- 标题需要你参与:默认生成 4~5 个候选标题供选择;想跳过交互,可在
EXTEND.md里把auto_select_title或auto_select设为true。 - 配置按优先级查找:项目级
.baoyu-skills/...→ XDG 路径 → 用户主目录,都没找到就用默认值,首次运行不需要额外配置。 - 安全边界:不自动安装依赖、不改系统权限、不创建持久化任务、不执行下载内容;涉及发送、发布、删除、部署等外部写入时,会先展示目标与影响并等你确认。
- 脚本中的代码默认只作参考,只有你明确要求执行且目标范围清楚时才会运行。
使用场景
- 写技术笔记时段落过长,需要按主题补标题层级、抽出列表与表格
- 整理会议纪要把散文里的并列项抽成列表,并保留原文措辞
- 交付前检查技术文档的中英文间距、CJK 强调标点与代码标记
- 写长文时生成候选标题,并在 frontmatter 补上 summary 与 description
适合人员
- 维护技术文档和内部 wiki 的工程师,需要排版可扫读但不改动原文
- 写公众号长文的作者,想在不改措辞的前提下优化标题与段落结构
- 整理周会纪要的项目经理,要把讨论项抽成列表并保留原始记录
- 运营和内容编辑,需要为文章补齐 frontmatter 元信息后再发布