小遥Claw Github Readme美化工具

产品介绍

Beautify Github Readme 是一个 Agent Skills 技能（基于上游 oil-oil/beautify-github-readme MIT 1.7k★ 本地升级，完整保留上游工作流与设计规范，致谢上游作者），把 README 当内容 + 视觉两层来做：Markdown 管内容（可搜索、可复制、可维护），SVG 管视觉（可编辑、可缩放、GitHub-safe）。很多仓库信息其实已经够了，只是没人愿意看——顺序混乱功能藏在第 5 屏、套模板换皮毫无项目原生感、GitHub 不支持 CSS / 动画 / 远程字体、SVG 深浅主题下看不清、SVG 文字不换行溢出不渲染根本看不见、Windows 中文字体回退宋体。本技能先读懂仓库再定配色 / 字体 / 图形语言（项目原生而非一份模板打天下），提供双模式（整份 README 优化 / asset-only 只做素材）与三种实现（纯 SVG / Hybrid 混合构图 / GitHub-safe GIF），并相对上游补强三大升级点：渲染级验证自动化（Chrome / Edge 无头渲染每张 SVG → WCAG 文字对比度检查 → 边缘贴边检测 → 输出 PNG 供复核）、Windows / 中文字体适配（字体栈内置微软雅黑，中英混排字宽指导）、深浅双主题安全规则（不透明容器或透明底双端对比度硬规则）。只读审计不动文件，未经确认不 commit / push / 发 PR。

核心功能

• 双模式 - 整份 README 优化（重排信息 + 建立视觉系统）或 asset-only（只做 hero / 章节标题 / 流程图 / 徽章等素材，README 一字不动）
• 项目原生视觉 - 先读懂仓库再定配色 / 字体 / 图形语言，每个项目一套视觉，不是一份模板打天下
• 三种实现 - 纯 SVG（确定性可编辑）/ Hybrid SVG 构图（SVG 排版 + AI 生图素材）/ GitHub-safe GIF（动效须明确选择，SVG 保留为源文件）
• 渲染级验证自动化 - Chrome / Edge 无头渲染每张 SVG → WCAG 文字对比度检查 → 边缘贴边检测 → 输出 PNG 供复核，跨平台一条命令（升级点）
• Windows / 中文字体适配 - 字体栈内置微软雅黑不再回退宋体，中英混排字宽指导：CJK ≈1em / 拉丁 ≈0.5em（升级点）
• 深浅双主题安全 - SVG 不吃 prefers-color-scheme → 不透明容器或透明底双端对比度硬规则，杜绝深色图在浅色页看不清（升级点）
• 只读审计 - 不动文件，先告诉你 README 哪里难懂、哪里缺证据
• 静态审计 + GIF 生成 - audit_readme.py 查引用 / XML / alt，render_motion_gif.py 一键 SVG → GitHub-safe GIF

适用场景

产品标签