用途:该 Skill 面向“格式化 Markdown”“美化文章”“添加格式”或改善排版的需求,把纯文本或已有 Markdown 文件整理成结构清晰、带 frontmatter 与合适排版的 Markdown。
主要能力:读取用户指定的文件,判断其属于 Markdown 还是纯文本;为缺失的 YAML frontmatter 生成字段,包括 title、slug、summary,并在同目录存在 imgs/cover.png 时写入相对路径封面(也接受 featureImage);处理标题层级、加粗、列表、行内代码与代码块、引用和分隔线;最后运行排版脚本修正中文强调标点、中英文间距,并可选替换引号。
使用方式:Claude 先完成内容分析与格式化,再执行脚本。常用命令为 npx -y bun ${SKILL_DIR}/scripts/main.ts {output-file-path} [options]。选项包括 --quotes/-q 启用引号替换、--no-quotes 禁用、--spacing/-s 启用中英文间距(默认开)、--no-spacing、--emphasis/-e 修正中文强调(默认开)、--no-emphasis、--help/-h。结果保存为 {filename}-formatted.md,如已存在会按时间戳备份。
配置:可通过项目级 .tuzi-skills/tuzi-format-markdown/EXTEND.md 或用户级 $HOME/.tuzi-skills/tuzi-format-markdown/EXTEND.md 覆盖默认格式化选项与摘要长度偏好;未找到则用默认值。脚本位于 scripts/ 目录,包含 main.ts、quotes.ts、autocorrect.ts。
适用场景:将草稿、笔记或缺失结构的文章整理为有标题、摘要、小标题与列表的成稿,并统一中英混排排版。
限制:资料未提供收费、价格、支持平台与具体效果数据;处理时会保留原文观点与语气,不添加原文不存在的内容,代码块语言需人工确认。