Agent Skills
返回列表
📁

宝玉 Markdown 排版

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/baoyu-md-formatter。

技能介绍

要解决什么问题

技术笔记、博客初稿和从别处粘来的长文,经常出现这些问题:没有 frontmatter、标题层级混乱、要点埋在段落里、中英文混排缺空格、粗体标点不合法。手工排版既慢,又容易在「润色」时偷偷改意思——这篇技能的设计前提是:读者要更快抓住结构和高光句,但原文一字不能删改、不能改写。

技能如何工作

工作流分 Analyze 与 Format 两阶段(纯排版可走短路)。

  1. 读入并判定类型:有 YAML frontmatter、# 标题或列表/代码块则视为 Markdown;否则按纯文本处理。若已是 Markdown,会通过用户输入工具让你选 Optimize(完整流程)、Keep original(复制后只做排版脚本)或 Typography only(仅跑脚本)。
  2. 读者视角分析:产出亮点、结构缺口、可列表化的并列项、应加粗的核心结论等,写入 {原名}-analysis.md,作为后续格式化的蓝图。
  3. Frontmatter 与标题/摘要:补全或生成 title、slug、summary、description;标题可走公式候选并让用户选择(也可通过 EXTEND.md 的 auto_select_title 等跳过交互)。正文去掉重复 H1。
  4. 结构化排版:按分析加 ##/###、列表、表格、引用块与 ` 行内代码 `,只调整格式与明显错字,不加解说句、不删段。
  5. 输出与排版脚本:保存为 {原名}-formatted.md,再调用 scripts/main.ts(remark-cjk-friendly、可选 autocorrect 中英文间距、可选全角引号替换等)。

配置优先级:项目 .baoyu-skills/baoyu-format-markdown/EXTEND.md → XDG 用户配置 → $HOME/.md。

边界与注意点

  • 仅支持单文件处理;极长文档速度取决于 Agent 与模型。
  • 完整「优化」流程需要 LLM + 可选 exec(Bun/npx 跑 TS 脚本);无交互环境时需用编号问答替代 AskUserQuestion。
  • 不适用需要主观改稿、重组论点或营销话术重写的场景;那是编辑,不是本技能的职责。

使用场景

  • 静态站发文前,要把墙式长文拆成带 `##` 层级和要点列表的定稿
  • 技术周报是纯文本粘贴稿,需要补 `title`/`summary` frontmatter 且不改写段落
  • 已有 Markdown 但作者只要 CJK emphasis 与中英文间距修复,选 Typography only 跑脚本
  • 会议记录缺目录感,要先出 analysis 再按段落边界加中性小标题

适合人员

  • 用 Hugo/Jekyll 发技术博客、每篇都要规范 frontmatter 与摘要字段的独立作者
  • 维护内部 Runbook 的 SRE,想把杂乱 Markdown 整理成可检索标题层级但禁止改操作步骤原文
  • 运营需要把长文转成订阅号预览格式,同时要生成 50~80 字 `summary` 与稍长的 `description`
  • 文档工程师处理中英混排 API 说明,需要默认开启 spacing/emphasis 脚本减少手工校对