oil-oil/beautify-github-readme

解決的問題

許多 GitHub 倉庫包含所有必要資訊，但呈現順序混亂，常導致訪客在理解專案核心價值之前，就看到技術安裝指令或目錄樹。本專案提供一個系統，重新組織並設計 README，使專案價值、實際應用範例與使用界線立即清晰可見。

如何運作

該工具作為 AI 代理技能運作，分析倉庫以識別最清晰的價值與證據。它將視覺層與內容層分離，以保持可搜尋性與可維護性：

• 內容層： 重新組織閱讀順序，消除重複，並將內部術語替換為具體成果（Markdown 格式）。
• 視覺層： 使用 SVG 實現可編輯的主視覺、章節過渡與圖表。可創造「混合」構圖，結合決定性 SVG 排版與 AI 生成、背景移除的影像，以呈現有機質感或角色。
• 工程層： 確保資產符合 GitHub 安全標準，圖像可存取，指令仍可複製。

適用對象

希望真正提升專案首頁清晰度與視覺識別度，但又不願將 README 變成冗長且不可搜尋的圖片的開發者與開源維護者。

主要亮點

• 兩種運作模式： 提供「完整 README」模式（完整重設計，含內容與視覺）與「僅資產」模式（僅創建特定視覺元素，如主視覺或徽章）。
• 專案原生設計： 避免使用通用模板；而是從專案本身的特性中提取色彩、字型與主題（例如，CLI 工具使用命令節奏，研究型倉庫使用圖表）。
• 專案忠實： 嚴格使用真實專案素材，從不虛構功能或偽造推薦。
• 代理整合： 可透過 npx 安裝，或直接向 AI 代理請求使用。