用途:为 Next.js 应用快速搭建一个公开的 /changelog 更新日志页面,展示 GitHub Releases 中的发布记录,并附带 RSS 订阅。
主要能力:通过 GitHub Releases API 获取发布数据(无需认证即可读取);按次版本号(如 v1.2.3 归入 v1.2)分组展示;生成 /changelog.xml 的 RSS 2.0 订阅源;页面样式与应用现有设计保持一致,支持响应式与深色模式。
使用方式:技能假定从 master/main 分支开始,先执行 git checkout -b feat/changelog-page-$(date +%Y%m%d) 创建分支。随后生成三个文件:lib/github-releases.ts(API 客户端,含 getReleases 与 groupReleasesByMinor)、app/changelog/page.tsx(页面组件)、app/changelog.xml/route.ts(RSS 路由)。需配置环境变量:GITHUB_REPO(必填,格式 owner/repo)、GITHUB_TOKEN(可选,用于提高 API 速率限制)、NEXT_PUBLIC_APP_NAME 与 NEXT_PUBLIC_SITE_URL(用于页面元数据)。数据请求默认缓存 5 分钟(revalidate: 300)。
适用场景:需要对外公开产品更新记录、希望用户通过 RSS 订阅发布动态的 Next.js 项目。
限制:页面必须公开,不应包裹在 Clerk 的 <SignedIn>、中间件鉴权或任何会话要求中;复杂样式或应用特定定制需参考现有设计模式,可委派给 Codex 实现。验证方式为启动开发服务器后访问 /changelog 与 /changelog.xml。