GitHub 转小红书

将 GitHub 仓库转换为小红书风格的技术文章。

概述

该技能将 GitHub 仓库信息转换为吸引人的小红书格式文章，适合中文技术社区推广。

支持的文章类型：

1. 介绍 - 项目推荐/概述
2. 测评 - 技术评测与评估
3. 教程 - 使用指南与教程
4. 合集 - 工具合集/列表
5. 发布 - 版本发布说明

快速开始

# 基本用法 - 生成介绍文章
python3 scripts/generate_article.py <github-url>

# 指定文章类型
python3 scripts/generate_article.py <github-url> --type review

# 保存到文件
python3 scripts/generate_article.py <github-url> --output article.md

工作流程

1. 解析 URL - 从 GitHub URL 提取 owner/repo
2. 获取数据 - 通过 GitHub API 获取仓库信息、README、语言
3. 生成内容 - 使用 LLM 创建小红书风格的文章
4. 格式化输出 - 应用表情符号和话题标签

文章类型

1. 介绍（项目推荐）

项目介绍与推荐

• 重点：功能、关键特性、为什么使用
• 风格：热情但技术性

2. 测评（项目测评）

技术评测与评估

• 重点：优缺点、使用场景、对比
• 风格：客观分析

3. 教程（使用教程）

使用指南

• 重点：安装、快速开始、示例
• 风格：分步指导

4. 合集（工具合集）

工具合集

• 重点：多个相关工具，分类整理
• 风格：精选列表并附简要说明

5. 发布（版本发布）

版本发布说明

• 重点：新功能、变更、迁移
• 风格：变更日志格式

输出格式

小红书风格包括：

• 表情装饰（🔥💡⚡️🚀）
• 章节分隔符
• 话题标签（#技术分享 #开源项目 #程序员）
• 简洁段落（适合手机阅读）

资源

scripts/

• generate_article.py - 文章生成主脚本
• github_api.py - GitHub API 封装
• formatters.py - 小红书格式工具

references/

• prompts.md - 每种文章类型的 LLM 提示模板
• rednote-style.md - 小红书格式指南

assets/

• 模板和示例输出