tomevault-io 前端周刊创建器 (fe-weekly-creator)
帮助用户从多个技术周刊源自动抓取、筛选、生成中文前端周刊。
工作流程概览
整个流程分为 4 个阶段：抓取 → 合并 → 筛选 → 生成。
阶段一：抓取素材
从以下 6 个周刊源抓取最新一期内容（使用 read_web_page/web_fetch 工具）：
核心源（前端，每期必查）
- JavaScript Weekly —
https://javascriptweekly.com/issues/latest - Frontend Focus —
https://frontendfoc.us/issues/latest - Node Weekly —
https://nodeweekly.com/issues/latest - React Status —
https://react.statuscode.com/latest
AI 源（补充）
- TLDR AI —
https://tldr.tech/ai - The Batch —
https://www.deeplearning.ai/the-batch/
扩展搜索（可选）
除以上固定源外，还可以通过 web_search 主动搜索以下渠道获取补充素材：
- Hacker News：搜索本周热门前端相关帖子
- Reddit（r/javascript, r/reactjs 等）：本周热门讨论
- GitHub Trending：本周趋势项目
对每个源，提取以下信息：
- 文章标题 + 原文链接
- 简短描述（如果源提供了的话）
- 分类标签（技术文章 / 工具 / 版本发布 / 简讯）
抓取时用 forceRefetch: true 确保获取最新内容。
并行抓取所有源以提高效率。
阶段二：合并用户链接
检查用户是否提供了额外的链接。如果有：
- 使用
read_web_page/web_fetch读取每个链接的内容 - 将其纳入素材池，标记为"用户提供"
阶段三：筛选展示
从所有抓取的素材中，根据「内容筛选偏好」预筛选出约 15 条最有价值的内容，去掉低质量和重复条目。每个分类不超过 15 条，总量控制在 15 条左右，减轻用户审核负担。
按以下分类展示给用户：
## 📋 本期素材清单（已预筛选，共约 15 条）
### 技术文章（N 篇）
1. [文章标题](链接) — 一句话描述 [来源: JS Weekly]
2. ...
### 工具推荐（N 个）
1. [工具名](链接) — 一句话描述 [来源: Frontend Focus]
2. ...
### 版本发布（N 个）
1. [项目 vX.Y](链接) — 一句话描述 [来源: Node Weekly]
2. ...
### 本周快讯候选（N 条）
1. [关键词](链接) 一句话描述
2. ...
然后询问用户：
- 哪些需要保留、哪些删除
- 是否需要调整分类
- 是否需要补充遗漏的内容
阶段四：生成周刊
4.1 确定期号和日期
- 读取项目目录
src/content/blog/，找到最大的weekly-N.md中的 N - 新期号 = N + 1
- pubDate = 当周周一的日期（格式
YYYY-MM-DD）- 如果今天是周一，用今天
- 否则用下一个周一
4.2 生成内容
对用户确认的每条素材，用 read_web_page/web_fetch 读取原文，生成中文摘要点评。
链接规范：写入文档的所有资源链接必须是重定向后的最终 URL。在生成前对每条素材的链接发起请求，跟随重定向（301/302 等）获取最终目标地址，再将最终地址写入周刊 Markdown；不要使用短链、追踪链接或中间跳转地址。确保读者点击后直达原文。
严格遵循以下格式规范（来自项目 AGENTS.md）：
Frontmatter
---
title: "前端周刊 #N：关键词1，关键词2"
description: "关键词1，关键词2"
pubDate: YYYY-MM-DD
---
title 和 description 中的关键词从本期最亮眼的 2-3 个话题中提取。
板块顺序
- 本周快讯（可选，
## 本周快讯）— 独立的一周要闻，非下文的总结 - 技术文章（
## 技术文章） - 工具推荐（
## 工具推荐） - 版本发布（
## 版本发布）
本周快讯格式
- 关键词使用中文：
[关键词](链接)中的「关键词」用中文书写，便于读者扫读。 - 该板块为独立的一周要闻列表，与下方技术文章/工具/版本发布无总结关系。
## 本周快讯
- [关键词](链接) 一句话描述。
- [关键词](链接) 一句话描述。
卡片式格式（技术文章 / 工具推荐 / 版本发布通用）
- 标题必须使用中文：卡片标题
### [标题](链接)中的「标题」一律用中文呈现。若原文为英文标题，需翻译或提炼为简洁的中文标题再写入，不要直接保留英文。
### [标题](链接)
**四到五句**中文摘要点评。用抓人眼球的方式描述核心亮点、技术价值和实际影响。
突出最让人兴奋的变化，强调对开发者工作流的具体影响。
如果有代码示例能帮助理解，可以附上关键代码片段。
4.3 摘要点评写作要求
- 使用中文撰写
- 每条摘要 4-5 句话，信息密度高且抓人眼球
- 突出"这是什么"、"为什么重要"和"对你有什么影响"
- 如果是工具/库，说明解决什么问题、核心特性
- 如果是版本发布，说明主要变更和影响
- 适当附上关键代码片段帮助理解（不是每条都需要）
- 避免空洞的赞美，提供具体的技术信息
- AI 相关内容要关联到前端开发者的实际使用场景
4.4 内容排序
每个板块内的条目按以下优先级从高到低排序：
- 影响面广：涉及主流框架/工具、影响大量开发者的内容排最前
- 技术深度高：有独到见解、深入分析的内容优先于浅层资讯
- 实用价值强：能直接改善开发者工作流、解决真实痛点的内容靠前
- 话题热度高：社区讨论度高、本周热门话题的内容靠前
确保读者打开周刊时，第一眼看到的就是本期最值得关注的内容。
4.5 输出文件
将生成的内容写入 src/content/blog/weekly-{N}.md（项目根目录为 fe-weekly 所在路径）。
内容筛选偏好
在筛选阶段，优先选择以下类型的内容：
- 有影响力的版本发布：主流框架/工具的大版本更新（React、Vue、Next.js、Node.js、Vite、TypeScript 等）
- 实用的技术文章：性能优化、架构设计、最佳实践，而非纯新闻报道
- 值得关注的新工具：解决真实痛点的工具和库
- AI + 前端交叉内容：AI 辅助开发、AI 在前端的应用、LLM 相关的前端工具
- 有深度的工程实践：大厂工程实践、大规模项目经验分享
避免选入：
- 纯广告/赞助商内容
- 过于小众的项目（除非特别有趣）
- 重复出现在多个源中的同一条目（去重）
注意事项
- 链接必须使用最终重定向后的 URL：使用项目内置脚本或
curl命令解析最终地址，确保周刊中的所有链接都是直达原文的真实地址
解析重定向 URL
使用项目内置脚本 .agents/scripts/resolve-url.sh：
# 批量解析
.agents/scripts/resolve-url.sh 'https://link1' 'https://link2' 'https://link3'
# 输出: https://link1 -> https://final-url1
- 如果某个周刊源无法访问，跳过它并告知用户，继续处理其他源
- 去重：同一个链接/项目如果出现在多个源中，只保留一次
- 如果用户只说"写周刊"而没提供额外链接，直接进入抓取阶段
- 如果用户直接给了一组链接说"用这些写周刊"，可以跳过抓取阶段，直接用用户的链接生成
Source: shfshanyue/weekly — distributed by TomeVault.