Baoyu Markdown 格式化

解决什么问题

这类文本很常见：内容本身说得清楚，但 Markdown 结构已经失真——标题层级断裂，关键结论埋在段落里，并列项写成散文，中文与英文之间没有间距，ASCII 引号和强调标点风格混杂，YAML frontmatter 里缺 title、slug、summary 或 description。结果不是读不懂，而是读者要花更多时间找重点。该技能的目标很窄：只重排版，不重写。

工作方式

技能按 Analyze → Format 两阶段执行。先判断输入是 Markdown 还是普通文本：有 YAML frontmatter、标题、列表、代码块、引用块等标记就按 Markdown 处理。若检测到 Markdown，会优先用运行时的用户输入工具询问处理方式：Optimize、Keep original 或 Typography only；没有该工具时，退化为编号纯文本提问。

分析阶段从读者视角提取亮点、关键结论、可引用金句、结构边界和排版问题，并写入 {original-filename}-analysis.md。随后检查或创建 frontmatter，生成或优化标题候选；标题未设置 auto_select 或 auto_select_title 时会让用户选择，摘要则直接生成 summary 与 description 两档。

排版阶段按分析结果应用标题、加粗、列表、表格、行内代码、围栏代码块、引用块和分隔线。原则是保留作者语气与每个词，只把自然存在的并列项拆成列表，给真正的话题转折加标题，修正明显笔误，不添加解释或评论。

排版后处理

排版结果保存为 {original-filename}-formatted.md，随后运行 scripts/main.ts 做文字排版修正。脚本支持 --quotes / --no-quotes、--spacing / --no-spacing、--emphasis / --no-emphasis，默认开启中英文间距与 CJK 强调标点修正，关闭 ASCII 引号替换；YAML frontmatter 始终会被格式化。完成后输出变更报告，说明实际改动。

适用边界

它不适合改写观点、压缩篇幅、补写论据、翻译或生成新内容。若用户选择 Keep original，技能只备份并运行排版脚本；Typography only 则直接在原文件上做排版修正。配置可通过 EXTEND.md 调整 auto_select、auto_select_title、auto_select_summary 等选项；脚本运行依赖 Bun 或 npx -y bun。