用途:把纯文本或 Markdown 文件整理成结构清晰、便于阅读的 Markdown,帮助读者快速抓住要点与结构。核心原则是只调整排版、修正明显错别字,绝不新增、删除或改写原文内容。
主要能力:生成或补全 YAML frontmatter(title、slug、summary、description、coverImage),生成标题候选并让用户选择,生成一句话摘要与较长描述,按内容分析补充小标题、加粗、有序/无序列表、表格、代码标记与引用,并可调用脚本做排版修正:CJK 强调/加粗标点修复、中英文混排加空格、把 ASCII 引号替换为全角引号、格式化 frontmatter。
使用方式:先读取并识别内容类型(是否已有 Markdown 结构),已存在格式时询问是优化排版、保留原格式还是仅做排版修正。分析阶段产出 {原文件名}-analysis.md 作为排版蓝本;格式化结果保存为 {原文件名}-formatted.md(若同名文件存在会先备份)。排版脚本位于 scripts/ 子目录,{baseDir} 为本 SKILL.md 所在目录;运行时优先使用 bun,其次 npx -y bun,否则提示安装 bun。命令示例:${BUN_X} {baseDir}/scripts/main.ts article.md,可用 --quotes/-q 开启全角引号替换,--no-spacing 关闭中英文加空格,--no-emphasis 关闭 CJK 强调修复。提问优先使用运行时内置的用户输入工具(如 AskUserQuestion),不支持则输出编号文本让用户回复。
适用场景:需要把草稿或纯文本整理为可发布、易扫读的 Markdown 文档,统一中文排版规范时使用。
限制:不改变原文措辞与结构含义,不添加解释性语句,不做编辑性标题;偏好配置从 .baoyu-skills/baoyu-format-markdown/EXTEND.md 按项目、XDG、用户主目录顺序读取,未找到则使用默认值(auto_select 类选项默认 false)。封面图仅在同目录存在 imgs/cover.png 时使用相对路径。收费、平台支持范围与效果等资料未提供。