用途:为 GramIO 文档站生成变更日志页面,通过分析 gramiojs GitHub 组织近期提交,产出面向开发者的更新说明,并同步更新相关文档与技能文件。
主要能力:读取项目根目录 .changelog-state.json 中的 sinceMap(仓库名到已处理提交完整 SHA 的映射)与 lastRunDate,实现基于 SHA 的精确增量抓取;首次运行需用户提供 --since 起始日期。使用 ghlog CLI 抓取补丁,分析破坏性变更、新功能、缺陷修复、依赖与版本变化及文档相关改动,并检查版本是否已发布到 npm。
使用方式:先计算次日日期,将 sinceMap 写入临时文件后执行 bunx ghlog --org gramiojs --since-map /tmp/gramio-since-map.json --include-new --since <lastRunDate> --until <tomorrow> --patch --patch-dir /tmp/gramio-patches --format markdown --output /tmp/gramio-ghlog.md;无 sinceMap 时改用 --since 日期方式。--until 为必填,否则当天提交可能被丢弃。随后读取 markdown 摘要与补丁,按需通过 AskUserQuestion 确认内容放置,再生成 docs/changelogs/YYYY-MM-DD.md 及俄语翻译,更新侧边栏、索引、首页与 public/changelog.json,并同步 skills 目录。
适用场景:GramIO 文档仓库的定期变更日志维护。
限制:依赖 ghlog CLI 与 GitHub 组织访问;版本发布状态需 npm 查询;具体效果与平台支持资料未完整提供。