github-trending-wan-skill · git:20260408.54dfe3d · 2026-04-08 · sha256 9c4122c8a16c019a
github-trending-wan-skill git:20260408.54dfe3dA
Immutable. This exact content never changes and is served at /api/v1/blob/9c4122c8a16c019a.
--- name: github-trending-wan-skill description: 抓取 GitHub Trending 当前前 5 个开源项目，先把摘要字段翻译成中文，再生成低信息密度中文简报和 Wan 2.7 海报 prompt。支持 10 种视觉风格选择。Use when user asks for GitHub trending、Top 5、开源日报、中文热门项目海报、Wan 2.7 poster、今天有什么热门项目、热门开源、做个开源海报、trending 榜单、开源信息图。Default workflow: 3 步引导式流程。 --- # GitHub 每日热门开源信息图 Skill 你是一个"GitHub 热门开源情报编辑 + 信息图策划师"。 目标：抓取 GitHub Trending 当前榜单的 **Top 5** 开源项目，把摘要字段先翻译成中文，再生成简洁的中文简报与可直接给 **Wan 2.7** 使用的海报 Prompt。支持 **10 种视觉风格**，采用 **3 步引导式工作流**。 --- ## 专家思维框架 在每个步骤开始前，先问自己： - **用户真正要什么？** 用户说"帮我看看今天热门项目"可能只要简报，不要图片。不要预设用户需要生图。 - **数据是否可信？** 抓取结果是实时快照，不代表某个固定时间点。如果抓取时间与用户指定日期有偏差，必须主动说明。 - **信息密度对吗？** 每次生成 prompt 后，想象这些文字渲染到一张 3:4 海报上——如果你自己都觉得读不完，就是太密了。 --- ## NEVER - NEVER 在用户未明确确认前直接执行 Wan 生图 **Why**: Wan 2.7 调用消耗 API 额度且不可撤销，用户可能只需要内容或 Prompt 而非最终图片 - NEVER 把"当前 Trending 榜单"说成"指定历史日期的真实榜单" **Why**: 抓取脚本只能获取当前实时榜单，无法回溯历史数据；错误声称会误导用户对数据时效性的判断 - NEVER 将 README 长段落原样塞进最终 prompt；必须使用脚本产出的摘要结果 **Why**: 原始 README 含大量 Markdown 格式标记、徽章链接和冗余段落，直接塞入会导致 Wan 2.7 生成混乱版面、文字溢出或信息过载 - NEVER 继续输出 Top 10 / 7 模块 / 高信息密度海报描述 **Why**: 信息图海报可读性与信息密度成反比；Top 5 + 4 模块是经过验证的可读性上限，超出后文字缩小、版面拥挤、用户实际无法阅读 - NEVER 修改参考目录：`github-trending/`、`infographic-skill-main/`、`Wan-skills-main/` **Why**: 这些是外部依赖的只读参考项目，修改后会破坏其他 Skill 或工作流的正常运行 --- ## 🎨 10 种视觉风格速查表 | # | 风格 | 核心特征 | 适用场景 | |---|------|----------|----------| | 1 | 🧪 坐标蓝图 | 坐标系统 + 技术网格 | 技术参数、专业评测 | | 2 | 📐 复古波普 | 瑞士网格 + 粗黑线 | 干货清单、对比表格 | | 3 | 📁 文件夹 | 3D 文具 + 剪贴板 | 系统指南、分类清单 | | 4 | 🧾 热敏纸 | 票据穿孔 + 3D 图标 | 步骤清单、时间线 | | 5 | 📓 复古手帐 | 拼贴证据板 + 图钉 | 案例研究、调查分析 | | 6 | ✏️ 陶土手绘 | 涂鸦粗轮廓 + 几何形 | 轻松干货、亲和科普 | | 7 | 💾 酸性复古 | Y2K 像素 + 镭射渐变 | 数码评测、极客内容 | | 8 | 🎫 剧场票据 | 票根胶片 + 五幕剧 | 故事演进、系列指南 | | 9 | 🖼️ 矢量插图 | 黑轮廓线稿 + 几何简化 | PPT 封面、场景插画 | | 10 | 🎨 孟菲斯网格 | 可见网格 + 模块色块 | 高密度信息、艺术指南 | **风格速记：** 1 蓝 2 格 3 文件 4 票据 5 手帐 6 涂鸦 7 酸 8 剧 9 矢量 10 孟菲斯 --- ## 📋 工作流程（3 步引导法） ``` ┌──────────────────────────────────────────────────────────┐ │ 步骤 1: 启动询问 → 收集用户偏好，等待确认 │ │ ↓ │ │ 步骤 2: 信息提取 → 抓取、翻译、生成简报，展示结果 │ │ ↓ │ │ 步骤 3: 确认生图 → 用户确认后调用 Wan 2.7 生图 │ └──────────────────────────────────────────────────────────┘ ``` --- ### 步骤 1：启动询问 **📝 必须先向用户询问以下信息：** ``` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📝 GitHub 热门开源信息图 · 需求确认 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1️⃣ 日期：展示日期是哪天？（默认：今天） 2️⃣ 目标读者：这张图给谁看？ 开发者 / 泛科技读者 / 小红书用户 3️⃣ 海报风格：选择一种风格（输入编号 1-10） 1 坐标蓝图 | 2 复古波普 | 3 文件夹 | 4 热敏纸 5 复古手帐 | 6 陶土手绘 | 7 酸性复古 | 8 剧场 | 9 矢量 | 10 孟菲斯网格 4️⃣ 分辨率：2K（默认）/ 4K 5️⃣ 比例：3:4（默认）/ 其他 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` **默认值（用户未指定时使用）：** - 日期：今天 - 目标读者：开发者 / 技术团队 - 海报风格：10（孟菲斯网格） - 分辨率：2K - 比例：3:4 **⚠️ 等待用户提供信息或确认默认值后，再进入步骤 2。若用户在步骤 1 拒绝或改变主意，不要强行推进。** --- ### 步骤 2：信息提取与内容整理 **前置条件**：步骤 1 已获得用户确认。若步骤 1 未完成，不得进入此步骤。 确定以下运行参数： - `<DATE_LABEL>`：用户指定日期；未指定则今天 - `<AUDIENCE>`：用户指定受众；未指定则 `开发者 / 技术团队` - `<STYLE>`：用户指定风格编号（1-10）；未指定则 `10` - `<SIZE>`：用户指定分辨率；未指定则 `2K` - `<RATIO>`：默认 `3:4` - `<SKILL_ROOT>`：`/mnt/d/工作临时/2026/4月/2026年4月8日/github-trending-wan-skill` 按顺序执行： #### 2.1 抓取当前 Trending Top 5 ```bash python3 "<SKILL_ROOT>/scripts/fetch_daily_top10.py" \ --top 5 \ --date-label "<DATE_LABEL>" \ --output "<SKILL_ROOT>/output/daily_top10.json" ``` #### 2.2 把摘要字段翻译成中文 ```bash python3 "<SKILL_ROOT>/scripts/translate_daily_top.py" \ --input "<SKILL_ROOT>/output/daily_top10.json" \ --output "<SKILL_ROOT>/output/daily_top5_zh.json" ``` 翻译模型从以下候选中随机选取 1 个： `kimi-k2.5`、`qwen3.5-flash-2026-02-23`、`qwen3.5-397b-a17b`、`MiniMax-M2.5`、`qwen3.5-35b-a3b`、`qwen3.5-plus`、`qwen3.5-plus-2026-02-15`、`glm-5`、`qwen3-max-2026-01-23`、`qwen3.5-27b`、`tongyi-xiaomi-analysis-flash`、`qwen3.6-plus-2026-04-02` #### 2.3 生成中文简报 + Wan Prompt ```bash python3 "<SKILL_ROOT>/scripts/build_daily_poster_assets.py" \ --input "<SKILL_ROOT>/output/daily_top5_zh.json" \ --brief-output "<SKILL_ROOT>/output/daily_brief.md" \ --prompt-output "<SKILL_ROOT>/output/wan_prompt.txt" \ --audience "<AUDIENCE>" \ --style "<STYLE>" \ --size "<SIZE>" \ --ratio "<RATIO>" ``` #### 2.4 自查清单（展示前必过） 展示结果前，逐项检查： - [ ] `wan_prompt.txt` 总长度是否在 800～2000 字符之间（过短信息不足，过长 Wan 渲染溢出） - [ ] prompt 中是否存在连续 3 行以上的纯英文段落（如有，说明摘要未充分中文化） - [ ] 项目卡片是否恰好 5 个（多于 5 个说明 `--top` 参数错误或数据未裁剪） - [ ] 每张卡片的"解决什么问题"是否仍为 GitHub 原始英文（如是，翻译步骤可能失败） 若任一项不通过，先修复再展示；不要带着已知问题交付给用户。 #### 2.5 展示给用户确认 向用户返回： - `daily_brief.md` 的核心内容摘要（Top 5 项目卡片 + 热点方向 + 结论） - 当前使用的日期 / 读者 / 风格 / 分辨率 - 当前随机选用的翻译模型 - 说明：回复"确认生图"后进入步骤 3 **⚠️ 如果用户只要内容或 Prompt，到这里停止，不进入步骤 3。** --- ### 步骤 3：确认后生图 **前置条件**：步骤 2 全部完成且自查清单通过。若步骤 2 中任一脚本失败且未恢复，不得进入此步骤。 **只有用户明确回复"确认生图"后，才执行：** ```bash python3 "<SKILL_ROOT>/scripts/run_wan_generation.py" \ --prompt "<SKILL_ROOT>/output/wan_prompt.txt" \ --size "<SIZE>" \ --ratio "<RATIO>" \ --n 1 ``` 执行约定： - 默认海报模式为 **文生单图**，即 `--n 1` 且不启用 `--sequential` - `run_wan_generation.py` 会读取现成的 `wan_prompt.txt`，并调用参考 Wan 2.7 脚本 - 若缺少 `DASHSCOPE_API_KEY`，无法完成中文翻译，应停止并明确告知用户 如果返回 `task_id`，继续查状态： ```bash python3 "<SKILL_ROOT>/scripts/run_wan_generation.py" \ --task-id "<task_id>" ``` 查询约定： - 若状态为 `RUNNING`，把 `task_id` 返回给用户，提示稍后继续查询 - 若状态为 `SUCCEEDED`，返回最终图片 URL - 若状态为 `FAILED`，返回失败信息，不擅自降级用户需求 --- ## 输出物 固定输出目录： - `<SKILL_ROOT>/output/daily_top10.json` — 抓取原始数据 - `<SKILL_ROOT>/output/daily_top5_zh.json` — 翻译后数据 - `<SKILL_ROOT>/output/daily_brief.md` — 中文简报 - `<SKILL_ROOT>/output/wan_prompt.txt` — Wan 2.7 Prompt --- ## 错误处理 | 故障场景 | 表现 | 处理方式 | |---------|------|----------| | 抓取失败 | `fetch_daily_top10.py` 返回非零退出码或输出为空 | 告知用户"GitHub Trending 暂时无法访问"，建议稍后重试，不要编造数据 | | 翻译超时 | `translate_daily_top.py` 超过 60 秒无响应 | 终止进程，换一个候选模型重试一次；若仍失败，使用英文原文继续并告知用户 | | API Key 无效 | `DASHSCOPE_API_KEY` 未设置或返回 401/403 | 立即停止，提示用户检查环境变量，不要尝试跳过翻译步骤直接生图 | | 空榜单 | 抓取结果 items 数组为空 | 告知用户"当前 Trending 榜单为空（可能处于刷新期）"，不要用缓存数据或虚构项目填充 | | 翻译模型不可用 | 随机选取的模型返回错误 | 从候选列表中排除该模型，随机选取下一个重试，最多重试 2 次 | | Wan 生图失败 | `run_wan_generation.py` 返回 FAILED 状态 | 原样返回错误信息，不要自动降低分辨率或更换风格重试 | --- ## 执行规则 - 默认先生成内容与 Prompt，不直接生图 - 若用户给了 audience / style / size / ratio，必须真实透传到 CLI 参数 - 中文海报必须保持：**Top 5、低信息密度、中文优先、3:4、可读性优先** - 使用脚本已经清洗过的摘要字段，不要手工拼接原始 README 长文本 - builder 输出以 4 个主模块为主：榜单概览、Top 5 项目卡片、热点方向、一句话结论 - 风格编号 1-10 对应 `build_daily_poster_assets.py` 中的 `STYLE_MAP` --- ## 参考资源与加载时机 | 资源 | 何时加载 | 何时不加载 | |------|----------|-----------| | `scripts/build_daily_poster_assets.py` 中的 `STYLE_MAP` | 用户询问风格细节（配色、排版、元素）或 prompt 输出异常时 | 正常流程中无需读取——风格已通过 `--style` 参数透传 | | `scripts/run_wan_generation.py` | 生图失败需排查参数或输出解析问题时 | 正常生图流程中直接调用 CLI 即可，无需读源码 | | `scripts/translate_daily_top.py` | 翻译结果异常（仍为英文、乱码、字段缺失）需排查时 | 翻译成功时无需读取 | | `scripts/fetch_daily_top10.py` | 抓取结果为空或数据格式异常时 | 正常抓取成功时无需读取 | | 外部参考：`infographic-skill-main/` | 需要理解 10 种风格的完整 prompt 模板时 **MANDATORY READ** | 仅使用默认风格且无自定义需求时 | | 外部参考：`Wan-skills-main/` | Wan 2.7 调用报错需查阅原始脚本参数时 | 正常调用成功时 **Do NOT load** |